Kimi K3.1 Pro를 Kimi Code CLI에 통합하기: 설치, 로그인, 그리고 Windows의 함정

Kimi Code CLI는 Moonshot의 터미널 코딩 에이전트이며, Kimi K3.1 Pro가 서드파티 통합이 아니라 기본값인 유일한 클라이언트입니다. 설정은 Claude Code나 Codex 경로보다 짧습니다 — 설치 스크립트 하나, /login 한 번, 플랫폼 선택 한 번이면 되는데, 클라이언트와 모델이 같은 회사에서 나오기 때문입니다. 주의할 점은 플랫폼마다 다릅니다. Windows에서는 CLI가 함께 번들된 Git Bash 안에서 실행되는데, 그 셸이 설치 프로그램이 예상하는 위치에 없으면 도구가 시작된 뒤 모델 오류처럼 보이는 방식으로 실패합니다.

이것은 2026년 10월 24일 Moonshot 문서와 대조해 검증한 작동 순서이며, 실패 모드는 실제로 발생하는 지점에서 짚어 두었습니다.

설치

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. 이 스크립트는 최신 릴리스를 다운로드하고 체크섬을 검증한 뒤 kimi 실행 파일을 PATH에 추가합니다. Node.js나 Python 런타임은 필요하지 않습니다.

Windows에는 놓치기 쉬운 필수 조건이 하나 있습니다: 먼저 Git for Windows를 설치하세요. Kimi Code CLI는 번들로 제공되는 Git Bash를 셸 환경으로 사용합니다. Git Bash가 표준이 아닌 위치에 있다면 실행 전에 KIMI_SHELL_PATH 환경 변수를 bash.exe의 절대 경로로 설정하세요. 그렇지 않으면 에이전트는 시작되지만 실행하려는 모든 셸 명령이 실패합니다.

API 키로 로그인

작업하려는 프로젝트 디렉터리 안에서 CLI를 시작하세요:

• kimi를 실행하여 대화형 인터페이스를 여세요.

• /login을 입력하세요. Kimi Code CLI가 플랫폼 선택기를 엽니다.

• 선택하세요: Kimi Platform (API 키 · platform.kimi.ai). 이 옵션은 오픈 플랫폼에서 생성한 키에 해당하며, 다른 옵션은 서로 다른 계정 화면에 해당합니다.

• 키를 붙여넣으세요. 키가 없다면 platform.kimi.ai의 API Keys에서 하나를 생성하세요. CLI는 이를 로컬에 저장하므로 config 디렉터리를 자격 증명 저장소처럼 취급하세요.

그게 연결의 전부입니다. CLI 내부의 모델 선택기는 현재 Kimi 모델들을 나열하며, Kimi K3.1 Pro와 그 고속 변형이 에이전트 작업에 중요한 두 가지입니다.

기존 설정 전환 및 키 교체

두 가지 마이그레이션이 흔하며, 둘 다 같은 화면을 거칩니다. Kimi Code CLI가 이미 API 키가 아니라 구독을 통해 로그인되어 있다면, /login을 다시 실행하고 API 키 플랫폼을 선택하면 재설치 없이 전환됩니다. 키를 교체하는 경우 — 키가 유출되었거나 프로젝트에 자체 결제가 필요한 경우 — 동일한 흐름으로 저장된 자격 증명이 교체됩니다.

CLI가 실행 중일 때 저장된 설정을 직접 편집하는 것만은 절대 하지 마세요. 프로세스는 시작 시 자격 증명을 읽으며, 세션 도중에 편집한 내용은 종료 시 덮어써집니다.

에이전트가 실제로 하는 일

Kimi Code CLI는 터미널 안의 채팅 창이 아닙니다. 코드를 읽고 편집하며, 저장소를 검색하고, 명령을 실행해 그 결과를 읽고, 작업에 프로젝트 외부의 무언가가 필요할 때 웹 콘텐츠를 가져오거나 검색할 수 있습니다. Moonshot은 이를 모델이 계획을 세우는 가운데 사용자 자신의 머신에서 실행되는 코딩 에이전트라고 설명합니다. Claude Code나 Codex와 같은 형태이며, 권한에 관해서도 같은 함의를 지닙니다. 셸 명령을 실행할 수 있는 에이전트는 기꺼이 수정해도 되는 디렉터리에서 시작해야 하고, 무엇이든 푸시하기 전에 검토해야 합니다.

이 클라이언트에는 두 가지 과금 모델이 공존합니다. Kimi Code 앱은 요금제 등급이 있는 구독으로 판매되며, CLI는 해당 구독이나 오픈 플랫폼의 API 키를 사용할 수 있습니다. API 키 경로는 토큰당 경제성을 제공합니다. K3.1 Pro의 경우 백만 토큰당 $2.00 및 $10.00, 고속 버전의 경우 $4.00 및 $20.00입니다. 반면 구독은 할당량이 포함된 정액 요금입니다. 이미 다른 곳에서 API 사용료를 지불하고 있는 팀에게는 키 경로가 지출을 한곳에 모아 주고, 하루 종일 코딩하는 개인에게는 구독이 보통 더 저렴하며 CLI는 어느 쪽이든 동일한 다운로드입니다.

모델과 노력 수준 선택

Kimi K3.1 Pro는 항상 추론하며, effort는 low, high, max를 허용하는 최상위 필드로 설정되고 기본값은 max입니다. Kimi Code CLI는 해당 모델을 노출하는데, effort 기본값이 비용이 큰 쪽이므로 세션이 느리게 느껴진다면 보통 연결이 끊긴 것이 아니라 max로 실행 중인 세션일 가능성이 큽니다. 고속 변형은 지연 시간을 가격과 맞바꾸는 대신 백만 토큰당 $2.00와 $10.00이 아닌 $4.00와 $20.00이며, 모델이 어차피 사람을 기다리는 대화형 작업에서는 합리적인 기본값입니다.

모델이 어떤 클라이언트로 가더라도 두 가지 제약이 따릅니다. 샘플링 매개변수는 고정되어 있고(temperature 1.0, top-p 0.95, n은 1), 대화 중간에 effort를 변경하면 prefix-cache 적중이 무효화됩니다. 세션 시작 시 레벨을 정하세요.

이 라우트가 Claude Code 및 Codex와 어떻게 비교되는지

세 클라이언트는 동일한 모델에 접근하기 위해 각기 다른 세 가지 프로토콜을 사용하며, 선택은 대부분 팀이 이미 사용 중인 인터페이스에 달려 있습니다. Kimi Code CLI는 구성이 가장 적게 필요합니다. 환경 블록도, TOML 파일도 필요 없고, 공급업체가 양쪽을 관리합니다. Claude Code는 Anthropic 호환 엔드포인트와 네 가지 모델 티어 변수를 올바르게 설정해야 하며, Codex는 wire_api = "responses"가 포함된 공급자 블록이 필요하지만, 그러면 둘 다 해당 프로토콜을 사용하는 모든 공급자에 대해 작동합니다. 다른 공급업체의 모델도 제공하는 게이트웨이를 포함해서요.

실용적인 구분: {{2}}Kimi{{/2}}만 필요하고 가장 짧은 경로를 원할 때는 {{1}}Kimi Code CLI{{/1}}를 사용하세요. 같은 세션에서 벤더를 전환해야 하거나 팀의 도구, 권한, 스킬이 이미 해당 {{5}}클라이언트{{/5}}에 자리 잡고 있을 때는 {{3}}Claude Code{{/3}}나 {{4}}Codex{{/4}}를 사용하세요.

시간을 절약해 주는 문제 해결 순서

• CLI는 시작하지만 셸 명령이 실행되지 않는다면, 모델을 탓하기 전에 먼저 Git Bash와 KIMI_SHELL_PATH를 확인하세요.

• 정상적으로 작동하던 설정 후 인증 오류 — 다음을 다시 실행하세요: /login 그런 다음 플랫폼 옵션이 키가 생성된 위치와 일치하는지 확인하세요. 서로 다른 화면에서 생성된 키는 서로 바꿔 사용할 수 없습니다.

• 세션이 느리게 느껴진다면 — 모델을 바꾸기 전에 effort 기본값을 확인하세요. max는 지연 시간과 토큰 양쪽 모두에서 비용이 큽니다.

• 업데이트 후 모델을 찾을 수 없음 — CLI는 플랫폼이 제공하는 항목을 나열합니다. K3.1 Pro가 없다면 클라이언트가 아직 업데이트되지 않은 환경을 가리키고 있는 것입니다.

플랫폼에서 Kimi K3.1 Pro는 입력 토큰 100만 개당 $2.00, 출력 토큰 100만 개당 $10.00이며, 1M 토큰 컨텍스트와 최대 943,718개의 출력 토큰을 지원합니다.kimi/kimi-k3.1-pro로, 제공업체의 정가에 마크업 없이 제공합니다 — 해당 경로의 구성은 Claude Code 및 Codex 가이드에서 다룹니다.