【图文详细教学】CC-switch 安装与配置以及Gemini Cli使用举例。
摘要:CC-Switch是一款专为解决AI编程助手(ClaudeCode/Codex/GeminiCLI)频繁切换API配置问题而开发的工具。通过预置多套API方案实现一键切换,避免传统手动修改配置文件耗时且易错的问题。Windows用户可通过GitHub下载安装,支持同时配置多个API供应商(如第三方平台魔芋AI),并实现跨工具统一管理。文章以GeminiCLI为例演示了模型切换流程,后续将补充
最近 AI 辅助开发工具迭代得特别快,像 Claude Code、Codex ,Gemini Cli这类编程助手,已经慢慢成了很多开发者日常工作里的“标配”。
不过,用得越多,大家越容易碰到一个很现实的问题:API 配置切换太麻烦了。
比如你在用 Claude Code 写代码时,当前账号额度用完了,就得切到另一个站点;另一个站点额度也没了,还得再换新的配置。
而传统的切换方式,通常意味着你要手动去打开 ~/.claude/settings.json,然后修改 API 地址、替换 Key、检查 JSON 格式有没有写错,保存之后再重启工具,最后还得确认配置有没有生效。
这套流程看起来不复杂,但真正操作起来其实很耗时间。
一次切换,少则几分钟;如果一天要切好几次,浪费掉的时间就非常可观。更让人头疼的是,手动改配置本身就是高风险操作——多打一个空格、少写一个字符、地址填错、格式出问题,都可能直接导致工具无法正常使用。对开发者来说,这种反复折腾既影响效率,也特别打断思路。
而 CC-Switch,就是专门为了解决这个问题而出现的。大家可以把它理解成一个面向 Claude Code、Codex、Gemini CLI 的API 配置切换工具。
核心思路很简单:过去我们切换 API 配置,像是每次都要自己拆装一整套设备;而 CC-Switch 更像是提前帮你把所有方案都整理好,等你需要的时候,直接一键启用。整个过程会轻松很多,也更不容易出错。
一、Windows版CC-switch下载配置
1.点击下载链接→https://github.com/farion1231/cc-switch/releases←,进入CC-Switch的Github Release页面
2.鼠标滚动到最下方选择适合自己版本的安装包,windows系统推荐下载普通msi后缀的安装包进行安装

3.下载完成后双击MSI文件安装,或者解压ZIP文件后直接运行进入界面。

4.首次打开软件后,点击左上角的“齿轮”图标,进入 CC Switch 的全局设置页面。

5.在设置页面的“通用”选项卡中,找到并开启 “应用到 XXX 插件”(例如应用到 Claude Code 插件)开关,这样当你在 CC Switch 切换供应商时,对应的终端工具配置才会生效。你可以顺便开启“开机自启”。

6.回到软件主界面,点击右上角的 “+” 加号图标,新建一个 API 供应商配置。
如果你只打算在某个单独的应用中使用(比如只用在 Claude Code),那么直接在弹出的供应商编辑窗口中填写。
或者选择Claude Code,Gemini Cli,Openai Codex三者统一供应商。

这里我选择第三方api平台供应商魔芋AI,这样可以一个api key 供给使用Claude Gemini Openai系列全模型。
二、API KEY 或者以及URL地址获取
这边模型api key大家肯定根据自身需求进行选择,可以选择官方渠道或者第三方平台渠道,综合需求我选择第三方平台魔芋ai平台👉https://www.moyu.info/register?aff=g2d7。
1.使用手机号码或者邮箱来进行账号注册

2.注册成功后登录进入【令牌管理】



3.复制要使用的api key,待会使用

!!!baseUrl: 魔芋AI的API服务地址(https://www.moyu.info/ 或https://www.moyu.info/v1)
三、Gemini CLi 的CC-switch切换使用
这里以Gemini Cli使用切换进行举例,一开始选择Moyu设置

Moyu设置里面是选择了gemini-2.5-pro模型,返回Gemini CLI进行查看。
请求地址要写的和我一致->https://www.moyu.info/

切换Moyu2设置,Moyu2设置里面是gemini-3.1-pro-preview!


然后连续两下ctrl c,关闭之前启动的Gemini cli。
重新输入gemini,查看是否切换成功。

切换成功,模型成功切换为gemini-3.1-pro-preview。
!!!Claude code和OpenAI Codex切换道理也和Gemini Cli一致,通过在cc switch里面设置好后,即可通过cc switch 进行一键切换。
后续有时间我会再更新Claude code和OpenAI Codex切换的详细图文教程进来。
更多推荐


所有评论(0)