TTokenPortal

Claude Code 配置要点（未验证为完整教程）

Doc status已发布Feature status上线中Last updated：2026-09-19

本页是三条已核实的配置要点，不是完整的接入教程——还有很多 Claude Code 使用场景没有验证过。遇到本页未覆盖的报错，请看已知问题 · 视频生成 KI-C1，或直接联系支持。

一、ANTHROPIC_BASE_URL 不要带 /v1

Claude Code 使用的 Anthropic 原生 SDK 约定是：ANTHROPIC_BASE_URL 填不带 /v1 的裸域名，SDK 自己会拼接 /v1/messages。

这与站内其它示例（OpenAI 协议的 base_url 需要自己包含 /v1）刚好相反——如果你把 OpenAI 惯例的地址（带 /v1）填进 ANTHROPIC_BASE_URL，Claude Code 拼接后会变成两个 /v1（.../v1/v1/messages），网关找不到这个路径，返回一个不带结构化信息的 404，Claude Code 会把它显示成一条模糊的"模型不存在"报错，容易误导你去怀疑模型名而不是地址格式。

二、模型 ID 必须精确匹配目录，没有归一化

平台对 model 字段做精确字符串匹配，不做任何归一化、不剥离前缀、不做模糊纠错。填错哪怕一个字符（比如把点号写成连字符）都会命中不到，返回 model_not_found。

  • 必须带 provider/ 前缀（如 anthropic/、openai/），不能只写模型本身的名字
  • 具体到某个模型时，标点符号（点号/连字符）要跟目录里的完全一致，不要凭记忆或旧文档拼写
  • 上游供应商自己的原生模型名（如 Anthropic 官方接口用的名字）不是平台的 model_id，两者不能互换

调用前用 GET https://intertoken.ai/v1/models（数据面，sk- 鉴权）或控制面 GET /api/v1/models 查当前目录里的准确拼写，不要照抄可能过期的文档或截图。

三、三个环境变量

ANTHROPIC_BASE_URL=https://intertoken.ai
ANTHROPIC_API_KEY=sk-你的密钥
ANTHROPIC_MODEL=anthropic/claude-opus-4.8

ANTHROPIC_BASE_URL 对应第一条（裸域名，不带 /v1）；ANTHROPIC_MODEL 请按第二条的方式，用查目录得到的当前有效 ID 替换示例值，不要直接照抄。

鉴权方式

Claude Code / Anthropic 原生 SDK 发送的是 x-api-key 请求头，不是 Authorization: Bearer——平台两种都认（见对话端点（四协议） §二），这一点不需要你额外配置，Claude Code 会自动使用它认识的头。

Claude Code 配置要点（未验证为完整教程） · TokenPortal