KozeKoze
← 返回部落格
教學2026年3月23日·管理员

claude code 配置教學

claude code 配置教學

📋 前置準備

在開始之前，請確保你已經：

  • 註冊了 Koze 帳號並登入
  • 在 API 管理 頁面創建了一把 API Key
  • 已安裝 Claude Code（npm install -g @anthropic-ai/claude-code）

🚀 步驟一：設定環境變數

在終端機中執行以下命令，將 API 位址和金鑰設定為環境變數：

# 設定 Koze 代理程式位址為 Base URL
export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"
# 設定你在 Koze 後台建立的 API Key
export ANTHROPIC_AUTH_TOKEN="你的API金鑰"

💡 提示：將 https://api.kozeai.com 替換為你的實際服務網域。 API 金鑰可在「API 管理 → 現有金鑰」頁面中查看或建立。

🔧 步驟二：VSCode 外掛程式配置（可選）

如果你使用 VSCode 的 Claude 插件，需要在 ~/.claude/config.json 中設定：

{
  "primaryApiKey": "你的API金鑰",
  "apiBaseUrl": "https://api.kozeai.com/v1"
}

如果檔案不存在，請手動建立。

  • macOS / Linux： ~/.claude/config.json
  • Windows： C:\Users\你的使用者名稱\.claude\config.json

🎯 步驟三：啟動 Claude Code

環境變數配置完成後，直接在終端啟動：

claude

Claude Code 會自動使用你設定的 Koze 代理位址進行請求。

📌 持久化環境變數

為避免每次開啟終端機都要重新設置，建議將變數寫入 shell 設定檔：

# Bash 用戶
echo 'export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API金鑰"' >> ~/.bashrc
source ~/.bashrc
# Zsh 用戶
echo 'export ANTHROPIC_BASE_URL="https://api.kozeai.com/v1"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API金鑰"' >> ~/.zshrc
source ~/.zshrc

✅ 驗證連線

啟動 Claude Code 後，如果看到正常的對話介面，表示設定成功。你可以在 Koze 的「使用統計」頁面查看即時呼叫記錄。

⚠️ 常見問題

問題 解決方案
提示 "Invalid API Key" 檢查 API Key 是否正確複製，確保沒有多餘空格
連線逾時 確認 Base URL 是否正確，是否包含 /v1 後綴
模型不可用 在 Koze 模型大廳確認目前套餐可用的模型清單

 

claude code 配置教學 | Koze AI