TokenRa
English登录注册

工具集成 · Claude Code · Codex

在 CC Switch 中使用 TokenRa

CC Switch 是一款开源桌面应用，用来集中管理 Claude Code、Codex 等编程工具的 API 供应商，并一键切换。TokenRa 控制台可以把 API Key 直接导入 CC Switch。

适用工具
Claude Code, Codex
Claude Code 地址
https://tokenra.io
Codex 地址
https://tokenra.io/v1
对照版本
CC Switch v4.0.21

Before you start

准备工作

  • TokenRa API Key：注册账号后，在控制台的「API 密钥」页面创建。Key 以 sk- 开头。
  • 已安装 Claude Code 或 Codex CLI。不使用 CC Switch 的配置方法见各自的页面：Claude Code、Codex CLI。
实测范围
CC Switch 写入的 Claude Code、Codex 配置已于 2026-10-29 在这两个工具中对 TokenRa 实测可用。CC Switch 的操作步骤以其 v4.0.21 用户手册为准，我们没有实际操作该桌面应用。

Install

安装 CC Switch

从 GitHub Releases 下载 CC Switch：Windows 10 及以上用 .msi 安装包或绿色版 .zip，macOS 12 及以上用 .dmg，Linux 用 .deb、.rpm 或 .AppImage。项目唯一的官方网站是 ccswitch.io。也可以用包管理器安装：

SHELL
# macOS（Homebrew）
brew install --cask cc-switch

# Arch Linux
paru -S cc-switch-bin

首次启动时，CC Switch 会把现有的 Claude Code、Codex 配置导入为名为 default 的供应商，随时可以切换回去。

One click

从 TokenRa 控制台一键导入

  1. 登录后打开控制台的「API 密钥」页面。
  2. 在要使用的 Key 所在行打开操作菜单，选择 CC Switch。
  3. 在「填入 CC Switch」对话框中选择应用（Claude 或 Codex），按需修改名称，并选择主模型。选 Claude 时请同时填写 Haiku、Sonnet、Opus 模型（可以填同一个模型 ID），因为 Claude Code 的模型别名和后台任务会用到它们。
  4. 点击「打开 CC Switch」，并在浏览器的提示中允许打开应用。
  5. CC Switch 会弹出导入确认框，显示接口地址、打码后的 Key 和模型。确认导入即可；开启「导入后立即切换」时，TokenRa 会直接成为当前供应商。
链接中包含你的 Key
控制台会在浏览器中生成 ccswitch:// 链接，并把这把 Key 写在链接里。请只在自己的电脑上使用，不要转发。对话框中也有 Gemini 选项，但 TokenRa 对 Gemini CLI 的支持还在准备中，请选择 Claude 或 Codex。
Codex 搭配 MiniMax M3.1 Flash
请在 CC Switch 中编辑该供应商，在 config.toml 里加上 web_search = "disabled"，否则请求会返回 HTTP 400，原因见 Codex CLI 页面。

Manual

手动添加供应商

在 CC Switch 侧栏选中要配置的工具，点击右上角的「+」（添加供应商），选择「自定义配置」。名称填 TokenRa，粘贴下面的配置并把 sk-... 换成你的 Key。模型输入框旁的「获取模型列表」按钮会读取 /v1/models，使用 TokenRa 的 Key 即可获取。

Claude Code

settings.json · env
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://tokenra.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4.1-flash"
  }
}

Codex

Codex 的表单分为 auth.json 和 config.toml 两部分：

auth.json
{
  "OPENAI_API_KEY": "sk-..."
}
config.toml
model_provider = "custom"
model = "deepseek-v4.1-flash"
web_search = "disabled"

[model_providers.custom]
name = "TokenRa"
base_url = "https://tokenra.io/v1"
wire_api = "responses"
requires_openai_auth = true

CC Switch 管理的 Codex 供应商统一写在 [model_providers.custom] 中，切换时会把 Key 写成该表的 experimental_bearer_token。这一配置已于 2026-10-29 在 Codex CLI 0.165.0 中实测可用。

Switch

切换供应商

  • 在主界面点击 TokenRa 卡片上的「启用」，或在系统托盘的 CC Switch 菜单中直接选择。
  • Claude Code 无需重启即可生效；Codex 切换后需要重新启动。
  • 要换回原来的配置，启用 default 或官方供应商即可。

FAQ

常见问题

CC Switch 会修改哪些文件？

Claude Code 是 ~/.claude/settings.json，Codex 是 ~/.codex/config.toml。CC Switch 只替换地址、Key、模型等连接信息，并会在第一次改写前自动备份原文件。

地址要不要带 /v1？

Claude Code 用 https://tokenra.io，不带 /v1；Codex 用 https://tokenra.io/v1。从控制台一键导入时会自动填对。

点击「打开 CC Switch」没有反应

可能是没有安装 CC Switch，或浏览器拦截了 ccswitch:// 链接。安装 CC Switch 后再点一次并允许浏览器打开应用，或按上文手动添加供应商。

Codex 报错 400，提示不支持联网搜索

在 CC Switch 中给该供应商的 config.toml 加上 web_search = "disabled"，然后重启 Codex。