Claude Code 可以通过云信大模型 API 平台（简称 AIHub）的 Anthropic Messages 兼容入口接入。

Claude Code 原生读取进程环境变量进行配置，适合命令行、IDE 插件和脚本化开发场景。

安装 Claude Code

1. Claude Code 依赖 Node.js 运行环境，安装前请确认已安装 Node.js 18 或更高版本：

   bashnode --version
   

2. 执行以下命令安装 Claude Code：

   • macOS/Linux：

     在 macOS/Linux 终端中执行以下命令安装 Claude Code：

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

   • Windows：

     建议使用 WSL2 或 Git Bash，并在对应终端中执行同一条 npm 安装命令。

     安装完成后，重新打开终端并确认命令可用：

     bashclaude --version
     

如果使用 Claude Code 的 VS Code 或 JetBrains 插件，建议 先完成 CLI 安装和 AIHub 接入验证，再安装 IDE 插件。插件通常复用本机 CLI 配置，安装后需重启 IDE 才能读取最新的环境变量。

配置接入凭证

Claude Code 通过以下环境变量接入 AIHub：

配置项	说明
ANTHROPIC_BASE_URL	AIHub 协议根地址，不要追加 /v1/messages（Claude Code 会自动拼接）
ANTHROPIC_AUTH_TOKEN	AIHub API Key / 访问令牌
ANTHROPIC_MODEL	AIHub 模型名称

基础配置

bashexport AIHUB_BASE_URL="https://ai.yunxinapi.com/hub"
export AIHUB_TOKEN="sk-..."
export AIHUB_MODEL="your-logical-model"

export ANTHROPIC_BASE_URL="$AIHUB_BASE_URL"
export ANTHROPIC_AUTH_TOKEN="$AIHUB_TOKEN"
export ANTHROPIC_MODEL="$AIHUB_MODEL"

# 关闭非必要流量，提升稳定性
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

如果希望 Claude Code 内置的 haiku、sonnet、opus 别名映射到 AIHub 的同一个逻辑模型，可额外配置：

bashexport ANTHROPIC_DEFAULT_HAIKU_MODEL="$AIHUB_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$AIHUB_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$AIHUB_MODEL"

验证配置

1. 验证 AIHub Messages 端点。

   bashcurl "$AIHUB_BASE_URL/v1/messages" \
   -H "Authorization: Bearer $AIHUB_TOKEN" \
   -H "Content-Type: application/json" \
   -H "anthropic-version: 2023-06-01" \
   -d '{
       "model": "'"$AIHUB_MODEL"'",
       "max_tokens": 8,
       "messages": [
       {"role": "user", "content": "只回复 OK"}
       ]
   }'
   

2. 验证 Claude Code。

   bashclaude -p "只回复 OK" --model "$AIHUB_MODEL" --output-format json
   

   如果返回 OK，且控制台请求日志中能看到 /v1/messages 请求，说明配置已生效。

IDE 插件配置

Claude Code 的 VS Code、JetBrains 等 IDE 插件通常复用本机 CLI 配置。完成 CLI 验证后，按以下步骤操作：

1. 安装 IDE 插件。
2. 重启 IDE，确保插件进程能读取同一组环境变量。
3. 若插件仍访问默认服务，请在 IDE 启动前确认环境变量已正确导出。

常见问题

现象	排查方向
请求仍访问 Anthropic 官方地址	环境变量未进入 Claude Code 进程，请重新打开终端或 IDE。
/v1/messages 返回 401	AIHUB_TOKEN 不正确、已禁用，或未作为 Bearer Token 发送。
/v1/messages 返回 404	ANTHROPIC_BASE_URL 缺少环境前缀（如公网环境少了 /hub）。
model not allowed/no candidate	当前访问令牌无权调用该逻辑模型，或路由未配置可用渠道。
使用内置模型别名（haiku/sonnet/opus）失败	请配置 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL。