Kimi Code CLI 是 Moonshot AI 的開源終端機 AI 程式設計 Agent，可讀取及編輯程式碼、執行 shell 指令，並根據你的回饋規劃下一步。這份快速參考彙整了開發人員最常使用的 Kimi Code 指令、斜線指令、鍵盤快速鍵、內建工具及日常工作流程。請在終端機旁隨時開啟本頁，並在 Kimi Code 中使用 /help，或在 shell 中使用 kimi --help，查看目前版本提供的功能。
對大多數開發人員而言，官方安裝指令碼是最快的方式：它會安裝單一 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 作為 shell 環境。安裝後，開啟新的終端機並確認二進位檔：
第一次進入專案時，請採用以下最基本的流程：
僅在你信任的工作區中使用 --yolo、/yolo 和 /auto。這些選項可減少核准流程的阻礙，但也會讓 Kimi Code 擁有更高的自主性。
如果只記得幾個指令，請記住這些——它們涵蓋大多數日常工作階段。
| 指令 | 功能說明 |
|---|---|
kimi | 在目前目錄啟動互動式工作階段 |
kimi -C | 在此繼續最近一次工作階段 |
kimi -p "..." | 不開啟 TUI，直接執行單一提示詞 |
/login | 首次啟動時登入 |
/init | 產生或更新 AGENTS.md |
/plan on | 針對範圍廣或風險高的變更進入 Plan Mode |
/model | 切換此工作階段使用的模型 |
/compact | 對話過長時釋放 context |
/sessions | 瀏覽並繼續先前的工作階段 |
/help | 列出所有指令與快速鍵 |
Shift-Tab | 切換 Plan Mode |
| 指令／旗標 | 功能 |
|---|---|
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 login | 不進入 TUI，啟動 Kimi Code OAuth 裝置代碼登入 |
kimi acp | 將 Kimi Code 作為 Agent Client Protocol 伺服器執行，以整合 IDE |
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 與遠端存取：
斜線指令是內建的 TUI 控制項。在輸入框中鍵入 / 可開啟指令自動完成，別名也會比對。若以 / 開頭的輸入不符合內建指令或 Skill 指令，則會以一般訊息傳送給 Agent。
| 指令 | 別名 | 用途 |
|---|---|---|
/login | — | 透過 kimi.ai / kimi.com OAuth 或 API 金鑰登入 |
/logout | — | 清除目前帳戶的憑證 |
/provider | — | 開啟供應商管理工具，以檢視、新增及移除已設定的供應商 |
/model | — | 切換目前工作階段使用的 LLM 模型 |
/effort | — | 切換思考投入程度（關閉／低／高／最高） |
/secondary-model | — | 設定子 agent 模型集區 |
/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 | — | 多 Agent worktree 編排（實驗功能；請在 /experiments 啟用） |
/swarm on\|off | — | 無需傳送提示詞即可開啟或關閉 swarm 模式 |
/swarm <task> | — | 開啟 swarm 模式，將任務作為提示詞傳送，並在一般回合結束後關閉 swarm 模式 |
/goal [...] | — | 啟動或管理自主目標 |
Plan Mode 適合範圍廣、風險高或需求不明確的工作。在變更檔案前，它會優先進行探索與規劃。
/plan on，讓 Kimi Code 檢查專案、審閱提出的計畫，並在進行變更前核准。Goal mode 子指令包括 /goal status、/goal pause、/goal resume、/goal cancel、/goal replace <objective>、/goal next <objective> 和 /goal next manage。
| 指令 | 別名 | 用途 |
|---|---|---|
/help | /h, /? | 顯示鍵盤快速鍵與可用指令 |
/btw [question] | — | 在分支子 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 的指示、Skill 與 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 | 需要核准 | 執行 shell 命令 |
WebSearch | 自動允許 | 可用時搜尋網路 |
FetchURL | 自動允許 | 擷取指定 URL 的內容 |
| 工具 | 預設核准方式 | 用途 |
|---|---|---|
EnterPlanMode | 自動允許 | 進入規劃模式 |
ExitPlanMode | 自動允許；由使用者確認計畫 | 退出規劃模式並提交計畫 |
TodoList | 自動允許 | 管理可見的任務待辦清單 |
Agent | 自動允許 | 為聚焦的子任務建立子 Agent |
AgentSwarm | 在 swarm 模式下自動允許；否則可能需要核准 | 啟動以項目為單位的子 agent，或繼續執行既有子 agent |
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 | 將正在執行的 shell 指令移至背景工作 |
| 快速鍵 | 動作 |
|---|---|
↑ / ↓ | 在核准選項之間移動 |
Enter | 確認選取的核准選項 |
1 – 9 | 以數字選取核准選項 |
Esc / Ctrl-C / Ctrl-D | 拒絕目前的核准請求 |
Ctrl-E | 展開或收合正在審查的 diff 或檔案預覽 |
| 快速鍵 | 動作 |
|---|---|
PageUp / PageDown | 每次捲動彈出視窗 10 行 |
q / Q | 關閉彈出視窗 |
Enter | 關閉說明彈出視窗 |
接著開啟 /tasks 監控背景工作，或讓 Kimi Code 在任務完成時通知你。
若需要指定工作階段，請執行 kimi --session，或在 TUI 中使用 /sessions。
將 Kimi Code CLI 視為擁有明確專案脈絡的終端機協作夥伴時，最能發揮效用。請從 /init 開始；面對大型或不確定的變更時使用 /plan；透過 /tasks 追蹤長時間執行的工作；在長工作階段中隨時使用 /compact；並選擇符合儲存庫信任程度的權限模式。
kimi --continue，即可繼續最近一次的工作階段。若要選擇特定工作階段，請在 shell 中使用 kimi --session [id]，或在 TUI 內使用 /sessions。--yolo 會略過一般工具呼叫的核准程序。僅應在可信任且受版本控制的工作區中使用。對於不熟悉的儲存庫或正式環境資料，請保留核准機制。/skill:name、/mcp 和 /mcp-config 探索並設定它們。