Kimi Code怎麼用：CLI安裝、登入、常用命令與額度規則

適用於誰

• 搜「kimi code」「kimi code cli」「kimi code 官網」「kimi code 額度」的開發者；
• 已經是 Kimi 會員，想把額度用在寫代碼上的人；
• 安裝或登入時遇到「No models available」等報錯的人。

本文根據 Kimi Code 官方文檔整理，資料核對於 2026-10-11。命令均來自官方文檔，執行前建議對照官方頁面確認沒有變化。

結論先說

1. Kimi Code 是 Kimi 會員權益裏面向開發者的編程服務，有三種官方形態：桌面端（Desktop）、終端工具（CLI）和 VS Code 擴展；會員還可以創建 API Key，把模型接到 Claude Code、OpenCode、Codex 等第三方工具裏。
2. CLI 一條命令安裝，腳本安裝不需要預裝 Node.js；Windows 需要先裝 Git for Windows。
3. 登入有兩種：用 Kimi 帳號走 OAuth（消耗會員額度），或填 Kimi 開放平台的 API Key（按量計費）。兩套 Key 和接口地址不通用。
4. 改文件和執行命令前預設會問你，只讀操作自動執行。
5. 額度是共享的：CLI、VS Code、桌面端和第三方工具的請求計入同一套配額，另有 5 小時滾動窗口限流和月總額度。

步驟

1. 確認環境

• Windows：先安裝 Git for Windows，CLI 要用其中的 Git Bash。Git Bash 不在標準路徑時，把環境變量 KIMI_SHELL_PATH 設為 bash.exe 的絕對路徑；
• Node.js：只有用 npm 或 pnpm 安裝時才需要，要求 22.19.0 或更高版本（node --version 查看）；
• 終端：CLI 是全交互式介面，官方建議用支持真彩色的現代終端。

2. 安裝

腳本安裝（官方推薦）

macOS / Linux：

sh
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows（PowerShell）：

powershell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

用 npm 或 pnpm 安裝

sh
npm install -g @moonshot-ai/kimi-code
# 或
pnpm add -g @moonshot-ai/kimi-code

裝完運行 kimi --version，能顯示版本號就是成功了。

3. 啟動並登入

sh
cd your-project
kimi

在交互介面裏輸入 /login，從平台選擇器裏選一種：

• Kimi Code（OAuth）：按提示在任意裝置上打開連結、登入 Kimi 帳號並輸入驗證碼完成授權。用的是會員裏的 Kimi Code 額度；
• Kimi Platform API 密鑰：填入在 platform.kimi.com（國內）或 platform.kimi.ai（海外）創建的 Key，按開放平台的價格按量計費。

退出登入用 /logout。想接入其他廠商的模型，官方說明可以編輯 ~/.kimi-code/config.toml 配置。

4. 交辦第一個任務

直接用自然語言說要做什麼：

介紹一下這個項目的目錄結構，重點說明入口文件和數據庫相關的代碼在哪裏。

在 src/utils 裏新增一個把日期格式化成「2026-10-11 週日」的函數，並補充單元測試。

CLI 會自己讀取和搜尋相關文件，並在過程中說明每一步在做什麼。只讀操作預設自動執行；修改文件或運行 Shell 命令前，預設會先徵求你的確認——認真看一眼它要改什麼、要跑什麼命令再批准，尤其是刪除、安裝依賴、數據庫相關的命令。

不想進交互介面，只執行一條指令：

sh
kimi -p "檢查這個倉庫裏有沒有未使用的依賴，列出來但不要刪除"

接着上一次的會話繼續：kimi -c。

5. 記住這些命令和快捷鍵

快捷鍵：Esc 中斷輸出或關閉彈窗；Shift-Tab 切換 Plan 模式（先出方案再動手）；Ctrl-S 在輸出中途插入消息；Ctrl-O 摺疊或展開工具輸出。退出也可以連按兩次 Ctrl-C，或在輸入框為空時按 Ctrl-D。

6. 選模型

官方文檔列出的模型 ID（用 /model 切換）：

不同模型對應不同的會員檔位。日常開發用消耗較低的版本，遇到大範圍重構再切到 k3。

7. 弄清額度規則

按官方「會員權益」文檔：

• 同一套配額：CLI、VS Code 擴展、桌面端和第三方工具的請求都計入同一額度，所有登入裝置和 API Key 共享；
• 5 小時滾動窗口：請求過於頻繁會觸發限流，窗口滾動後自動恢復；
• 月總額度：用完後 Kimi Code 額度凍結，等月額度重置或升級訂閱；
• 加油包：訂閱額度耗盡後可以按實際用量付費繼續用，可設定每月消費上限。官方寫明的充值規則是單次最低 25 元、每日最多 10 次，餘額不過期，一般不可退款；
• 裝置：超過 30 天不活躍的裝置會自動解綁，重新 /login 即可。

隨時用 /usage 看剩餘配額。官方文檔裏同時出現了「老套餐」和「新套餐」兩套檔位名稱，哪個檔位能用哪些模型、是否包含 1M 上下文，以官方會員權益頁面當前的表格為準。

8. 升級和卸載

• 升級：在終端運行 kimi upgrade，或 npm install -g @moonshot-ai/kimi-code@latest；
• 卸載：腳本安裝的刪除 kimi 可執行文件；npm 安裝的運行 npm uninstall -g @moonshot-ai/kimi-code。

常見問題

Q：/login 後提示「No models available for the selected platform」？

官方給的原因：API 密鑰無效或過期，或者無法訪問對應的接口地址；另外接口地址必須和密鑰所屬平台匹配。Kimi Code 國內地址是 https://api.kimi.com/coding/，開放平台國內地址是 https://api.moonshot.cn/v1，兩者的 Key 不能混用。

Q：提示會員過期或配額用盡？

用 /usage 確認狀態。限流等 5 小時窗口滾動；月額度用完則等重置、升級，或開啟加油包。

Q：粘貼圖片失敗，提示當前模型不支持圖片輸入？

換一個支持圖片輸入的模型，並確認剪貼簿裏是圖片本身而不是圖片的文件路徑。

Q：macOS 第一次運行特別慢？

官方說明是系統的 Gatekeeper 首次檢查導致，之後會恢復正常。

Q：可以把 Kimi Code 的 Key 用在別的工具裏嗎？

可以，官方文檔提供了 Claude Code、OpenCode、Codex 等工具的接入頁面，接口同時兼容 OpenAI 和 Anthropic 協議。注意官方提醒：篡改客戶端標識（User-Agent）可能導致會員權益被暫停，按官方文檔的方式配置即可。

Q：VS Code 擴展提示找不到 CLI 或未打開工作區？

先在 VS Code 裏打開一個文件夾；找不到 CLI 時手動安裝 Kimi Code CLI，並在設定裏配置 kimi.executablePath。可以通過命令「Kimi Code: Show Logs」查看錯誤日誌。

Q：它和 Claude Code 是什麼關係？

兩個獨立的產品，用法相似（終端裏的編程 Agent）。Kimi Code 用的是 Kimi 的模型和會員額度。Claude Code 的入門見《Claude Code 中文入門教學》。

參考資料

• Kimi Code 文檔：產品概覽 — https://www.kimi.com/coding/docs/
• Kimi Code CLI：開始使用 — https://www.kimi.com/coding/docs/kimi-code-cli/guides/getting-started.html
• Kimi Code：會員權益 — https://www.kimi.com/coding/docs/kimi-code/membership.html
• Kimi Code：常見問題 — https://www.kimi.com/coding/docs/kimi-code/faq.html