Claude Code 接入

将 Claude Code 接入 Token Hub，使用申请到的 API Key 即可。

环境变量清单

重要：Claude Code 的配置以本节为准。 将 <your-api-key> 替换为你的 API Key，其余值保持不变。

export ANTHROPIC_AUTH_TOKEN="<your-api-key>"
export ANTHROPIC_BASE_URL="https://tokenhub.piegateway.me"
export ANTHROPIC_MODEL="claude-opus-4-6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

⚠️ CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 必须设置。 如果不设置，Claude Code 会启用实验性功能（如 extended thinking），这些功能使用非标准 API 格式，会导致请求通过网关时解析失败或报错。

配置步骤

Step 1 — 确认 shell 类型：

echo $SHELL

Step 2 — 选择配置文件：

• zsh → 编辑 ~/.zshrc
• bash → 编辑 ~/.bash_profile

Step 3 — 如果之前配置过 Claude Code / Anthropic / Bedrock，先注释旧的 ANTHROPIC_*、CLAUDE_CODE_*、AWS_* 相关变量，避免冲突。

Step 4 — 将上方「4.1 环境变量清单」中的完整配置追加到配置文件末尾，将 <your-api-key> 替换为你的 API Key。

Step 5 — 重新加载配置并启动：

source ~/.zshrc   # 或 source ~/.bash_profile
claude

验证配置

检查环境变量是否生效：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL

验证 API Key 是否可用：

curl -s https://tokenhub.piegateway.me/v1/models \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" | head -c 200

返回模型列表即表示配置成功。

常见问题

配置修改后不生效 — 通常是没有重新加载配置，执行 source ~/.zshrc 或 source ~/.bash_profile。

存在多个旧配置相互覆盖 — 检查配置文件中是否同时存在旧的 ANTHROPIC_*、CLAUDE_CODE_*、AWS_*，注释掉旧配置后重新加载。