确认配置适用场景

ANTHROPIC_BASE_URL 决定 Claude Code 的 Anthropic 格式请求发到哪里。只有当你不走 Anthropic 官方默认入口,而是改用 DeepSeek、企业代理、本地转发或其它 Anthropic-compatible 网关时,才需要主动设置它。

这个变量不是 OpenAI SDK 里的 baseURL。OpenAI-compatible 只说明服务端能接 OpenAI Chat Completions,不说明它能接 Claude Code 发出的 Anthropic Messages 请求。把 OpenAI 入口填进这里,常见结果是 404、unsupported parameter 或 model not found。

选择供应商 Anthropic 入口

先确认你准备用哪家供应商。Claude Code 走第三方模型时,ANTHROPIC_BASE_URL 要填这家供应商提供的 Anthropic-compatible 入口,ANTHROPIC_AUTH_TOKEN 要填同一家供应商的 API Key。

先在当前 PowerShell 里只放入口和 Key。下一步再启动 Claude Code。真实 API Key 不要粘到聊天记录、截图或仓库里。

DeepSeekhttps://api.deepseek.com/anthropic
GLMhttps://open.bigmodel.cn/api/anthropic
MiniMax 国际区https://api.minimax.io/anthropic
MiniMax 中国区https://api.minimaxi.com/anthropic
PowerShell
$env:ANTHROPIC_BASE_URL="<供应商的 Anthropic-compatible 入口>"
$env:ANTHROPIC_AUTH_TOKEN="<你的 API Key>"

以上入口截至 2026-06-04 复查自官方文档。供应商更新文档后,优先按当前官方入口填写。

核对 Key 和模型名来源

如果你用 DeepSeek,base URL、API Key 和模型名都按 DeepSeek 文档来。不要拿 DeepSeek 的入口配 GLM 或 MiniMax 的模型名。

如果你用 GLM,base URL 填 GLM 的 Anthropic 入口,模型档位也按 GLM 文档里的 OPUS、SONNET、HAIKU 映射来。

如果你用 MiniMax,先按账号区域选择国际区或中国区入口,再使用 MiniMax 文档里当前支持的 Claude Code 模型名。

入口、Key、模型名只要有一个来自别的供应商,错误就可能表现成 401、model not found 或请求格式不支持。

启动 Claude Code 验证配置

配置放进当前 PowerShell 后,再在同一个窗口启动 Claude Code。这里的 claude 是读取配置并发起会话的程序,不是 ANTHROPIC_BASE_URL 的一部分。

成功标准不是 CLI 没有立刻退出,而是 Claude Code 能进入会话,并且首轮问题能从当前供应商对应模型返回。

PowerShell
claude

排除常见入口误填

如果你已经设置了 ANTHROPIC_BASE_URL 但 Claude Code 仍然报错,先对照下面三种写法。它们都很常见,而且错误日志不一定会直接指出入口填错。

把 OpenAI 格式入口填进 ANTHROPIC_BASE_URL

例如 DeepSeek 的 https://api.deepseek.com 能给 OpenAI SDK 用,但不代表 Claude Code 能用。Claude Code 需要供应商提供的 Anthropic-compatible 入口。

在正确入口后面手动追加 /v1/messages

Claude Code 会按自己的 Anthropic 请求格式拼路径。你多写一段,最终请求可能落到不存在的 URL。

看到 OpenAI-compatible 就直接套用

Claude Code 要的是 Anthropic-compatible、Anthropic API 或 Messages format。只写 OpenAI-compatible 的网关,需要先确认是否另有 Anthropic 入口。

检查当前会话入口和 Key

ANTHROPIC_BASE_URL 只决定请求发到哪里,不负责鉴权。第三方 Anthropic-compatible 入口通常还需要 ANTHROPIC_AUTH_TOKEN。Claude Code 会把这个值作为 Authorization Bearer Token 发送,所以变量值里只放 Key,不要手动写 Bearer。

如果你同时设置了 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和官方 Anthropic 登录态,要先确认自己想走哪条链路。配置冲突时,CLI 可能仍能启动,但请求会发到你没预期的服务。

PowerShell
$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_AUTH_TOKEN.Length

恢复 Anthropic 官方默认入口

如果你的目标是直连 Anthropic 官方服务,通常不需要主动设置 ANTHROPIC_BASE_URL。保留旧的 ANTHROPIC_BASE_URL 反而会把请求转到第三方网关。

排查“明明登录了官方账号却请求异常”时,先检查当前 shell 有没有残留这个变量。需要回到官方默认链路时,开一个干净终端,或者清掉当前会话里的 ANTHROPIC_BASE_URL。

PowerShell
$env:ANTHROPIC_BASE_URL

核对代理网关配置

换成 LiteLLM、OpenRouter、内部代理或本地转发时,不要只替换 URL。先确认这五项:文档是否明确支持 Anthropic Messages、根路径是否已经包含供应商前缀、鉴权变量用 Token 还是 API Key、模型名是否需要映射、网关是否会自动拼接 /v1/messages。

如果其中任意一项不确定,先不要改完整配置。用最小入口和 Key 验证,再逐项加入模型名、代理和子任务配置。这样失败时能知道是哪一层坏了。

Text
接口格式:Anthropic Messages / Anthropic-compatible
根地址:不要猜,照网关文档填写
鉴权:确认使用 ANTHROPIC_AUTH_TOKEN 还是其它变量
模型名:确认是否需要网关别名
路径拼接:不要重复追加 /v1/messages

按错误类型定位配置层级

404 通常先查入口路径。最常见原因是把 OpenAI 入口、错误区域入口或重复路径填进 ANTHROPIC_BASE_URL。

unsupported parameter 通常说明你接到的不是 Anthropic-compatible 入口,服务端按 OpenAI 格式解析了 Anthropic Messages 字段。

model not found 不一定是模型名真的不存在。入口格式错、网关没有模型映射、模型名来自旧教程,都会落到这个表现。

参考来源

Claude Code 环境变量文档官方文档DeepSeek Anthropic API 文档官方文档GLM Claude Code 文档官方文档MiniMax Claude Code 文档官方文档

相关文章

Claude Code 接入 DeepSeek API:配置方法和报错处理智能编程 / 约 20 分钟Claude Code model not found 错误排查步骤错误日志 / 约 12 分钟DeepSeek Anthropic API 404 错误排查步骤错误日志 / 约 12 分钟