> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch 接入 BetterToken 指南

> 在 CC Switch 中接入 BetterToken，统一管理 Claude Code、Codex CLI、OpenCode 和 OpenClaw。

CC Switch 是一款跨平台桌面工具，用来统一管理 Claude Code、Codex、OpenCode 和 OpenClaw 的供应商配置。这篇文档介绍如何在 CC Switch 中接入 BetterToken，并覆盖 Claude Code、Codex、OpenCode、OpenClaw 这四条已确认的接入路径。

## 安装 CC Switch

<Tabs>
  <Tab title="macOS">
    推荐优先使用 Homebrew；也可以从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载最新版 `.dmg` 或 `.zip`。

    ```bash theme={null}
    brew tap farion1231/ccswitch
    brew install --cask cc-switch
    ```
  </Tab>

  <Tab title="Windows">
    从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载最新版 `CC-Switch-v{version}-Windows.msi` 或便携版 `.zip`，然后按安装向导完成安装。
  </Tab>

  <Tab title="Linux">
    从 [GitHub Releases](https://github.com/farion1231/cc-switch/releases) 下载最新版 `.deb`、`.rpm` 或 `.AppImage`。
  </Tab>
</Tabs>

## 开始前准备

* BetterToken API Key（<a href={"https://www.bettertoken.ai/register"}>注册并获取</a>）
* Claude Code 使用 Anthropic 协议：`Base URL` 填 `https://www.bettertoken.ai`
* Codex、OpenCode、OpenClaw 使用 OpenAI-compatible 协议：`Base URL` 填 `https://www.bettertoken.ai/v1`
* 给 Codex、OpenCode、OpenClaw 准备一个当前可用的 **GPT 分组**模型 ID。你可以从 <a href={"https://www.bettertoken.ai/pricing"}>BetterToken 模型广场</a> 复制，或在 CC Switch 里用 **获取模型** 直接从 `/v1/models` 拉取

<Info>
  CC Switch 首次启动时会自动导入本机已有的配置。你可以保留官方 provider 作为回退，再新增 BetterToken。
</Info>

<Note>
  BetterToken 同时提供 Anthropic 和 OpenAI-compatible 两种接入模式。为了避免把 `https://www.bettertoken.ai` 和 `https://www.bettertoken.ai/v1` 混在一起，建议在 CC Switch 里按应用分别创建 provider，而不是把 Claude Code 和 OpenAI-compatible 工具合并到一个统一供应商。
</Note>

## 添加 BetterToken provider

<Tabs>
  <Tab title="Claude Code" id="claude-code">
    <Steps>
      <Step title="切到 Claude Code 并添加 provider">
        打开 CC Switch，切到 **Claude Code**，点击 **Add Provider**。

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/claude-code-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=517f215f5f828187647dd214eacfe19b" alt="CC Switch 的 Claude Code 页面，右上角加号按钮用于新增 provider。" style={{ borderRadius: '0.5rem' }} width="2000" height="1792" data-path="images/cc-switch/claude-code-add-provider.png" />
        </Frame>
      </Step>

      <Step title="填写基础字段">
        * **Provider Name**：`BetterToken-claude`（也可使用便于区分的名称）
        * **Base URL**：`https://www.bettertoken.ai`
        * **API Key**：你的 BetterToken API Key

        下图中的标注对应：

        1. **Provider Name**
        2. **API Key**
        3. **Base URL**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=514944678fb16510d03f0f2610bd8b70" alt="CC Switch 的 Claude Code provider 编辑页面，标出了 Provider Name、API Key 和 API Endpoint 的填写位置。" style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="按 API Key 分组处理模型映射">
        * 如果你使用 **Claude 分组**，通常不需要再调整高级选项或模型映射
        * 如果你使用 **GPT 分组**，请额外完成下面这些设置：

        1. 打开 **高级选项**
        2. 在 **API 格式** 中选择 **OpenAI Responses API**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-api-format.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5605667b764f033854f78dc981592f84" alt="CC Switch 的高级选项区域，API 格式被设置为 OpenAI Responses API。" style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-api-format.png" />
        </Frame>

        3. 在 **模型映射** 里点击 **获取模型列表**
        4. 将 **主模型**、**推理模型（Thinking）**、**Haiku 默认模型**、**Sonnet 默认模型**、**Opus 默认模型** 都从下拉列表中显式选中

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-model-mapping.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=d1104cc24dae2825dfed3a6be53dc6b3" alt="CC Switch 的模型映射区域，展示了获取模型列表以及主模型、Thinking、Haiku、Sonnet、Opus 的映射位置。" style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-model-mapping.png" />
        </Frame>

        这里使用的模型都应来自 <a href={"https://www.bettertoken.ai/pricing"}>BetterToken 模型广场</a> 当前可用的 **GPT 分组**模型 ID。
      </Step>

      <Step title="保存、切换，并按分组决定是否开启代理">
        保存后，回到渠道列表页：

        1. 将刚保存的 BetterToken provider 设为 **使用中**
        2. 如果你使用 **Claude 分组**，不需要打开左上角的 **CC Switch 代理功能**
        3. 如果你使用 **GPT 分组**，再打开左上角的 **CC Switch 代理功能**

        下图展示保存后在 provider 列表中确认 BetterToken-claude 已启用。只有使用 **GPT 分组**时，才需要额外打开左上角的 **CC Switch 代理功能**。

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/claude-code-enable-proxy.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=13c9adc5d76d5a2d1fae0e52e90a87ca" alt="CC Switch provider 列表中，BetterToken-claude 已被选中并显示为 In Use。" style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/claude-code-enable-proxy.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex" id="codex-cli">
    <Steps>
      <Step title="切到 Codex 并添加 provider">
        打开 CC Switch，切到 **Codex**，点击 **Add Provider**。如果界面先让你选预设，优先选择 **OpenAI Compatible** 或 **Custom** 这一类自定义 OpenAI-compatible provider。

        图中对应顺序如下：

        1. 切到 **Codex**
        2. 点击右上角 **Add Provider**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/qbH0nwqS9mSIdsda/images/cc-switch/codex-cli-add-provider.png?fit=max&auto=format&n=qbH0nwqS9mSIdsda&q=85&s=5f892bf124c432babed54886c6051632" alt="CC Switch 的 Codex 页面，顶部选中了 Codex，右上角加号按钮用于新增 provider。" style={{ borderRadius: '0.5rem' }} width="1800" height="1532" data-path="images/cc-switch/codex-cli-add-provider.png" />
        </Frame>
      </Step>

      <Step title="填写基础字段">
        * **Provider Name**：`BetterToken`
        * **Base URL**：`https://www.bettertoken.ai/v1`
        * **API Key**：你的 BetterToken API Key

        如果你切到了自定义配置视图，确保底层配置使用 `wire_api = "responses"`。

        图中标注对应：

        1. **Provider Name**
        2. **API Key**
        3. **Base URL**

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/cc-switch/codex-cli-basic-fields.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=a6483a11bcf6eaf3663134f407843391" alt="CC Switch 的 Codex provider 编辑页，标出了 Provider Name、API Key 和 Base URL 的填写位置。" style={{ borderRadius: '0.5rem' }} width="2000" height="1300" data-path="images/cc-switch/codex-cli-basic-fields.png" />
        </Frame>
      </Step>

      <Step title="保存并切换">
        保存后将 BetterToken 设为当前 provider。CC Switch 会把对应配置写入 Codex 的认证和配置文件。

        保存后回到列表页，确认 BetterToken 这一项显示为 **使用中**。

        <Frame>
          <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/cc-switch/codex-cli-activate-provider.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=52dc850977af1443b4b573a27726c4b5" alt="CC Switch 的 Codex provider 列表页，BetterToken 已被选中，并显示为使用中。" style={{ borderRadius: '0.5rem' }} width="1800" height="1686" data-path="images/cc-switch/codex-cli-activate-provider.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenCode" id="opencode">
    <Steps>
      <Step title="切到 OpenCode 并添加 provider">
        打开 CC Switch，切到 **OpenCode**，点击 **Add Provider**。如果界面先让你选预设，优先选择 **OpenAI Compatible** 或 **Custom**。
      </Step>

      <Step title="填写基础字段">
        * **Provider Name**：`BetterToken`
        * **Base URL**：`https://www.bettertoken.ai/v1`
        * **API Key**：你的 BetterToken API Key
      </Step>

      <Step title="选择默认模型">
        优先点击 **获取模型**。如果需要手动填写，请直接使用 <a href={"https://www.bettertoken.ai/pricing"}>BetterToken 模型广场</a> 中当前可用的 **GPT 分组**模型 ID。
      </Step>

      <Step title="保存并切换">
        保存后将 BetterToken 设为当前 provider。
      </Step>
    </Steps>
  </Tab>

  <Tab title="OpenClaw" id="openclaw">
    <Steps>
      <Step title="切到 OpenClaw 并添加 provider">
        打开 CC Switch，切到 **OpenClaw**，点击 **Add Provider**。如果界面先让你选预设，优先选择 **OpenAI Compatible** 或 **Custom**。
      </Step>

      <Step title="填写基础字段">
        * **Provider Name**：`BetterToken`
        * **Base URL**：`https://www.bettertoken.ai/v1`
        * **API Key**：你的 BetterToken API Key

        如果你进入的是 OpenClaw 的自定义 provider 配置视图，确保 `api` 写成 `openai-responses`。
      </Step>

      <Step title="选择默认模型">
        优先点击 **获取模型**。如果需要手动填写，请使用当前可用的 **GPT 分组**模型 ID。
      </Step>

      <Step title="保存并切换">
        保存后将 BetterToken 设为当前 provider。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 保存后如何生效

所有配置保存并切换完成后，都建议先重启对应客户端或网关，再开始验证。

* Claude Code：完全退出当前 Claude Code 会话，再重新启动。
* Codex：重启当前 Codex 进程，或新开一个终端会话。
* OpenCode：退出当前 OpenCode 会话并重新启动。
* OpenClaw：执行 `openclaw gateway restart`，再在 Discord 中依次执行 `/new`、`/status`、`/model`。

## 常见问题

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

## 相关页面

* Claude Code 细节配置：[Claude Code](/zh/ai-tools/claude-code)
* Codex 细节配置：[Codex](/zh/ai-tools/codex)
* OpenCode 细节配置：[OpenCode](/zh/ai-tools/opencode)
* OpenClaw 细节配置：[OpenClaw](/zh/ai-tools/openclaw)

## 相关 FAQ

* [OpenAI-compatible API 和 Anthropic-compatible API 有什么区别？](/zh/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP 和 API Key / Base URL 有什么区别？](/zh/faq/concepts/mcp-vs-api-key-base-url)
* [Codex CLI 中 model\_provider、base\_url 和 wire\_api 是什么？](/zh/faq/codex/model-provider-base-url-wire-api)
* [Cline 如何配置 OpenAI-compatible API？](/zh/faq/cline/openai-compatible-api)