Claude Code

本指南僅使用 Claude 系列模型。 Claude Code 可執行 Claude 系列模型（Claude Opus 5.5、Claude Sonnet 5.5、Claude Sonnet 5、Claude Fable 5.1、Claude Haiku 5.5），以及沒有限制的模型（GLM、Qwen、Kimi、MiniMax、DeepSeek）。GPT 系列模型無法在 Claude Code 中使用，請參考 Codex。

1. 安裝 Claude Code

本地安裝

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

irm https://claude.ai/install.ps1 | iex

使用 npm 安裝

需要 Node.js 18 或更高版本

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

2. 配置 Harogo API

要通過兼容 Anthropic API 的方式來接入 Harogo 的模型服務，需要配置以下環境變量。

將 ANTHROPIC_BASE_URL 設置爲 https://api.harogo.ai/
將 ANTHROPIC_AUTH_TOKEN 設置爲從 Harogo 平台獲取的 API Key
將 ANTHROPIC_MODEL 設置爲 Harogo 中支持的 Claude 模型，例如 claude-sonnet-5。

macOS
Windows

在終端中執行以下命令，查看默認 Shell 類型。

echo $SHELL

根據 Shell 類型設置環境變量，命令如下：

# 將 <HAROGO_API_KEY> 替換爲你從 Harogo 平台獲取的真實 Key
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc

# 將 <HAROGO_API_KEY> 替換爲你從 Harogo 平台獲取的真實 Key
echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<HAROGO_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile

在終端中執行下列命令，使環境變量生效。

source ~/.zshrc

source ~/.bash_profile

打開一個新的終端，執行下列命令，查看環境變量是否生效。

echo $ANTHROPIC_BASE_URL
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
echo $ANTHROPIC_MODEL

在 Windows 中，可以通過 CMD 或 PowerShell 將 Harogo 的 Base URL 和 API Key 設置爲環境變量。

CMD
PowerShell

在 CMD 中運行以下命令，設置環境變量。

REM 將 <HAROGO_API_KEY> 替換爲你從 Harogo 平台獲取的真實 Key
setx ANTHROPIC_AUTH_TOKEN "<HAROGO_API_KEY>"
setx ANTHROPIC_BASE_URL "https://api.harogo.ai"
setx ANTHROPIC_MODEL "claude-sonnet-5"

打開一個新的 CMD 窗口，運行以下命令，檢查環境變量是否生效。

if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_MODEL%

在 PowerShell 中運行以下命令，設置環境變量。

# 將 <HAROGO_API_KEY> 替換爲你從 Harogo 平台獲取的真實 Key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<HAROGO_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User)

打開一個新的 PowerShell 窗口，運行以下命令，檢查環境變量是否生效。

if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" }
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL

如果你準備通過 CC Switch 管理 Claude Code，建議不要再額外設置全局 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL。系統或用戶環境變量可能覆蓋 CC Switch 寫入的 Provider 配置，導致界面裏選擇了正確 Provider，但 Claude Code 實際仍使用舊 Key 或舊模型。

3. 驗證配置是否生效

完成環境變量或 CC Switch 配置後，建議先用一次最小請求確認 Key、模型和 Anthropic 兼容接口都可用，再啓動長會話。

curl https://api.harogo.ai/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

curl.exe https://api.harogo.ai/v1/messages `
  -H "content-type: application/json" `
  -H "anthropic-version: 2023-06-01" `
  -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" `
  -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}"

4. 開始使用

完成配置後，進入你的工作目錄，在終端運行 claude 命令開始使用 Claude Code。

$ cd /path/your-project
> claude

如果啓動後看到 Not logged in · Please run /login，或進入 Anthropic 登錄選項，通常說明 Claude Code 沒有讀取到可用的 Harogo 配置，或首次引導尚未完成。請先確認上一步最小請求可返回 2，並檢查 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 是否被舊的全局環境變量覆蓋。確認 Key 可用後，如仍進入登錄流程，可按以下步驟跳過首次引導：

定位用戶主目錄下的 .claude.json 文件，具體路徑如下：
- macOS / Linux: ~/.claude.json
- Windows: C:\Users\%USERNAME%\.claude.json
設置hasCompletedOnboarding 字段的值爲 true

{
  "hasCompletedOnboarding": true
}

保存文件，然後在終端中重新運行 claude 。

（可選）更多配置模型的方式

Claude Code 支持以下模型配置方式，按優先級從高到低排列，優先級高的配置會覆蓋優先級低的配置。

對話期間： 執行/model <模型名稱>命令切換模型。適用於臨時切換模型。

/model claude-sonnet-5

啓動 Claude Code 時： 執行claude --model <模型名稱>指定模型。適用於單次會話。

claude --model claude-sonnet-5

設置環境變量：可按任務複雜度配置不同級別的模型，Claude Code 會根據任務類型自動選擇合適的模型。適用於全局生效。

export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"

其中：

ANTHROPIC_DEFAULT_OPUS_MODEL：用於複雜推理、架構設計等高難度任務。
ANTHROPIC_DEFAULT_SONNET_MODEL：用於代碼編寫、功能實現等日常任務。
ANTHROPIC_DEFAULT_HAIKU_MODEL：用於語法檢查、文件搜索等簡單任務。

在 settings.json 配置文件中永久設置：在 Claude Code 的用戶配置文件（如 ~/.claude/settings.json，Windows 爲 C:\Users\%USERNAME%\.claude\settings.json）或項目級配置中寫入模型配置信息，可分別進行用戶級或項目級的永久配置。

如何通過 CC Switch 配置？

運行 CC Switch，先在左側選擇 Claude Code，再點擊「添加供應商」。

在預設列表中選擇供應商爲「自定義配置」。

填寫供應商名稱、API Key、端點（https://api.harogo.ai）等信息。信息填寫完整後，點擊「添加」即可。

返回首頁，在供應商列表中選擇「harogo」，點擊「使用」即可。

Tip: 終端打開 Claude Code後，輸入 /status 可查詢模型ID，輸入/models 可選擇配置的其他模型

如果 CC Switch 提示「檢測到系統環境變量衝突」，請優先處理 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL。這些全局變量會覆蓋當前 Provider 配置；其中 ANTHROPIC_AUTH_TOKEN=<HAROGO_API_KEY> 這類佔位符值會直接導致認證失敗。確認不再需要全局變量後，可在 CC Switch 中刪除衝突項，或手動刪除系統/用戶環境變量，然後重啓終端。

開始使用

快速開始

價格表

1. 安裝 Claude Code

本地安裝

使用 npm 安裝

2. 配置 Harogo API

3. 驗證配置是否生效

4. 開始使用

（可選）更多配置模型的方式

如何通過 CC Switch 配置？

​1. 安裝 Claude Code

​本地安裝

​使用 npm 安裝

​2. 配置 Harogo API

​3. 驗證配置是否生效

​4. 開始使用

​（可選）更多配置模型的方式

​如何通過 CC Switch 配置？

1. 安裝 Claude Code

本地安裝

使用 npm 安裝

2. 配置 Harogo API

3. 驗證配置是否生效

4. 開始使用

（可選）更多配置模型的方式

如何通過 CC Switch 配置？