Claude Code

​

快速開始

​

1. 安裝 Claude Code

​

本機安裝

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

​

使用 npm 安裝

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

​

2. 配置 AIHubMix API

1. 將 ANTHROPIC_BASE_URL 設為 https://aihubmix.com
2. 將 ANTHROPIC_AUTH_TOKEN 設為從 AIHubMix 平台 取得的 API Key
3. 將 ANTHROPIC_MODEL 設為模型列表中支援的 Claude 模型，例如 claude-sonnet-4-5。

echo $SHELL

# 將 <AIHUBMIX_API_KEY> 替換為你從 AIHubMix 平台取得的真實 Key
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="claude-sonnet-4-5"' >> ~/.zshrc

source ~/.zshrc

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

REM 將 <AIHUBMIX_API_KEY> 替換為你從 AIHubMix 平台取得的真實 Key
setx ANTHROPIC_AUTH_TOKEN "<AIHUBMIX_API_KEY>"
setx ANTHROPIC_BASE_URL "https://aihubmix.com"
setx ANTHROPIC_MODEL "claude-sonnet-4-5"

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

# 將 <AIHUBMIX_API_KEY> 替換為你從 AIHubMix 平台取得的真實 Key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "<AIHUBMIX_API_KEY>", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aihubmix.com", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5", [EnvironmentVariableTarget]::User)

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

​

3. 驗證配置是否生效

curl https://aihubmix.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1，只輸出答案"}]
  }'

claude -p "1+1，只輸出答案" --model claude-sonnet-4-5

​

4. 開始使用

$ cd /path/your-project
> claude

1. 定位使用者主目錄下的 .claude.json 檔案，具體路徑如下：
   • macOS / Linux: ~/.claude.json
   • Windows: C:\Users\%USERNAME%\.claude.json
2. 設定 hasCompletedOnboarding 欄位的值為 true

{
  "hasCompletedOnboarding": true
}

3. 儲存檔案，然後在終端機中重新執行 claude。

​

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

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

/model claude-sonnet-4-5

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

claude --model claude-sonnet-4-5

3. 設定環境變數：可按任務複雜度配置不同級別的模型，Claude Code 會根據任務類型自動選擇合適的模型。

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

• ANTHROPIC_DEFAULT_OPUS_MODEL：用於複雜推理、架構設計等高難度任務。
• ANTHROPIC_DEFAULT_SONNET_MODEL：用於程式碼編寫、功能實作等日常任務。
• ANTHROPIC_DEFAULT_HAIKU_MODEL：用於語法檢查、檔案搜尋等簡單任務。

4. 在 settings.json 配置檔中永久設定：在 Claude Code 的使用者配置檔（如 ~/.claude/settings.json，Windows 為 C:\Users\%USERNAME%\.claude\settings.json）或專案級配置中寫入模型配置信息。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<AIHUBMIX_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "gemini-3.5-flash",
    "ANTHROPIC_MODEL": "gpt-5.5"
  },
  "model": "gpt-5.5"
}

​

如何透過 CC Switch 配置？

1. 執行 CC Switch，先在左側選擇 Claude Code，再點擊「新增供應商」。

2. 在預設列表中選擇「AiHubMix」。請確認目前配置的是 Claude Code 側的 Provider。

3. 在「API Key」欄中填寫你的真實密鑰。

4. 配置完成後，先使用 claude-sonnet-4-5 作為模型 ID，點擊「新增」儲存設定。確認健康檢查通過後，可在 Claude Code 中透過 /models 或 /model 切換其他 Claude 模型。
   
5. 返回首頁，在供應商列表中選擇「AiHubMix」，點擊「啟動」即可使用。

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

​

如何透過 VS Code 外掛配置？

1. 執行 VS Code，安裝外掛。

2. 按下 Ctrl + Shift + P（或 Cmd + Shift + P），輸入 Settings 開啟設定。

3. 搜尋 Claude Code，找到 Claude Code: Environment Variable -> Edit in settings.json。

4. 在 claudeCode.environmentVariables 中填入 AIHubMix 相關資訊。

​

Wechat-Agent-SDK

安裝地址：https://github.com/AIhubmix/wechat-agent-sdk

​

常見問題

​

Q：提示 401 認證錯誤怎麼辦？

• No token provided：沒有傳入 Key。開啟 Claude Code，輸入 /config，找到 Use custom API key 選項，檢查 Token 是否已配置。
• invalid key: AIHUBMIX_API_KEY：通常表示把示例占位符原樣寫入了環境變數。請在 AIHubMix 控制台重新複製真實 Key，並更新 ANTHROPIC_AUTH_TOKEN。
• this key is not enabled：請求已到達 AIHubMix，但目前 Key 尚未啟用或沒有調用權限。請在 AIHubMix 控制台 檢查該 Key 是否啟用、是否過期、是否有額度，並確認它可以調用你選擇的 Claude 模型。

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_MODEL", "User")

​

Q：提示 400 Incorrect model ID 或 Bad request (400) 怎麼辦？

​

Q：macOS 中安裝成功後仍然報錯：zsh: command not found: claude

1. 確認 Claude 安裝路徑。Claude Code 官方腳本通常安裝在以下目錄之一：

• ~/.claude/bin
• ~/.local/bin

ls -l ~/.claude/bin
或
ls -l ~/.local/bin | grep claude

2. 將安裝目錄加入 PATH。根據實際安裝位置執行對應命令：

​

情況 A：安裝在 ~/.claude/bin

echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

​

情況 B：安裝在 ~/.local/bin

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 驗證是否生效。執行：

which claude
claude -v

​

Q：Claude Code 無法連接 Anthropic 服務

​

更多資源

• Github
• npm 套件
• 官方最佳實踐
• 官方配置指引