Claude Code

​

快速开始

​

1. 安装 Claude Code

​

本地安装

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

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

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

winget install Anthropic.ClaudeCode

brew install --cask claude-code

​

使用 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-5-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-5-5"' >> ~/.zshrc

# 将 <AIHUBMIX_API_KEY> 替换为你从 AIHubMix 平台获取的真实 Key
echo 'export ANTHROPIC_BASE_URL="https://aihubmix.com"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="<AIHUBMIX_API_KEY>"' >> ~/.bash_profile
echo 'export ANTHROPIC_MODEL="claude-sonnet-5-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

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-5-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-5-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 "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "1+1, output only the answer"}]
  }'

$body = @{
  model = "claude-sonnet-5-5"
  max_tokens = 16
  messages = @(@{ role = "user"; content = "1+1, output only the answer" })
} | ConvertTo-Json -Depth 5

$response = Invoke-RestMethod -Uri "https://aihubmix.com/v1/messages" -Method Post `
  -ContentType "application/json" `
  -Headers @{ "anthropic-version" = "2023-06-01"; "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN" } `
  -Body $body
$response.content[0].text

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

​

4. 开始使用

$ cd /path/your-project
> claude

1. 确认上一步的最小请求可以返回 2。
2. 确认 ANTHROPIC_AUTH_TOKEN 写在 Claude Code 启动时就能读取的位置：终端环境变量，或 ~/.claude/settings.json 的 env。写入 ~/.zshrc 等配置文件后，需要打开新的终端再运行 claude。只写在项目目录的 .claude/settings.json 或 .claude/settings.local.json 中时，要等首次引导和信任文件夹确认完成后才生效，因此首次启动仍会进入登录界面。
3. 检查 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 是否被旧的全局环境变量覆盖。

​

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

1. 对话期间： 执行/model <模型名称>命令切换模型，所选模型会保存为之后新会话的默认模型。只想切换当前会话时，输入 /model 打开模型列表，在目标模型上按 s。设置了 ANTHROPIC_MODEL 时，新会话仍使用该变量指定的模型。

/model claude-sonnet-5-5

2. 启动 Claude Code 时： 执行claude --model <模型名称>指定模型。适用于单次会话。

claude --model claude-sonnet-5-5

3. 设置环境变量 ANTHROPIC_MODEL： 适用于全局生效。

export ANTHROPIC_MODEL="claude-sonnet-5-5"

4. 在 settings.json 配置文件中永久设置： 在 Claude Code 的用户配置文件（如 ~/.claude/settings.json，Windows 为 C:\Users\%USERNAME%\.claude\settings.json）或项目级配置中写入 model 字段，可分别进行用户级或项目级的永久配置。设置了 ANTHROPIC_MODEL 时，model 字段不生效。

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

• ANTHROPIC_DEFAULT_FABLE_MODEL：fable 别名对应的模型。
• ANTHROPIC_DEFAULT_OPUS_MODEL：opus 别名对应的模型，opusplan 在 Plan 模式下也使用该模型。
• ANTHROPIC_DEFAULT_SONNET_MODEL：sonnet 别名对应的模型，opusplan 在 Plan 模式以外使用该模型。
• ANTHROPIC_DEFAULT_HAIKU_MODEL：haiku 别名对应的模型，Claude Code 的后台任务也使用该模型。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "<AIHUBMIX_API_KEY>",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

​

如何通过 CC Switch 配置？

1. 运行 CC Switch，先在左侧选择 Claude Code，再点击「添加供应商」。

2. 在预设列表中选择「AiHubMix」。请确认当前配置的是 Claude Code 侧的 Provider。

3. 在「API Key」栏中填写你的真实密钥。

4. 向下滚动到「模型映射」，在 Sonnet、Opus、Haiku 三行的「显示名称」和「实际请求模型」中分别填写 claude-sonnet-5-5、claude-opus-5-5、claude-haiku-5-5，其余行留空；「默认兜底模型」填写 claude-sonnet-5-5。点击「添加」保存设置，之后可在 Claude Code 中通过 /model 切换这些模型。
   
5. 返回首页，点击「AiHubMix」卡片右侧的 ▷ 按钮（切换）。卡片显示「使用中」即表示 Claude Code 已改用该供应商。

Tip: 终端打开 Claude Code后，输入 /status 可查询模型ID，输入/model 可选择配置的其他模型

​

如何通过 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 相关信息，并将 claudeCode.disableLoginPrompt 设为 true，跳过插件的登录提示。

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://aihubmix.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-***" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" }
  ],
  "claudeCode.disableLoginPrompt": true
}

​

常见问题

​

Q：提示 401 认证错误怎么办？

• no key provided：请求中没有 Key。打开 Claude Code，输入 /status，确认 Anthropic base URL 一行为 https://aihubmix.com，并且 Auth token 或 API key 一行显示了 ANTHROPIC_AUTH_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 安装到以下位置：

• macOS / Linux：~/.local/bin/claude
• Windows：%USERPROFILE%\.local\bin\claude.exe

ls -l ~/.local/bin/claude

2. 将安装目录加入 PATH：

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

3. 验证是否生效。执行：

which claude
claude -v

​

Q：Claude Code 无法连接 Anthropic 服务

​

更多资源

• 官方最佳实践
• 官方配置指引