前言：告别手动改配置的烦恼

用 Claude Code 写代码时，最让人崩溃的不是 AI 的水平，而是繁琐的配置管理。每次想换一个 API 供应商，都需要打开终端、找到配置文件、手动修改 BASE_URL 和 API_KEY。一旦格式写错，Claude Code 就会直接启动失败。

CC Switch 正是为解决这个痛点而生的工具。它提供了一个可视化界面，支持一键切换，并能统一管理 Claude Code、Codex、Gemini CLI 等全家桶的配置。

本文将手把手带你完成三步：

1. 安装 CC Switch
2. 注册并接入 weelinking
3. 从此告别手动修改配置文件

💡 特别提示：本文所有操作均以 weelinking 为例。它提供国内直连 Claude 的服务，无需特殊网络设置，按量付费，新用户注册即送体验额度。

一、CC Switch 是什么？

CC Switch 是一款开源、跨平台的桌面工具（GitHub 地址：farion1231/cc-switch）。它的定位是 Claude Code 的「配置管家」——你不再需要手动编辑任何配置文件，所有 API 供应商的增、删、改、切，全部通过图形界面完成。

1.1 支持哪些 AI 编程工具？

CLI 工具	说明
Claude Code	Anthropic 官方 CLI，本文主角
Codex	OpenAI 的 AI 编程工具
OpenCode	开源 AI 编程助手
Gemini CLI	Google 的 AI 命令行工具

1.2 核心功能一览

功能	说明
供应商管理	添加、编辑、删除多个 API 供应商，一键切换
内置预设模板	常见供应商开箱即用，填 Key 就能用
MCP 统一管理	跨 CLI 统一管理 MCP 服务器（stdio/http/sse）
Skills 管理	从 GitHub 一键安装 Claude Skills
系统托盘	常驻托盘，右键菜单快速切换
深链接导入	ccswitch:// 协议，一键导入配置
全局代理	为 CC Switch 本身设置代理

二、安装 CC Switch

2.1 Windows 安装（推荐 .msi 安装包）

1. 下载：访问 GitHub Releases 页面，下载最新版本中以 .msi 为后缀的安装包（例如：CC-Switch-v3.10.3-Windows.msi）。

2. 安装：双击下载的 .msi 文件，按照安装向导完成安装。

3. 启动：安装完成后，在任务栏右下角的系统托盘区域会出现 CC Switch 的图标。

   ⚠️ 踩坑提示：

   • 若 Windows 弹出「Windows 已保护你的电脑」的 SmartScreen 提示，点击「更多信息」→「仍要运行」即可。这是正常的开源软件安全提示。
   • 便携版：如果你不想安装，也可以下载 .zip 便携包，解压后直接运行 cc-switch.exe。

2.2 macOS 安装（推荐 Homebrew）

1. 使用 Homebrew 安装：
   打开终端，依次执行以下命令：

   # 第一步：添加 tap 源
   brew tap farion1231/ccswitch
   
   # 第二步：安装 cc-switch
   brew install --cask cc-switch
   

2. 启动：在「应用程序」文件夹中找到 CC Switch 打开，或通过 Spotlight（⌘ + Space）搜索「CC Switch」。

   ⚠️ 踩坑提示：

   • 若首次打开提示「无法验证开发者」，请前往「系统设置」→「隐私与安全性」，点击「仍要打开」；或者右键点击应用图标选择「打开」。
   • 手动安装：从 GitHub Releases 下载 .dmg 或 .zip 文件，将应用拖入「应用程序」文件夹即可。

2.3 Linux 安装

• Ubuntu / Debian（.deb 包）：

  # 从 GitHub Releases 下载最新 .deb 包（请替换版本号）
  wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_3.10.x_amd64.deb
  # 安装
  sudo dpkg -i cc-switch_3.10.x_amd64.deb
  

• Arch Linux（AUR）：

  paru -S cc-switch-bin
  

• AppImage（通用 Linux）：

  # 下载 .AppImage 文件后赋予执行权限
  chmod +x cc-switch-3.10.x.AppImage
  ./cc-switch-3.10.x.AppImage
  

  ⚠️ 踩坑提示（Linux ARM64）：AppImage 在 ARM64 架构上需要先安装 xdg-utils 才能正常进行桌面集成：

  sudo apt install xdg-utils
  

2.4 验证安装成功

启动 CC Switch 后：

• 主窗口会显示供应商列表（首次打开为空）。
• 系统托盘出现 CC Switch 图标。

如果之前已手动配置过 ~/.claude/settings.json，CC Switch 会在首次启动时自动检测并导入已有配置。

三、注册 weelinking 并获取 API Key

在配置 CC Switch 之前，你需要有一个可用的 API Key。这里我们使用 weelinking。

1. 打开注册页面：访问 weelinking 注册页面
2. 完成注册：使用微信登录即可完成注册。新用户会自动获得体验额度，无需充值即可完成后续步骤。
3. 创建 API Key：进入「密钥管理」→「创建新密钥」。生成的密钥格式类似 sk-xxxxxxxxxxxxxxxxxx，请复制并保存好，这就是后面要填入 CC Switch 的 API Key。

weelinking 配置信息汇总：

参数	值
Base URL	https://api.weelinking.com
API Key	在控制台创建，以 sk- 开头
支持模型	Claude Sonnet、Claude Opus 等全系列

四、在 CC Switch 中添加 weelinking 供应商

这是本文最核心的一步。

4.1 打开添加界面

启动 CC Switch，在主界面点击右上角的 「+」 按钮或 「Add Provider」。

4.2 填写供应商信息

在弹出的对话框中，按照以下信息填写：

字段	填写内容	说明
Provider Name	weelinking	自定义一个方便识别的名称
Base URL	https://api.weelinking.com	weelinking 的 API 地址
API Key	sk-你的密钥	刚才从 weelinking 复制的密钥

⚠️ 踩坑提示：Base URL 末尾不要加斜杠（/）。填写 https://api.weelinking.com 即可，否则部分版本的 Claude Code 在拼接路径时会出现双斜杠错误。

4.3 保存供应商

点击 「Add」 完成添加。添加成功后，weelinking 会出现在供应商列表中。

4.4 启用 weelinking 配置

在供应商列表中，找到刚添加的 weelinking，点击右侧的 「Enable」（启用）按钮。当按钮变为 「使用中」 或 「Active」 状态时，说明配置已成功写入 Claude Code 的配置文件。

此时，CC Switch 在后台自动完成了以下配置的写入（~/.claude/settings.json）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_BASE_URL": "https://api.weelinking.com",
    // ... 其他模型配置
  },
  "includeCoAuthoredBy": false
}

以前需要手动完成的工作，现在都由 CC Switch 自动处理了。

4.5 验证配置生效

打开终端，启动 Claude Code：

claude

如果看到正常的 Claude Code 交互界面，并能成功提问和得到回复，说明 weelinking 已经成功接入。

⚠️ 踩坑提示：如果启动后提示 Invalid API Key 或 Authentication Error，请检查：

• weelinking 的 API Key 是否复制完整（开头为 sk-，无多余空格）。
• Base URL 是否正确（https://api.weelinking.com，无多余路径）。
• 在 CC Switch 中点击该供应商旁的「健康检查」按钮，看是否通过。

五、日常使用与进阶功能

5.1 日常使用：一键切换供应商

配置好多个供应商后，CC Switch 的真正价值就体现出来了。只需右键点击系统托盘图标，即可在已启用的供应商之间快速切换，无需关闭或重启终端。

5.2 进阶：MCP 服务器统一管理

点击顶部导航的 「MCP」 标签，可以统一管理 MCP 服务器（如连接数据库、Slack、GitHub 等）。支持 stdio、http、sse 三种传输类型，一次配置，即可在 Claude Code / Codex / Gemini CLI 等多个工具间共享。

5.3 进阶：Claude Skills 批量安装

点击顶部导航的 「Skills」 标签，CC Switch 会自动扫描 GitHub 上的公开 Skills 仓库。你可以直接在界面中勾选想要的 Skill 并一键安装，它会自动下载并配置到对应的 ~/.claude/skills/ 目录。

5.4 进阶：Prompts 统一管理

点击 「Prompts」 标签，可以管理多套系统提示词（System Prompt）预设，并同步到 CLAUDE.md、AGENTS.md 等文件。你可以为不同场景（如代码审查模式、教学模式）创建不同的提示词，并在不同场景下一键切换。

六、踩坑 & 注意事项

• ⚠️ Windows 路径问题：CC Switch 的数据库文件存放在 %USERPROFILE%\.cc-switch\cc-switch.db。若你的用户名包含中文字符，偶尔可能出现路径识别问题。建议使用英文用户名。
• ⚠️ 切换后未立即生效：大多数情况下切换是热生效的。若遇到切换后不生效，可以尝试关闭当前 Claude Code 会话后重新打开。
• ⚠️ API Key 限流：weelinking 的 API Key 可能有调用频率限制。若遇到 429 Too Many Requests 错误，可在 weelinking 控制台检查或联系客服提升额度。
• ⚠️ 更新后配置丢失：正常更新不会影响数据。但如果是全量删除重装，建议先备份 ~/.cc-switch/cc-switch.db 数据库文件。

七、本篇小结

✅ 今天你学到了：

• CC Switch 是什么，它能解决什么问题。
• 在 Windows / macOS / Linux 上安装 CC Switch 的完整步骤。
• 注册 weelinking 并获取 API Key。
• 在 CC Switch 中添加、启用 weelinking 供应商并验证生效。
• 了解了一键切换、MCP 管理、Skills 管理等进阶功能。

对比一下使用前后的体验：

场景	之前（手动改配置）	之后（CC Switch + weelinking）
切换供应商	打开文件 → 找字段 → 手动改 → 保存	右键托盘 → 点一下
新供应商接入	查文档 → 找配置格式 → 手动写 JSON	填 3 个字段 → 点 Add
出问题排查	不知道是 API 还是配置问题	点健康检查，直接告诉你结果
多 CLI 管理	4 个工具 4 套配置文件，各改各的	一个界面统一管理

希望这篇指南能帮助你彻底告别繁琐的配置工作，更专注于使用 Claude Code 进行高效的开发。

🔗 开始使用 Claude

文中的所有操作，你现在就可以上手。

推荐使用 weelinking 访问 Claude：

优势	说明
🇨🇳 国内直连	无需任何网络配置，打开即用
💰 按量付费	用多少花多少，不浪费
🎁 新用户福利	注册即送体验额度
⚡ 稳定可靠	账号池技术，不掉线

👉 立即注册，免费开始

---