閱讀時長：8分鐘2026-06-18
本快速參考彙整開發者最常用的 Kimi Code 命令、斜線命令、鍵盤快速鍵、內建工具與日常工作流程。把它放在終端機旁，並在 Kimi Code 內使用 /help，或在 shell 中使用 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 作為 shell 環境。安裝後，開啟新的終端機並驗證二進位檔：
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，並在本次啟動中取代自動探索到的使用者與專案技能目錄 |
非互動範例
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 | 將 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 | 從終端機管理供應商 |
實用的伺服器命令：
kimi server run # 啟動或重用本機背景伺服器
kimi server run --foreground # 連接終端機執行
kimi server install # 註冊為作業系統管理的服務
kimi server status # 顯示已安裝 / 執行中 / pid / 連接埠狀態
kimi web # 開啟瀏覽器 UI
斜線命令
斜線命令是內建的 TUI 控制項。在輸入框輸入 / 可開啟命令自動完成；別名也會一併比對。若以 / 開頭的輸入未符合內建命令或 Skill 命令，會作為一般訊息送給 Agent。
帳號與設定
| 命令 | 別名 | 用途 |
|---|---|---|
/login | — | 選擇帳號或平台並登入 |
/logout | — | 清除目前帳號的憑證 |
/provider | — | 開啟供應商管理器，以檢視、新增及移除已設定的供應商 |
/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 | 在核准面板中展開或收合完整差異或檔案預覽內容 |
PageUp / PageDown | 每次捲動彈出視窗 10 行 |
q / Q | 關閉彈出視窗 |
常見工作流程
建立新儲存庫
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；並依儲存庫的可信程度選擇合適的權限模式。
常見問題
Kimi Code CLI 可以免費安裝嗎？
是。Kimi Code CLI 是開源的，且可免費安裝。存取底層模型或服務可能取決於你的 Kimi Code 方案。詳情請參閱 Kimi Code pricing。
為什麼這個頁面稱為快速參考，而不只是速查表？
「快速參考」是更正式、文件風格更明確的標籤。這個頁面仍涵蓋同樣的速查用途：把可複製貼上的命令、斜線命令、快速鍵、工具與工作流程集中在一處。
安裝 Kimi Code CLI 需要 Node.js 嗎？
官方安裝腳本不需要 Node.js。npm 與 pnpm 安裝方式需要 Node.js 環境，因為它們使用 JavaScript 套件管理器。
`/plan` 與一般模式有什麼不同？
一般模式會讓 Agent 直接工作。Plan Mode 適用於範圍大、風險高或不明確的工作：Kimi Code 會先探索、撰寫計畫，並在計畫核准後結束。
如何恢復先前的工作階段？
在同一個專案目錄執行
kimi --continue，即可延續最近的工作階段。若要選擇特定工作階段，可在 shell 使用 kimi --session [id]，或在 TUI 內使用 /sessions。`--yolo` 安全嗎？
--yolo 會略過一般工具呼叫的核准。只應在可信任、受版本控制的工作區中使用。對不熟悉的儲存庫或正式環境資料，請保留核准機制。Skills 與 MCP 在 Kimi Code 中扮演什麼角色？
Skills 可封裝可重用的工作流程，也能以斜線命令形式出現。MCP 會將 Kimi Code 連接到外部工具與資料來源。使用
/skill:name、/mcp 和 /mcp-config 來探索與設定它們。