閱讀時長：8分鐘2026-07-22
Kimi Code CLI 是 Moonshot AI 的開源終端機 AI coding agent——可讀取並編輯程式碼、執行 shell 指令，並根據你的回饋規劃下一步。這份快速參考彙整了開發者最常用的 Kimi Code 指令、斜線指令、鍵盤快捷鍵、內建工具與日常工作流程。把它放在終端機旁隨時查閱；也可在 Kimi Code 內使用 /help，或在 shell 中使用 kimi --help，確認目前版本提供哪些功能。
若需上游詳細資訊，請參閱官方的 kimi command、slash commands、built-in tools 與 keyboard shortcuts 參考文件。
安裝 Kimi Code CLI
對多數開發者而言，官方安裝 script 是最快的方式：它會安裝單一 Kimi Code binary，且不需要 Node.js。若更符合你的本機工具鏈，也可以使用 Homebrew、npm 或 pnpm。
| 平台 / 管理工具 | 指令 |
|---|---|
| macOS / Linux script | 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 環境。安裝後，開啟新的 terminal 並驗證 binary：
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 |
/login | 首次啟動時登入 |
/init | 產生或重新整理 AGENTS.md |
/plan on | 針對範圍大或風險高的變更進入 Plan Mode |
/model | 切換此工作階段使用的模型 |
/compact | 對話變長時釋放 context |
/sessions | 瀏覽並恢復過去的工作階段 |
/help | 列出所有指令與快捷鍵 |
Shift-Tab | 切換 Plan Mode |
啟動與自動化
核心 CLI 選項
| 指令 / Flag | 作用 |
|---|---|
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 "彙整目前 repository 狀態"
kimi -m kimi-code/kimi-for-coding -p "說明最新的 diff"
kimi -p "列出已變更的檔案" --output-format stream-json
CLI 子指令
| 子指令 | 用途 |
|---|---|
kimi login | 不進入 TUI，啟動 Kimi Code OAuth 裝置碼登入 |
kimi acp | 將 Kimi Code 作為 Agent Client Protocol 伺服器執行，以便整合 IDE |
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 | 從 terminal 管理 providers |
實用 server 指令：
kimi server run # 啟動或重用本機背景 server
kimi server run --foreground # 附著在 terminal 上執行
kimi server install # 註冊為 OS 管理的 service
kimi server status # 顯示已安裝 / 執行中 / pid / port 狀態
kimi web # 開啟瀏覽器 UI
斜線指令
斜線指令是內建的 TUI 控制項。在輸入框鍵入 / 可開啟指令補全；別名也會一併比對。若以 / 開頭的輸入未符合內建指令或 Skill 指令，會作為一般訊息傳送給 Agent。
帳號與設定
| 指令 | 別名 | 用途 |
|---|---|---|
/login | — | 選擇帳號或平台並登入 |
/logout | — | 清除目前帳號的憑證 |
/provider | — | 開啟 provider 管理器，以檢視、新增與移除已設定的 providers |
/model | — | 切換目前工作階段使用的 LLM 模型 |
/settings | /config | 在 TUI 中開啟設定面板 |
/experiments | /experimental | 開啟實驗性功能面板 |
/permission | — | 選擇權限模式 |
/editor | — | 設定由 Ctrl-G 啟動的外部編輯器 |
/theme | — | 切換終端機 UI 色彩主題 |
工作階段管理
| 指令 | 別名 | 用途 |
|---|---|---|
/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 [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 模式子指令包括 /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 的指示、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 等唯讀工具預設自動允許；寫入檔案、執行指令、停止任務或建立排程的工具通常需要核准，除非你的權限模式允許。
檔案、shell 與網頁
| 工具 | 預設核准 | 用途 |
|---|---|---|
Read | 自動允許 | 讀取文字檔 |
Write | 需要核准 | 建立或覆寫檔案 |
Edit | 需要核准 | 取代檔案中的精確內容 |
Grep | 自動允許 | 使用 ripgrep 搜尋檔案內容 |
Glob | 自動允許 | 依 glob 模式尋找檔案 |
ReadMediaFile | 自動允許 | 讀取圖片或影片檔 |
Bash | 需要核准 | 執行 shell 指令 |
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 | 引導：將目前輸入注入正在執行的回合 |
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；並依 repo 的信任程度選擇合適的權限模式。
常見問題
Kimi Code CLI 可以免費安裝嗎？
可以。Kimi Code CLI 是開源專案，可免費安裝。是否能使用底層模型或服務，可能取決於你的 Kimi Code 方案。詳情請參閱 Kimi Code pricing。
為什麼這個頁面叫快速參考，而不只叫速查表？
「快速參考」是較正式、偏文件風格的名稱。這個頁面仍涵蓋同樣的速查用途：把可複製貼上的指令、斜線指令、快捷鍵、工具與工作流程集中在一處。
安裝 Kimi Code CLI 需要 Node.js 嗎？
官方安裝 script 不需要 Node.js。npm 與 pnpm 安裝方式需要 Node.js 環境，因為它們使用 JavaScript package manager。
`/plan` 和一般模式有什麼不同？
一般模式讓 Agent 直接工作。Plan Mode 適用於範圍大、風險高或不明確的工作：Kimi Code 會先探索、寫出計畫，並在計畫核准後結束。
如何繼續先前的工作階段？
在同一個專案目錄中執行
kimi --continue，即可延續最近一次工作階段。若要選擇特定工作階段，可在 shell 使用 kimi --session [id]，或在 TUI 內使用 /sessions。`--yolo` 安全嗎？
--yolo 會略過一般工具呼叫的核准流程。只應在可信任、已納入版本控制的工作區中使用。面對不熟悉的 repository 或 production data 時，請保留核准機制。Skills 和 MCP 在 Kimi Code 中扮演什麼角色？
Skills 會封裝可重用的工作流程，也可以顯示為斜線指令。MCP 可將 Kimi Code 連接到外部工具與資料來源。使用
/skill:name、/mcp 與 /mcp-config 來探索與設定它們。