Claude Code 接入国内模型最佳实践：用 free-claude-code 和 cc-switch 双剑合璧

大家好，我是蓝戒，本篇我们来聊聊：“Claude Code 如何更好的接入国内模型”。

为什么国内开发者用 Claude Code，总像在闯关？

Claude Code 很强。

它能读项目、改代码、跑命令、写测试、查 Bug，像一个住在终端里的 AI 程序员。问题是，国内开发者真正上手时，经常不是卡在“怎么写代码”，而是卡在“怎么稳定用”。

常见痛点基本就这几个：

• 账号不稳：注册、登录、风控、封号风险都让人头大。
• 网络不稳：连接失败、请求重试、TLS 报错，时不时给你来点惊喜。
• 额度缩水：刚用顺手，额度就不够了。
• Token 太贵：让它读个项目，费用像开了小水龙头。
• 配置麻烦：今天换 DeepSeek，明天换 Qwen，后天换 GLM，配置文件改到怀疑人生。

所以，国内使用 Claude Code 的核心思路不应该是“找一个临时能用的接口”，而是搭一套稳定、可切换、可维护的工作流。

这篇文章就分享一套更适合长期使用的方案：

Claude Code + free-claude-code + cc-switch + 国内模型。

简单说：Claude Code 负责干活，国内模型负责出力，free-claude-code 负责转发适配，cc-switch 负责配置管理和一键切换。

先理解这几个工具分别干什么

Claude Code 是入口。

你依然在项目目录里输入 claude，让它读取代码、理解项目、生成方案、修改文件、运行命令。

free-claude-code 更像一个中间代理。

它可以把 Claude Code 发出的请求转到其他模型服务上，让你不必只依赖官方模型。你可以接入国内模型，也可以接入其他兼容接口，甚至按不同模型角色做映射。

cc-switch 则是配置管家。

它把原本需要手动修改的 API Key、Base URL、模型名称、Provider 配置、本地代理等内容，放到一个可视化界面里管理。你不用每次都打开隐藏目录找 settings.json，也不用担心多改一个逗号导致整套配置报废。

可以这样理解：

Claude Code 是车，国内模型是发动机，free-claude-code 是变速箱，cc-switch 是仪表盘和中控台。

车能不能跑，发动机很重要；但想长期开得舒服，中控也不能太寒酸。

推荐架构：别裸连，先加一层代理和管理

比较推荐的使用架构是：

开发者
  ↓
Claude Code
  ↓
free-claude-code / 本地代理
  ↓
国内模型服务

同时用 cc-switch 管理不同 Provider：

cc-switch
  ├─ 日常编程模型
  ├─ 复杂推理模型
  ├─ 便宜快速模型
  ├─ 备用模型
  └─ 本地或实验模型

这样做的好处很明显。

第一，Claude Code 的使用方式不变。你还是在终端里正常使用，不需要换一套操作习惯。

第二，模型可以随时替换。今天某个服务限流了，直接切换备用 Provider，不用停工。

第三，配置更清楚。以前排查问题像算命，现在至少能明确看到当前启用的是哪个模型、哪个 API、哪个代理。

第四，成本更好控制。简单任务用便宜模型，复杂任务再上推理模型，不让高价模型去干“改按钮文案”这种小活。

第一步：安装 Claude Code

如果你还没安装 Claude Code，可以通过 npm 安装：

npm install -g @anthropic-ai/claude-code

安装后检查版本：

claude --version

进入测试项目目录后启动：

claude

第一次使用时，Claude Code 可能会询问是否信任当前目录。建议先用一个测试项目练手，不要一上来就在公司核心仓库里开全自动模式。

AI 很强，但它不是你项目的 CTO。尤其是第一次见面，别直接把生产权限交出去。

第二步：配置 free-claude-code

free-claude-code 的作用，是让 Claude Code 可以通过兼容代理调用其他模型。

它通常需要配置 Provider、API Key、模型名称等信息。具体安装命令建议以项目最新文档为准，因为这类工具更新比较快。

配置时不要只想着“填一个模型能跑就行”，更推荐按角色分层：

PROVIDER=your_provider
API_KEY=你的_API_Key
MODEL=默认模型
MODEL_HAIKU=快速便宜模型
MODEL_SONNET=日常主力模型
MODEL_OPUS=复杂推理模型

模型名称不要照抄别人的。

不同平台模型命名不同，接口兼容程度不同，上下文长度和价格也不同。你需要根据自己使用的平台，填入实际可用的模型名称。

配置完成后，先做一个小测试：

请读取当前目录结构，并告诉我这个项目大概是什么类型。

如果能正常返回，说明 Claude Code 到代理，再到模型服务的链路已经跑通。

这一步不要急着让它“重构整个项目”。刚通电就上高速，刺激归刺激，容易翻车。

第三步：用 cc-switch 管理模型配置

如果只用一个模型，手动配置还能忍。

但只要你开始同时用 DeepSeek、Qwen、GLM、Kimi、硅基流动、百炼、魔搭或其他服务，手动改配置就会变成一种折磨。

cc-switch 适合解决这类问题。

它可以保存多套 Provider 配置，并且支持可视化切换。你可以给不同场景建立不同配置：

daily-coding：日常开发
reasoning-heavy：复杂推理
cheap-fast：便宜快速
backup-stable：稳定备用
local-test：本地实验

不要命名成 test1、test2、new-test-final。

这种名字现在看很清楚，三天后你自己都不知道哪个是哪个。

配置 cc-switch 时，基本流程是：

1. 打开 cc-switch。
2. 添加 Provider。
3. 选择预设或手动填写 API 信息。
4. 填入 API Key、Base URL、模型名称。
5. 测试连接。
6. 启用 Provider。
7. 重启终端并运行 claude 验证。

cc-switch 的核心价值不是“能填 Key”，而是“能长期管理多套配置”。

你不需要每次切模型都去改 JSON，也不需要担心格式写错。点一下切换，心情都比手改配置文件稳定。

第四步：开启本地代理，切换才真正顺滑

很多人用了 cc-switch 后，发现界面里明明切换了模型，但 Claude Code 好像没反应。

这通常和环境变量、代理地址、终端会话有关。

推荐开启 cc-switch 的本地代理能力，让 Claude Code 统一请求本地代理，再由 cc-switch 转发到当前选中的 Provider。

这样结构更清楚：

Claude Code
  ↓
127.0.0.1 本地代理
  ↓
当前启用的模型 Provider

如果需要手动设置环境变量，形式通常类似：

export ANTHROPIC_BASE_URL="http://127.0.0.1:你的端口"
export ANTHROPIC_AUTH_TOKEN="你的本地代理 Token"

Windows PowerShell 示例：

$env:ANTHROPIC_BASE_URL="http://127.0.0.1:你的端口"
$env:ANTHROPIC_AUTH_TOKEN="你的本地代理 Token"

注意，端口和 Token 以你本机实际配置为准。

不要看到别人教程里写了一个端口就直接复制。本地端口这种东西，最喜欢和教程不一样。

第五步：模型选择别迷信“最强”，要讲性价比

Claude Code 很费 Token。

它不是普通聊天工具。你让它修一个 Bug，它可能会读文件、分析依赖、查调用链、生成补丁、跑测试、再根据报错继续修。

这很强，也很费。

所以模型选择一定要分层。

简单任务用快速模型。

比如解释代码、改注释、写小函数、格式调整、补类型声明。

日常任务用主力模型。

比如写组件、改接口、生成测试、修复中等复杂度 Bug。

复杂任务用推理模型。

比如架构设计、疑难 Bug、跨模块重构、性能分析、迁移方案。

可以按下面这个思路配置：

任务类型	推荐模型角色	典型场景
轻量任务	快速模型	注释、解释、小改动
日常编码	主力模型	写功能、补测试、改接口
复杂推理	推理模型	架构、重构、疑难 Bug
长上下文	长上下文模型	大项目阅读、文档分析

不要让最贵的模型帮你改按钮颜色。

也不要让便宜模型独自面对一个十年历史包浆项目。

前者浪费钱，后者太残忍。

第六步：Claude Code 常用命令要用好

Claude Code 好不好用，很大程度取决于你会不会控制上下文。

进入项目后，建议先运行：

/init

它会分析项目，并生成或更新项目说明文件。后续 Claude Code 会参考这些信息理解项目。

任务做了一段时间后，使用：

/compact

这个命令可以压缩上下文，减少 Token 消耗，也能降低长对话带来的干扰。

开始新任务前，使用：

/clear

它可以清空当前对话上下文，让模型从一个更干净的状态开始。

很多人用 AI 编程效果不好，不是模型不行，而是上下文已经乱成一锅粥。

上一轮还在修登录页，下一轮突然让它改数据库迁移，中间不清理上下文，模型当然容易带着“前任记忆”胡乱发挥。

第七步：写好 CLAUDE.md，少花冤枉 Token

建议每个项目都维护一个 CLAUDE.md。

这个文件相当于写给 Claude Code 的项目说明书。你可以把项目结构、开发规范、禁止事项、测试命令都写进去。

示例：

# 项目说明

这是一个基于 TypeScript 的前端管理后台项目。

## 开发规则

- 不要修改 public/config.json，除非明确要求。
- 所有业务组件放在 src/components/business。
- API 请求统一使用 src/services/request.ts。
- 修改功能后优先运行相关测试。
- 大改动前先输出方案，不要直接修改文件。

这类说明能减少重复解释，也能让 Claude Code 更稳定地按你的项目习惯工作。

没有 CLAUDE.md，它只能靠猜。

有了 CLAUDE.md，至少它猜错时，你还能理直气壮地说：我文档里写了。

第八步：提需求要具体，不要只说“优化一下”

很多人喜欢这样提需求：

帮我优化一下这个项目。

这句话看似简洁，实际非常危险。

“优化”可以是性能优化、代码结构优化、命名优化、UI 优化、依赖优化，也可能被模型理解成“我来大改一通”。

更好的写法是：

请分析 src/api/user.ts 中的登录逻辑。
目标：
1. 保持现有入参和返回结构不变；
2. 增加错误处理；
3. 补充单元测试；
4. 修改前先给出方案，不要直接改文件。

再比如：

请帮我重构订单状态流转逻辑。
要求：
1. 先分析当前实现；
2. 列出风险点；
3. 给出修改方案；
4. 等我确认后再动代码。

AI 编程最怕的不是模型写得慢，而是它非常自信地写错。

你需求越具体，它越不容易跑偏。

第九步：权限控制别太激进

Claude Code 可以读文件、改文件、执行命令。

这意味着它效率很高，也意味着它需要权限边界。

新手建议按这个节奏来：

先只读分析
  ↓
允许生成方案
  ↓
允许修改局部文件
  ↓
允许运行测试
  ↓
最后再考虑更自动化的模式

不要一上来就全自动。

尤其遇到这些内容，要格外小心：

rm
sudo
delete
reset
migration
deploy
overwrite
.env
private key
production config

看到这类操作，建议人工确认。

AI 是助手，不是背锅侠。真删了文件，最后还是你来修。

第十步：成本控制，重点不是省，而是别浪费

想控制 Claude Code 的使用成本，重点有四个：

第一，减少无关文件读取。

依赖目录、构建产物、日志文件、大型二进制文件，不要让 AI 随便扫。

第二，及时压缩上下文。

长对话用 /compact，新任务用 /clear。

第三，按任务切模型。

简单任务用便宜模型，复杂任务才用推理模型。

第四，把项目规则写进 CLAUDE.md。

不要每次都重复告诉它项目结构、技术栈、命令规范。

Token 不是水龙头。

但如果你不控制上下文，它花起来真的像没关水龙头。

第十一步：常见问题快速排查

如果提示 claude: command not found，先检查 Claude Code 是否安装成功，以及 npm 全局路径是否加入 PATH。

如果请求一直失败，优先检查四件事：

API Key 是否正确
Base URL 是否正确
模型名称是否正确
本地代理是否启动

如果 cc-switch 切换后不生效，尝试重启终端，并确认环境变量是否指向当前代理地址。

如果模型回答质量很差，先别急着换工具。检查任务描述是否清楚，项目说明是否完整，是否选错了模型，是否上下文太乱。

如果 Token 消耗过快，检查是否读取了过多无关文件，是否长对话没有压缩，是否所有任务都走了高价模型。

很多问题不是工具坏了，而是配置链路里有一环没对上。

推荐日常工作流

实际使用时，可以按这个流程来：

进入项目目录
  ↓
启动 claude
  ↓
执行 /init 或确认 CLAUDE.md 已更新
  ↓
提出一个明确的小任务
  ↓
要求先给方案，不要直接改
  ↓
确认方案后允许修改
  ↓
运行测试
  ↓
人工 Review diff
  ↓
使用 /compact 压缩上下文
  ↓
进入下一个任务

这个流程看起来比“直接让 AI 全自动写完”慢。

但真实开发里，它通常更快。

因为返工少，风险低，代码更可控。

AI 编程不是让模型替你胡乱冲锋，而是让它在你的节奏里高效执行。

最佳实践配置清单

如果你准备长期使用 Claude Code，可以按这份清单整理：

基础工具：
- Claude Code：负责项目交互和代码操作
- free-claude-code：负责兼容代理和模型转发
- cc-switch：负责 Provider 管理和模型切换

模型配置：
- 快速模型：处理轻量任务
- 主力模型：处理日常开发
- 推理模型：处理复杂问题
- 备用模型：应对限流和异常

项目配置：
- CLAUDE.md：写清项目规则和注意事项
- 忽略规则：排除敏感文件和无关目录
- 权限边界：默认先分析，再修改

使用习惯：
- 新项目先 /init
- 长对话用 /compact
- 新任务用 /clear
- 大改动先出方案
- 所有修改必须 Review

这套配置不追求花哨，只追求稳定。

因为真正能提高效率的，不是今天偶尔跑通一次，而是每天都能稳定使用。

写在最后

Claude Code 的强大，不在于它能陪你聊天，而在于它能真正参与开发流程。

但在国内环境下，直接使用经常会遇到账号、网络、额度、成本和配置问题。与其每天和这些问题斗智斗勇，不如从一开始就搭一套更稳的工作流。

free-claude-code 解决代理和兼容问题。

cc-switch 解决配置和切换问题。

国内模型解决可用性和成本问题。

Claude Code 继续负责最核心的编码体验。

工具不必神秘，配置不必玄学。把链路理顺，把模型分层，把权限管好，把上下文控制住，Claude Code 就能从“折腾玩具”变成真正的生产力工具。

跑通一次靠运气。

长期好用，靠体系。