將 Kimi K3.1 Pro 導入 Kimi Code CLI：安裝、登入與 Windows 陷阱

Kimi Code CLI 是 Moonshot 的終端機程式設計代理，也是 Kimi K3.1 Pro 並非第三方整合、而是預設選項的唯一用戶端。設定流程比 Claude Code 或 Codex 路徑更短——一個安裝指令碼、一次 /login、一個平台選擇——因為用戶端與模型來自同一家公司。問題在於平台差異：在 Windows 上，CLI 會在其內建的 Git Bash 中執行；若該殼層不在安裝程式預期的位置，工具會啟動，然後以看起來像模型錯誤的方式失敗。

這是可行的流程，已於 2026 年 10 月 24 日對照 Moonshot 的文件核對過，並在失敗模式實際發生處標註出來。

安裝

macOS 與 Linux 只需一行：curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash。Windows PowerShell 同樣只需一行：irm https://code.kimi.com/kimi-code/install.ps1 | iex。此腳本會下載最新版本、驗證其校驗碼，並將 kimi 可執行檔放到你的 PATH 中。不需要 Node.js 或 Python 執行環境。

Windows 有一個容易忽略的先決條件：請先安裝 Git for Windows。Kimi Code CLI 會使用隨附的 Git Bash 作為其殼層環境。如果 Git Bash 位於非標準位置，請在啟動前將 KIMI_SHELL_PATH 環境變數設為 bash.exe 的絕對路徑——否則代理程式雖會啟動，但它嘗試執行的每個殼層命令都會失敗。

使用 API 金鑰登入

在您要作業的專案目錄中啟動 CLI：

• 執行 kimi 以開啟互動式介面。

• 輸入 /login。Kimi Code CLI 會開啟平台選擇器。

• 選擇 Kimi Platform（API key · platform.kimi.ai）。這是針對在開放平台上建立的 API 金鑰所適用的選項；其他選項則對應不同的帳戶介面。

• 貼上金鑰。若你還沒有金鑰，請在 platform.kimi.ai 的 API Keys 下建立一個。CLI 會將它儲存在本機，因此請將設定目錄視為憑證存放區。

這就是全部的關聯。CLI 內的模型選擇器會列出目前的 Kimi 模型，而 Kimi K3.1 Pro 及其高速版本是對代理式工作最重要的兩個。

切換現有設定，並更換金鑰

兩種遷移很常見，而且兩者都會經過同一個畫面。如果 Kimi Code CLI 已經透過訂閱而非 API 金鑰登入，執行 /login 並選擇 API 金鑰平台，就能在不重新安裝的情況下切換。如果你正在輪換金鑰——因為它外洩了，或因為某個專案需要自己的帳單——同樣的流程會取代已儲存的憑證。

唯一不要做的事，就是在 CLI 執行期間手動編輯已儲存的設定；該程序會在啟動時讀取憑證，而工作階段進行中的編輯會在結束時被覆寫。

代理程式實際上做了什麼

Kimi Code CLI 並不是終端機裡的聊天視窗。它會讀取並編輯程式碼、搜尋儲存庫、執行命令並讀取結果，而且當任務需要專案以外的內容時，還能引入網頁內容或進行搜尋。Moonshot 將其描述為一種在你自己的機器上執行、由模型負責規劃的程式設計代理——形態與 Claude Code 或 Codex 相同，對權限的意涵也相同：能執行 shell 命令的代理，應該在你願意讓它修改的目錄中啟動，並且在任何內容被推送之前先經過審查。

這個用戶端同時採用兩種計費模式。Kimi Code 應用程式以訂閱制搭配方案層級販售，而 CLI 則可使用該訂閱，或使用來自開放平台的 API 金鑰。API 金鑰途徑提供的是按 token 計價的經濟效益——K3.1 Pro 每百萬 token 為 $2.00 與 $10.00，高速版本則為 $4.00 與 $20.00——而訂閱則是附有配額的固定費用。對於已在其他地方支付 API 用量的團隊來說，金鑰途徑可讓支出集中在同一處；對於整天寫程式的個人而言，訂閱通常較便宜，而且不論哪種方式，CLI 都是同一個下載。

選擇模型與投入程度

Kimi K3.1 Pro 一定會進行推理，而推理強度由頂層欄位設定，接受 low、high 與 max，預設為 max。Kimi Code CLI 會公開此模型；推理強度的預設值是最昂貴的那個，因此感覺緩慢的工作階段通常是以 max 執行的工作階段，而非連線故障。高速版本以較高價格換取較低延遲——每百萬 token 為 $4.00 與 $20.00，而非 $2.00 與 $10.00——對於模型反正都在等待人類的互動式工作而言，是合理的預設選擇。

任何用戶端使用這個模型時，都會受到兩項限制：取樣參數是固定的（temperature 1.0、top-p 0.95、n 固定為 1），而且在對話進行到一半時更改 effort 會讓前綴快取的命中失效。請在工作階段開始時就先決定好等級。

這條路線與 Claude Code 和 Codex 相比如何？

這三個用戶端使用三種不同協定來存取同一個模型，而選擇主要取決於你的團隊已經習慣哪種介面。Kimi Code CLI 的設定最少：沒有環境區塊、沒有 TOML 檔案，而且供應商同時維護兩端。Claude Code 需要 Anthropic 相容端點，並正確設定四個模型層級變數；Codex 則需要包含 wire_api = "responses" 的 provider 區塊，但兩者之後都能對接任何支援這些協定的供應商——包括同時提供其他廠商模型的閘道。

實務上的區分方式：當 Kimi 是你唯一需要的模型，而且你想走最短路徑時，就用 Kimi Code CLI；當同一個工作階段必須在不同廠商之間切換，或是你團隊的工具、權限與技能已經建立在 Claude Code 或 Codex 這些用戶端時，就用它們。

節省時間的疑難排解順序

• CLI 能啟動，但沒有任何 shell 指令執行——先檢查 Git Bash 和 KIMI_SHELL_PATH，先別急著怪模型。

• 原本運作正常的設定後來出現驗證錯誤 — 請重新執行 /login，並確認平台選項與金鑰建立的位置相符；不同介面建立的金鑰無法互換。

• 覺得工作階段很慢 — 在更換模型之前先檢查 effort 預設值；max 無論在延遲還是 token 上都很傷。

• 更新後出現找不到模型的情況——CLI 會列出平台所供應的項目；若 K3.1 Pro 不在其中，就表示用戶端所指向的介面尚未更新。

平台上，Kimi K3.1 Pro 的價格為每百萬輸入 token 2.00 美元、每百萬輸出 token 10.00 美元，具備 1M token 的上下文，且最多可輸出 943,718 個 token。如果你比較想透過其他工具已在使用的 API 存取它，OrcaRouter 以供應商定價提供相同模型 kimi/kimi-k3.1-pro，不額外加價——該路由的設定說明收錄在 Claude Code 與 Codex 指南中。