8분 읽기2026-06-18
이 빠른 참조에는 개발자가 가장 자주 쓰는 Kimi Code 명령어, 슬래시 명령어, 키보드 단축키, 내장 도구, 일상 워크플로가 정리되어 있습니다. 터미널 옆에 열어 두고, 현재 버전에서 제공하는 항목은 Kimi Code 안의 /help 또는 셸의 kimi --help로 확인하세요.
업스트림 세부 정보는 공식 kimi command, slash commands, built-in tools, keyboard shortcuts 참조를 확인하세요.
여기서 시작하세요
프로젝트에 처음 들어갈 때는 다음 최소 루프를 사용하세요.
cd your-project
kimi
# 세션 안에서
/login # 처음 실행했다면 로그인
/init # AGENTS.md 생성 또는 새로 고침
/plan on # 범위가 넓거나 위험하거나 불명확한 작업 전에 계획 수립
/help # 명령어와 단축키 확인
/compact # 대화가 길어졌을 때 컨텍스트 확보
--yolo, /yolo, /auto는 신뢰하는 워크스페이스에서만 사용하세요. 승인 과정의 번거로움은 줄어들지만, Kimi Code가 더 자율적으로 행동하게 됩니다.
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에서는 처음 실행하기 전에 Git for Windows를 설치하세요. Kimi Code CLI가 번들로 제공되는 Git Bash를 셸 환경으로 사용하기 때문입니다. 설치 후 새 터미널을 열어 바이너리를 확인하세요.
kimi --version
실행 및 자동화
핵심 CLI 옵션
| 명령어 / 플래그 | 기능 |
|---|---|
kimi | 현재 디렉터리에서 대화형 세션 시작 |
kimi --continue, kimi -C | 이 디렉터리의 가장 최근 세션 이어가기 |
kimi --session [id], kimi -S [id] | ID로 세션을 재개하거나, ID 없이 세션 선택기 열기 |
kimi -p "...", kimi --prompt "..." | TUI를 열지 않고 단일 비대화형 프롬프트 실행 |
--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 "Summarize the current repository status"
kimi -m kimi-code/kimi-for-coding -p "Explain the latest diff"
kimi -p "List changed files" --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에 내장된 제어 기능입니다. 입력창에 /를 입력하면 명령어 자동 완성이 열리며, 별칭도 함께 매칭됩니다. /로 시작하는 입력이 내장 명령어나 Skill 명령어와 일치하지 않으면 일반 메시지로 Agent에게 전송됩니다.
계정 및 구성
| 명령어 | 별칭 | 목적 |
|---|---|---|
/login | — | 계정 또는 플랫폼을 선택하고 로그인 |
/logout | — | 현재 계정의 자격 증명 삭제 |
/provider | — | provider 관리자를 열어 구성된 provider를 확인, 추가, 제거 |
/model | — | 현재 세션에서 사용하는 LLM 모델 전환 |
/settings | /config | TUI 안에서 설정 패널 열기 |
/experiments | /experimental | 실험적 기능 패널 열기 |
/permission | — | 권한 모드 선택 |
/editor | — | Ctrl-G로 실행되는 외부 편집기 구성 |
/theme | — | 터미널 UI 색상 테마 전환 |
세션 관리
| 명령어 | 별칭 | 목적 |
|---|---|---|
/new | /clear | 현재 컨텍스트를 버리고 새 세션 시작 |
/sessions | /resume | 이전 세션을 둘러보고 그중 하나로 전환 |
/tasks | /task | 백그라운드 작업 목록 보기 |
/fork | — | 현재 대화에서 새 세션을 fork |
/title [...] | /rename | 현재 세션 제목을 표시하거나 설정 |
/compact [...] | — | 대화 컨텍스트를 압축합니다. 선택 텍스트로 보존할 내용을 힌트로 줄 수 있습니다. |
/undo [n] | — | 활성 컨텍스트에서 최근 프롬프트 실행 취소 |
/reload | — | 세션을 다시 로드하고 최신 config.toml 및 tui.toml 설정 적용 |
/reload-tui | — | tui.toml UI 환경설정만 다시 로드 |
/init | — | 코드베이스를 분석하고 AGENTS.md 생성 |
/export-md [...] | /export | 현재 세션을 Markdown으로 내보내기 |
/export-debug-zip | — | 현재 세션을 디버그 ZIP 아카이브로 내보내기 |
모드 및 실행 제어
| 명령어 | 별칭 | 목적 |
|---|---|---|
/yolo [on|off] | /yes | YOLO 모드 전환. 켜져 있으면 일반 도구 호출의 승인을 건너뜁니다. |
/auto [on|off] | — | 자동 권한 모드 전환. 승인은 자동으로 처리되며 질문은 생략됩니다. |
/plan [on|off] | — | Plan Mode 전환. 단순히 전환해도 빈 계획 파일은 생성되지 않습니다. |
/plan clear | — | 현재 계획 지우기 |
/swarm on|off | — | 프롬프트를 보내지 않고 swarm 모드를 켜거나 끄기 |
/swarm <task> | — | swarm 모드를 켜고 작업을 프롬프트로 보낸 뒤, 일반 턴이 끝나면 swarm 모드를 끄기 |
/goal [...] | — | 자율 목표를 시작하거나 관리 |
Plan Mode는 범위가 넓거나 위험하거나 불명확한 작업에 적합합니다. 파일을 변경하기 전에 탐색과 계획을 우선합니다.
계획을 검토하지 않은 채 40개 파일 리팩터링을 바로 시작합니다.
/plan on을 실행해 Kimi Code가 프로젝트를 살펴보게 하고, 제안된 계획을 검토한 뒤 변경이 이루어지기 전에 승인하세요.목표 모드 하위 명령어에는 /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective>, /goal next manage가 있습니다.
정보 및 상태
| 명령어 | 별칭 | 목적 |
|---|---|---|
/help | /h, /? | 키보드 단축키와 사용 가능한 명령어 표시 |
/btw [question] | — | fork된 하위 Agent에서 사이드 대화 열기 |
/usage | — | token 사용량, 컨텍스트 소비량, 할당량 정보 표시 |
/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 | 승인 필요 | 프롬프트가 나중에 실행되도록 예약 |
CronList | 자동 허용 | 예약된 작업 목록 보기 |
CronDelete | 승인 필요 | 예약된 작업 취소 |
키보드 단축키
현재 버전에서 사용할 수 있는 단축키 목록은 TUI 안에서 /help를 입력해 확인하세요. 전체 원본 목록은 공식 키보드 단축키 참조를 참고하세요.
일반 입력
| 단축키 | 동작 |
|---|---|
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 | Steer: 현재 입력을 실행 중인 턴에 주입 |
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
편집 전 리팩터링 계획 세우기
/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는 명확한 프로젝트 컨텍스트를 갖춘 터미널 동료처럼 다룰 때 가장 잘 작동합니다. /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로 찾아보고 설정하세요.