集成大模型
认识和安装之后，要先确认 Claude Code 背后使用的模型、账号、额度和网络环境。国内用户尤其要先弄清楚：是用官方 Claude、国内可访问网关，还是团队 LLM Gateway。
这一阶段的学习顺序
01模型配置总览先理解账号、模型、额度、网络和密钥边界。
02接入国内大模型确认 Anthropic Messages、Base URL、模型名和密钥边界。
03模型服务选择判断默认模型、企业云、网关或兼容模型服务怎么选。
04只读验证配置后用项目分析任务验证模型是否稳定。
这一章解决什么
- 确认当前使用的是 Claude 官方模型还是自定义模型服务。
- 理解模型、账号、API Key、Base URL、额度和网络之间的关系。
- 知道什么时候需要配置第三方、国内模型或 LLM Gateway，什么时候不建议折腾。
- 完成一次只读验证，证明模型能正常理解项目上下文。
先不要急着改模型
如果官方账号和网络环境能稳定使用，优先用默认模型跑通前几篇教程。刚开始同时排查安装、权限、模型和项目问题，很容易分不清问题来源。
模型配置要遵循一个原则：先稳定，再优化。只有默认路线跑通后，再考虑国内网关、团队 Gateway 或多模型切换。
| 当前情况 | 建议 |
|---|---|
| 官方账号和网络都稳定 | 先别折腾，直接进入只读项目 |
| 官方网络不稳定 | 再考虑国内网关或团队 Gateway |
| 公司统一接入模型 | 按团队配置，不私自写密钥 |
| 想尝试国产模型 | 先只读验证，再做低风险任务 |
| 经常报错或中断 | 先排查模型链路，不要怪项目代码 |
国内大模型优先用
cc switch 做配置档切换，不建议每次手动改环境变量。Claude Code 更关心网关是否支持 Anthropic Messages、流式输出、工具调用、模型选择和 token 统计。下一篇会按国内场景一步步拆。需要收集的 4 个信息
- Provider：模型服务商是谁。
- Model：具体模型名是什么，不能靠猜。
- Base URL：Claude Code 应该请求的接口地址是什么。
- API Key：密钥从哪里配置，不能写进项目文件。
这 4 个信息要来自服务商控制台、团队文档或可靠配置，不要靠猜：
| 信息 | 常见错误 |
|---|---|
| Provider | 把 OpenAI 兼容服务当成 Anthropic 兼容 |
| Model | 模型名写错或使用过期别名 |
| Base URL | 少路径、多路径、协议不对、网关地址填错 |
| API Key | 写进项目、提交到 Git、发进对话 |
国内模型先走这一篇
如果使用通义千问、DeepSeek、Kimi、智谱、百度千帆、团队自建网关或其他国内模型服务，先不要直接套普通聊天 API。先进入国内模型接入教程，确认服务支持的协议和能力。
不同模型适合做什么
| 任务 | 更适合的模型能力 |
|---|---|
| Plan Mode、架构判断 | 强推理、长上下文 |
| 跨文件修改 | 稳定工具调用、可靠 diff 理解 |
| 文档和模板 | 中文表达稳定、成本可控 |
| 代码审查 | 强代码理解、风险识别 |
| 简单摘要 | 快速便宜模型也可以 |
新手阶段不建议频繁切模型。固定一个稳定配置，把工作流练熟，比每天换模型更重要。
配置前让 CC 帮忙做只读检查
请只读检查当前 Claude Code 模型环境，不要修改任何配置。 请告诉我： 1. 当前能否正常响应。 2. 是否能读取当前项目的少量文件。 3. 是否能区分事实和推测。 4. 如果后续要配置自定义模型，需要准备哪些信息。 5. 哪些信息不能写进项目文件。 不要输出真实 API Key，也不要尝试修改配置。
配置后的最小验收
请做一次只读模型验证。 要求： 1. 不要修改任何文件。 2. 读取项目根目录和 README 或配置文件。 3. 用中文总结项目用途和技术栈。 4. 明确说明哪些结论来自文件，哪些是不确定项。 5. 如果响应明显混乱、遗漏或编造，请提醒模型配置可能不稳定。
配置不稳定时的处理
当前模型配置表现不稳定，请先帮我判断问题来源。 现象： 【中断、乱码、工具调用失败、编造文件、响应很慢等】 请判断： 1. 更像网络、网关、模型能力、上下文长度还是权限问题。 2. 应该先做哪个只读验证。 3. 是否建议切换回官方或备用配置。 4. 不要修改项目代码来掩盖模型问题。
验收结果
- 你知道模型配置应该在正式使用 CC 前完成。
- 你知道 API Key 不能写进项目文件。
- 你能用只读任务验证模型是否可用。