Kimi Code CLI

상위 문서: ← Kimi Integrations 출처: Kimi API Platform 공식 문서 — Use Kimi API Platform with Kimi Code CLI 한글화 (2026-07-22) 공급사: Moonshot AI (月之暗面)

Kimi Code는 개발자를 위한 지능형 코딩 서비스이며, Kimi Code CLI는 그 터미널 기반 AI 에이전트입니다.

Kimi Code CLI는 Kimi API Platform에서 생성한 API Key를 직접 사용할 수 있습니다. 이 가이드는 다음 작업을 설명합니다:

platform.kimi.ai의 API Key로 연결
기존 Kimi Code CLI 설정을 Kimi API Platform으로 전환
설정된 API Key 교체

이 가이드는 Kimi Code CLI가 이미 설치되어 있다고 가정합니다.

1. Kimi Code CLI 설치 (필요 시)

설치되어 있지 않으면 공식 설치 가이드 참고 또는 OS에 맞게 실행:

macOS / Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows (PowerShell):

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Windows에서 첫 실행 전 Git for Windows를 설치하세요. Kimi Code CLI는 번들된 Git Bash를 셸 환경으로 사용합니다. Git Bash가 비표준 경로에 설치되어 있으면 KIMI_SHELL_PATH 환경 변수를 bash.exe의 절대 경로로 설정하세요.

설치 스크립트는 최신 릴리스를 다운로드해 체크섬을 검증한 뒤 kimi 실행 파일을 PATH에 배치합니다.

2. API Key 준비

Kimi API Platform에 로그인 → API Keys 페이지에서 API Key를 생성·복사합니다.

API Key는 안전하게 보관하고, 공유하거나 스크린샷에 전체 값을 노출하지 마세요.

3. Kimi API Platform 연결

3-1. Kimi Code CLI 시작

작업할 프로젝트 디렉토리에서 시작:

kimi

대화형 인터페이스에서 다음 입력:

/login

Kimi Code CLI가 플랫폼 선택기를 엽니다.

3-2. API Key 플랫폼 선택

API Key가 생성된 플랫폼과 일치하는 옵션 선택:

API Key 출처	Kimi Code CLI에서 선택
`platform.kimi.ai`	`Kimi Platform (API key · platform.kimi.ai)`

화살표 키로 선택 후 Enter.

선택한 플랫폼은 API Key가 생성된 사이트와 일치해야 합니다. 불일치 시 API Key 검증 실패.

3-3. API Key 입력

프롬프트에 API Key를 붙여넣고 Enter.

Kimi Code CLI가 API Key를 검증하고 계정에서 사용 가능한 모델을 로드합니다.

3-4. 모델 선택

API Key 검증이 끝나면 계정에서 사용 가능한 모델이 표시됩니다. 사용할 모델을 선택·확인.

Kimi Code CLI가 다음을 수행합니다:

현재 세션을 선택 모델로 전환
선택한 플랫폼·모델 저장
이후 실행에서 같은 설정 재사용

구성 확인 메시지가 나타나면 Kimi API Platform 연결 완료.

3-5. 연결 확인

현재 세션 상태 확인:

/status

현재 모델을 확인한 후 간단한 작업을 보냅니다:

Review the current project and briefly describe its directory structure.

Kimi Code CLI가 정상 응답을 반환하면 연결이 동작하는 것입니다.

4. 다른 로그인에서 Kimi API Platform API Key로 전환

Kimi Code CLI가 이미 다른 로그인 방법을 사용 중이라면, 프로그램을 종료하거나 설정을 수동으로 편집할 필요 없이 현재 세션에서 다음을 다시 실행:

/login

그 다음:

Kimi Platform (API key · platform.kimi.ai) 선택
Kimi API Platform API Key 입력
사용할 모델 선택
구성 확인 대기

현재 세션이 선택한 Kimi API Platform 모델로 즉시 전환됩니다. Kimi Code CLI를 재시작할 필요 없음.

5. API Key 교체

/login을 다시 실행 → Kimi Platform (API key · platform.kimi.ai) 선택 → 새 API Key 입력. 구성 완료 후 새 Key 사용.

트러블슈팅

API Key 검증 실패

선택한 플랫폼이 API Key가 생성된 플랫폼과 일치하는지
공백 없이 완전한 API Key가 복사되었는지
API Key가 유효한지
해당 Kimi API Platform 계정이 API를 호출할 수 있는지

API Key가 폐기/노출되었다면 새 API Key를 발급하고 /login을 다시 실행.

`/login` 사용 불가

Kimi Code CLI가 생성·작업 중이라면 작업이 끝나길 기다리거나, Esc / Ctrl-C로 중단한 뒤 /login 재실행.

모델이 표시되지 않음

API Key와 선택한 플랫폼이 일치하는지 확인 후 /login 재실행. 그래도 안 되면 Kimi Code CLI를 업그레이드하고 Kimi API Platform 계정 상태를 확인.

더 알아보기

변경 이력

날짜	변경
2026-07-22	초판 작성 (공식 Kimi Code CLI 통합 가이드 한글화)
2026-07-22	제목에 "Kimi" 접두사 추가, 본문 H1 중복 제거