国内模型服务商确认清单
接入国内模型服务前,不要只问能不能聊天。要确认 Anthropic Messages、Base URL、模型名、流式输出、工具调用、上下文、限流、日志和密钥管理。
国内模型接入前,最重要的不是“哪个模型最火”,而是这个服务能不能稳定承接 Claude Code 的 agent 工作流。
这里不评价具体服务商好坏,只提供确认清单。
先问服务商 8 个问题
| 问题 | 为什么重要 |
|---|---|
| 是否支持 Anthropic Messages | Claude Code 不只是普通聊天 |
| Base URL 应该填哪个 | 地址错会导致 404、timeout |
| 模型名是什么 | 猜模型名容易失败 |
| 是否支持流式输出 | 长任务体验和稳定性更好 |
| 是否支持工具调用 | CC 读写文件和运行检查依赖工具链 |
| 上下文长度多少 | 大项目分析需要长上下文 |
| 是否支持 token 统计 | 方便判断上下文和计费 |
| 是否记录请求内容 | 团队和隐私场景必须确认 |
不同服务路线怎么问
国内 Claude / Anthropic 兼容网关
重点确认:
- 是否是 Anthropic Messages 兼容。
- 是否提供
/v1/messages。 - 是否提供
/v1/messages/count_tokens。 - 是否能指定 Claude Code 使用的模型名。
- 是否能稳定流式输出。
国产模型网关
重点确认:
- 网关是否把国产模型转换成 Anthropic 兼容格式。
- 工具调用是否稳定。
- 长上下文是否足够。
- 复杂代码任务是否建议使用更强模型。
- 是否有备用模型和限流策略。
团队 LLM Gateway
重点确认:
- 密钥由谁管理。
- 请求日志保存多久。
- 是否有权限分组和额度限制。
- 是否区分测试、预发、生产。
- 是否允许用于公司代码。
供应商回答怎么判断
| 回答 | 判断 |
|---|---|
| 明确提供 Anthropic Messages 地址 | 可以继续验证 |
| 只说兼容 OpenAI | 不能直接认为适合 CC |
| 模型名需要控制台复制 | 正常,不要猜 |
| 不说明日志策略 | 团队和隐私场景要谨慎 |
| 不支持工具调用 | 不适合完整 CC 工作流 |
| 经常限流或超时 | 只能作为备用,不适合主力 |
发给管理员的清单
我准备把 Claude Code 接入团队模型网关,请帮我确认: 1. 网关是否支持 Anthropic Messages 格式。 2. Claude Code 应该使用的 Base URL。 3. 推荐用于 coding 的模型名。 4. 认证方式和密钥管理方式。 5. 是否支持流式输出、工具调用、长上下文。 6. 是否支持 token 统计或模型列表。 7. 是否记录请求内容,是否允许发送项目代码。 8. 限流、余额、并发和故障时的处理方式。 9. 是否有备用配置。 10. 是否有不允许接入的项目或数据类型。
配置档建议
| 配置档 | 用途 |
|---|---|
official-claude | 官方稳定配置 |
cn-main-coding | 国内主力编码配置 |
cn-backup-fast | 备用快速配置 |
team-gateway | 团队统一网关 |
命名要清楚,后面排障才知道当前用的是哪条路线。
配置后必须验证
请验证当前国内模型配置是否适合 Claude Code。 要求: 1. 不修改文件。 2. 读取项目 README 和目录结构。 3. 总结项目用途和技术栈。 4. 明确区分文件事实和推测。 5. 判断工具调用、上下文和响应稳定性是否足够。 6. 如果不稳定,请建议切回官方或备用配置。
多模型怎么分工
如果网关提供多个模型,不要一开始全都混用:
| 模型类型 | 适合任务 |
|---|---|
| 强编码模型 | Plan Mode、跨文件修改、代码审查 |
| 快速模型 | 摘要、文档、错误解释 |
| 便宜模型 | 轻量问答、格式整理 |
| 备用模型 | 主力限流或故障时临时切换 |
新手阶段优先固定一个稳定主力模型,先跑完整学习路线。
不要这样做
- 不要把 API Key 发给 CC。
- 不要把密钥写进项目文件。
- 不要只验证普通聊天。
- 不要把 OpenAI 兼容当成 Claude Code 兼容。
- 不要用不稳定网关做真实项目重构。
- 不要在不知道日志策略时发送敏感代码。
验收结果
- 已确认协议、Base URL、模型名和认证方式。
- 已确认流式输出、工具调用、上下文和限流。
- 已确认日志和数据合规边界。
- 已用只读项目任务验证模型可用。