不用“魔法”也能用上最强AI编程助手:Claude Code 国内接入全攻略-夜雨聆风

不用“魔法”也能用上最强AI编程助手:Claude Code 国内接入全攻略

今天这篇文章，就是来帮你彻底解决这个痛点的。

我们不讲虚的，直接手把手教你在不需要任何魔法网络的情况下，在国内用上目前世界上最强的 AI 编程框架——Claude Code。更关键的是，我们要给它装上国产的“最强大脑”，让它真的能把“小龙虾”按在地上摩擦。

Windows 和 Mac 系统全部覆盖，从环境安装到进阶配置，一次性说透。中间需要用到的截图我都给你留好位置了，照着填就行。

第一步：先搞懂一个核心逻辑

在开始折腾之前，有个概念你得分清：一个 AI 编程产品，其实是由外壳（Agent框架）和大脑（大模型）两部分组成的。

外壳（Claude Code）：负责读文件、跑命令、管理项目，充当你的“超级实习生”。
大脑（比如 Claude 模型）：负责思考代码怎么写、Bug 怎么修。

虽然 Claude 官方的那个“大脑”在国内确实用不了，但是Claude Code 这个“外壳”本身是开源的（基于 Anthropic 的 MCP 等开放协议），并不会被封禁。这就给了我们一个完美的“偷梁换柱”机会——保留原版强大的框架，接上我们国产的优秀模型，效果照样逆天。

第二步：搭好你的“外壳”——安装 Claude Code

首先，我们需要在你的电脑上把这个强大的框架装好。这一步很简单，完全不需要魔法。

开始前，请记住这个大前提：

Mac 用户：必须提前装好 Node.js（版本 v18.0 以上）。
Windows 用户：需要装好 Node.js 以及 Git for Windows，这样才能在 Git Bash 里运行命令。

安装步骤（Mac / Windows 通用）：

打开你的终端（Mac）或 Git Bash（Windows），粘贴下面这行命令并回车：

# Mac 有魔法：curl -fsSL https://claude.ai/install.sh | bash# Mac 无魔法：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" ; brew install --cask claude-code@latest# win 前置：winget install Git.Git# win 有魔法：irm https://claude.ai/install.ps1 | iex# win 无魔法：winget install Anthropic.ClaudeCode

耐心等待进度条跑完，整个过程通常不超过两分钟。

装好之后，来验证一下。输入 claude –version，如果蹦出来版本号，就说明外壳安装成功，你可以进行下一步了。

第三步：给你换个“大脑”——用 CC-Switch 接入国产模型

框架准备好了，现在得给它找个真正聪明的“大脑”。这里推荐一个叫 CC-Switch 的图形化工具，它内置了 50+ 供应商预设，选好模型填个 API Key 就完事，不用你手写配置文件。

安装 CC-Switch：

Mac 用户（终端）：

brew tap farion1231/ccswitchbrew install --cask cc-switch

Windows 用户：去 GitHub Releases 下载 .msi 安装包，双击安装。

配置模型（以 GLM-5.1 为例）：

打开 CC-Switch，确认顶部选中的是“Claude”。
点右上角 + 号，在“预设”里选你要用的服务商（或自定义）。
填上 API Key 和模型名，点“添加”，再在主界面点“启用”。

以后想换模型，在 CC-Switch 里再点一下别的卡片就行，终端里不用重启。

第四步：国产生力军——四款经过验证的超强模型

根据最新评测和开发者实测，下面这四款国产模型接上去之后效果最炸裂，各有各的绝活：

DeepSeek V4-Pro：刚刚开源的新旗舰，Agentic Coding 能力达到开源最佳水平，编程体验优于 Sonnet 4.5，交付质量接近 Opus 4.6。1.6T 参数、标配百万 token 上下文，对 Claude Code 有专项适配优化。短板是目前不支持图片输入。
小米 MiMo-V2.5-Pro：专为 Agent 长程执行设计，能稳定支撑超千次工具调用的复杂工程任务。实战案例：4.3 小时全自动从零写了个编译器，拿到满分；11.5 小时肝出 8192 行代码的视频编辑器。Token 效率极高，同等能力水平下比竞品省 40%-60% 的成本。
智谱 GLM 5.1：目前唯一能独立持续工作超 8 小时的开源模型。在最接近真实软件开发的 SWE-Bench Pro 基准中，国产模型首次超越 Claude Opus 4.6；三大代码评测平均成绩位列全球第三、国产第一。能主动分析瓶颈、自我进化，完成从规划到交付的完整闭环。
Kimi K2.6：长程编码能力拉满——能连续编码 13 小时、处理超 4000 行复杂代码。支持 300 个子 Agent 并行协作完成超 4000 个步骤，独立运行最长可达 5 天。前端与设计能力尤为突出，在多项 Agent 评测中超越或持平顶尖闭源模型。

第五步：唤醒你的专属AI程序员

配置搞定了，打开终端，进入项目文件夹，输入：

claude

第一次启动会有一系列初始化设置——颜色主题、安全确认、信任目录，一路回车默认过去就好，直到看到那个能输入指令的对话界面。

第六步：立规矩——编写 CLAUDE.md 文件

很多人装好之后，直接就开干了。但是用着用着就发现，这位新来的“大牛”老是自作主张，写出来的东西总差了点意思,所以要给 Claude Code 立一个规矩。

这个“规矩”，就是 CLAUDE.md 文件。

简单说，每次 Claude Code 启动新会话，都会先读一遍这个文件，把它当作必须遵守的铁律。

怎么写这个文件？

在你的项目根目录下新建一个 CLAUDE.md 文件。我已经为你准备了一个可以直接套用的模板，你只需要把里面标红的部分改成你自己的要求，其他内容甚至可以直接丢给 Claude Code，让它帮你写进去。

一个实战模板参考：

## 关于我[你的名字 / 身份 / 职业背景，非程序员的话一定要写出来]。我用 Claude Code 做 [具体用途 1] 和 [具体用途 2]。## 思维原则所有决策从问题本质出发，不因「惯例如此」照搬。回到问题本身：要解决什么？最直接的路径是什么？从零设计会怎么做？不要谄媚。不要夸我的想法好、不要说「这是个很好的问题」、不要开头加「当然可以」。给我真实判断，方案有问题直接指出来。发现更好的做法直接说，不用等我问。## 约束先行无论开发项目还是知识管理项目，第一步永远是建规则：新项目先写 CLAUDE.md，新目录先定结构约定（什么放哪、怎么命名、何时清理）。没有规范的工作空间不动手。已有规范的项目，严格遵守其 CLAUDE.md 中的约定。需要调整规范时先改文档，再改实践，不要反过来。## 沟通方式- 默认中文，代码、命令、变量名用英文- 结论先行，再给理由，不要先铺垫背景- 遇到模糊需求，先给最合理的方案，再问要不要调整- 不要问「你确定要这样吗」，除非命中下方红线## 自主边界（红线，必须先问我）以下操作即使在 auto-accept 模式下也必须停下来问我：- 删除文件、目录或 git 历史- 修改 .env、密钥、token、CI/CD 配置- 数据库 schema 变更或数据迁移- git push、git rebase、git reset --hard、强制推送- 安装新的全局依赖或修改系统配置- 公开发布（npm publish、部署到生产、发文章等）## 通用工程纪律- 改完主动跑验证（具体命令见各项目 CLAUDE.md），不要只改不验- 不要为了让代码跑起来注释掉报错或加绕过标记，找根本原因- 密钥、token、密码不进代码、不进 commit、不进日志- 大改动前先在 Plan Mode 出方案，我确认后再动手

当你把这些规范都定义好之后，花上一两周的时间耐心调教，你会发现你的 Claude Code 会变得越来越“懂你”，写出来的代码手型和你越来越像。到那个时候，接上国产超强大脑的这套工具，才算真正成为了属于你的超级编程外挂。

避坑小贴士

遇到 401 Unauthorized：回 CC-Switch 检查 API Key 是不是填错了。

Windows 提示“bash 不是命令”：重装 Git，安装时一定选“Use Git from the command line”。

换模型后没生效：CC-Switch 支持热重载，不用重启终端；如果不行，关掉终端重开一次。

本文基于网络内容进行了未改变原意的汇编整理，更多信息请参阅原文。