CC Switch 配置教程

到 GitHub 仓库下载对应系统的安装包：

• Windows：下载 CC-Switch-vX.X.X-Windows.msi，双击安装
• macOS：下载 CC-Switch-vX.X.X-macOS.dmg，拖入 Applications
• Linux：下载 .AppImage 或 .deb 包

GitHub Releases：github.com/farion1231/cc-switch/releases

登录 控制台 → API 密钥，新建一把令牌：

• 分组：选 default（包含 Claude / GPT / Gemini）
• 模型限制：默认不限制（建议留空，所有模型可用）
• 额度：按需设置或勾选「无限制」

创建后，复制完整 sk- 令牌（点令牌行的复制图标）。

在「API 密钥」列表中，点击该令牌行尾的「··· → 导入到 CC Switch」按钮（图标），会弹出配置窗口：

• 应用：选 Claude（或 Codex / Gemini）
• 名称：例如「LinksAPI Claude」
• 主模型：必填，例如 claude-sonnet-4-5-20250929
• Haiku / Sonnet / Opus 模型（可选）：分别填快速 / 主力 / 攻坚模型，CC Switch 会在 Claude Code 自动切换。
  推荐：Haiku → claude-haiku-4-5，Sonnet → claude-sonnet-4-5，Opus → claude-opus-4-7

点「打开 CC Switch」→ 浏览器会弹出「是否在 CC Switch 中打开？」点确认。

导入成功后，CC Switch 会显示刚加的 provider。点右上角的「选中」（圆圈勾选）让它成为当前生效配置。

CC Switch 会自动写到 Claude Code 的配置文件（macOS/Linux 是 ~/.claude/auth.json，Windows 是 %USERPROFILE%\.claude\auth.json），无需手动改环境变量。

打开终端运行：

claude --version

然后随便发一条消息测试：

cd 你的项目目录
claude
> 你好，请回复 LinksAPI-OK

如果模型正常回复，说明已切到 LinksAPI 通道。

Q: 浏览器弹「无法访问此网站 ccswitch://...」？

说明 CC Switch 没启动过、或者协议没注册。打开 CC Switch app 跑一次，再回控制台重新导入。

Q: 导入后 Claude Code 还是 401 ？

检查 CC Switch 里的 Endpoint 是 https://linksapi.cn（不带 /v1，Claude Code 会自动拼接）。控制台一键导入是正确的，如果你手动改过就要注意这一点。

Q: CC Switch 同时管理多个 provider 怎么切？

每个 provider 旁边有圆圈，点选哪个就用哪个。切换后 Claude Code 重启或新开窗口即可生效。

Q: Codex / Gemini CLI 怎么配？

同样在控制台一键导入，「应用」选 Codex 或 Gemini 即可，Endpoint 会自动调整（Codex 需要带 /v1，CC Switch 自动处理）。