자주 묻는 질문

이전 버전에서 마이그레이션하기

Kimi Code CLI는 메이저 버전 업그레이드를 거쳐 Python/uv에서 Node.js로 전환되었으며, 더 간편한 설치 경험과 빠른 시작 속도, 새롭게 디자인된 터미널 UI를 제공합니다. 이전 버전은 점차 단계적으로 종료될 예정이니 가능한 한 빨리 업그레이드하시기를 권장합니다.

이전 버전에서 마이그레이션하는 경우 아래 단계를 따르세요. 명령어 한 번으로 설정, MCP 서버, 세션 기록을 새 버전으로 마이그레이션할 수 있습니다.

새로워진 점

Python / uv 불필요: Node.js 기반으로 재구축되어 Python 환경이 필요 없고 설치가 더 간단해졌습니다
네이티브 바이너리, 즉시 사용 가능: 더 빠른 시작 속도와 가벼운 용량
새롭게 디자인된 터미널 UI: 더 부드럽고 반응성이 뛰어난 경험
전체 데이터 마이그레이션: 설정, MCP 서버, 세션 기록이 모두 매끄럽게 이전됩니다

마이그레이션 방법

마이그레이션 방법은 두 가지가 있습니다.

kimi-code 설치 후 처음 kimi를 실행하면 ~/.kimi/ 아래에 kimi-cli 데이터가 존재하는지 자동으로 확인합니다. 데이터가 발견되면 마이그레이션 안내가 표시되며, 지금 마이그레이션하기, 나중에 하기, 다시 묻지 않기 중에서 선택할 수 있습니다.

또한 언제든지 직접 실행할 수도 있습니다:

Bash

채팅 세션을 함께 마이그레이션할지 선택할 수 있습니다. 아직 기록이 필요하지 않다면 설정만을 선택하고, 그렇지 않다면 설정 + N개 세션을 선택해 한 번에 모두 가져오세요. 마지막에 요약이 출력됩니다.

마이그레이션 중 일어나는 일

마이그레이션되는 항목: 설정(config.toml), MCP 서버 설정, 입력 기록, 그리고 마이그레이션하기로 선택한 채팅 세션.

마이그레이션되지 않는 항목: OAuth 로그인 자격 증명과 MCP 서비스 인증은 복사되지 않으므로, 마이그레이션 후 다시 /login을 실행하고 MCP 서버를 재인증해야 합니다. kimi-cli 플러그인 역시 대상에서 제외됩니다.

마이그레이션은 ~/.kimi/ 아래의 기존 데이터를 결코 수정하거나 삭제하지 않습니다. kimi-cli는 예전처럼 계속 작동하며 둘은 서로 간섭하지 않습니다. 마이그레이션은 반복해서 실행할 수도 있는데, 이미 마이그레이션된 세션은 다시 가져오지 않습니다.

마이그레이션 후 kimi-cli에서 가져온 세션은 세션 선택기에서 [imported] 태그가 붙어 새 세션과 구분할 수 있습니다.

설치 및 인증

`/login` 실행 시 사용 가능한 모델이 없음

/login 실행 시 "선택한 플랫폼에 사용 가능한 모델이 없습니다"가 표시된다면 다음 원인일 수 있습니다:

API 키가 유효하지 않거나 만료됨: 입력한 API 키가 올바르고 여전히 유효한지 확인하세요.
네트워크 연결 문제: API 서비스 주소(예: api.kimi.com 또는 api.moonshot.cn)에 접근할 수 있는지 확인하세요.

플랫폼 구분에 주의

Kimi Code 멤버십 혜택과 Kimi 오픈 플랫폼은 서로 다른 Base URL을 사용합니다. 설정 시 Base URL이 API Key와 일치하는지 반드시 확인하세요.

플랫폼	Base URL	과금 방식	키 생성
Kimi Code	Anthropic 호환: `https://api.kimi.com/coding/`	Kimi 멤버십 구독(크레딧 포함)	Kimi Code 콘솔
Kimi 오픈 플랫폼	`https://api.moonshot.cn/v1`	사용량 기반 과금	Kimi 오픈 플랫폼

API 키가 유효하지 않음

API 키가 유효하지 않은 가능한 원인:

키를 잘못 입력함: 불필요한 공백이나 누락된 문자가 없는지 확인하세요.
키가 만료되었거나 취소됨: 플랫폼 콘솔에서 키 상태를 확인하세요.

멤버십 만료 또는 크레딧 소진

Kimi Code 플랫폼을 사용 중이라면 /usage 명령어로 현재 quota와 멤버십 상태를 확인할 수 있습니다. quota가 소진되었거나 멤버십이 만료된 경우 Kimi Code에서 갱신하거나 업그레이드해야 합니다.

인보이스 요청이나 멤버십 업그레이드는 어떻게 하나요?

Kimi 멤버십 페이지에 방문하여 안내에 따라 인보이스 요청을 제출하거나 플랜을 업그레이드하세요.

상호작용 관련 문제

이미지 붙여넣기 실패

Ctrl-V로 이미지를 붙여넣을 때 "현재 모델은 이미지 입력을 지원하지 않습니다"가 표시된다면, 현재 모델이 이미지 입력을 지원하지 않는 것입니다.

해결 방법:

이미지를 지원하는 모델로 전환: image_in 기능을 갖춘 모델을 사용하세요.
클립보드 내용 확인: 클립보드에 이미지 파일 경로가 아니라 실제 이미지 데이터가 들어 있는지 확인하세요.

업데이트 및 업그레이드

macOS 첫 실행이 느림

macOS Gatekeeper는 새 프로그램을 처음 실행할 때 보안 검사를 수행하므로 시작 속도가 느려집니다. 해결 방법:

검사가 완료될 때까지 대기: 첫 실행 시 잠시 기다리면 이후 실행은 정상 속도로 돌아옵니다.
개발자 도구에 추가: 시스템 설정 → 개인정보 보호 및 보안 → 개발자 도구에서 터미널 앱을 추가하세요.

Kimi Code CLI 업그레이드 방법

kimi upgrade를 실행하면 최신 버전을 확인하고 업데이트 옵션을 제시합니다. Install update now를 선택해 업그레이드하세요. 패키지 관리자를 통해 직접 업그레이드할 수도 있습니다:

Bash

VS Code 확장 프로그램 FAQ

아래는 Kimi Code VS Code 확장 프로그램에 관한 자주 묻는 질문입니다.

VS Code에 열린 작업 공간이 없다고 표시됨

VS Code에서 폴더를 열어주세요. Kimi Code VS Code 확장 프로그램이 제대로 작동하려면 작업 공간이 필요합니다.

VS Code에 CLI를 찾을 수 없다고 표시됨

Kimi Code CLI를 수동으로 설치한 뒤 VS Code 설정에서 kimi.executablePath를 구성하거나, 내장 CLI가 존재하는지 확인하세요.

VS Code 로그인 실패

로그인을 건너뛰고 대신 API 키 모드를 사용해 보거나, 네트워크 연결을 확인하거나, Kimi Code 확장 프로그램 작업 메뉴를 통해 나중에 다시 시도하세요.

VS Code에서 메시지를 보내도 응답이 없음

Kimi Code CLI가 사용 가능한지, 모델이 구성되어 있는지, VS Code에 작업 공간 폴더가 열려 있는지 확인하세요. "Kimi Code: Show Logs"를 통해 오류 로그를 확인하세요.

VS Code 연결 시간 초과

30초 이내에 응답이 없으면 시간 초과됩니다. 네트워크를 확인하고 다시 시도하세요.

VS Code에서 메시지를 보내기 전 오류 발생

Kimi Code CLI를 찾을 수 없거나, 버전이 너무 낮거나, 로그인되지 않았거나, 세션이 사용 중인 경우 등 특정 오류로 인해 VS Code에서 메시지를 보낼 수 없습니다. 오류는 토스트 알림으로 표시되며, 다시 시도할 수 있도록 입력 내용은 보존됩니다.

피드백 및 문의

문서로 문제가 해결되지 않음

위 내용으로 문제가 해결되지 않았다면 이메일로 문의해 주세요: [email protected]. 이메일에 겪으신 문제, 수행한 단계, 관련 로그 정보를 적어주시면 최대한 빨리 답변드리겠습니다.

문제나 제안 사항이 있으시면 GitHub Issues에서도 피드백을 남기실 수 있습니다.