用 cc switch 配置国内大模型

国内用户使用 Claude Code 时，可以优先把官方模型、国内主力网关、备用网关做成 cc switch 配置档，通过切换配置来管理模型，而不是反复手改项目文件。

cc switch 这类切换器适合解决一个很现实的问题：国内用户可能同时有官方 Claude、国内网关、团队网关、备用模型几个配置。如果每次都手动改环境变量，很容易改错、泄露密钥，或者忘记当前到底用的是哪个模型。

更稳定的做法是：把每个模型来源做成独立配置档，需要时切换。

不需要背配置文件路径，也不要把密钥写进项目仓库。具体工具界面和字段可能随版本变化，重点是配置思路、风险边界和验证流程。

什么时候需要 cc switch

官方 Claude 访问不稳定，需要国内可用方案。
同时有主力网关和备用网关。
团队提供了统一 LLM Gateway。
经常需要在“学习配置”和“真实项目配置”之间切换。
想避免手动改环境变量导致配置混乱。

不一定需要 cc switch 的情况：

官方 Claude 一直稳定可用。
只有一个模型来源，而且很少切换。
当前还没完成 Claude Code 基础安装。
还不知道 Base URL、API Key、模型名分别是什么。

配置档	用途	备注
`official-claude`	官方 Claude 配置	学习主线、复杂任务优先使用
`cn-main-coding`	国内主力 coding 网关	日常开发使用
`cn-backup-fast`	国内备用网关	主力限流、余额不足、故障时切换

配置档	用途
`team-gateway`	公司统一网关
`readonly-cheap`	只读分析、文档总结等低成本任务
`high-context`	长上下文、大项目分析

配置前准备什么

从服务商或团队网关那里确认这些信息：

Base URL。
API Key 或 Token。
模型名。
是否支持 Claude Code 需要的请求格式。
是否支持流式输出。
是否支持工具调用或 agent 工作流。
速率限制、余额限制、并发限制。

如果服务商只说“兼容 OpenAI”，还不够。Claude Code 的 agent 工作流对长上下文、流式、工具调用和错误返回都比较敏感，必须做验证。

直接让 CC 帮你准备配置清单

我要用 cc switch 配置 Claude Code 国内模型。

请先帮我整理配置前检查清单，不要让我把密钥发给你。

我会提供：
- 服务商名称：
- Base URL：
- 模型名：
- 是否有 API Key：

请帮我判断：
1. 这些信息是否足够创建配置档。
2. 还缺什么信息。
3. 哪些内容不能写进项目文件。
4. 配置档应该怎么命名。
5. 配置后应该怎么做只读验证。

配置流程

推荐流程：

先确认 Claude Code 已经能正常启动。
准备官方配置档，作为回退方案。
新增国内主力配置档。
填入 Base URL、API Key、模型名等必要字段。
保存配置档。
切换到国内主力配置档。
重启或刷新 Claude Code，使配置生效。
做只读验证。
验证成功后，再做低风险小任务。

不要一配置完就直接改真实项目。先让模型证明自己能稳定工作。

只读验证模板

切换后，用一个不会改文件的任务验证。

请只读验证当前 Claude Code 模型配置是否可用。

要求：
1. 不修改任何文件。
2. 读取当前项目的 README 或目录结构。
3. 总结项目大概是什么。
4. 说明当前回答是否流畅、是否有中断。
5. 如果能看到模型信息，请说明当前模型或配置档。
6. 如果无法确认模型，请说明还需要如何验证。

如果回答很慢、断流、乱码、工具调用失败，先不要进入真实任务。

切换后怎么确认没用错模型

请帮我确认当前模型配置是否符合预期。

要求：
1. 只做只读检查。
2. 不输出任何密钥。
3. 说明当前任务里能确认的模型/配置线索。
4. 如果无法直接确认，请给出低风险验证方法。
5. 不要修改配置文件。

很多工具不会直接暴露完整密钥或配置，这是好事。验证重点是“当前模型是否能稳定完成 CC 工作流”，不是把敏感配置打印出来。

常见问题

问题	常见原因	处理方式
切换后无响应	Key 错、Base URL 错、服务商故障	切回官方档或备用档，只读验证
回复到一半中断	流式不稳定、网关超时	换备用网关，减少上下文
工具调用异常	网关不完整兼容 agent 工作流	不做真实项目，先换服务
模型答非所问	模型能力不足或上下文太短	用更强模型或切回官方
不知道当前用哪个配置	切换后没刷新、配置档命名混乱	重新切换并做只读验证

安全边界

API Key 不写进项目代码。
API Key 不写进 Markdown 教程。
不把真实密钥发给 CC。
不把配置文件提交到公开仓库。
团队网关的地址、规则和额度要听团队管理员要求。
配置失败时不要把所有密钥都复制到聊天里让 CC 猜。

验收结果

你知道什么时候需要 cc switch。
你知道配置档应该怎么设计。
你知道配置前要准备 Base URL、Key、模型名和兼容性信息。
你知道配置后必须先做只读验证。
你知道密钥不能进入项目和对话。

返回：接入国内大模型下一篇：第一次任务