在 Windows 上將 Claude Code 連接 Kimi Code API（2026 實測版）：npm 安裝、settings.json 設定與方案對照

過去寫過一篇同主題的設定指南，最近重裝時發現流程已經簡化不少。這篇是 2026 年 8 月在 Windows 11 上的實測記錄，依據 Kimi 官方文件的最新寫法，從安裝到驗證大約十分鐘走完。實測環境：Claude Code 2.1.228、Node.js（npm 全域安裝）、Git Bash。

與舊文的主要差異：官方現在提供「跳過 Anthropic 登入」的初始化腳本，不再需要手動對付 OAuth 流程；模型也從 kimi-for-coding 單一選項，變成依會員方案選擇 k3 / k3[1m] / kimi-for-coding，最高支援 1M context。

前置需求

Windows 10 或 11
Node.js 18+（確認 node -v 與 npm -v 可用）
Kimi 會員，且已開通 Kimi Code 權益
Kimi Code API 金鑰（格式為 sk-kimi-*）：到 Kimi Code Console 點「Create API Key」建立，金鑰只會完整顯示一次，請立即複製保存

第一步：安裝 Claude Code

macOS / Linux 教學常見的 curl -fsSL https://claude.ai/install.sh | bash 不適用於 Windows。Windows 的官方原生安裝方式是 PowerShell 的 irm https://claude.ai/install.ps1 | iex，但如果你本來就有 Node.js，直接用 npm 最省事：

npm install -g @anthropic-ai/claude-code

如果 npm 提示 postinstall script 被 allow-scripts 阻擋（新版 npm 的安全機制），加參數重跑一次：

npm install -g --allow-scripts=@anthropic-ai/claude-code @anthropic-ai/claude-code

驗證：

claude --version
# 2.1.228 (Claude Code)

第二步：跳過 Anthropic 登入流程

安裝完先不要啟動 claude。官方提供了一段初始化腳本，做兩件事：

在 ~/.claude.json 寫入 hasCompletedOnboarding: true，跳過 Anthropic 的登入引導
清掉 ~/.claude/settings.json 裡殘留的舊模型環境變數（ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 等），避免與新設定衝突

直接在終端執行（官方文件的版本少了 require，在 node --eval 下會報錯，以下是修正版）：

node --eval "
const fs = require('fs'), path = require('path'), os = require('os');
const claudeJsonFilePath = path.join(os.homedir(), '.claude.json');
if (fs.existsSync(claudeJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8'));
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ ...content, penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8');
} else {
    fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8');
}
const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json');
if (fs.existsSync(claudeSettingsJsonFilePath)) {
    const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8'));
    if (typeof content === 'object' && typeof content.env === 'object') {
        for (const element of [
            'ANTHROPIC_MODEL','ANTHROPIC_SMALL_FAST_MODEL','CLAUDE_CODE_SUBAGENT_MODEL',
            'ANTHROPIC_DEFAULT_FABLE_MODEL','ANTHROPIC_DEFAULT_FABLE_MODEL_NAME',
            'ANTHROPIC_DEFAULT_OPUS_MODEL','ANTHROPIC_DEFAULT_OPUS_MODEL_NAME',
            'ANTHROPIC_DEFAULT_SONNET_MODEL','ANTHROPIC_DEFAULT_SONNET_MODEL_NAME',
            'ANTHROPIC_DEFAULT_HAIKU_MODEL','ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME',
        ]) { delete content.env[element]; }
        fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8');
    }
}
console.log('done');
"

第三步：把 Kimi 設定寫進 settings.json

Windows 上用 .bashrc / setx 傳環境變數給 Claude Code 一直不夠穩定，最可靠的方式仍是 Claude Code 原生讀取的 ~/.claude/settings.json。它的 env 區塊會注入程序環境，且只影響 Claude Code，不汙染系統環境。

先確認你的會員方案，選對模型與 context 上限：

方案	可用模型	Context 上限
Andante	`kimi-for-coding`	262144
Moderato	`k3`、`kimi-for-coding`	262144
Allegretto 以上	`k3`、`kimi-for-coding`、`kimi-for-coding-highspeed`	K3 為 1048576（1M）；K2.7 Code 系列為 262144

Allegretto 以上的完整設定（編輯 C:\Users\<你的使用者名稱>\.claude\settings.json，若檔案已有其他設定請合併 env 區塊，不要整檔覆蓋）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "sk-kimi-你的金鑰",
    "ANTHROPIC_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "k3[1m]",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576"
  }
}

幾個細節：

k3[1m] 這個寫法（含引號、含方括號）是專門給 Claude Code 環境變數用的，用來明確指定 1M context window。直接打 API 或填其他工具的 Model ID 欄位時，只寫 k3。
方案只有 256K 的話，把所有 k3[1m] 改成 k3，兩個 context 變數改成 262144。
舊文強調要用 ANTHROPIC_AUTH_TOKEN；2026 年的官方文件改用 ANTHROPIC_API_KEY，實測可正常認證。跟著官方現行寫法即可。
如果 settings.json 裡有舊的 "model": "opus" 之類的頂層設定，建議移除，讓 ANTHROPIC_MODEL 全權決定模型。

第四步：驗證（先測金鑰，再開 claude）

建議先用 curl 直接打 Kimi 端點，確認金鑰本身有效——這一步不需要啟動 Claude Code，能把「金鑰問題」和「Claude Code 設定問題」分開排查：

curl -sS -m 60 https://api.kimi.com/coding/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: sk-kimi-你的金鑰" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"k3","max_tokens":16,"messages":[{"role":"user","content":"Say OK"}]}'

回傳 JSON 含 "role":"assistant" 就代表金鑰與端點都正常。

接著啟動：

claude

第一次啟動若詢問是否使用此 API key，確認即可，並依提示選擇信任的專案資料夾。進入後輸入：

/status

看到 Base URL: https://api.kimi.com/coding/ 即設定成功。介面上的模型名稱可能仍顯示 Claude 的模型名，但實際請求都送往 Kimi Code API，以 Base URL 為準。

切換思考強度：/effort

工作階段中輸入 /effort 可切換 thinking effort，不需要改環境變數。K3 支援 low / high / max，對應關係：

Claude Code 層級	K3 層級
low	low
medium（建議）	high
high（建議）	high
xhigh	max
max	max
未設定（預設）	high

注意：關閉 thinking 會讓 K3 / K2.7 Code 降級走 K2.6。要用 K3 / K2.7 請保持 thinking 開啟；K2.7 Code 的快速切換鍵是 macOS 的 Option+T、Windows / Linux 的 Alt+T。

常見問題與排查

1. 呼叫模型時 401 / 權限錯誤

多半是方案不支援你設定的模型或 context。Allegretto 以下用了 k3[1m] 就會出問題——改回 k3 並把兩個 context 變數設為 262144；Andante 方案則改用 kimi-for-coding。

2. Not logged in · Please run /login

第二步的初始化腳本沒跑，或 ~/.claude/settings.json 的 JSON 格式有誤（常見是多了逗號）。重新執行腳本並用 node -e "JSON.parse(require('fs').readFileSync(process.env.USERPROFILE + '/.claude/settings.json','utf-8'))" 驗證語法。

3. claude: command not found

npm 全域路徑不在 PATH。執行 npm prefix -g 確認路徑（通常是 C:\Users\<使用者>\AppData\Roaming\npm），把它加進使用者環境變數 PATH 後重開終端。

4. 介面顯示的模型名是 Claude 模型

正常現象。ANTHROPIC_DEFAULT_* 系列變數把 Claude Code 內部所有模型別名都映射到 k3[1m]，名稱只是顯示層，/status 的 Base URL 才是事實。

5. 金鑰安全

金鑰以明文存在 settings.json。若金鑰曾出現在聊天記錄、截圖或公開場所，到 Kimi Code Console 撤銷重建一支，再更新檔案即可。

settings.json 的作用範圍

~/.claude.json 與 ~/.claude/settings.json 都是使用者層級：對目前 Windows 帳號下的所有專案生效，但不影響其他 Windows 使用者，重裝 CLI 也不會動到它們。若某個專案想改用官方 Anthropic API，在該專案建 .claude/settings.local.json 覆寫環境變數即可，其餘專案維持走 Kimi。優先順序大致為：命令列參數 > 專案 local 設定 > 專案設定 > 使用者設定。

快速參考

Allegretto 以上（1M context）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "sk-kimi-...",
    "ANTHROPIC_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "k3[1m]",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1048576",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576"
  }
}

256K 方案：上述 k3[1m] 全部改 k3，兩個 1048576 改 262144。

參考來源：Kimi Code 官方文件 — 在 Claude Code 等第三方 Agent 中使用

_最後更新：2026-08-12_

如果你照舊文設定到一半卡住，最快的修法其實是：跑一遍第二步的初始化腳本，再把 env 區塊整段換成這篇的版本。舊設定和新設定混著用，才是大多數「怎麼改都沒反應」的根源。