1. 快速配置工具
ZetaRouter-Plan
  • 快速开始
    • 中转站是什么
  • 使用指南
    • 欢迎使用
    • 注册账号
    • 兑换套餐/额度
    • 创建令牌
    • 模型广场
  • Node.js环境安装
    • Windows平台
    • macOS 平台
    • Linux 平台
  • 快速配置工具
    • CC-Switch 配置工具
  • 软件/插件配置教程
    • Claude Code 配置教程
    • Claude Code插件配置教程
    • Claude 桌面端配置
    • OpenCode CLI 配置教程
    • Codex CLI 配置教程
    • Codex 桌面端配置教程
    • OpenClaw 配置教程
    • Cherry Studio配置教程
    • Gpt-Image 生图配置教程
    • Chatbox配置教程
  1. 快速配置工具

CC-Switch 配置工具

CC-Switch 快速配置工具#

All-in-One AI CLI 管理器 - 桌面应用程序

🎯 工具介绍#

CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。
💡
核心功能
一键切换不同 AI 工具的提供商配置
• API 端点速度测试与质量指示器
• 多预设系统提示管理
• MCP 服务器统一架构管理
• Claude Skills 发现与安装系统
• 配置备份/恢复（自动保留最近10个）
• 深度链接协议支持（ccswitch://）
• 环境变量冲突检测

📦 安装方法#

🖥️ Windows 平台#

方法一：MSI 安装器（推荐）
1.
访问项目发布页：https://github.com/farion1231/cc-switch/releases
2.
下载最新版本的 .msi 安装器
3.
运行安装器，按照向导完成安装
4.
安装完成后从开始菜单启动 CC-Switch
方案二：夸克网盘下载
链接：https://pan.quark.cn/s/27849bd2e176

🍏 macOS 平台#

推荐方式：Homebrew 安装#

# 添加 tap 源
brew tap farion1231/ccswitch

# 安装 cc-switch
brew install --cask cc-switch

手动安装#

1.
访问项目发布页：https://github.com/farion1231/cc-switch/releases
2.
下载 .dmg 安装包
3.
打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹
4.
从启动台或应用程序文件夹启动

🐧 Linux 平台#

Debian/Ubuntu 系列（推荐）
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f  # 修复依赖
AppImage 通用版本
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage
Arch Linux（AUR）
paru -S cc-switch-bin
# 或使用 yay

yay -S cc-switch-bin

🚀 快速开始#

第一步：添加提供商配置#

1.
启动 CC-Switch 应用程序
2.
点击「添加提供商」按钮
3.
选择预设配置（如 OpenRouter）或创建自定义配置
4.
填写以下信息：
提供商名称：自定义名称（如"OpenRouter"）
API 密钥：从 https://plan.zetarouter.com 获取
API 端点：https://plan.zetarouter.com
5.
模型选择：根据需求选择可用模型
6.
点击「保存」完成配置
📌
重要提示
不同的AI工具（Claude Code、Codex、Gemini CLI）可能需要不同的令牌组配置。 请在 OpenRouter 平台创建对应的专用令牌。

第二步：切换提供商#

1.
在提供商列表中选择要使用的配置
2.
点击「启用」按钮
3.
或使用系统托盘图标进行即时切换

系统托盘快速切换：#

右键点击系统托盘中的 CC-Switch 图标
从菜单中直接选择要切换的提供商
配置立即生效

第三步：应用配置#

切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。

🔧 高级功能#

API 端点速度测试#

测试不同提供商的响应速度和质量：
1.
在提供商列表中找到目标配置
2.
点击「测试速度」按钮
3.
查看延迟和质量指标
4.
根据结果选择最优提供商

系统提示管理#

1.
创建针对不同场景的系统提示
2.
快速切换不同的提示预设
3.
导入/导出提示配置

MCP 服务器管理#

1.
在一个界面中配置所有 MCP 服务器
2.
自动同步到对应的配置文件
3.
支持启用/禁用服务器

Claude Skills 管理#

1.
浏览可用的 Skills 列表
2.
一键安装需要的 Skills
3.
递归扫描本地 Skills 目录

配置备份与恢复#

1.
每次修改配置时自动创建备份
2.
保留最近10个备份版本
3.
一键恢复到任意历史版本
4.
导出/导入配置文件

💡 使用技巧#

提示 1：开机自动启动
在设置中启用「开机自动启动」选项，CC-Switch 将在系统启动时自动运行并最小化到系统托盘。
提示 2：环境变量冲突检测
CC-Switch 会自动检测并提示环境变量冲突，避免配置问题导致 CLI 工具无法正常运行。
提示 3：多语言支持
v3.8.0 版本新增日语界面支持，可在设置中切换语言。
🔗 项目资源
GitHub 仓库：https://github.com/farion1231/cc-switch
问题反馈：GitHub Issues
最新版本：Releases 页面
修改于 2026-05-13 15:20:24
上一页
Linux 平台
下一页
Claude Code 配置教程
Built with