model 可用性會隨時間變動。目前的 Claude model ID,請查看
CometAPI Models page。
先決條件
- 從你的 dashboard 取得的 CometAPI 金鑰(以
sk-開頭) - 已安裝 Git
- 支援的作業系統:macOS、Linux 或 Windows
安裝 Claude Code
1
執行官方安裝程式
- macOS / Linux
- Homebrew
- Windows
2
驗證安裝
設定 CometAPI 端點
建立或編輯設定檔:- macOS / Linux:
~/.claude/settings.json - Windows:
%USERPROFILE%\.claude\settings.json
sk-your-cometapi-key 替換為你實際的 CometAPI 金鑰,然後啟動 Claude Code:
疑難排解
settings.json 未生效
settings.json 未生效
- 完全重新啟動你的終端機:關閉所有視窗後再重新開啟。
- 如果仍然無法運作,請建立
~/.claude.json並加入:
- 作為備用方案,直接匯出環境變數:
Invalid API Key 或 Please run /login
Invalid API Key 或 Please run /login
請檢查
~/.claude/settings.json 是否存在,且 JSON 格式有效,沒有尾隨逗號,並使用正確的引號。可於 jsonlint.com 驗證。使用了快取的官方憑證
使用了快取的官方憑證
Claude Code 會優先使用已快取的官方憑證。請在 Claude Code 內執行
/logout,將其關閉後再重新啟動。如果仍然失敗,請移除快取的驗證檔案:狀態顯示為 offline
狀態顯示為 offline
Claude Code 會透過 Google 檢查連線狀態。
offline 表示無法連上 Google。這不影響 CometAPI 的使用。Fetch 或網頁瀏覽失敗
Fetch 或網頁瀏覽失敗
Claude Code 的 Fetch 功能會先呼叫 Anthropic 的原生服務,而這需要可直接存取網際網路。你可能需要設定系統層級的代理。