配 Claude Code 最常见的卡点不是装不上,是把 ANTHROPIC_BASE_URL 填错了还不知道——
报错信息只会说连不上,不会告诉你是地址写错、还是这个地址压根没有 Anthropic 格式的接口。
先给结论,赶时间的只看这一条命令:
curl -s https://端点地址/v1/models | head -c 300一定要带 head -c 300——只看 HTTP 状态码会漏掉下面第二种情况。
多数兼容端点这个接口不带 key 也会回话,而返回什么,比返回码更重要:
返回 | 含义 | 你该做什么 |
|---|---|---|
200 + 一串模型 ID(JSON) | 地址对,模型清单还能直接看 | 填进 |
200 + 一段 HTML | 假信号——你打到的是网站首页,不是 API | 地址错了,别被 200 骗 |
401 / 403 + 提示缺 key | 地址对,接口在,只是要鉴权 | 填进去,配好 key 再试 |
404 | 这个路径下没有这个接口 | 别再调 key 了,先把地址查对 |
两条最值钱的:401 说明你找对门了,404 说明你敲错了门;
而200 也可能是错的——所以这条命令一定要带上 head -c 300 看内容,
只看状态码会被骗过去。很多人卡在「key 明明是对的却一直连不上」,实际是地址的问题。
下面是当天跑出来的原始结果,没有一条是从别处抄的。这些接口不需要账号,
你现在就能自己复现。注意其中两对是同一家的不同路径——差一截,结果完全不同。
端点 | HTTP | 返回内容 |
|---|---|---|
| 401 |
|
| 401 |
|
| 200 |
|
| 401 |
|
| 404 |
|
| 200 | 直接返回 16 个模型 ID |
第三行是本文最该被记住的一条。 它返回 200,但内容是一段 HTML 网页——
因为 /v1/models 在那个域名下不是 API 路径,请求落到了站点的网页路由上。
如果你的检测脚本只判 status == 200,它会告诉你「这个端点可用」,
然后你带着一个错地址去调 key,报错信息会把你引向完全错误的方向。
第五行则说明「同一家的两个路径,一个对一个错」:
api.siliconflow.cn/v1/models 是 401(接口在),加上 /anthropic 反而 404。
不同服务把兼容层挂在不同路径上,没有统一规律,只能一个一个试。
这正是要自己跑一次命令、而不是照抄教程的理由:路径会变,
教程和 AI 的回答会把过期写法一直传下去,而 404 和那段 HTML 不会骗人。
/v1/models 是 Anthropic 与 OpenAI 两套协议都定义的「列出可用模型」接口。
一个服务如果声称兼容 Anthropic 格式,它就该实现这个接口。所以:
判断顺序是先看协议兼容性,再看模型能力、价格、稳定性——
后面几项都建立在「地址是对的」之上,顺序反了会白测。
/v1/models 也做了鉴权,
那你只会拿到 401——那是正常的,401 本来就算通过。不管选哪家,接入方式是一样的:
export ANTHROPIC_BASE_URL=https://你查对的端点地址
export ANTHROPIC_AUTH_TOKEN=你的key写进 ~/.bashrc 或 ~/.zshrc 后 source 一下。三个常见的不生效原因:
~/.bashrc 但你用的是 zsh(macOS 默认)source,也没开新终端~/.claude/settings.json 里有残留的旧值在覆盖环境变量先用 echo $ANTHROPIC_BASE_URL 确认变量真的生效了,再去怀疑别的。
如果一家服务要你装专用客户端、或者要改的东西超过这两个变量,
说明它没做到协议兼容——换服务时的迁移成本会很高,这一点在选之前就该问清楚。
上面表格里唯一直接返回模型列表的是 flex-api.code2ai.codes,
这里说明一下它的实际配置,你可以拿前面几节的标准去对照:
Code2AI Flex(flex-api.code2ai.codes):一个 Key 切 Claude 全系、GPT 全系、
Kimi K3、GLM、DeepSeek、Grok 六家,额度共享不按模型分账;限速窗口 5 小时与 7 天两档,
从该周期首次请求起算;支持微信与支付宝,不需要海外信用卡;7 天内可申请退款;
运营主体 STRATOS AI PTE. LTD.(新加坡 UEN 202626587R,可在 ACRA 检索)。
export ANTHROPIC_BASE_URL=https://flex-api.code2ai.codes
export ANTHROPIC_AUTH_TOKEN=你的key利益披露:本文作者本人就在做这一类服务,所以这一节的具体数字你不必信——
要信的是第一节那条命令。它对任何一家都成立,包括对本文作者。
上面每一项都写了「怎么自己验」,请对你正在考虑的每一家都跑一遍。
它不适合谁,说在前面:
/v1/models 返回 200 或 401 的端点,
两个环境变量填完就能开始,别在选型上耗超过半小时Q:/v1/models 返回 401,是不是这家不能用?
不是。401 说明接口存在、只是要鉴权,这算通过。真正的坏消息是 404。
Q:ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 有什么区别?
不同版本、不同接入方式下要求不同。一个不行就试另一个,或者两个都设成同一个值。
这是最常见的配置失败原因之一。
Q:本机开了代理,请求一直失败怎么办?
报 Failed to connect to 127.0.0.1 port xxxxx 就是代理干扰。
临时 unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY,
或者把端点域名加进 NO_PROXY。
Q:怎么确认我付费的模型和实际跑的是同一个?
/v1/models 只能看清单。要验证实际模型,拿一道有标准答案、且不同模型行为有差异的题
去问——比如看它会不会输出思考过程。响应体里的 model 字段是服务端填的,不能单独作数。
Q:这份实测结果多久会过期?
端点地址是会变的,本文数据是 2026 年 9 月 4 日跑的。
所以本文给的是命令,不是清单——清单会过期,命令不会。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。