Claude Code + Kimi Code API 安裝速查

將 Claude Code 終端工具連接至 Kimi Code API，在本地開發環境使用 Kimi 的編程模型。

環境需求

Linux/macOS 系統
網路連線
Kimi Code API 金鑰（格式：sk-kimi-*）

快速安裝（一鍵完成）

# 1. 安裝 Node.js（透過 nvm）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm install --lts && nvm use --lts

# 2. 安裝 Claude Code
npm install -g @anthropic-ai/claude-code

# 3. 建立永久可用的 claude 指令連結
mkdir -p ~/.local/bin
ln -sf "$(which claude)" ~/.local/bin/claude

# 4. 設定 Kimi Code API 環境變數
mkdir -p ~/.bashrc.d
cat > ~/.bashrc.d/claude-code-kimi.sh <<'EOF'
export ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
export ANTHROPIC_MODEL="kimi-for-coding"
export ANTHROPIC_API_KEY="sk-kimi-YOUR_KIMI_CODE_API_KEY_HERE"
export CLAUDE_CODE_SIMPLE=1
EOF
chmod 600 ~/.bashrc.d/claude-code-kimi.sh

# 5. 載入設定
source ~/.bashrc

# 6. 啟動
claude

逐步詳解

安裝 Node.js 18+

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
nvm install --lts
nvm use --lts

驗證：

node --version
npm --version

安裝 Claude Code

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

確保 claude 指令永久可用

nvm 在精簡 shell 環境中可能未載入，建立符號連結至 ~/.local/bin：

mkdir -p ~/.local/bin
ln -sf "$(which claude)" ~/.local/bin/claude

取得 Kimi Code API 金鑰

前往 Kimi Code 文件中心
在 Kimi Code 控制台建立 API 金鑰
立即複製（僅顯示一次）

專用通道金鑰格式：sk-kimi-...

設定環境變數

建立獨立設定檔：

mkdir -p ~/.bashrc.d
cat > ~/.bashrc.d/claude-code-kimi.sh <<'EOF'
# Claude Code + Kimi Code API
export ANTHROPIC_BASE_URL="https://api.kimi.com/coding/"
export ANTHROPIC_MODEL="kimi-for-coding"
export ANTHROPIC_API_KEY="sk-kimi-YOUR_KIMI_CODE_API_KEY_HERE"

# 跳過 Anthropic OAuth 認證，直接使用 API 金鑰
export CLAUDE_CODE_SIMPLE=1
EOF

chmod 600 ~/.bashrc.d/claude-code-kimi.sh

確認 ~/.bashrc 會載入 ~/.bashrc.d/*.sh，若無則加入：

if [ -d ~/.bashrc.d ]; then
    for rc in ~/.bashrc.d/*; do
        [ -f "$rc" ] && . "$rc"
    done
fi
unset rc

載入並驗證設定

source ~/.bashrc
env | grep -E 'ANTHROPIC_BASE_URL|ANTHROPIC_MODEL|CLAUDE_CODE_SIMPLE'

預期輸出：

ANTHROPIC_BASE_URL=https://api.kimi.com/coding/
ANTHROPIC_MODEL=kimi-for-coding
CLAUDE_CODE_SIMPLE=1

測試 API 端點：

curl -s -o /dev/null -w "%{http_code}" \
  https://api.kimi.com/coding/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY"

預期回應：200

啟動 Claude Code

cd /path/to/your-project
claude

進入後執行 /status 確認：

Base URL: https://api.kimi.com/coding/
Model: kimi-for-coding
API key: ANTHROPIC_API_KEY

問題排解

問題	原因	解決方式
`claude: command not found`	nvm 未載入或 PATH 遺失	開啟新 shell，或手動執行 `export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"`
`Unable to connect to Anthropic services` / `ERR_BAD_REQUEST`	Claude Code 優先嘗試 Anthropic OAuth	確認 `CLAUDE_CODE_SIMPLE=1` 已匯出
API 檢查回傳 `401` / `403`	金鑰或端點錯誤	使用 Kimi Code 金鑰（`sk-kimi-*`）搭配 `https://api.kimi.com/coding/`；若為 Moonshot 開放平台金鑰，改用 `https://api.moonshot.cn/anthropic` 與模型 `kimi-k2.5`
Claude 要求輸入 Anthropic `sk-ant-...` 金鑰	舊的 `ANTHROPIC_API_KEY` 或 `ANTHROPIC_AUTH_TOKEN` 存在	清除 `ANTHROPIC_AUTH_TOKEN`，僅保留 Kimi 金鑰
`/status` 顯示錯誤模型	環境變數未載入	執行 `source ~/.bashrc` 後重試

核心原理

協議相容：Kimi Code 同時支援 OpenAI 與 Anthropic 通訊協議，Claude Code 使用 Anthropic 相容端點，故以 ANTHROPIC_* 變數設定
強制簡易模式：CLAUDE_CODE_SIMPLE=1 阻止 Claude Code 先連線 api.anthropic.com 進行 OAuth/鑰匙圈認證，確保直接使用自定義 Base URL
金鑰保護：設定檔權限設為 600，避免其他使用者讀取