Claude Code 接入配置

让 Claude Code 改连 HybridInference 网关、不再直连 Anthropic，这样它用的就是该部署提供的模型和签发的 API key。

配置

编辑 ~/.claude/settings.json（Windows 上是 %USERPROFILE%\.claude\settings.json）：

{
  "model": "<gateway-model-id>",
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-gateway.example/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>"
  }
}

/anthropic 是网关的 Anthropic 兼容接口。Claude Code 把 Messages API 请求发到 /anthropic/v1/messages，把 token 计数请求发到 /anthropic/v1/messages/count_tokens。对于没有配置 /anthropic 前缀的客户端，同样的端点也可以通过 /v1/messages 访问。

顶层的 model 设置是可选的。它决定初始使用的模型，之后也可以用 /model 换。

客户端这边的细节——某个版本的 Claude Code 读哪些变量、请求超时是多少、只改 settings.json 够不够——都由 Claude Code 决定，与网关无关。具体请看 Anthropic 最新的 LLM 网关、模型配置和安装文档。

模型家族与别名

Claude Code 请求模型时用的是 Anthropic 的名称，例如 claude-sonnet-4-6，而不是网关的模型 id。网关在查找模型之前，会先转换它认识的名称：

Claude Code 发送	网关查找
`claude-sonnet-4-6`, `claude-sonnet-4-5`, `claude-3-5-sonnet-latest`, `claude-3-5-sonnet-20241022`, `claude-3-5-sonnet-20240620`	`claude-sonnet-4.6`
`claude-opus-4-7`, `claude-3-opus-latest`	`claude-opus-4.7`
`claude-opus-4-6`, `claude-3-opus-20240229`	`claude-opus-4.6`

所以，部署方要注册的是右栏中的 id——作为模型 id，或者写进该模型的 aliases:——而不是 Claude Code 发送的那个。直接注册 claude-sonnet-4-6 只会得到 404。其他 id 会原样透传，按发送时的名字查找。并不是每个部署都提供这些模型，所以请先查一下 GET /v1/models。

当用户选用长上下文变体时，Claude Code 会在 id 后面加一个标记（claude-sonnet-4-6[1m]）。网关在查找之前会先去掉它，所以不需要注册带方括号的形式。

如果要显式指定 Claude Code 各个模型家族对应的模型，可以把下面这些受支持的变量按需加进同一个 env 块：

{
  "ANTHROPIC_DEFAULT_OPUS_MODEL": "<gateway-model-id>",
  "ANTHROPIC_DEFAULT_SONNET_MODEL": "<gateway-model-id>",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<fast-gateway-model-id>"
}

Haiku 这一项用于 Claude Code 较小的后台调用。网关并不读取这些变量——Claude Code 在本地解析它们，只把解析出的 id 发过来——所以你的版本支持哪些变量，以上面链接的 Anthropic 模型配置文档为准。

使用与验证

cd your-project
claude

用 /status 确认当前生效的模型和网关配置，用 /model 换模型。只要选中的网关模型支持所需的工具调用，工具使用、文件编辑、搜索等本地 agent 功能都照常可用。

这些设置只影响模型推理，而且只对这台机器上的 Claude Code 生效。Anthropic 托管的产品功能不属于网关实现的 Messages API；其他地方的 Claude 会话——网页版、别的客户端——都不会读这份本地配置。

故障排查

报错	原因	处理
401 认证错误	API key 不对	检查 `~/.claude/settings.json` 里的 `ANTHROPIC_AUTH_TOKEN`
404 找不到模型	网关没有为最终的模型 id 注册任何路由，或者你的 key 所属的角色看不到这个模型	查 `GET /v1/models`（它会列出你的 key 能访问的模型），再更新 `model` 或对应的 `ANTHROPIC_DEFAULT_*_MODEL`
429 被限流	请求过多	等一会儿再重试
503 没有可用的 provider	模型解析出来了，但它的路由目前没有一条能提供服务	重试，或换一个模型
504/超时	网关或上游的请求超过了时限	先查网关健康状况，确有必要时再调整超时

卸载

从 ~/.claude/settings.json 中删掉网关专用的 model 值，以及 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_DEFAULT_*_MODEL 这几个键。文件里与此无关的其他 Claude Code 设置和环境变量要保留。之后 Claude Code 就会恢复直连 Anthropic。