Kimi Code CLI 빠른 참조

Q: 이전 세션을 재개하려면 어떻게 하나요?

가장 최근 세션을 이어서 진행하려면 같은 프로젝트 디렉터리에서 `kimi --continue`를 실행하세요. 특정 세션을 선택하려면 셸에서 `kimi --session [id]`를 사용하거나 TUI 내에서 `/sessions`를 사용하세요.

Q: `--yolo`는 안전한가요?

`--yolo`는 일반 도구 호출의 승인을 건너뜁니다. 신뢰할 수 있고 버전 관리되는 작업 공간에서만 사용하세요. 익숙하지 않은 리포지토리나 프로덕션 데이터에서는 승인을 유지하세요.

명령어, 슬래시 명령어, 키보드 단축키, 내장 도구, Plan Mode, Skills, MCP 및 일상적인 개발자 워크플로를 다루는 Kimi Code CLI 치트 시트 및 빠른 참조 가이드입니다.

Kimi Code 받기

8분 읽기업데이트: 2026-09-15

Kimi Code CLI는 Moonshot AI의 오픈 소스 터미널 AI 코딩 에이전트입니다. 코드를 읽고 수정하며, 셸 명령을 실행하고, 피드백을 바탕으로 다음 단계를 계획합니다. 이 빠른 참조 가이드에는 개발자가 가장 자주 사용하는 Kimi Code 명령, 슬래시 명령, 키보드 단축키, 내장 도구, 일상적인 워크플로를 모았습니다. 터미널 옆에 열어 두고, Kimi Code에서는 /help, 셸에서는 kimi --help를 사용해 현재 버전에서 제공하는 기능을 확인하세요.

Install

Install with the official script. No Node.js required.

macOS / LinuxScript installcurl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows PowerShellNo Node.js requiredirm https://code.kimi.com/kimi-code/install.ps1 | iex

npm@moonshot-ai/kimi-codenpm install -g @moonshot-ai/kimi-code

pnpmAlternative package managerpnpm add -g @moonshot-ai/kimi-code

Fast Start

kimi in a repo. Use /init once, /plan for risky work, and /compact when context gets long.

Trust Rule

--yolo is for trusted workspaces only. Keep approvals on when touching unfamiliar code or production data.

CLI Command

Open or resume

kimiOpen in current repo.

--continueResume latest session here.

--session <id>Resume a specific session.

Automation

-p "..."Run one prompt.

--output-format stream-jsonEmit JSONL events.

--model <model>Select model.

Modes

--planStart in Plan Mode.

--yoloAuto-approve routine actions.

--autoAuto-handle approvals.

--skills-dir <dir>Load custom Skills.

Subcommands

export / migrate / upgradeBundle, migrate, update.

webLocal web UI + API server.

Background Tasks

/tasksOpen background task list.

TaskListList running tasks.

TaskOutputView task output.

TaskStopStop a running task.

CronCreateSchedule prompt.

WaitForWait for background tasks.

Slash Commands

Session

/newStart fresh.

/clearAlias for new.

/sessionsResume past work.

/resumeAlias for sessions.

/forkFork current session.

/compactCompress context.

/titleRename session.

/undoWithdraw last prompt.

Status

/helpShow commands.

/h / /?Help aliases.

/usageTokens and quota.

/statusVersion, model, dir, mode.

/versionCLI version.

/btwSide Agent chat.

/exitQuit.

Account & Config

Account

/loginOAuth via kimi.ai / kimi.com.

/logoutClear credentials.

/providerAdd or remove providers.

Preferences

/modelSwitch model.

/settingsOpen settings.

/effortThinking effort level.

/experimentsExperimental features.

/secondary-modelSubagent model pool.

/editorExternal editor.

Session & Plan

Context

/initGenerate or refresh AGENTS.md.

/compactCompress conversation context.

/export-mdExport session as Markdown.

/exportExport alias.

/export-debug-zipCreate debug ZIP.

Plan Mode

ShiftTabToggle Plan Mode.

/plan onEnter Plan Mode.

/plan offExit Plan Mode.

EnterPlanModeTool enters plan.

ExitPlanModeTool exits after approval.

Modes

/yolo / /yesAuto-approve routine calls.

/towerMulti-agent worktree orchestration (enable in /experiments).

/swarm on|offToggle swarm mode.

/goal [...]Goal mode.

Use Plan Mode for broad, risky, or unclear tasks.

Skills & Extensions

/skill:nameRun an installed Skill.

/nameShortcut when no conflict.

/mcpCheck MCP status.

/mcp-configConfigure MCP servers.

/custom-themeEdit TUI theme.

/update-configEdit config files.

/import-from-cc-codexImport settings.

One prompt can activate multiple Skills.

/pluginsManage plugins.

Built-In Tools

Files & search

ReadRead text files.

WriteCreate or overwrite files.

EditReplace exact content.

GrepSearch file contents.

GlobFind files by pattern.

Runtime & agentic work

BashRun shell commands.

WebSearchSearch web when available.

FetchURLFetch page content.

ReadMediaFileRead image/video files.

TodoListManage visible todos.

AgentSpawn a subagent.

AgentSwarmRun many subagents.

AskUserQuestionAsk structured choices.

Keyboard

Input

EnterSubmit prompt.

ShiftEnter / CtrlJNew line.

CtrlGEdit in external editor.

CtrlVPaste image/video.

AltVPaste on Windows.

Ctrl-Undo input edit.

While running

CtrlSSteer running response.

EscStop or cancel.

CtrlCInterrupt or clear input.

CtrlDExit when input is empty.

CtrlOExpand tool output.

CtrlBShell to background task.

↑ / ↓Move between options.

Ctrl+EExpand diff in approval.

치트 시트 다운로드

자세한 내용은 공식 kimi 명령, 슬래시 명령, 내장 도구, 키보드 단축키 참조 문서를 확인하세요.

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

Kimi Code 받기

여기서 시작하기

프로젝트에 처음 들어갈 때는 다음의 최소 작업 흐름을 따르세요:

cd your-project kimi # 세션 내에서 /login # 처음 실행하는 경우 로그인 /init # AGENTS.md 생성 또는 업데이트 /plan on # 범위가 넓거나 위험하거나 불분명한 작업 전 계획 수립 /help # 명령어 및 단축키 확인 /compact # 대화가 길어질 때 컨텍스트 확보

신뢰할 수 있는 워크스페이스에서만 --yolo, /yolo, /auto를 사용하세요. 승인 절차는 줄어들지만 Kimi Code가 더 자율적으로 작업할 수 있게 됩니다.

자주 사용하는 명령

몇 가지만 외운다면 다음 명령을 익히세요. 대부분의 일상적인 세션을 처리할 수 있습니다.

명령어	기능
`kimi`	현재 디렉터리에서 대화형 세션 시작
`kimi -C`	이 위치에서 가장 최근 세션 이어가기
`kimi -p "..."`	TUI를 열지 않고 단일 프롬프트 실행
`/login`	처음 실행할 때 로그인
`/init`	`AGENTS.md` 생성 또는 새로 고침
`/plan on`	범위가 넓거나 위험성이 있는 변경 작업에 대해 계획 모드 시작
`/model`	현재 세션의 모델 전환
`/compact`	대화가 길어졌을 때 컨텍스트 확보
`/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를 열지 않고 단일 비대화형 프롬프트 실행
`--output-format stream-json`	스크립팅을 위해 JSONL 이벤트를 출력합니다. `--prompt`에서만 작동합니다
`kimi --model <model>`, `kimi -m <model>`	특정 모델 별칭으로 시작
`kimi --plan`	계획 모드에서 새 세션 시작
`kimi --yolo`, `kimi -y`	일반 도구 호출을 자동 승인합니다. 신뢰할 수 있는 디렉터리에서만 사용하세요.
`kimi --auto`	자동 권한 모드로 시작합니다. 승인은 자동으로 처리되며 에이전트는 질문하지 않습니다.
`--skills-dir <dir>`	지정한 디렉터리에서 Skills를 불러오며, 이번 실행에서는 자동으로 검색된 사용자 및 프로젝트 스킬 디렉터리를 대체합니다

비대화형 예시

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 doctor`	`config.toml` 및 `tui.toml`의 유효성을 검사합니다.
`kimi export [sessionId]`	세션을 ZIP 아카이브로 패키징합니다.
`kimi rc`	Remote Control을 통해 Web UI를 엽니다(별칭: `kimi remote`).
`kimi session list`	스크립트용 세션 목록을 표시합니다.
`kimi upgrade`	최신 버전을 확인하고 업데이트 옵션을 표시합니다.
`kimi web`	로컬 Web UI 및 REST/WebSocket API 서비스를 실행합니다.

Web UI 및 원격 액세스:

kimi web # 로컬 Web UI + REST/WebSocket API 서비스 실행 kimi rc # Remote Control을 통해 Web UI 열기(별칭: kimi remote) kimi session list # 스크립트용 세션 목록 표시

슬래시 명령

슬래시 명령은 내장 TUI 제어 기능입니다. 입력 상자에 /를 입력하면 명령 자동 완성이 열리며 별칭도 인식됩니다. /로 시작하는 입력이 내장 명령이나 스킬 명령과 일치하지 않으면 일반 메시지로 에이전트에 전송됩니다.

계정 및 구성

명령	별칭	용도
`/login`	—	kimi.ai / kimi.com OAuth 또는 API 키로 로그인
`/logout`	—	현재 계정의 자격 증명 삭제
`/provider`	—	프로바이더 관리자를 열어 구성된 프로바이더를 확인, 추가 및 제거
`/model`	—	현재 세션에서 사용할 LLM 모델 전환
`/effort`	—	사고 강도 전환(끔/낮음/높음/최대)
`/secondary-model`	—	서브에이전트 모델 풀 구성
`/settings`	`/config`	TUI 내에서 설정 패널 열기
`/experiments`	`/experimental`	실험적 기능 패널 열기
`/permission`	—	권한 모드 선택
`/editor`	—	`Ctrl-G`로 실행할 외부 편집기 구성
`/theme`	—	터미널 UI 색상 테마 전환
`/remote-control`	`/rc`	로컬 웹 세션에 원격으로 접속

세션 관리

명령어	별칭	용도
`/new`	`/clear`	현재 컨텍스트를 버리고 새 세션 시작
`/sessions`	`/resume`	이전 세션을 찾아보고 하나로 전환하기
`/tasks`	`/task`	백그라운드 작업 목록 찾아보기
`/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`	`/yes`	필요 시 확인 모드로 전환: 일반 작업은 자동으로 실행하고, 위험한 작업은 계속 확인
`/auto`	—	확인 안 함 모드로 전환: 모든 작업을 자동으로 실행
`/plan [on\\|off]`	—	계획 모드를 켜거나 끕니다. 단순 전환만으로는 빈 계획 파일이 생성되지 않습니다.
`/plan clear`	—	현재 계획 지우기
`/tower`	—	멀티 에이전트 worktree 오케스트레이션(실험 기능, `/experiments`에서 활성화)
`/swarm on\\|off`	—	프롬프트를 보내지 않고 swarm 모드를 켜거나 끕니다.
`/swarm <task>`	—	swarm 모드를 켜고 작업을 프롬프트로 보낸 뒤, 일반 턴이 끝나면 swarm 모드를 끕니다.
`/goal [...]`	—	자율 목표 시작 또는 관리

계획 모드는 범위가 넓거나 위험하거나 불분명한 작업을 위한 모드입니다. 파일을 변경하기 전에 탐색과 계획 수립을 우선합니다.

계획을 검토하지 않고 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]`	—	분기된 하위 에이전트에서 사이드 대화 열기
`/usage`	—	token 사용량, 컨텍스트 소모량 및 할당량 정보 표시
`/status`	—	버전, 모델, 작업 디렉터리, 권한 모드 등 런타임 상태 표시
`/mcp`	—	MCP 서버 및 연결 상태 나열
`/plugins`	—	플러그인 관리자 열기
`/version`	—	Kimi Code CLI 버전 표시
`/feedback`	—	제품 피드백 제출
`/exit`	`/quit`, `/q`	Kimi Code CLI 종료

스킬 및 확장 기능

하나의 프롬프트로 여러 스킬을 활성화할 수 있습니다.

명령어	용도
`/mcp-config`	MCP 서버를 구성하고 MCP OAuth 로그인을 처리
`/custom-theme [...]`	사용자 지정 TUI 색상 테마 생성 또는 편집
`/update-config`	`config.toml` 및 `tui.toml` 검사 또는 편집
`/import-from-cc-codex`	Claude Code 및 Codex 지침, Skills, MCP 설정 가져오기
`/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`	자동 허용	계획 모드 시작
`ExitPlanMode`	자동 허용, 사용자가 계획 확인	계획 모드를 종료하고 계획 제출
`TodoList`	자동 허용	표시되는 작업 할 일 목록 관리
`Agent`	자동 허용	집중이 필요한 하위 작업을 위한 하위 에이전트 생성
`AgentSwarm`	swarm 모드에서는 자동 허용, 그 외에는 승인이 필요할 수 있음	항목 기반 하위 에이전트를 시작하거나 기존 하위 에이전트 재개
`AskUserQuestion`	자동 허용	구조화된 객관식 질문 제시
`Skill`	자동 허용	등록된 인라인 Skill 호출

백그라운드 및 예약 작업

도구	기본 승인 설정	용도
`TaskList`	자동 허용	백그라운드 작업 나열
`TaskOutput`	자동 허용	백그라운드 작업의 출력 보기
`WaitFor`	자동 허용	현재 턴에서 백그라운드 작업 대기
`TaskStop`	승인 필요	실행 중인 백그라운드 작업 중지
`CronCreate`	승인 필요	향후 실행할 프롬프트 예약
`CronList`	자동 허용	예약된 작업 목록 보기
`CronDelete`	승인 필요	예약된 작업 취소

키보드 단축키

현재 버전에서 사용할 수 있는 단축키 목록은 TUI에서 /help를 입력해 확인하세요. 전체 최신 목록은 공식 키보드 단축키 참고 자료를 참조하세요.

일반 입력

단축키	동작
`Enter`	현재 입력 제출
`Shift-Enter` / `Ctrl-J`	줄바꿈 삽입
`↑` / `↓`	입력 기록 탐색
`Esc`	팝업을 닫거나, 완성을 취소하거나, 스트리밍 / 컴팩션 중단
`Ctrl-C`	스트리밍 출력을 중단하거나 입력 상자 지우기
`Ctrl-D`	입력 상자가 비어 있으면 종료

모드 전환 및 편집

단축키	작업
`Shift-Tab`	계획 모드 전환
`Ctrl-G`	외부 편집기에서 현재 입력 편집
`Ctrl-V`	Unix / macOS에서 클립보드의 이미지 또는 동영상 붙여넣기
`Alt-V`	Windows에서 클립보드의 이미지 또는 동영상 붙여넣기
`Ctrl--`	입력 편집 실행 취소

스트리밍 및 도구 출력 중

단축키	작업
`Ctrl-S`	조종: 현재 입력을 실행 중인 턴에 삽입
`Esc`	현재 스트리밍 출력 중단
`Ctrl-C`	현재 스트리밍 출력 중단
`Ctrl-O`	도구 출력 펼치기 또는 접기
`Ctrl-B`	실행 중인 셸 명령을 백그라운드 작업으로 이동

승인 패널

단축키	작업
`↑` / `↓`	승인 옵션 간 이동
`Enter`	선택한 승인 옵션 확인
`1` – `9`	숫자로 승인 옵션 선택
`Esc` / `Ctrl-C` / `Ctrl-D`	현재 승인 요청 거부
`Ctrl-E`	검토 중인 diff 또는 파일 미리보기 펼치기/접기

팝업 및 도움말

단축키	동작
`PageUp` / `PageDown`	팝업을 한 번에 10줄씩 스크롤
`q` / `Q`	팝업 닫기
`Enter`	도움말 팝업 닫기

일반적인 워크플로

새 리포지토리 시작하기

cd your-project kimi /init /status

편집 전에 리팩터링 계획 세우기

/plan on 새 token 형식을 사용하도록 인증 모듈을 리팩터링하고 모든 호출부를 업데이트하세요.

백그라운드 작업 실행하기

테스트 스위트를 실행하고 완료되면 알려주세요.

그런 다음 /tasks를 열어 백그라운드 작업을 모니터링하거나, 작업이 완료되면 Kimi Code가 알려 주도록 하세요.

어제 하던 작업 이어 하기

kimi --continue

특정 세션이 필요하면 kimi --session을 실행하거나 TUI에서 /sessions를 사용하세요.

세션 내보내기 또는 디버깅

/export-md /export-debug-zip kimi export -y

마무리

Kimi Code CLI는 명시적인 프로젝트 맥락을 제공하고 터미널에서 함께 작업하는 동료처럼 활용할 때 가장 효과적입니다. /init으로 시작하고, 규모가 크거나 불확실한 변경에는 /plan을 사용하세요. 장시간 실행되는 작업은 /tasks로 확인하고, 긴 세션에서는 /compact를 가까이 두며, 리포지토리의 신뢰 수준에 맞는 권한 모드를 선택하세요.

Kimi Code 받기

자주 묻는 질문

Kimi Code CLI는 무료로 설치할 수 있나요?

예. Kimi Code CLI는 오픈 소스이며 무료로 설치할 수 있습니다. 기본 모델 또는 서비스에 대한 액세스는 Kimi Code 요금제에 따라 달라질 수 있습니다. 자세한 내용은 Kimi Code 요금을 참조하세요.

이 페이지는 왜 치트 시트가 아니라 빠른 참조라고 하나요?

빠른 참조는 더 공식적이고 문서형에 가까운 명칭입니다. 이 페이지는 여전히 복사해 붙여넣을 수 있는 명령어, 슬래시 명령어, 단축키, 도구, 워크플로를 한곳에 모아 둔 동일한 치트 시트 용도를 다룹니다.

Kimi Code CLI를 설치하려면 Node.js가 필요한가요?

공식 설치 스크립트에는 Node.js가 필요하지 않습니다. npm 및 pnpm 설치 방식은 JavaScript 패키지 관리자를 사용하므로 Node.js 환경이 필요합니다.

`/plan`과 일반 모드의 차이는 무엇인가요?

일반 모드에서는 에이전트가 직접 작업합니다. 플랜 모드는 범위가 넓거나 위험하거나 불명확한 작업을 위한 모드입니다. Kimi Code가 먼저 살펴본 뒤 계획을 작성하고, 계획이 승인되면 종료합니다.

이전 세션을 재개하려면 어떻게 하나요?

가장 최근 세션을 이어서 진행하려면 같은 프로젝트 디렉터리에서 kimi --continue를 실행하세요. 특정 세션을 선택하려면 셸에서 kimi --session [id]를 사용하거나 TUI 내에서 /sessions를 사용하세요.

`--yolo`는 안전한가요?

--yolo는 일반 도구 호출의 승인을 건너뜁니다. 신뢰할 수 있고 버전 관리되는 작업 공간에서만 사용하세요. 익숙하지 않은 리포지토리나 프로덕션 데이터에서는 승인을 유지하세요.

스킬과 MCP는 Kimi Code에서 어떤 역할을 하나요?

스킬은 재사용 가능한 워크플로를 패키징하며 슬래시 명령으로 표시될 수 있습니다. MCP는 Kimi Code를 외부 도구 및 데이터 소스에 연결합니다. /skill:name, /mcp, /mcp-config를 사용해 스킬과 MCP를 찾아 구성하세요.