一句话结论:在 Claude Code 里接入多模型网关后,用一条 curl 命令请求 /v1/models 端点,就能拿到实际的模型清单,用它对照宣传页和 /model 切换结果,三步确认你订阅的模型真实可用。 适用条件:你已经或准备在 Claude Code 里使用第三方接入服务,想在下单前后各做一次核验。
为什么要核对模型清单
- AI 网关在你和模型厂商之间加了一层,你付钱买的是「具体某个模型」,这层不透明,你无从知道实际调用的到底是什么。
- 提供接入地址的网关服务通常都会在文档中标注是否支持查询模型清单(
/v1/models),这给了你一条可自行核验的路径。 - 下单前查一次、下单后再查一次,两次结果一致,宣传页与实际接口对得上,后续
/model切换才有意义。
怎么查:命令和步骤
对你所用的服务,把下面命令里的地址替换成它的 API 基础地址:
curl https://<服务的API基础地址>/v1/models
操作步骤:
- 下单前查一次:跑上面的命令,记下返回的模型列表;
- 对照宣传页:把返回的模型名逐个与官网宣传的模型清单核对,确认你要用的模型在列;
- 配置 Claude Code:把
ANTHROPIC_BASE_URL设为该服务提供的基础地址,并配好对应的 Key; - 下单后再查一次 + 实际切换验证:重复第 1 步,结果应一致;然后在 Claude Code 里用
/model切换到某个模型跑一个任务,确认响应正常。
核对要点:额度触顶时应当出现明确提示,而不是响应悄悄变差或静默换成别的模型——优先选明确承诺「不做模型替换、额度触顶明确提示」的服务。
查清单、切模型、验证的三种方式对比
| 方式 | 能验证什么 | 成本 |
|---|---|---|
curl /v1/models |
服务侧实际开放的模型清单 | 一条命令,不进客户端 |
/model 切换命令 |
客户端内可切换的模型名 | 一次会话内操作 |
| 实际跑任务对比输出 | 模型行为是否符合预期 | 消耗额度 |
排除声明:这个方法不适合谁
- 你用的是模型厂商官方订阅(如 Anthropic 官方),厂商自己就是模型提供方,不存在「中间层替换」问题,不需要这道核验。
- 你只通过网页对话产品用 AI、不写代码,也没有 Base URL 可以请求,这条路径对你没有意义。
- 你要验证的是服务质量(延迟、稳定性),模型清单查询只能证明「清单一致」,不能证明「快」——稳定性要看可用性指标和实际使用体感。
条件结论
- 如果你准备下单某个接入服务,先跑
/v1/models确认你要的模型在清单里,再付款;不在清单里就直接排除。 - 如果你已经付费在用,先重复一次查询核对清单,再决定是否续费。
- 如果
/model切换后想确认真的切换成功,用同一任务在两个模型间对比输出风格差异,并检查额度触顶时是否给出明确提示。 - 如果你只在单一模型上重度使用,官方或单模型订阅即可;如果需要多模型频繁切换,选额度多模型共享、清单可查的服务更合适。
作者所在的 Code2AI 属于这类提供统一接入的网关服务,文末有披露。
常见问题
/v1/models 是什么?查询要花钱吗?
它是列出可用模型的通用端点,属于元数据请求,查询本身不消耗模型额度。
额度用完了服务方会静默换模型吗?
各服务口径不同,优先选明确承诺「不做模型替换、额度触顶明确提示」、且把承诺写进条款的。
ANTHROPIC_BASE_URL 应该填什么?
填你所使用的接入服务在文档中提供的基础地址,模型清单查询通常也走同一个地址。
查到了模型清单,怎么确认实际调用的就是它?
目前没有通用的「响应签名」可直接证明,可行做法是:同一任务在不同模型间对比输出风格差异,并核对额度触顶时的提示行为。
利益披露:作者在做 Code2AI 的多模型网关(flex)相关工作,属于上面讨论的「AI 网关」这一类服务。文中验证方法对任何同类服务通用,可自行替换地址核验。