CLI · 시작하기

담당 팀이 관리하는 전체 문서 보기

Kimi Code CLI란?

터미널에서 동작하는 AI Agent로, 코드 읽기·수정, 셸 명령 실행, 파일 검색, 웹페이지 가져오기를 수행하고 피드백에 따라 다음 단계를 조정합니다. 기능 구현, 버그 수정, 리팩터링, 낯선 프로젝트 이해, 파일 처리와 빌드·테스트에 적합합니다. TypeScript로 작성되고 npm으로 배포되는 Node.js 앱입니다.

설치

공식 설치 스크립트(권장)는 Node.js를 미리 설치할 필요가 없습니다. TUI를 잘 표시하려면 트루 컬러와 합자를 지원하는 Kitty나 Ghostty를 사용하세요.

macOS / Linux

Bash

Windows · PowerShell

Powershell

Windows에서는 처음 실행하기 전에 Git for Windows를 설치하세요. 내장 Git Bash를 셸로 사용합니다. 다른 위치에 설치했다면 KIMI_SHELL_PATH에 bash.exe의 절대 경로를 설정하세요. 스크립트는 최신 버전을 내려받고 체크섬을 확인한 뒤 kimi를 PATH에 추가합니다.

npm / pnpm

Node.js 22.19.0 이상이 필요합니다.

Bash

Bash

Bash

첫 실행과 로그인

프로젝트 디렉터리에서 실행하세요.

Bash

단일 지시는 kimi -p "…", 직전 세션 재개는 kimi -c를 사용합니다.

Text

/login에서 플랫폼을 선택합니다. Kimi Code (OAuth)는 원하는 기기에서 링크를 열고 로그인한 뒤 코드를 입력하는 방식입니다. Kimi Platform API key는 platform.kimi.com 또는 platform.kimi.ai의 키를 입력합니다. /logout으로 자격 증명을 삭제합니다. 다른 공급자는 ~/.kimi-code/config.toml에서 API 키를 설정하세요. 공급자, 설정 파일, 환경 변수, 설정 재정의를 참고하세요.

첫 대화

프로젝트를 파악하는 읽기 전용 질문으로 시작하세요.

Text

관련 파일을 읽은 뒤 답변합니다. 기본적으로 읽기는 자동으로 실행하지만 파일 변경과 셸 실행은 확인을 요청합니다. 구체적인 변경도 요청할 수 있습니다.

Text

Agent가 계획·편집·테스트를 수행하고 각 단계를 설명합니다. /help는 명령과 단축키 목록을 엽니다. ↑ / ↓로 탐색하고 Esc로 닫습니다. /exit, 대기 중 Ctrl-C 두 번, 또는 빈 입력란에서 Ctrl-D로 종료합니다.

자주 쓰는 명령과 키

대화 및 입력과 이전 안내를 참고하세요. 업그레이드, 삭제, 데이터 위치, 문제 해결은 담당 팀의 전체 안내를 확인하세요.