Skip to Content
工具调用Claude Code

Claude Code 接入指南

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。本指南介绍如何将其接入 AMAX Token Router。

准备工作

接入方式

方式一：环境变量（推荐）

在终端中设置以下环境变量：

export ANTHROPIC_BASE_URL=https://ai.amaxsmp.com
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

注意：

  • ANTHROPIC_BASE_URL 不要带 /v1 后缀，Claude Code 会自动拼接路径
  • ANTHROPIC_AUTH_TOKEN 用于 Bearer Token 鉴权，适合网关/代理场景
  • 如果使用 ANTHROPIC_API_KEY，会以 x-api-key 头传递，网关可能不识别

方式二：配置文件

在 ~/.claude/settings.json 中写入（JSON 格式）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.amaxsmp.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

也可以在项目根目录的 .claude/settings.local.json 中配置（不提交到 Git），优先级高于 ~/.claude/settings.json。

方式三：项目级配置

在项目根目录创建 .claude/settings.json（可提交共享），配置格式同上。团队成员可共用同一套网关配置。

模型配置

AMAX Token Router 支持 Anthropic 协议互转，你可以使用任何模型名称。在 Claude Code 中使用 /model 命令可以切换模型。

如需使用智能模型路由，将模型设为 amax-router：

claude --model amax-router

网关兼容性配置

如果遇到兼容性问题，可设置以下变量：

# 如果网关不支持 anthropic-beta 头，禁用实验性功能
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
 
# 如果网关不支持 thinking 参数
export CLAUDE_CODE_DISABLE_THINKING=1
 
# 启用网关模型发现（从网关 /v1/models 获取模型列表）
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

验证配置

在终端运行：

claude -p "用一句话介绍你自己。"

如果返回正常的 AI 回复，说明配置成功。

常见问题

连接超时

增加超时时间：

export API_TIMEOUT_MS=1200000  # 20 分钟

模型不可用

AMAX Token Router 透传上游错误。请确认：

  • API Key 有效且未被禁用
  • 账户余额充足
  • 模型名称正确

工具调用异常

某些网关可能不支持 Anthropic 的扩展头。尝试启用网关兼容模式：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

参考

智能模型路由Codex