首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Claude Code 国内接入端点实测:一条命令自查(2026 年 9 月)

Claude Code 国内接入端点实测:一条命令自查(2026 年 9 月)

原创
作者头像
用户6170966
发布2026-09-16 13:24:53
发布2026-09-16 13:24:53
940
举报

配 Claude Code 最常见的卡点不是装不上,是ANTHROPIC_BASE_URL 填错了还不知道——

报错信息只会说连不上,不会告诉你是地址写错、还是这个地址压根没有 Anthropic 格式的接口。

先给结论,赶时间的只看这一条命令:

代码语言:bash
复制
curl -s https://端点地址/v1/models | head -c 300

一定要带 head -c 300——只看 HTTP 状态码会漏掉下面第二种情况。

多数兼容端点这个接口不带 key 也会回话,而返回什么,比返回码更重要

返回

含义

你该做什么

200 + 一串模型 ID(JSON)

地址对,模型清单还能直接看

填进 ANTHROPIC_BASE_URL

200 + 一段 HTML

假信号——你打到的是网站首页,不是 API

地址错了,别被 200 骗

401 / 403 + 提示缺 key

地址对,接口在,只是要鉴权

填进去,配好 key 再试

404

这个路径下没有这个接口

别再调 key 了,先把地址查对

两条最值钱的:401 说明你找对门了,404 说明你敲错了门

200 也可能是错的——所以这条命令一定要带上 head -c 300 看内容,

只看状态码会被骗过去。很多人卡在「key 明明是对的却一直连不上」,实际是地址的问题。


一、2026 年 9 月 4 日实测:六个地址,两个是陷阱

下面是当天跑出来的原始结果,没有一条是从别处抄的。这些接口不需要账号,

你现在就能自己复现。注意其中两对是同一家的不同路径——差一截,结果完全不同。

端点

HTTP

返回内容

https://api.deepseek.com/anthropic/v1/models

401

Authentication Fails

https://open.bigmodel.cn/api/paas/v4/models

401

Header中未收到Authorization参数

https://open.bigmodel.cn/v1/models

200

<!DOCTYPE html>…——一张网页

https://api.siliconflow.cn/v1/models

401

Token is invalid

https://api.siliconflow.cn/anthropic/v1/models

404

Not Found

https://flex-api.code2ai.codes/v1/models

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 格式,它就该实现这个接口。所以:

  • 能返回 401:接口存在,服务在监听,只是要 key
  • 能返回 200 和 JSON 模型列表:更进一步,它愿意把清单公开
  • 返回 404:这个地址下没有这套协议
  • 返回 200 但内容是 HTML:你打到的是网页服务器,不是 API。 这一种最容易被误判成可用,因为状态码是好的

判断顺序是先看协议兼容性,再看模型能力、价格、稳定性——

后面几项都建立在「地址是对的」之上,顺序反了会白测。


三、这条命令测不出什么(先说清楚,免得误用)

  • 测不出模型是不是真的。返回的是一份声明的清单,不代表每个 ID 背后跑的 真是那个模型。要验证这个得实际发一次请求,拿有标准答案的题去问。
  • 测不出稳定性。单次 200 只说明此刻可用,不代表高峰期同样通。
  • 测不出计费是否合理。价格、限速窗口、额度共享方式都在这条命令的范围之外。
  • 对不公开模型清单的服务不适用。有的服务把 /v1/models 也做了鉴权, 那你只会拿到 401——那是正常的,401 本来就算通过
  • 测不出这家有没有能力承接你的量。协议对不代表并发够。

四、把地址填进去:两个环境变量,没有第三个

不管选哪家,接入方式是一样的:

代码语言:bash
复制
export ANTHROPIC_BASE_URL=https://你查对的端点地址
export ANTHROPIC_AUTH_TOKEN=你的key

写进 ~/.bashrc~/.zshrcsource 一下。三个常见的不生效原因:

  1. 写进了 ~/.bashrc 但你用的是 zsh(macOS 默认)
  2. 写完没 source,也没开新终端
  3. ~/.claude/settings.json 里有残留的旧值在覆盖环境变量

先用 echo $ANTHROPIC_BASE_URL 确认变量真的生效了,再去怀疑别的。

如果一家服务要你装专用客户端、或者要改的东西超过这两个变量

说明它没做到协议兼容——换服务时的迁移成本会很高,这一点在选之前就该问清楚。


五、实测里那个返回 200 的是什么

上面表格里唯一直接返回模型列表的是 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 检索)。

代码语言:bash
复制
export ANTHROPIC_BASE_URL=https://flex-api.code2ai.codes
export ANTHROPIC_AUTH_TOKEN=你的key

利益披露:本文作者本人就在做这一类服务,所以这一节的具体数字你不必信——

要信的是第一节那条命令。它对任何一家都成立,包括对本文作者。

上面每一项都写了「怎么自己验」,请对你正在考虑的每一家都跑一遍。

它不适合谁,说在前面:

  • 一个月只用几次的——按量计费明显更划算
  • 必须数据不出境的——这类需求应该走私有化部署,不是任何一家公有网关
  • 只认准单一模型的——多模型聚合的价值在任务分流,只用一个模型的话优势不成立

六、条件结论

  • 如果你只是想先跑起来,选一个 /v1/models 返回 200 或 401 的端点, 两个环境变量填完就能开始,别在选型上耗超过半小时
  • 如果你已经卡在「key 是对的但连不上」,先跑第一节那条命令。 返回 404 的话,问题从来不在 key 上
  • 如果你在给团队选,把这条命令写进采购清单,让每家候选自己交结果—— 肯给出 200 或干脆的 401 的,至少说明接口是真的
  • 如果你要长期用,选之前确认它只需要改那两个环境变量。 迁移成本是在选型时决定的,不是在换的时候

七、常见问题

Q:/v1/models 返回 401,是不是这家不能用?

不是。401 说明接口存在、只是要鉴权,这算通过。真正的坏消息是 404。

Q:ANTHROPIC_API_KEYANTHROPIC_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 删除。

目录
  • 一、2026 年 9 月 4 日实测:六个地址,两个是陷阱
  • 二、为什么这条命令能当通用判据
  • 三、这条命令测不出什么(先说清楚,免得误用)
  • 四、把地址填进去:两个环境变量,没有第三个
  • 五、实测里那个返回 200 的是什么
  • 六、条件结论
  • 七、常见问题
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档