Claude Code

模型调用暂未开放

本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。

需要哪种接口

Anthropic Messages。Claude Code 只使用这一种格式，请在模型广场的「端点类型」里选择 Anthropic，从列出的模型中选择。

关于官方支持

Claude Code 是 Anthropic 的产品。Anthropic 官方说明，不为通过网关使用非 Claude 模型提供支持；部分功能的效果可能与官方模型不同。

开始之前

完成实名认证，认证通过后重新登录一次。
在主站「API 密钥」页面创建一把 Key，复制并妥善保存。
在模型广场的「端点类型」筛选里选择 Anthropic（窄屏时点“筛选”按钮），从列出的模型中复制模型 ID。

另外需要先安装好 Claude Code，安装方法见 Claude Code 官方文档。

配置步骤

推荐写进 Claude Code 的用户设置文件，所有终端和项目都会生效：

macOS / Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

文件不存在就新建。已有内容时，只把下面 env 里的几项合并进去，不要整份覆盖。也可以只在当前终端临时设置，见另外两个标签。

settings.json · 配置示例

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aiput.top",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "MODEL_ID_FROM_CATALOG",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MODEL_ID_FROM_CATALOG",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MODEL_ID_FROM_CATALOG",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MODEL_ID_FROM_CATALOG",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

终端 · 只对当前窗口生效

export ANTHROPIC_BASE_URL='https://api.aiput.top'
export ANTHROPIC_AUTH_TOKEN='YOUR_API_KEY'
export ANTHROPIC_MODEL='MODEL_ID_FROM_CATALOG'
export ANTHROPIC_DEFAULT_OPUS_MODEL='MODEL_ID_FROM_CATALOG'
export ANTHROPIC_DEFAULT_SONNET_MODEL='MODEL_ID_FROM_CATALOG'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='MODEL_ID_FROM_CATALOG'
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS='1'

PowerShell · 只对当前窗口生效

$env:ANTHROPIC_BASE_URL = "https://api.aiput.top"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "MODEL_ID_FROM_CATALOG"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "MODEL_ID_FROM_CATALOG"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "MODEL_ID_FROM_CATALOG"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "MODEL_ID_FROM_CATALOG"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"

各项的含义：

ANTHROPIC_BASE_URL：AIPUT 的地址，不带 /v1，Claude Code 会自动加上 /v1/messages。
ANTHROPIC_AUTH_TOKEN：你的 AIPUT Key。
ANTHROPIC_MODEL 和三个 ANTHROPIC_DEFAULT_*_MODEL：都填模型广场里的模型 ID。Claude Code 内部按 opus、sonnet、haiku 三档选模型，会话标题等后台任务也会用到；全部指向同一个可用模型，可以避免它请求 AIPUT 上没有的型号。
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS：关闭 Claude Code 的预览功能字段，减少模型因不认识这些字段而报错。

以前用 claude.ai 账号登录过也没关系：设置了 ANTHROPIC_AUTH_TOKEN 后，Claude Code 优先使用这把 Key。想换回原来的登录方式，删掉这几项即可。

怎样确认配置成功

在终端运行 claude，进入后输入 /status：Anthropic base URL 一行应显示 AIPUT 的地址，Auth token 一行应显示 ANTHROPIC_AUTH_TOKEN。
发一句简短的问题，能收到回复就说明配置成功。
也可以先在终端单独测试接口。这会产生一次很小的调用费用：

终端 · 接口测试

curl -sS 'https://api.aiput.top/v1/messages' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'anthropic-version: 2023-06-01' \
  --header 'Content-Type: application/json' \
  --data '{"model":"MODEL_ID_FROM_CATALOG","max_tokens":16,"messages":[{"role":"user","content":"你好"}]}'

返回一段包含 "content" 的 JSON，说明地址和 Key 都正确。

Claude Code 自身的限制

/model 模型选择器不会列出 AIPUT 的模型，请用上面的设置指定模型。
/context 显示的上下文用量是估算值。
Claude Code 默认按 200K 的上下文窗口工作。模型的上下文窗口更小时，在 env 里加上 CLAUDE_CODE_MAX_CONTEXT_TOKENS，值填该模型的上下文长度。
使用 Key 时，Remote Control、语音输入等依赖 claude.ai 账号的功能不可用。

常见问题

现象	处理
启动后仍要求登录	Key 没有被读到：确认写在 `~/.claude/settings.json` 的 `env` 里，或者在启动 `claude` 的同一个终端里设置了环境变量
`401` 或"无效的令牌"	Key 填错或已删除；确认用的是 `ANTHROPIC_AUTH_TOKEN`
`404`	`ANTHROPIC_BASE_URL` 多写了 `/v1`
`400`，提到 `context_management` 或 `Extra inputs`	确认已设置 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`
`400`，提到 `thinking`	这个模型不接受 Claude Code 的思考参数，换一个模型广场里标有 Anthropic 的模型
"无可用渠道"	账户还没有实名认证、模型 ID 写错，或模型当前不可用，见常见问题

本页按 2026 年 10 月的 Claude Code 版本编写，界面和配置项可能随版本变化，以 Claude Code 官方说明为准。Claude Code 的名称和商标归其所有者所有，这里只表示兼容。