创智AI
教程CC-Switch

CC-Switch 安装与使用

CC-Switch 是一个跨平台桌面工具,可以图形化管理 Claude Code、Codex、Gemini CLI 等多个 AI 助手的代理配置,无需手动编辑环境变量。

为什么用 CC-Switch?
  • 图形界面一键切换不同的 API 供应商,告别手动改环境变量
  • 支持多账号:工作号、个人号、团队号同时管理
  • 内置 MCP 服务器管理、Skills 安装、Prompt 管理
  • 跨平台:Windows / macOS / Linux 全支持
1

前置条件

确保已安装 Claude Code。如果还没安装,请先完成 Claude Code 安装教程

2

安装 CC-Switch

# 方式 1:从 GitHub Releases 下载 MSI 安装包
# https://github.com/farion1231/cc-switch/releases

# 方式 2:PowerShell 一键安装
irm https://raw.githubusercontent.com/farion1231/cc-switch/main/install.ps1 | iex

安装完成后启动 CC-Switch 应用。

3

添加创智AI供应商

在 CC-Switch 中操作:

  1. 点击左侧 "Provider" 面板中的 "+" 按钮
  2. 填写供应商名称:创智AI
  3. 填写请求地址(BASE_URL):
https://api.my-genesis.top/v1
  1. 填写 API Key(在 API Key 管理 中获取)
  2. 点击 "保存"
4

启用并验证

点击创智AI供应商旁的开关将其启用,然后打开终端:

claude
# 输入 /status 检查连接

注意事项

重启电脑后配置丢失

CC-Switch 重启后可能覆盖 Claude 的自定义配置。解决方法:在 CC-Switch 的供应商配置中编辑 JSON,将自定义的 env 配置添加进去。

CC-Switch 和手动环境变量冲突

使用 CC-Switch 后,建议不要再手动设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 环境变量,由 CC-Switch 统一管理。