跳轉到主要內容
使用本指南將 Claude Code 連接到 CometAPI。 官方參考資料：
模型可用性會隨時間變動。若要查看目前的 Claude 模型 ID，請參閱 CometAPI Models page。

​
先決條件

  • 從你的 dashboard 取得 CometAPI 金鑰（以 sk- 開頭）
  • 已安裝 Git
  • 支援的作業系統：macOS、Linux 或 Windows

​
安裝 Claude Code

1

執行官方安裝程式

curl -fsSL https://claude.ai/install.sh | bash
2

驗證安裝

claude --version

​
設定 CometAPI 端點

建立或編輯設定檔：
  • macOS / Linux：~/.claude/settings.json
  • Windows：%USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
將 sk-your-cometapi-key 替換成你實際的 CometAPI 金鑰，接著啟動 Claude Code： 
cd your-project
claude

​
疑難排解

settings.json 沒有生效？
  1. 完整重新啟動你的終端機（關閉所有視窗後重新開啟）
  2. 如果仍然無法運作，建立 ~/.claude.json 並加入： 
    {
  "hasCompletedOnboarding": true
}
  3. 作為備用方式，直接匯出環境變數： 
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
export ANTHROPIC_BASE_URL="https://api.cometapi.com"
出現 Invalid API Key 或 Please run /login？ 請檢查 ~/.claude/settings.json 是否存在，且 JSON 格式是否正確（沒有尾隨逗號、引號正確）。可在 jsonlint.com 驗證。 先前曾登入 Anthropic 官方服務？ Claude Code 會優先使用快取的官方憑證。請在 Claude Code 內執行 /logout，將其關閉後再重新啟動。如果仍然失敗： 
rm -rf ~/.config/claude-code/auth.json
狀態顯示 offline？ Claude Code 會透過 Google 檢查連線狀態。offline 只代表無法連到 Google——這不會影響 CometAPI 的使用。 Fetch / 網頁瀏覽失敗？ Claude Code 的 Fetch 功能會先呼叫 Anthropic 的原生服務，這需要可直接存取網際網路。你可能需要設定系統層級的代理。