跳转到主要内容
CC Switch 是一款跨平台桌面工具，用来统一管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 的供应商配置。这篇文档介绍如何在 CC Switch 中接入 BetterToken，并覆盖 Claude Code、Codex CLI、OpenCode、OpenClaw 这四条已确认的接入路径。
Gemini CLI 需要 Google / Vertex AI 协议。当前 BetterToken 文档还没有确认这条接入路径，所以本文不展开。

​
安装 CC Switch

推荐优先使用 Homebrew；也可以从 GitHub Releases 下载最新版 .dmg 或 .zip。
brew tap farion1231/ccswitch
brew install --cask cc-switch

​
开始前准备

  • BetterToken API Key（注册并获取）
  • Claude Code 使用 Anthropic 协议：Base URL 填 https://www.bettertoken.ai
  • Codex CLI、OpenCode、OpenClaw 使用 OpenAI-compatible 协议：Base URL 填 https://www.bettertoken.ai/v1
  • 给 Codex CLI、OpenCode、OpenClaw 准备一个当前可用的 Codex 分组模型 ID。你可以从 BetterToken 模型广场 复制，或在 CC Switch 里用 获取模型 直接从 /v1/models 拉取
CC Switch 首次启动时会自动导入本机已有的配置。你可以保留官方 provider 作为回退，再新增 BetterToken。
BetterToken 同时提供 Anthropic 和 OpenAI-compatible 两种接入模式。为了避免把 https://www.bettertoken.ai 和 https://www.bettertoken.ai/v1 混在一起，建议在 CC Switch 里按应用分别创建 provider，而不是把 Claude Code 和 OpenAI-compatible 工具合并到一个统一供应商。

​
添加 BetterToken provider

1

切到 Claude Code 并添加 provider

打开 CC Switch，切到 Claude Code，点击 Add Provider。
CC Switch 的 Claude Code 页面，右上角加号按钮用于新增 provider。
2

填写基础字段

  • Provider Name：BetterToken
  • Base URL：https://www.bettertoken.ai
  • API Key：你的 BetterToken API Key
下图中的标注对应：
  1. Provider Name
  2. API Key
  3. Base URL
CC Switch 的 provider 编辑页面，标出了 Provider Name、API Key 和 Base URL 的填写位置。
3

按 API Key 分组处理模型映射

  • 如果你使用 Claude_* 分组，通常不需要再调整高级选项或模型映射
  • 如果你使用 Codex_* 分组，请额外完成下面这些设置：
  1. 打开 高级选项
  2. 在 API 格式 中选择 OpenAI Responses API
CC Switch 的高级选项区域，API 格式被设置为 OpenAI Responses API。
  1. 在 模型映射 里点击 获取模型列表
  2. 将 主模型、推理模型（Thinking）、Haiku 默认模型、Sonnet 默认模型、Opus 默认模型 都从下拉列表中显式选中
CC Switch 的模型映射区域，展示了获取模型列表以及主模型、Thinking、Haiku、Sonnet、Opus 的映射位置。
这里使用的模型都应来自 BetterToken 模型广场 当前可用的 Codex 分组模型 ID。
4

保存、切换，并按分组决定是否开启代理

保存后，回到渠道列表页：
  1. 将刚保存的 BetterToken provider 设为 使用中
  2. 如果你使用 Claude_* 分组，不需要打开左上角的 CC Switch 代理功能
  3. 如果你使用 Codex_* 分组，再打开左上角的 CC Switch 代理功能
下图示例对应需要开启代理的 Codex_* 分组场景。
保存后回到渠道列表页，将 BetterToken 设为使用中，并打开左上角的 CC Switch 代理开关。

​
保存后如何生效

所有配置保存并切换完成后，都建议先重启对应客户端或网关，再开始验证。
  • Claude Code：完全退出当前 Claude Code 会话，再重新启动。
  • Codex CLI：重启当前 Codex CLI 进程，或新开一个终端会话。
  • OpenCode：退出当前 OpenCode 会话并重新启动。
  • OpenClaw：执行 openclaw gateway restart，再在 Discord 中依次执行 /new、/status、/model。

​
常见问题

  • Claude Code 的 Base URL 不要加 /v1
  • Claude Code 使用 Codex_* 分组时，要在 高级选项 里把 API 格式 切到 OpenAI Responses API
  • Claude Code 使用 Claude_* 分组时，不需要打开 CC Switch 代理功能
  • Codex CLI、OpenCode、OpenClaw 的 Base URL 要写 https://www.bettertoken.ai/v1
  • Codex CLI、OpenCode、OpenClaw 默认模型请使用 Codex 分组模型 ID，不要沿用 Claude 风格模型名
  • 如果 获取模型 失败，先检查 API Key 和 Base URL，再改为手动粘贴模型 ID
  • 如果切换后没有生效，先确认 BetterToken provider 已被设为当前 provider，再按上面的方式重启对应客户端或网关

​
相关页面