자주 묻는 질문

설치 및 인증

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

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

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

플랫폼 구분에 주의

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

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

API 키가 유효하지 않음

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

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

멤버십 만료 또는 credit 소진

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에서 메시지를 보낼 수 없습니다. 오류는 토스트 알림으로 표시되며, 다시 시도할 수 있도록 입력 내용은 보존됩니다.

문의 및 피드백

Kimi의 왼쪽 아래 프로필 → Get Help → User Feedback에서 지원팀에 문의하세요. 문제, 수행한 단계, 관련 로그를 설명해 주세요.

이 문서가 도움이 되었나요?