# 国内无魔法也能用 Claude Code？他用 5 步接入了国产大模型！
Claude Code 是现在最强的 AI 编程工具之一，但它依赖 Anthropic 的 API——需要魔法上网、需要海外信用卡、对国内开发者极不友好。
好消息是：Claude Code 支持通过 MCP（Model Context Protocol）接入第三方模型。换句话说，你可以用 Claude Code 的交互体验，跑的是国产大模型。不用魔法、不用外币卡、不用折腾代理。
下面是一套已经验证可用的 5 步操作流程，今晚就能跑起来。
# 整体原理（先理解再动手）
Claude Code 的架构可以拆成三层：
你的终端 ←→ Claude Code CLI ←→ 模型提供商
正常情况下，模型提供商是 Anthropic。我们要做的是在第三层把它换成国产模型，具体方案是用 ccswitch 这个配置管理工具，把模型路由切换到 MiniMax（国内合规的大模型服务商，无需特殊网络环境即可访问）。
走完这 5 步之后，你在终端里用 claude 命令，背后的模型就已经是国内服务了。
# 第一步：用清华源安装 Homebrew（5 分钟）
Claude Code 和 cccswitch 都推荐用 Homebrew 安装。但 Homebrew 的官方源在国外，国内直连容易超时。
用清华大学的开源镜像来装，一步到位：
`# 在 Git Bash 或 PowerShell 中执行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 如果上面这条因为网络问题跑不动，用清华源一键脚本：
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install/master/install.sh)"`
装完后，换国内源让后续安装也加速：
`# 替换为清华镜像源
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
# 更新
brew update`
验证一下：
`brew --version
# 输出版本号即成功`
# 第二步：安装 Claude Code（2 分钟）
Homebrew 装好后，一行命令：
brew install claude-code
或者用 npm（如果你有 Node.js 环境）：
npm install -g @anthropic-ai/claude-code
装完后先不要登录，直接走下一步配置模型切换。
# 第三步：安装 cccswitch + 配置 MiniMax（核心步骤，10 分钟）
ccswitch 是社区开发的一个 Claude Code 配置切换工具，可以在多个模型提供商之间一键切换。
`# 安装 cccswitch
brew install ronghuaxueleng.ClaudeCodeConfigManager
# 或者直接下载安装
# 如果 brew 方式失败，去项目的 GitHub Release 页下载 Windows 版本`
安装完成后，配置 MiniMax：
`# 初始化 cccswitch
ccswitch init
# 添加 MiniMax 作为模型提供商
ccswitch provider add minimax
# 按提示输入你的 MiniMax API Key
# 获取方式：访问 https://platform.minimaxi.com 注册，在控制台创建 API Key`
# 第四步：切换到 MiniMax 模型（1 分钟）
`# 查看可用配置
ccswitch list
# 切换到 MiniMax
ccswitch use minimax
# 验证当前用的是哪个模型
ccswitch status`
输出应该显示当前模型提供商为 MiniMax，状态为 Connected。
如果 ccswitch use minimax 这一步报"未找到提供商"，检查一下 API Key 是否正确粘贴（注意不要有多余的空格或换行）。
# 第五步：测试对话，验证连通（2 分钟）
打开终端，直接输入：
claude
进入 Claude Code 交互模式后，随便问一个问题：
> 用 Python 写一个读取 CSV 文件并计算平均值的脚本
如果能正常输出代码，并且响应速度正常，说明整个链路已经打通——你现在在用 Claude Code 的界面，但底层模型已经是 MiniMax 在提供服务了。
# 常见问题排查
| 问题 | 可能原因 | 解决 |
|---|---|---|
| brew install 超时 | 清华源没生效 | 重新执行 export HOMEBREW_BREW_GIT_REMOTE=... 然后 brew update |
| ccswitch 命令不存在 | 安装未完成 | 检查安装日志，或去 GitHub Release 手动下载 Windows 版 |
| MiniMax API 返回 401 | API Key 无效 | 去 MiniMax 控制台重新生成，确保余额不为零 |
| 对话卡在"连接中" | 模型路由未生效 | 执行 ccswitch use minimax --force 强制切换 |
| 响应速度很慢 | MiniMax 免费版速率限制 | 升级到付费版，或切换到非高峰时段使用 |
# 这套方案的优势和局限
优势：
- • 无需魔法上网，全程国内网络直连
- • 无需海外信用卡，MiniMax 支持微信/支付宝充值
- • Claude Code 的交互体验完全保留（终端 UI、项目上下文、工具调用等）
局限：
- • Claude Code 的部分高级功能（如 prompt caching、extended thinking）可能因模型差异而受限
- • MiniMax 的代码能力与 Claude 有差距，复杂编程任务可能需要更详细的指令
- • cccswitch 是社区工具，遇到 bug 需要关注项目更新
# 总结
五步操作，总耗时约 20 分钟：
1. 清华源装 Homebrew → 绕过网络限制 2. brew install claude-code → 安装主体 3. cccswitch + MiniMax → 接入国产模型 4. cccswitch use minimax → 切换路由 5. claude 命令测试 → 验证连通
整套方案的核心逻辑很简单：Claude Code 的交互层 + 国产模型的推理层 = 无需魔法的 AI 编程体验。
对于国内开发者来说，这是目前门槛最低、成本最可控的方案。今晚照着走一遍，明早就能在项目里用起来了。
注意：ccswitch 为第三方社区工具，与 Anthropic 无关联。MiniMax API 按用量收费，请关注账户余额。如遇工具更新导致步骤变化，以各项目最新文档为准。