ai工具安装教程汇总
CC Switch 把国内大模型接进 Claude Code【小白手把手安装步骤】
✍️ 约 11228 字 · 阅读约 45 分钟
4 月 14 日,Anthropic 在 Claude 的帮助中心悄悄加了一条新规:部分用户在使用某些功能时,要提交政府证件原件和实时自拍做身份验证(他们接的是 Persona 这家第三方验证服务)。官方的原话是"只针对特定场景",不是全员强制;但从这几天的反馈看,被随机抽到的用户比预想的多。
Claude Code 走的是 API 和订阅通道,目前还没出现大面积被验证弹窗拦下的反馈。但方向是明摆着的。想用 Claude 官方账号,门槛在一点一点加高。订阅本来就 $20 一个月,已经劝退了一批人,现在又加一道脸扫。我朋友圈上周就有两三个人卡在这步,转头来问我能不能不走官方。
这也是上一篇讲完 Claude Code 的 6 个核心能力之后,后台问得最多的那件事:我没有 Claude 账号,这东西能不能用?
答案是能。Kimi、GLM、MiniMax、DeepSeek 这几家国产模型都做了 Anthropic 接口兼容,接进 Claude Code 以后,日常用起来跟官方没太大差别。
这篇就是教你怎么接。过程里会用到一个叫 CC Switch 的小工具,本文主要就是围着它转。
整篇我们从零开始:先装 Claude Code,再装 CC Switch,最后用它们把 Kimi 接进来跑一遍。没装过任何东西的朋友也能跟着走。
读完之后你手上会有这几件事:不用 Claude 官方账号也能跑 Claude Code;Kimi、GLM、MiniMax、DeepSeek 四家随便接;切换模型像切 Wi-Fi 一样,点一下就换。
照着做的话,大概十分钟能跑通,然后用上 Claude Code 啦。
一、为什么需要 CC Switch
先说不装 CC Switch 能不能接国产模型。能。
但你得打开电脑里一个叫 settings.json 的配置文件,位置在 ~/.claude/(Mac)或 用户目录\.claude\(Windows)下面,在里面手写一段配置代码。改完保存,关掉 Claude Code,再重新打开,它才认新模型。
这条路对非程序员不太友好。原因有几个。
这份配置文件对格式特别挑,你少写一个逗号、多打一个括号,Claude Code 启动就会报错。错误信息通常就一句"配置无效",不会告诉你错在第几行。(我有个朋友第一次改,漏了个花括号,Claude Code 启动失败,他以为自己把电脑搞坏了,大晚上发消息问我要不要重装系统。)
然后是 Claude Code 内部会按任务复杂度调不同档位的模型,简单任务轻量档,复杂任务高档。换一家供应商,这几个档位都得跟着改,漏一个就会在某个时刻莫名其妙报错。
切换也麻烦。你今天想用 Kimi 跑长文档,明天换 GLM 跑代码,每次都要手动改文件、保存、关终端、重开。几次下来半小时没了。
CC Switch 干的就是替你省这些事。它在界面上给你几个按钮,添加、切换、启用,你点按钮,它去改配置文件。它里面自带了 50 多家模型供应商的预设,选 Kimi 你只用填个 API Key,其它都帮你填好了。再配合"本地代理"模式,切换甚至不用重启 Claude Code(这个第五章单独说)。


这工具就是给那些不想碰代码、但还想用上 Claude Code 的人用的一个门把手。
二、先把 Claude Code 装起来
CC Switch 是管 Claude Code 的工具,要用它,Claude Code 得先装上。这一章从零开始把 Claude Code 装好,大概十分钟。
两种装法,推荐走 VSCode 插件
Claude Code 有两种用法:
- VSCode 插件:装个编辑器(VSCode)+ 一个插件,鼠标点一点就行。推荐小白走这条
- 命令行 CLI:在终端里跑。要先装 Node.js 这类环境,对非程序员门槛偏高
这篇走 VSCode 路线。装完之后如果你哪天想用命令行版,打开 VSCode 内置终端敲 claude 就能进命令行模式,插件自带 CLI 能力,不用你另外装任何东西。
(所以 Node.js 这些环境,这条路上都不用管。插件帮你全搞定。)
第 1 步:装 VSCode
VSCode(全名 Visual Studio Code)是微软出的一个编辑器。别被"编辑器"三个字吓到,它就是一个免费、好用、全世界开发者都在用的软件,既能写代码,也能装各种 AI 插件。
下载地址:👉 https://code.visualstudio.com
打开这个网站,首页一个大按钮会自动识别你的系统,Mac 用户看到"Download for macOS",Windows 用户看到"Download for Windows"。点一下就开始下载。
下载完按平时装软件的方式装好:Mac 把图标拖进 Applications 文件夹,Windows 双击 .exe 一路点下一步就行。

Windows 用户多一步:装 Git for Windows
Claude Code 底层需要一个叫 Shell 的东西来跑(简单说就是让它能在你电脑上执行命令的那套底层环境)。Mac 系统自带 Shell,Windows 需要额外装。装一个叫 Git for Windows 的软件就把 Shell 顺便装上了。
下载地址:👉 https://git-scm.com/downloads/win
下载完双击安装,全程默认选项就行,不用动任何勾选,不用理解弹出的任何提示。装完什么都不用配,Claude Code 会自己找到它。
(Mac 用户直接跳过这一步,进下一步。)
第 2 步:在 VSCode 里装 Claude Code 插件
- 打开 VSCode
- 按 Cmd+Shift+X(Mac)或 Ctrl+Shift+X(Windows)打开扩展面板。如果快捷键记不住,点 VSCode 左侧那一列图标里"四个小方块"那个,这就是扩展商店的入口
- 搜索框里输入 Claude Code
- 在结果列表里找到 Anthropic 官方发布的那个(作者栏写着 anthropic,图标是一个橙色的小符号)。一定要认准官方,同名的野鸡插件也有几个
- 点"安装"按钮,等几秒装完
装完之后 VSCode 左侧的活动栏(就是最左边那一列竖排图标)会多出来一个 Claude Code 图标。

第 3 步:打开 Claude Code 面板
点 VSCode 左侧活动栏里那个橙色 Claude Code 图标,面板就开了。

面板会问你怎么登录:
- 有 Claude 官方账号的朋友:按提示登录,浏览器会跳出来让你授权,授权完回到 VSCode 就行
- 没有 Claude 账号的朋友(这篇文章主要就是写给你的):这一步先跳过,不要点任何登录按钮。下面我们教你用 CC Switch 接国产模型,根本不用官方账号

装好了长什么样
你现在应该能看到一个 Claude Code 对话面板,里面有一个输入框。

看到输入框 = Claude Code 已经装好了。但现在还不能真的发消息,因为没登录官方账号、也没接其它模型。
下一章我们装 CC Switch,再下一章就能让 Claude Code 跑在 Kimi 上了。
三、装 CC Switch
先说版本:CC Switch v3.13.0(2026 年 4 月 10 日发布),这是写这篇文章时的最新稳定版。如果你看到这篇文章的时候版本号已经变了,不用纠结,装最新的就行,步骤基本不变。
从哪里下载
推荐:从我们的飞书知识库下载
我提前把 Mac 和 Windows 两个系统的安装包都下载好,存在飞书知识库里了。点下面的链接进去,挑对应你系统的那个包下载就行。不用理解什么 GitHub、Assets 这些概念,就跟你平时从网盘下东西一样。
👉 https://vcn5y6q5vxhe.feishu.cn/wiki/ZwvpwJVjjiMyHnkSMGDcNITSnJc?fromScene=spaceOverview

(飞书里的版本我会定期同步到 CC Switch 官方最新版。如果哪天你发现飞书里的版本比官方旧,再走下面的 GitHub 路径拿最新的。)
想走官方渠道:从 GitHub 下载(走飞书路径的可以跳过)
如果你就是想走官方、自己挑版本,CC Switch 的所有安装包都发布在 GitHub 上。
下载地址:
https://github.com/farion1231/cc-switch/releases/latest
GitHub 你先把它当成一个代码下载站就行,大部分开源软件的安装包都在上面。打开这个地址,往下翻到一个叫 Assets 的区域(Assets 意思是"资源",也就是各个系统的安装包放这里),找到对应你系统的文件下载。

先认一下这两个文件后缀
下载下来你会看到两种后缀:.dmg 和 .msi。别被英文缩写唬住。这俩就是你平时一直在用的安装包,只是之前没注意过名字:
- .dmg(Mac 用):就是你在 Mac 上装 Chrome、装微信、装 QQ 时看到的那种安装文件。双击打开,弹出一个小窗口,把软件图标往右边 Applications 文件夹里一拖,就装好了。
- .msi(Windows 用):就是你在 Windows 上装微信、装钉钉、装 QQ 时那种安装程序。双击打开之后会弹出"下一步、下一步、完成"的安装向导,一路点下去就行。
(说这么细是因为有朋友看到英文后缀就慌,其实根本不用。你每天都在用这个东西。)
Mac 用户
- 先搞清楚你的 Mac 是什么芯片:点左上角的苹果图标 → 关于本机,看"芯片"那一行。写 M1 / M2 / M3 / M4 的是苹果芯片,写 Intel 的是英特尔芯片
- 在 Assets 里找文件名:
- 苹果芯片的下载带
aarch64和.dmg的文件 - Intel 芯片的下载带
x64和.dmg的文件
- 下载完双击打开,把 CC Switch 图标拖到 Applications 文件夹
- 打开 Launchpad 启动台(Dock 栏里那个九宫格图标,或者按 F4 键),找到 CC Switch 点击打开

如果 Mac 弹"已损坏"或"无法打开":老教程里经常看到一条命令是 sudo xattr -rd com.apple.quarantine /Applications/CC-Switch.app,你可能搜到过。这条命令对 v3.13.0 以后的版本已经不需要。新版本完成了 Apple 代码签名和公证(也就是苹果官方认可了这个应用),直接能打开。如果你还遇到"已损坏"弹窗,说明你装的是老版本,升级到最新版就行。
Windows 用户
(重要声明:我们手上没有 Windows 设备做实机演示,Windows 部分基于 CC Switch 官方文档和其他教程作者的说法整理。大部分流程应该能走通,但遇到偏差的地方欢迎在评论区告诉我,我会补进后续版本。)
- 在 Assets 里找文件名里带
Windows和.msi的文件下载(推荐 MSI 版,支持自动更新) - 下载完双击安装
- 安装过程中如果弹出 SmartScreen(蓝色的警告窗口),点"更多信息"→"仍要运行"
如果你用的是便携版(Portable.zip),❗ 解压路径不要带中文,会导致启动失败。解压到 C:\Tools\cc-switch\ 这种纯英文路径就行。
打开之后长什么样
第一次打开是个空界面。左上角是一排小图标,代表它能管的几个 CLI 工具,像 Claude Code、Codex、Gemini CLI 这些,默认选中的是第一个。右上角有个橙色的"+"号,是添加供应商的入口。中间一片空白,因为你还没加过供应商。


接下来我们用 Kimi 把这片空白填上。
四、用 Kimi 跑通第一次
国产模型里我选 KIMI Code 做主示例。一是它在中文写作和长文档场景下表现挺稳,拿来跑 Claude Code 后端够用;二是它的控制台界面对新手友好,很多家后台第一次进去会懵,KIMI Code 相对不太会。加上 CC Switch 里有现成预设(就叫 Kimi For Coding),你只用填个 API Key 就完事。
整套流程一共 5 步,走完大概 10 分钟。CC Switch 先打开着放一边,我们去 KIMI Code 那边拿 Key。
第 1 步:注册 Kimi 账号
浏览器打开 https://www.kimi.com/code,这是 Kimi 专门为编程场景做的订阅服务 KIMI Code。(Kimi 的母公司叫月之暗面,英文名 Moonshot;KIMI Code 是他们给 Claude Code 这类编程 Agent 专门推出的入口,接入最顺。)
注册流程跟普通网站一样,手机号注册就行。注册完成之后需要完成实名认证。这一步是国内开发者平台的通用要求,拿身份证正反面拍一下上传就行,一两分钟搞定。没完成实名认证的话,后面创建 API Key 会被拦住。

第 2 步:拿到 API Key
登录进控制台之后,左侧菜单里找"API Key 管理"(也可能叫"密钥管理",不同时期命名略有差异,看到带 Key 字样的菜单就是)。点进去,右上角有个"新建"按钮,点一下,给这个 Key 起个名字(比如 claude-code-用,起什么都行,只是给你自己看的),然后创建。
这里有个坑要先说:KIMI Code 的 API Key 只在生成的那一瞬间完整显示一次。弹窗里会出现一串 sk- 开头的字符串,这就是你的 Key。❗ 马上复制下来,贴到备忘录或者密码管理器里都行。页面一关,这个 Key 就看不到完整版了,想拿回来只能删了重建。

(我第一次配的时候嫌麻烦直接关了弹窗,以为列表里还能看到。结果列表里只显示前几位和后几位,中间全是星号。最后回去删了重建,又走了一遍验证流程。路径都是自己给自己设的。)
第 3 步:在 CC Switch 里添加 Kimi
回到 CC Switch 主界面。
- 点右上角橙色的"+"号,进入"添加新供应商"页面
- 最上方有一排预设供应商的标签:自定义配置、Claude Official、DeepSeek、Zhipu GLM、Kimi、Kimi For Coding、MiniMax 等等(CC Switch 内置了 50+ 家的预设),❗ 点 Kimi For Coding 这个标签(不是 Kimi,认准"For Coding"那个)
- 选完 Kimi For Coding 之后,页面下方会自动填好官网链接、接口地址等信息,你唯一需要手动填的就是:API Key 那一栏,粘贴你刚才复制的那串 sk- 开头的字符
- 下方的模型名区域,默认填的就是 KIMI Code 当前推荐的模型(比如
K2.5,具体版本以 CC Switch 预设为准)。如果你有特殊偏好可以改,不懂就别动,默认的就行 - 页面右下角点"添加"



添加完成之后回到主界面,你会在列表里看到一条 Kimi For Coding 的记录。右边有一个"启用"按钮,点一下,按钮会变成"已启用"状态。

第 4 步:打开本地代理(最容易漏的一步)
这是很多人装完 CC Switch 之后"切换不生效"的主要原因。
CC Switch 有两种工作模式:
- 环境变量模式:改你的
settings.json,切换需要重启 Claude Code 才能生效 - 本地代理模式:CC Switch 在本地起一个小代理(localhost 上的服务),Claude Code 的请求先发到这个代理,代理再按你当前选的供应商转发。这种方式切换不需要重启,你在 CC Switch 里点一下,下一句话 Claude Code 就走新供应商了
❗ 这个开关默认是关的,你得手动打开。不开的话,你在 CC Switch 里切换看着生效,其实没生效。
开关位置:点 CC Switch 左上角的"设置"小齿轮图标 → 切到 "代理" 这个 Tab → 打开 "代理总开关"。旁边还有一个"在主页面显示本地代理开关"的选项,建议一起勾上,后面切换起来不用每次都跳到设置页。
打开之后,页面下方会显示监听地址(默认 127.0.0.1)和端口(默认 15721),代理就算跑起来了。

(这一步的重要性,博客园有一篇阅读量很高的文章,标题直接叫"90% 的人都没用对",说的就是这个开关没开。我自己第一次装的时候也漏了,切了供应商看着生效,实际 Claude Code 还在连官方地址,报错半天找不到原因。)
第 5 步:验证
打开 Claude Code(终端里敲 claude,或者在 VSCode 里打开 Claude Code 面板),输入一句最简单的话:
你好
如果你能看到 K2.5 的回复(通常回复的开头会是中文,风格跟 Claude 略有不同),说明链路全通了。恭喜,你的 Claude Code 现在跑在 KIMI Code 后端上了。

如果没看到回复,或者报错了,先别怀疑模型。按这个顺序排查:
- API Key 有没有复制带空格(两端都检查一下)
- CC Switch 里这个供应商是不是"已启用"状态(不是"已添加"就结束了)
- 本地代理有没有打开
- 重启一次 Claude Code
大部分问题都在这四条里。
切回官方 Claude 怎么办?
跑通 Kimi 这一刻,估计你心里会冒出另一个问题:那哪天我的 Claude 账号搞定了,想切回官方,回得去吗?
能。整个过程是可逆的,CC Switch 只是在动 Claude Code 的配置,不会碰你的 Claude 账号本身。
具体怎么切,看你原来用的是哪种方式。
情况 A:原来是用 Claude Pro/Max 订阅登录的(大多数人是这种)
- 在 CC Switch 里把当前的 Kimi For Coding 停用(点那个"已启用"按钮让它变回"启用"状态)
- 重启 Claude Code(完整关闭再重开,不能偷懒)
- Claude Code 会回到"未登录"状态,自动弹出登录界面
- 用你原来的 Claude 账号登回去就行
情况 B:原来是用 Anthropic 官方 API Key 的(按量付费那种)
- 在 CC Switch 里点"+"添加供应商,预设里选 Claude Official
- 填你原来的官方 API Key
- 启用它,就切回去了,这种方式不用重启
切换过程里可能遇到两个情况:切回去之后发现 Claude Code 还在连 Kimi For Coding,八成是你没重启 Claude Code,关了再开就行;提示"认证失败",去 CC Switch 里确认 Kimi For Coding 供应商处于"停用"状态,别留着启用,再试一次。
(接进来随时能出,CC Switch 不是一条单行道。)
五、接上模型之后,用它调度
上面那套如果只是为了接一个 Kimi 进来,CC Switch 的价值还没怎么发挥。它更好用的地方,是你同时接了好几家,然后在它们之间切来切去。下面讲四个我每天都在用的场景。
5.1 一键切换:不同任务切不同模型
我一天切几次供应商是常事。
写代码用 Claude 官方的 Sonnet,习惯了。到处理一份 200 页的 PDF 时,Sonnet 的上下文不够,我切 Kimi For Coding。再之后要从一堆 Excel 里批量抽字段、做格式化,这类活对模型智力要求不高,我会切到 GLM 或 DeepSeek 的轻量档,跑起来更快,顺便省点钱。
CC Switch 平时常驻在系统托盘里(Mac 是菜单栏、Windows 是任务栏角落那个小图标)。点一下图标,供应商列表弹出来,选哪个走哪个。不用打开主界面,不用重启 Claude Code,下一句话就换了后端。(用久了你会觉得"默认模型"这个概念有点多余。反正点一下就换,默认哪个都无所谓。)
5.2 自动故障转移:主力挂了自动切备用
这功能我上个月用得比较多。
国产模型的 API 偶尔会限流或者抖动。高峰时段排队的人多了,模型自己应付不过来。你正写着代码,Claude Code 卡住了,回头一看接口返回"请稍后再试"。手动切的话要停下活,打开 CC Switch,选备用供应商,再重发一遍消息。一次两次还能忍,连续卡五次,我那天下午真的差点把键盘砸了。
CC Switch 里可以配故障转移链:主力 A,备用 B、C。A 超时或返回错误,请求自动转到 B;B 也挂了再转 C。这过程对 Claude Code 来说是看不见的,它不知道自己被切了,你也不用动手。
不过要说清楚的是:不是所有错误都触发转移。超时、5xx 错误会转,4xx 的那种"你的请求有问题"类错误不转,因为那种转去别家也没用。所以转移更像是帮你挡"供应商自己的锅",不挡"你的锅"。
我自己的搭配是一个便宜不太稳的当主力(按量付费的 GLM 或 Kimi For Coding),一个贵但稳的当备用(官方 Claude Pro)。大部分时间跑主力,掉链子的时候自动切到备用。省下来的 Token 钱,够买好几杯咖啡。
5.3 配额监控:一眼看完所有家余额
v3.13.0 新加的功能。以前你想知道某家供应商还剩多少钱、还有多少 Token,得单独打开它的控制台看。接了三四家之后,月初对账我得挨个刷,半小时起步。现在在 CC Switch 主界面一眼扫完所有家的余额、已用 Token、当月消耗、请求数,不用再到处跳。

5.4 多 CLI 工具统一管理
CC Switch 不只能管 Claude Code,它同时支持:
- Claude Code
- Codex(OpenAI 家的编程智能体)
- Gemini CLI(Google 家的)
- OpenCode
- OpenClaw
左上角切换应用图标,每个应用都有独立的供应商列表、MCP 配置、Session 管理。你同时用多个 AI CLI 做不同事情的时候,一个 CC Switch 就管完了,不用分别去各自的配置文件里折腾。(这块展开能写一整篇,这篇先点到,后续文章单独出。)
六、几个进阶玩法(用熟了再来看)
下面这几个是我自己常用的,社区里也讨论得比较多。如果你刚装完 CC Switch、连第一个模型都还没接通,先别看这一章,基础流程跑顺了再回来看,不然容易越看越乱。
6.1 多设备同步:办公室、家里、出差用同一套配置
场景:你白天用办公室的 Mac,晚上回家换 Windows,出差又带 MacBook Air,三台机器都装了 CC Switch,但每台都得手动粘十几个 Key、改一遍。换一家供应商,三台机器要同步改。团队拼车买的 Key 也一样麻烦:一个人改了,其他人都要跟着改。
怎么做:CC Switch 支持把配置同步到云端(坚果云、Dropbox、OneDrive、iCloud 都行)。
以坚果云为例(国内用着最稳):
- 注册坚果云账号,进设置生成一个"应用密码"(不是你的登录密码,是专门给第三方工具用的密码)
- 打开 CC Switch → 设置 → 云同步
- 服务器地址填
https://dav.jianguoyun.com/dav/,账号填邮箱,密码填刚才生成的那个应用密码 - 保存,第一次它会把当前配置上传一份到云端
之后你在另一台机器上装好 CC Switch,按同样步骤填一遍坚果云账号,所有供应商、Key、MCP 配置自动同步过来。改一处,三台机器全更新。(团队拼车一个 Coding Plan 的时候特别好用:一个人换了 Key,其他人重启 CC Switch 自动跟上,不用在群里再喊一遍"新 Key 在这"。)
6.2 一键导入:分享配置不用再发 JSON
场景:你在交流群推荐一个好用的供应商或者 MCP 给朋友,传统做法是发一段 JSON 配置让对方手动贴进去,七八行字符串,对方贴错一个引号就装不上。
怎么做:CC Switch 支持一种叫 Deep Link 的链接(就是点了之后能自动打开 App 的那种链接,类似你点支付宝付款链接会自动唤起支付宝)。
- 想分享一个供应商:在 CC Switch 里找到它 → 右键导出 → 选 "Deep Link 格式" → 复制链接发给对方
- 对方收到链接,点一下:浏览器自动唤起 CC Switch,弹一个确认框问"要不要导入这个供应商",点"是",配置就进来了
(团队新人入职第一天,群里发五条链接,对方一顿点击,全套配置就齐了。比让对方一行行抄文档省事多了。)
6.3 历史对话救场:终端误关了还能找回上下文
场景:你在 Claude Code 里跟模型聊到一半,可能是配了半天的 prompt,可能是改到一半的代码,结果不小心把终端窗口给关了。或者切供应商的时候配额爆了被踢出,刚才那段对话找不到了。
怎么做:CC Switch 顶部有个 "Sessions" 标签页(v3.11 之后有的)。
- 点 Sessions
- CC Switch 自动扫描 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个工具的所有历史会话
- 按时间倒序排,也可以按关键字搜
- 找到你要的那条,点"恢复到终端",CC Switch 帮你把这段对话拉回来


(我用得最多的场景是:今早用 Codex 写过一段 prompt 效果挺好,下午想搬到 Claude Code 里再跑一次。以前得自己翻历史记录文件,现在搜关键字一秒找到。)
6.4 还有几个值得知道的小功能
剩下几个用一句话扫一下,等你将来碰到对应场景再回来研究:
- 自动获取模型列表(v3.13 新加):换新供应商的时候,填完接口地址点一下"获取模型列表",CC Switch 直接调对方接口拉回所有可用模型让你选,不用再翻文档抄模型名
- Debug 日志:设置里开 Debug 模式,CC Switch 会把每次请求和响应的完整内容存到日志里。某家供应商接进来报错搞不清原因的时候,看日志一眼就能定位是哪一步出了问题(这个偏技术,找你身边的程序员朋友一起看比较快)
- CC Switch + Claude Code Router 组合:CC Switch 负责切供应商,Claude Code Router 负责按任务复杂度自动路由,简单任务走轻量模型、复杂任务走旗舰模型。两个叠起来用效率高,但配置稍复杂,我后面单独写一篇
6.5 一个有点野的玩法(看看就好,不建议尝试)
CC Switch v3.13 还加了一个功能:用你的 ChatGPT Plus 订阅给 Claude Code 供能。通过逆向 Codex 的登录流程,把 ChatGPT 那边的额度反过来喂给 Claude Code。
听起来很爽:一份 Plus 订阅,两边用,省一笔 API 钱。
但有一个绕不过去的问题:这种用法可能违反 OpenAI 的服务条款,有封号风险。我个人估计这种玩法持续可用的时间窗口不会太长,OpenAI 那边一旦风控更新,账号被封掉的概率不低。
这篇教程的定位是给小白用,所以这个玩法我不展开教。你如果感兴趣,可以去 LINUX DO 论坛搜 "Codex OAuth 反向代理" 自己研究。但请记住一句话:❗ 账号没了我们不负责。
七、四家国产模型接入参数总表
(只接 Kimi For Coding 的朋友可以跳过这一章,直接去下面的"常见坑 FAQ"。这一章是给想接 GLM、MiniMax 或 DeepSeek 的朋友备查的。)
前面用 Kimi 走了一遍完整流程。其他几家接入逻辑一模一样。只有三个字段不同:接口地址(Base URL)、模型名、API Key 申请入口。下面这张表是当前四家主流国产模型的参数汇总,你需要接哪家,照着填就行。
| 参数 | GLM(智谱) | KIMI Code(月之暗面) | MiniMax | DeepSeek |
|---|---|---|---|---|
| 注册入口 | open.bigmodel.cn | www.kimi.com/code | platform.minimaxi.com | platform.deepseek.com |
| Base URL | https://open.bigmodel.cn/api/anthropic | https://api.kimi.com/coding/ | https://api.minimaxi.com/anthropic | https://api.deepseek.com/anthropic |
| 当前推荐模型名 | glm-4.7(小写) | K2.5(大写) | MiniMax-M2.7 | deepseek-chat |
| Key 入口 | 头像 → API Keys | 左侧 API Key 管理 | 账户 → 接口密钥 | API Keys → 创建 |
| 实名认证 | 必须 | 必须 | 必须 | 必须 |
四家通用的约定(这几条踩坑率最高,单独拎出来):
- 都用 ANTHROPIC_AUTH_TOKEN,不要用 ANTHROPIC_API_KEY。CC Switch 预设里填的是前者。如果你走手动配置,写错这个变量名,Claude Code 会当成要连官方账号,导致切换看着生效实际没生效
- Base URL 写到 /anthropic 为止,末尾不加 /v1。Claude Code 会自动拼
/v1/messages路径,你再加一个/v1,实际请求路径会变成/v1/v1/messages,直接 404 - 不需要 anthropic-beta header。四家都实现了 Anthropic Messages API 原生兼容
- MiniMax 和 DeepSeek 要把五个模型变量都填同一个值:
ANTHROPIC_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_SMALL_FAST_MODEL。CC Switch 预设里是填好的,自己手动配的时候容易漏 - 模型名大小写敏感。
glm-4.7全小写、K2.5全大写、MiniMax-M2.7首字母大写,按官网写法,一个字符不要错
另外,模型名版本更新比较快。这张表里的版本号是写这篇文章时的当前推荐,以官网最新文档为准。CC Switch 预设会跟官方文档同步更新,你装最新版 CC Switch 直接选预设,通常不用管具体版本号。
八、常见坑 FAQ
装完用不起来的时候,先别怀疑模型,也别怀疑 CC Switch,大部分问题在下面这张表里。
| 症状 | 原因 | 处理方式 |
|---|---|---|
| 切换看着生效,Claude Code 还是连官方 | 本地代理开关没开 | 打开 CC Switch 的"本地代理"开关(第四章第 4 步) |
| 报 404,找不到接口 | Base URL 末尾带了 /v1 | 删掉 /v1,保留到 /anthropic 为止 |
| 报 401 认证失败 | Key 复制时带了空格或换行 | 重新复制粘贴,两端检查空格 |
| 回复"账户欠费" | 供应商账户真的没钱 | 去控制台充值,或切到备用供应商 |
| 切换不生效,环境变量有残留 | 系统里有老的 API Key 环境变量没清 | 把报错截图发给 AI 问怎么清理,几分钟搞定,自己瞎清容易误删别的配置 |
| Mac 报"已损坏" | 装的是 v3.13.0 之前的老版本 | 升级到最新版,v3.13.0 起已 Apple 公证 |
| Windows 装不了,SmartScreen 拦截 | 系统默认拦截非常用软件 | "更多信息"→"仍要运行" |
| 模型名拼错 | 大小写或连字符错了 | 对着官网文档抄一遍,一个字符都不要错 |
| 切换回官方 Claude 账号登录不上 | 需要重新授权 | 重启一次 Claude Code,会弹新的登录流程 |
还有个实用的建议:遇到报错先截图发给 AI。Kimi、豆包、ChatGPT 都行,截图配一句"我在装 CC Switch 遇到这个报错,怎么办"。AI 看到的是你真实的界面,通常比我在这干写一百条 FAQ 都贴你的情况。
九、装上之后
装完 CC Switch,Claude Code 就不再被哪一家模型绑住。今天用 Kimi,明天用 GLM,后天 Claude 官方账号搞定了切回官方,切来切去的成本几乎是零。
今天你可以做三件事:把 CC Switch 装上(五分钟);照第四章把 Kimi For Coding 接一遍(再五分钟);最后把本地代理开关打开。大约九成的"切了没用"都卡在这一步。
下一篇我想写 Skill,就是把你自己的工作流固化成一个斜杠命令,在 Claude Code 里一敲就跑那种。第一篇写了 Claude Code 能干什么,这一篇写了怎么让它跑起来,下一篇想写怎么让它贴你的用法。
先把这一篇跑通。跑通了再回来看下一篇,顺序不要反。
想要更好的阅读体验?看飞书完整版
公众号的排版偏窄、图片缩略看得累,如果你想要更大的图、更清晰的目录、方便收藏和随时回翻,可以看我们这篇的飞书完整版:
👉 https://vcn5y6q5vxhe.feishu.cn/wiki/ZwvpwJVjjiMyHnkSMGDcNITSnJc
(飞书版会比公众号版多保留一些截图细节,读起来更从容。公众号版用来转发给朋友,飞书版用来自己照着做。)
写在最后
这篇教程我尽量写到颗粒度最细了,但总会有我没考虑到的情况。如果你照着做遇到文章里没覆盖的问题,欢迎在评论区发出来,我会看,也会回。读者一起踩出来的坑,比我一个人闷头写教程要准得多。
另外有件事要再强调一遍:我们全程用 Mac 做演示,Mac 部分的每一步都是我自己跑过一遍的。Windows 部分我们手上没有对应的设备,引用的是 CC Switch 官方文档和其他教程作者的经验。我没法保证每一步都跟 Windows 上的实际情况一模一样。Windows 的朋友照着做遇到偏差,麻烦在评论区告诉我,我会在后续版本里修正。
教程这件事我一直觉得:作者跟读者其实是在一起修一份文档。我先写一版,你们帮我补漏。
相关资源
CC Switch:
- 官方仓库:https://github.com/farion1231/cc-switch
- 最新 Release:https://github.com/farion1231/cc-switch/releases/latest
- 中文文档:仓库里的
README_ZH.md
国产模型开发者平台:
- Kimi(月之暗面):https://platform.moonshot.cn
- GLM(智谱):https://open.bigmodel.cn
- MiniMax:https://platform.minimaxi.com
- DeepSeek:https://platform.deepseek.com
Claude Code 系列:
- 第一篇:纯小白向一篇读完就能上手,Claude Code 的 6 个核心能力(链接)
- 飞书知识库(Claude Code 保姆级安装教程):👉 Claude Code 保姆级安装教程

- B 站系统课:搜 ai798Lab 能找到
关于 ZOPC
文章里提到的 ZOPC 是我们 ai798Lab 的付费社区,里面有我们整理的 Claude Code、CC Switch、国产模型接入的完整知识库,还有每天的答疑交流。这篇文章里的每个参数、每个坑,我们都在社群里被问过无数遍。如果你想要更系统地学,可以了解一下。
👉 ZOPC 社群介绍
扫码添加小助手微信,了解 ZOPC 详情。
