CC Switch 快速上手教程:5分钟完成配置,Claude Code、Codex、Gemini一键切换

SEO关键词: CC Switch教程、CC Switch快速上手、CC Switch配置指南、Claude Code切换API、Codex切换模型、Gemini配置教程、CC Switch供应商管理、本地路由工具
在这里插入图片描述

大家好 这里是「代码简单说」,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~

对于经常使用 Claude Code、Codex、Gemini、OpenCode 等 AI 编程工具的开发者来说,不同平台之间频繁切换账号、API 和模型是一件比较麻烦的事情。

CC Switch 的作用,就是统一管理多个 AI 服务商,通过本地路由实现快速切换,让不同客户端共享配置,无需反复修改环境变量。

今天就带大家快速完成 CC Switch 的首次配置,整个过程大约只需要 5 分钟。


软件介绍

CC Switch 是一款本地 AI 路由管理工具,可以帮助开发者:

  • 管理多个 AI 服务商
  • 一键切换 Claude、Codex、Gemini 等客户端
  • 支持 API 模式与官方登录模式切换
  • 支持 MCP 扩展
  • 支持 Skills 技能系统
  • 支持 Prompts 提示词管理
  • 支持自动故障转移

对于同时使用多个模型的开发者来说非常实用。


下载地址

资源 地址
CC Switch 下载 https://pan.quark.cn/s/f7bdbc4d3619

建议收藏备用。


第一步:添加供应商

打开 CC Switch 后:

  1. 点击右上角 +
  2. 在预设列表中选择供应商
  3. 输入 API Key
  4. 点击添加

常见预设包括:

  • DeepSeek
  • 智谱 GLM
  • MiniMax
  • Kimi
  • PackyCode

如果预设中没有需要的平台,也可以选择:

自定义供应商

手动填写:

  • API 地址
  • 模型名称
  • API Key

完成后点击保存即可。


预设模式的优势

使用预设时:

  • 自动填写接口地址
  • 自动配置兼容格式
  • 减少配置错误

因此大部分情况下只需要填写 API Key。


第二步:切换供应商

添加完成后,供应商会显示在列表中。

CC Switch 提供两种切换方式。


方法一:主界面切换

直接点击对应供应商的:

启用

按钮即可。

切换完成后会自动修改对应客户端配置。


方法二:托盘快速切换

Windows 或 macOS 用户还可以:

  1. 找到系统托盘图标
  2. 右键菜单
  3. 点击目标供应商

即可完成切换。

这种方式更加适合日常开发过程中频繁更换模型。


第三步:让配置生效

不同客户端读取配置的机制不同。

切换供应商后,需要按照对应方式刷新。

客户端 生效方式
Claude Code 即时生效
Gemini CLI 即时生效
Codex 重启终端
OpenCode 重启终端
OpenClaw 重启终端

Claude Code 特殊说明

首次启动 Claude Code 时,有些用户会遇到:

  • 登录提示
  • 初始化向导
  • 新手引导页面

此时可以开启:

跳过 Claude Code 初次安装确认

在这里插入图片描述

操作路径:

设置
 └─ 通用
     └─ 跳过 Claude Code 初次安装确认

开启后:

~/.claude/settings.json

会自动写入:

{
  "skipIntroduction": true
}

从而跳过官方初始化流程。


验证是否配置成功

配置完成后,启动对应 CLI 工具。

例如:

Claude Code

claude

输入:

你好,请简单介绍一下自己

Codex

codex

输入:

你好,请简单介绍一下自己

Gemini

gemini

输入:

你好,请简单介绍一下自己

OpenCode

opencode

输入:

你好,请简单介绍一下自己

OpenClaw

openclaw

输入:

你好,请简单介绍一下自己

如果能够正常收到 AI 回复,说明配置已经成功。


进阶玩法推荐

完成基础配置后,建议继续体验以下功能。


添加多个供应商

例如同时配置:

  • DeepSeek
  • Kimi
  • 智谱 GLM
  • MiniMax

根据不同任务快速切换模型。

例如:

场景 推荐模型
编程 DeepSeek
长文本 Kimi
推理 GLM
日常问答 MiniMax

配置 MCP 服务

MCP(Model Context Protocol)可以为 AI 增加额外能力。

例如:

  • 文件系统访问
  • 浏览器控制
  • 数据库操作
  • Git 仓库管理

让 Claude Code、Codex 等工具获得更强的自动化能力。


设置系统提示词

通过 Prompts 功能可以预设:

  • 前端开发助手
  • Java助手
  • Python助手
  • 产品经理助手

减少每次重复输入角色设定。


开启代理服务

CC Switch 的代理模式支持:

  • 请求监控
  • Token统计
  • 自动故障转移
  • 多供应商负载均衡

适合重度 AI 开发用户。


常见问题

切换供应商后没有生效?

大多数情况是因为客户端没有重新加载配置。

解决办法:

  • Claude Code:自动生效
  • Gemini:自动生效
  • Codex:重启终端
  • OpenCode:重启终端
  • OpenClaw:重启终端

找不到对应预设怎么办?

选择:

自定义

然后手动填写:

  • API 地址
  • 模型名称
  • API Key

即可正常使用。


如何恢复官方账号登录?

如果之前使用的是第三方 API。

想恢复官方模式时:

Claude / Codex

选择:

官方登录

Gemini

选择:

Google 官方

随后重启客户端并重新登录即可。


总结

CC Switch 的核心价值在于统一管理各种 AI 服务商,让 Claude Code、Codex、Gemini 等客户端能够快速切换不同模型。

对于经常使用:

  • DeepSeek
  • Kimi
  • GLM
  • MiniMax
  • Claude
  • Codex

进行开发的用户来说,可以有效减少环境配置和账号切换带来的时间成本。

如果你刚开始接触 CC Switch,建议先完成本文的基础配置,然后再尝试 MCP、Skills、Prompts 和代理服务等高级功能,能够进一步提升 AI 编程效率。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐