8분 읽기2026-07-22
Kimi Code CLI는 Moonshot AI의 오픈소스 터미널 AI 코딩 Agent입니다. 코드를 읽고 수정하며, 셸 명령을 실행하고, 사용자의 피드백을 바탕으로 다음 단계를 계획합니다. 이 빠른 참조에는 개발자들이 가장 자주 쓰는 Kimi Code 명령어, 슬래시 명령어, 키보드 단축키, 내장 도구, 일상 워크플로를 모았습니다. 터미널 옆에 열어 두고, Kimi Code 안에서는 /help, 셸에서는 kimi --help로 현재 버전에서 제공하는 기능을 확인하세요.
Kimi Code CLI 설치
대부분의 개발자에게는 공식 설치 스크립트가 가장 빠른 방법입니다. 단일 Kimi Code 바이너리를 설치하며 Node.js가 필요하지 않습니다. 로컬 툴체인에 더 잘 맞는다면 Homebrew, npm, pnpm도 사용할 수 있습니다.
| 플랫폼 / 관리자 | 명령어 |
|---|---|
| macOS / Linux 스크립트 | curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash |
| Homebrew | brew install kimi-code |
| Windows PowerShell | irm https://code.kimi.com/kimi-code/install.ps1 \| iex |
| npm | npm install -g @moonshot-ai/kimi-code |
| pnpm | pnpm add -g @moonshot-ai/kimi-code |
Windows에서는 Kimi Code CLI가 번들된 Git Bash를 셸 환경으로 사용하므로, 처음 실행하기 전에 Git for Windows를 설치하세요. 설치 후 새 터미널을 열고 바이너리를 확인합니다.
kimi --version
여기서 시작하세요
프로젝트에 처음 들어갈 때는 최소한 이 흐름을 사용하세요.
cd your-project
kimi
# 세션 내부
/login # 처음 실행하는 경우 로그인
/init # AGENTS.md 생성 또는 새로 고침
/plan on # 범위가 넓거나 위험하거나 불명확한 작업 전에 계획 수립
/help # 명령어와 단축키 확인
/compact # 대화가 길어질 때 context 확보
--yolo, /yolo, /auto는 신뢰하는 워크스페이스에서만 사용하세요. 승인 절차는 줄어들지만 Kimi Code가 더 자율적으로 행동할 수 있습니다.
가장 자주 쓰는 명령어
몇 가지만 외운다면 아래를 우선하세요. 대부분의 일상 세션을 처리할 수 있습니다.
| 명령어 | 기능 |
|---|---|
kimi | 현재 디렉터리에서 대화형 세션 시작 |
kimi -C | 여기서 가장 최근 세션 이어가기 |
kimi -p "..." | TUI를 열지 않고 단일 prompt 실행 |
/login | 처음 실행할 때 로그인 |
/init | AGENTS.md 생성 또는 새로 고침 |
/plan on | 범위가 넓거나 위험한 변경을 위해 Plan Mode 진입 |
/model | 이 세션의 모델 전환 |
/compact | 대화가 길어질 때 context 확보 |
/sessions | 이전 세션 탐색 및 재개 |
/help | 모든 명령어와 단축키 나열 |
Shift-Tab | Plan Mode 전환 |
실행 및 자동화
핵심 CLI 옵션
| 명령어 / 플래그 | 기능 |
|---|---|
kimi | 현재 디렉터리에서 대화형 세션 시작 |
kimi --continue, kimi -C | 이 디렉터리에서 가장 최근 세션 이어가기 |
kimi --session [id], kimi -S [id] | ID로 세션 재개 또는 ID 없이 세션 선택기 열기 |
kimi -p "...", kimi --prompt "..." | TUI를 열지 않고 단일 비대화형 prompt 실행 |
--output-format stream-json | 스크립팅용 JSONL 이벤트 출력. --prompt와 함께 사용할 때만 작동 |
kimi --model <model>, kimi -m <model> | 특정 모델 별칭으로 시작 |
kimi --plan | Plan Mode로 새 세션 시작 |
kimi --yolo, kimi -y | 일반 도구 호출 자동 승인. 신뢰하는 디렉터리에서만 사용 |
kimi --auto | 자동 권한 모드로 시작합니다. 승인은 자동으로 처리되며 Agent가 질문하지 않습니다. |
--skills-dir <dir> | 지정한 디렉터리에서 Skills를 로드하며, 이번 실행에서는 자동으로 발견된 사용자 및 프로젝트 Skill 디렉터리를 대체합니다. |
비대화형 예시
kimi -p "현재 저장소 상태 요약"
kimi -m kimi-code/kimi-for-coding -p "최신 diff 설명"
kimi -p "변경된 파일 목록" --output-format stream-json
CLI 하위 명령어
| 하위 명령어 | 용도 |
|---|---|
kimi login | TUI에 들어가지 않고 Kimi Code OAuth 디바이스 코드 로그인을 시작합니다. |
kimi acp | IDE 통합을 위해 Kimi Code를 Agent Client Protocol 서버로 실행합니다. |
kimi server | 로컬 REST/WebSocket/web 서비스를 실행, 설치, 관리합니다. |
kimi web | Kimi의 브라우저 UI를 엽니다. kimi server run --open과 같습니다. |
kimi doctor | config.toml 및 tui.toml을 검증합니다. |
kimi export [sessionId] | 세션을 ZIP 아카이브로 패키징합니다. |
kimi migrate | 기존 kimi-cli 설치의 로컬 데이터를 마이그레이션합니다. |
kimi upgrade | 최신 버전을 확인하고 업데이트 옵션을 표시합니다. |
kimi vis [sessionId] | 브라우저에서 세션 시각화 도구를 실행합니다. |
kimi provider | 터미널에서 provider를 관리합니다. |
유용한 서버 명령어:
kimi server run # 로컬 백그라운드 서버 시작 또는 재사용
kimi server run --foreground # 터미널에 연결된 상태로 실행
kimi server install # OS 관리 서비스 등록
kimi server status # 설치/실행/pid/포트 상태 표시
kimi web # 브라우저 UI 열기
슬래시 명령어
슬래시 명령어는 TUI에 내장된 제어 기능입니다. 입력 상자에 /를 입력하면 명령어 자동 완성이 열리며 alias도 함께 매칭됩니다. /로 시작하는 입력이 내장 명령어나 Skill 명령어와 일치하지 않으면 Agent에게 일반 메시지로 전송됩니다.
계정 및 구성
| 명령어 | Alias | 용도 |
|---|---|---|
/login | — | 계정 또는 플랫폼을 선택하고 로그인합니다. |
/logout | — | 현재 계정의 인증 정보를 지웁니다. |
/provider | — | provider 관리자를 열어 구성된 provider를 보고, 추가하고, 제거합니다. |
/model | — | 현재 세션에서 사용하는 LLM 모델을 전환합니다. |
/settings | /config | TUI 안에서 설정 패널을 엽니다. |
/experiments | /experimental | 실험적 기능 패널을 엽니다. |
/permission | — | 권한 모드를 선택합니다. |
/editor | — | Ctrl-G로 실행되는 외부 편집기를 구성합니다. |
/theme | — | 터미널 UI 색상 테마를 전환합니다. |
세션 관리
| 명령어 | Alias | 용도 |
|---|---|---|
/new | /clear | 현재 context를 버리고 새 세션을 시작합니다. |
/sessions | /resume | 이전 세션을 둘러보고 하나를 선택해 전환합니다. |
/tasks | /task | 백그라운드 작업 목록을 둘러봅니다. |
/fork | — | 현재 대화에서 새 세션을 fork합니다. |
/title [...] | /rename | 현재 세션 제목을 표시하거나 설정합니다. |
/compact [...] | — | 대화 context를 압축합니다. 선택 텍스트로 보존할 내용을 지정할 수 있습니다. |
/undo [n] | — | 활성 context에서 최근 prompt를 되돌립니다. |
/reload | — | 세션을 다시 로드하고 최신 config.toml 및 tui.toml 설정을 적용합니다. |
/reload-tui | — | tui.toml UI 기본 설정만 다시 로드합니다. |
/init | — | 코드베이스를 분석하고 AGENTS.md를 생성합니다. |
/export-md [...] | /export | 현재 세션을 Markdown으로 내보냅니다. |
/export-debug-zip | — | 현재 세션을 디버그 ZIP 아카이브로 내보냅니다. |
모드 및 실행 제어
| 명령어 | Alias | 용도 |
|---|---|---|
/yolo [on\|off] | /yes | YOLO 모드를 전환합니다. 켜져 있으면 일반 도구 호출 승인을 건너뜁니다. |
/auto [on\|off] | — | 자동 권한 모드를 전환합니다. 승인은 자동으로 처리되고 질문은 건너뜁니다. |
/plan [on\|off] | — | Plan Mode를 전환합니다. 단순히 전환하는 것만으로는 빈 계획 파일이 생성되지 않습니다. |
/plan clear | — | 현재 계획을 지웁니다. |
/swarm on\|off | — | prompt를 보내지 않고 swarm 모드를 켜거나 끕니다. |
/swarm <task> | — | swarm 모드를 켜고 작업을 prompt로 보낸 뒤, 정상 턴이 끝나면 swarm 모드를 끕니다. |
/goal [...] | — | 자율 목표를 시작하거나 관리합니다. |
Plan Mode는 범위가 넓거나 위험하거나 불명확한 작업에 사용합니다. 파일을 변경하기 전에 탐색과 계획 수립을 우선합니다.
계획을 검토하지 않은 채 40개 파일 리팩터링을 바로 시작합니다.
/plan on을 실행하고 Kimi Code가 프로젝트를 검사하게 한 다음, 제안된 계획을 검토하고 승인한 뒤 변경을 진행하세요.Goal 모드 하위 명령어에는 /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective>, /goal next manage가 있습니다.
정보 및 상태
| 명령어 | Alias | 용도 |
|---|---|---|
/help | /h, /? | 키보드 단축키와 사용 가능한 명령어 표시 |
/btw [question] | — | fork된 하위 Agent에서 곁가지 대화 열기 |
/usage | — | token 사용량, context 소모량, 할당량 정보 표시 |
/status | — | 버전, 모델, 작업 디렉터리, 권한 모드 등 실행 상태 표시 |
/mcp | — | MCP 서버와 연결 상태 나열 |
/plugins | — | 플러그인 관리자 열기 |
/version | — | Kimi Code CLI 버전 표시 |
/feedback | — | 제품 피드백 제출 |
/exit | /quit, /q | Kimi Code CLI 종료 |
Skills 및 확장 기능
| 명령어 | 용도 |
|---|---|
/mcp-config | MCP 서버를 구성하고 MCP OAuth 로그인을 처리합니다. |
/custom-theme [...] | 사용자 지정 TUI 색상 테마 생성 또는 편집 |
/update-config | config.toml 및 tui.toml 확인 또는 편집 |
/import-from-cc-codex | Claude Code 및 Codex 지침, Skills, MCP 설정 가져오기 |
/sub-skill | 로컬 Skill 목록을 찾아보고 재정리 |
/skill:name [extra text] | 설치된 외부 Skill 호출 |
/name [extra text] | 같은 이름의 시스템 명령어가 없을 때 외부 Skill 바로가기 |
/parent.child [extra text] | 점으로 구분된 명령어 이름으로 노출된 외부 하위 Skill 호출 |
내장 도구
내장 도구는 Kimi Code CLI 자체에서 제공됩니다. Read, Grep, Glob 같은 읽기 전용 도구는 기본적으로 자동 허용되며, 파일 쓰기, 명령 실행, 작업 중지, 일정 생성 도구는 권한 모드에서 허용하지 않는 한 보통 승인이 필요합니다.
파일, 셸, 웹
| 도구 | 기본 승인 | 용도 |
|---|---|---|
Read | 자동 허용 | 텍스트 파일 읽기 |
Write | 승인 필요 | 파일 생성 또는 덮어쓰기 |
Edit | 승인 필요 | 정확히 일치하는 파일 내용 교체 |
Grep | 자동 허용 | ripgrep으로 파일 내용 검색 |
Glob | 자동 허용 | glob 패턴으로 파일 찾기 |
ReadMediaFile | 자동 허용 | 이미지 또는 동영상 파일 읽기 |
Bash | 승인 필요 | 셸 명령 실행 |
WebSearch | 자동 허용 | 사용 가능한 경우 웹 검색 |
FetchURL | 자동 허용 | 지정한 URL의 콘텐츠 가져오기 |
계획, 상태, 협업
| 도구 | 기본 승인 | 용도 |
|---|---|---|
EnterPlanMode | 자동 허용 | Plan Mode 진입 |
ExitPlanMode | 자동 허용, 사용자가 계획 확인 | Plan Mode를 종료하고 계획 제출 |
TodoList | 자동 허용 | 표시되는 작업 할 일 목록 관리 |
Agent | 자동 허용 | 집중할 하위 작업을 위한 하위 Agent 생성 |
AgentSwarm | swarm 모드에서는 자동 허용, 그 외에는 승인이 필요할 수 있음 | 항목 기반 하위 agent를 시작하거나 기존 하위 agent 재개 |
AskUserQuestion | 자동 허용 | 구조화된 객관식 질문하기 |
Skill | 자동 허용 | 등록된 인라인 Skill 호출 |
백그라운드 및 예약 작업
| 도구 | 기본 승인 | 용도 |
|---|---|---|
TaskList | 자동 허용 | 백그라운드 작업 목록 표시 |
TaskOutput | 자동 허용 | 백그라운드 작업의 출력 보기 |
TaskStop | 승인 필요 | 실행 중인 백그라운드 작업 중지 |
CronCreate | 승인 필요 | 나중에 실행할 prompt 예약 |
CronList | 자동 허용 | 예약된 작업 목록 표시 |
CronDelete | 승인 필요 | 예약된 작업 취소 |
키보드 단축키
현재 버전에서 사용할 수 있는 단축키 목록은 TUI 안에서 /help를 입력해 확인하세요. 전체 upstream 목록은 공식 키보드 단축키 참조를 확인하세요.
일반 입력
| 단축키 | 동작 |
|---|---|
Enter | 현재 입력 제출 |
Shift-Enter / Ctrl-J | 새 줄 삽입 |
↑ / ↓ | 입력 기록 탐색 |
Esc | 팝업 닫기, 자동 완성 취소, 또는 스트리밍/압축 중단 |
Ctrl-C | 스트리밍 출력 중단 또는 입력 상자 비우기 |
Ctrl-D | 입력 상자가 비어 있을 때 종료 |
모드 전환 및 편집
| 단축키 | 동작 |
|---|---|
Shift-Tab | Plan Mode 전환 |
Ctrl-G | 현재 입력을 외부 편집기에서 편집 |
Ctrl-V | Unix / macOS에서 클립보드의 이미지 또는 동영상 붙여넣기 |
Alt-V | Windows에서 클립보드의 이미지 또는 동영상 붙여넣기 |
Ctrl-- | 입력 편집 되돌리기 |
스트리밍 및 도구 출력 중
| 단축키 | 동작 |
|---|---|
Ctrl-S | 조정: 현재 입력을 실행 중인 턴에 주입 |
Esc | 현재 스트리밍 출력 중단 |
Ctrl-C | 현재 스트리밍 출력 중단 |
Ctrl-O | 도구 출력 펼치기 또는 접기 |
승인 패널 및 팝업
| 단축키 | 동작 |
|---|---|
↑ / ↓ | 승인 옵션 사이 이동 또는 팝업 스크롤 |
Enter | 선택한 승인 옵션 확인; 도움말 팝업도 닫습니다 |
1 – 9 | 번호로 승인 옵션 선택 |
Esc / Ctrl-C / Ctrl-D | 현재 승인 요청 거부 |
Ctrl-E | 승인 패널에서 전체 diff 또는 파일 미리보기 내용 펼치기/접기 |
PageUp / PageDown | 팝업을 한 번에 10줄씩 스크롤 |
q / Q | 팝업 닫기 |
자주 쓰는 워크플로
새 repo 시작
cd your-project
kimi
/init
/status
편집 전 refactor 계획 세우기
/plan on
Refactor the auth module to use the new token format and update all callers.
백그라운드 작업 실행
테스트 스위트를 실행하고 완료되면 결과를 알려 주세요.
그런 다음 /tasks를 열어 백그라운드 작업을 모니터링하거나, 작업이 끝나면 Kimi Code가 알리도록 두세요.
어제 작업 이어서 하기
kimi --continue
특정 세션이 필요하면 kimi --session을 실행하거나 TUI 안에서 /sessions를 사용하세요.
세션 내보내기 또는 디버그
/export-md
/export-debug-zip
kimi export -y
마무리
Kimi Code CLI는 명확한 프로젝트 context를 공유하는 터미널 팀원처럼 다룰 때 가장 빛납니다. /init으로 시작하고, 크거나 불확실한 변경에는 /plan을 사용하며, 오래 걸리는 작업은 /tasks로 지켜보세요. 긴 세션에는 /compact를 곁에 두고, repository의 신뢰 수준에 맞는 권한 모드를 선택하세요.
자주 묻는 질문
Kimi Code CLI를 무료로 설치할 수 있나요?
예. Kimi Code CLI는 오픈소스이며 무료로 설치할 수 있습니다. 다만 기반 모델이나 서비스 이용 권한은 Kimi Code 요금제에 따라 달라질 수 있습니다. 자세한 내용은 Kimi Code 가격을 참고하세요.
왜 이 페이지 이름이 단순히 치트시트가 아니라 빠른 참조인가요?
‘빠른 참조’가 더 공식적이고 문서다운 명칭입니다. 이 페이지는 여전히 치트시트의 용도에 맞게 복사해 붙여 넣을 수 있는 명령어, 슬래시 명령어, 단축키, 도구, 워크플로를 한곳에 모았습니다.
Kimi Code CLI를 설치하려면 Node.js가 필요한가요?
공식 설치 스크립트에는 Node.js가 필요하지 않습니다. npm 및 pnpm 설치 방식은 JavaScript 패키지 관리자를 사용하므로 Node.js 환경이 필요합니다.
`/plan`과 일반 모드는 무엇이 다른가요?
일반 모드에서는 Agent가 바로 작업합니다. Plan Mode는 범위가 넓거나 위험하거나 불명확한 작업을 위한 모드입니다. Kimi Code가 먼저 탐색하고 계획을 작성한 뒤, 계획이 승인되면 종료합니다.
이전 세션은 어떻게 다시 시작하나요?
같은 프로젝트 디렉터리에서
kimi --continue를 실행하면 가장 최근 세션을 이어갈 수 있습니다. 특정 세션을 선택하려면 셸에서 kimi --session [id]를 사용하거나 TUI 안에서 /sessions를 사용하세요.`--yolo`는 안전한가요?
--yolo는 일반 도구 호출에 대한 승인을 건너뜁니다. 신뢰할 수 있고 버전 관리되는 워크스페이스에서만 사용하세요. 낯선 저장소나 프로덕션 데이터에서는 승인을 켜 두는 것이 좋습니다.Skills와 MCP는 Kimi Code에서 어떻게 쓰이나요?
Skills는 재사용 가능한 워크플로를 패키징하며 슬래시 명령어로 나타날 수 있습니다. MCP는 Kimi Code를 외부 도구 및 데이터 소스와 연결합니다.
/skill:name, /mcp, /mcp-config로 찾아보고 설정하세요.