開始使用

本頁保留快速開始與基礎操作；更多功能和最新變更，請參閱 Kimi Code 團隊維護的完整文件。

Kimi Code CLI 是什麼

Kimi Code CLI 是一個執行在終端中的 AI Agent，幫助你完成軟體開發任務和日常的終端操作——閱讀和修改程式碼、執行 Shell 命令、搜尋檔案、抓取網頁，並在執行過程中根據反饋自主規劃和調整下一步行動。

它適用於以下場景：

• 編寫和修改程式碼：實現新功能、修復 bug、完成重構
• 理解專案：探索陌生的程式碼庫，解答架構和實現層面的問題
• 自動化任務：批次處理檔案、執行構建與測試、串聯多個指令碼

整套 CLI 以 TypeScript 編寫，透過 npm 分發，執行在 Node.js 之上。

安裝

提供兩種安裝方式：官方安裝指令碼（推薦，無需預裝 Node.js）和 npm 全域性安裝。

指令碼安裝（推薦）

Bash

Powershell

Windows 使用者首次啟動前還需要安裝 Git for Windows，Kimi Code CLI 會使用其中的 Git Bash 作為 Shell 環境。如果 Git Bash 安裝在非標準路徑，請把 KIMI_SHELL_PATH 設為 bash.exe 的絕對路徑。

指令碼會自動下載最新版本、校驗 checksum，並把 kimi 可執行檔案放到你的 PATH 中。

npm 安裝

需要 Node.js 22.19.0 或更高版本：

Bash

Bash

Bash

第一次啟動

進入專案目錄後直接執行 kimi 啟動互動介面：

Bash

只想執行一條指令而不進入互動介面時，使用 -p：

Bash

繼續上一次會話加 -c：

Bash

首次啟動時需要配置 API 來源。在互動介面中輸入 /login 進入登入流程：

Text

/login 會彈出平臺選擇器，支援兩種方式：

• Kimi Code（OAuth） — 驗證碼流程，在任意裝置開啟連結、登入並輸入驗證碼即可授權
• Kimi Platform API 金鑰 — 輸入來自 platform.kimi.com 或 platform.kimi.ai 的 API 金鑰

需要退出登入時，輸入 /logout 清除當前憑證。

第一個對話

登入完成後，用自然語言描述任務即可。先讓它熟悉當前專案：

Text

Kimi Code CLI 會自動呼叫檔案讀取、搜尋等工具瀏覽相關內容後給出回答。只讀操作預設自動執行無需確認；對於會修改檔案或執行 Shell 命令的操作，預設會在執行前徵求確認。

也可以直接描述更具體的任務：

Text

Kimi Code CLI 會規劃步驟、修改程式碼、執行測試，並在每一步告訴你它做了什麼。

常用命令與快捷鍵速查

第一次使用時，記住下面這些就夠了：

會話相關命令

最常用快捷鍵

想看完整列表，輸入 /help 或訪問斜槓命令參考和鍵盤快捷鍵。

更多操作

互動與基礎操作。升級、解除安裝、資料路徑和故障排查請檢視維護方完整指南。