Kimi Code CLI Windows 安裝教程：登入、MCP、ACP 與舊 Kimi CLI 遷移

Moonshot AI 正在把舊版 Kimi CLI 遷移到新一代 Kimi Code CLI。新版本是終端 AI 程式設計 Agent，可讀取和修改程式碼、執行 Shell、搜尋檔案、訪問網頁，並支援 MCP、外掛、子 Agent、Hooks 和 ACP 編輯器接入。

專案地址：MoonshotAI/kimi-code

Windows 快速安裝

先安裝 Git for Windows。Kimi Code CLI 在 Windows 上使用 Git Bash 作為 Shell 環境，然後在 PowerShell 執行官方安裝指令碼：

1

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

關閉並重新開啟終端，檢查版本：

1

kimi --version

如果 Git Bash 安裝在自定義目錄，需要把 KIMI_SHELL_PATH 設定為 bash.exe 的絕對路徑。

首次登入和執行

進入專案目錄後啟動：

1
2

cd C:\Work\your-project
kimi

首次執行在互動介面輸入 /login，可以選擇 Kimi Code OAuth 或 Moonshot AI 開放平臺 API Key。登入後先用只讀任務驗證：

1

读取这个项目，说明主要目录和启动入口，不要修改文件。

確認路徑識別正確後，再交給它小範圍修改任務。

舊 Kimi CLI 怎樣遷移

官方說明安裝 Kimi Code CLI 會自動遷移舊版配置和會話，舊倉庫將逐步停止維護。遷移前仍建議備份原配置目錄，並記錄自定義 Provider、MCP Server 與工作區路徑。

遷移後重點檢查：

1. kimi --version 是否指向新版本；
2. /login 狀態是否有效；
3. MCP 服務是否仍能連線；
4. 舊會話能否開啟；
5. Git Bash 與專案路徑是否正確。

MCP 和 ACP 有什麼區別

MCP 用來給 Agent 增加外部工具和資料來源，新版可以透過 /mcp-config 對話式配置。ACP 則讓 Zed、JetBrains 等編輯器直接啟動 Kimi Code CLI 會話。

ACP 服務命令是：

1

kimi acp

使用 ACP 前應先在終端完成一次 /login。編輯器配置只負責啟動程序，不應把 API Key 明文寫進專案倉庫。

安裝指令碼執行前怎樣檢查

PowerShell 的 irm ... | iex 會直接執行網路返回內容。更穩妥的做法是先在瀏覽器開啟安裝指令碼或下載後檢查，再執行。重點檢視：

• 下載來源是否為 code.kimi.com；
• 二進位制安裝到哪個目錄；
• 如何修改 PATH；
• 是否寫入 Shell 配置；
• 升級和解除安裝方式；
• 是否要求管理員許可權。

企業電腦還要確認終端安全策略、代理和 Git for Windows 安裝來源。不要為了透過安裝臨時關閉系統防護。

第一次進入專案應該做什麼

先從只讀任務開始，不要直接要求“修復所有問題”。推薦步驟：

1. 在 Git 倉庫根目錄執行 kimi；
2. 讓它只讀取目錄結構和專案說明；
3. 確認它識別的工作目錄；
4. 要求列出準備讀取的檔案；
5. 再交給它一個可驗證的小改動；
6. 完成後檢視 git diff 和測試結果。

一個合適的首個修改任務是修正文件連結、增加單元測試或調整單個元件。依賴升級、資料庫遷移和全域性格式化不適合作為首次驗證。

登入方式如何選擇

Kimi Code OAuth

適合個人互動使用，配置簡單。要注意賬號訂閱、呼叫額度和組織策略是否覆蓋 CLI 使用。

Moonshot AI API Key

適合需要獨立計費、自動化或團隊管理的場景。Key 應放在使用者配置或安全環境變數中，不要提交到倉庫。

無論哪種方式，遷移後都應執行一次實際請求。介面顯示“已登入”不代表模型、地區和配額一定可用。

MCP 配置與驗證

新版主推透過 /mcp-config 管理 MCP，而舊 Kimi CLI 還提供 kimi mcp 命令。遷移使用者不要混用兩套文件；先用 kimi --version 確認當前產品，再檢視對應版本幫助。

新增 MCP Server 時按以下順序：

1. 閱讀 Server 倉庫與許可權說明；
2. 先在測試專案安裝；
3. 不傳真實生產 Token；
4. 檢視它暴露的工具列表；
5. 執行一次只讀呼叫；
6. 確認日誌不會輸出憑據；
7. 最後才開放寫入類工具。

MCP 能擴大 Agent 能力，也會擴大攻擊面。檔案、瀏覽器、資料庫和雲平臺 Server 不應預設得到相同信任級別。

在 Zed 或 JetBrains 中使用 ACP

ACP 讓編輯器透過標準輸入輸出啟動 Kimi Code CLI。以 Zed 為例，配置結構如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

若編輯器提示程序啟動失敗，先在同一個使用者環境的終端執行：

1

kimi acp

常見原因包括編輯器沒有繼承最新 PATH、kimi 安裝在不同使用者目錄、Git Bash 找不到，或尚未完成 /login。

影片輸入適合哪些場景

Kimi Code CLI 支援把螢幕錄製或演示影片作為輸入。它適合解釋難以用文字描述的 UI 行為，例如動畫節奏、復現步驟和參考效果。

使用前先裁剪影片，避免上傳賬號資訊、通知、Token、客戶資料和無關桌面區域。Agent 能“看懂影片”不代表能自動訪問影片中出現的系統，真正修改仍受當前工作區和工具許可權限制。

子 Agent 和 Hooks 怎樣安全啟用

內建 coder、explore 和 plan 子 Agent 可以分離上下文，但多個 Agent 仍可能操作同一工作區。任務中應明確：

• explore 只讀；
• plan 不寫檔案；
• coder 只修改指定目錄；
• 刪除、安裝和 Git 推送必須確認；
• 完成後由主會話統一檢視差異。

Lifecycle Hooks 可用於阻止高風險命令、記錄工具呼叫和傳送通知。Hook 配置本身也是可執行邊界，安裝第三方 Hook 前必須審查。

舊版遷移檢查表

更新時怎樣降低風險

CLI 更新可能改變許可權提示、外掛介面和配置格式。升級前備份配置，檢視 Release 與遷移說明；升級後先在測試倉庫執行只讀任務。若團隊依賴固定工作流，不要所有成員在不同時間自動升級。

排錯順序

Windows 常見問題

提示找不到 kimi

先新開終端，再檢查安裝目錄是否已加入 PATH。不要在舊視窗裡反覆執行安裝指令碼。

提示找不到 Bash

確認 Git for Windows 已安裝，並檢查 KIMI_SHELL_PATH。路徑應指向真實的 bash.exe，不是 Git GUI 或 git.exe。

Agent 要執行危險命令怎麼辦？

不要一次授權整個會話。先檢視命令、工作目錄和目標路徑；涉及刪除、覆蓋、推送或安裝全域性軟體時單獨確認。新版支援生命週期 Hooks，可以進一步攔截高風險工具呼叫。

安裝新版後還能保留舊 Kimi CLI 嗎？

兩者可能共享命令名和配置。官方方向是遷移到 Kimi Code CLI；需要回退時應依賴遷移前備份和官方解除安裝說明，不建議長期並存後依靠 PATH 順序碰運氣。

為什麼在 PowerShell 能執行，在編輯器裡不能？

編輯器通常在安裝前就已啟動，沒有讀取更新後的使用者環境變數。完全退出並重新開啟編輯器，再確認它使用的賬戶和終端環境。

總結

Windows 安裝 Kimi Code CLI 的關鍵是先準備 Git Bash，再完成 /login 和只讀驗證。舊 Kimi CLI 使用者應儘早遷移，但不要只看“安裝成功”，還要逐項核對會話、MCP、Provider 和專案路徑。