Claude Code 配置要点

The guide below is in Chinese.

为 Claude Code 设置 Anthropic Base URL、API Key 和目录中的模型 ID。遇到错误时,先核对路径和模型拼写。

三、三个环境变量

Shell command
export ANTHROPIC_BASE_URL="https://staging-dp.taotoken.io"
export ANTHROPIC_API_KEY="$TP_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"

先设置 TP_API_KEY,并把 MODEL_ID 换成当前目录中的对话模型 ID。启动 Claude Code 后,若请求报错,按下面两项核对。

一、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。

  • 目录中的 ID 包含前缀时,请连同前缀一起填写
  • 具体到某个模型时,标点符号(点号/连字符)要跟目录里的完全一致,不要凭记忆或旧文档拼写
  • 上游供应商自己的原生模型名(如 Anthropic 官方接口用的名字)不是平台的 model_id,两者不能互换

调用前用 GET https://staging-dp.taotoken.io/v1/models(数据面,sk- 鉴权)或控制面 GET /api/v1/models 查当前目录里的准确拼写,不要照抄可能过期的文档或截图。

鉴权方式

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

下一步

Claude Code 部分模型报错 · 客户端工具兼容性 · 查找错误码