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 包
• 官方最佳实践
• 官方配置指引