快速开始 / 接入 Agent 工具

接入 CC Switch

CC Switch 是一款开源的桌面应用，支持 Windows、macOS 和 Linux，可以集中管理 Claude Code、Codex、OpenCode、OpenClaw、Hermes、Pi 等工具的模型提供方，点一下就能在不同提供方之间切换，不用手动改配置文件。本站支持从控制台一键导入到 CC Switch。

1. 安装 CC Switch

从 CC Switch 官网或 GitHub Releases 下载对应系统的安装包。CC Switch 是免费软件，不要从其他渠道下载。

CC Switch 只负责管理配置，Claude Code、Codex 等工具本身还需要安装。可以在 CC Switch 侧栏底部的 应用 页一键安装，也可以按各工具的接入指南安装，例如Claude Code、Codex。

2. 一键导入本站（推荐）

一键导入需要 CC Switch v4.0.10 或更高版本。

1. 在控制台的 API Keys 页创建 Key。创建成功的弹窗里，在 一键配置 中选择 CC Switch。
2. 点击要使用的工具，例如 导入到 Claude Code。浏览器询问是否打开 CC Switch 时，选择允许。
3. CC Switch 会弹出导入确认框，显示地址、打码后的 Key 和模型。核对无误后点 导入。
4. Claude Code 和 Codex 同一时间只能用一个提供方：在确认框里打开 导入后立即切换，或导入后在供应商列表里点 TokenJoy 卡片上的 切换。OpenCode、OpenClaw、Hermes、Pi 可以同时使用多个提供方，导入后直接写入这些工具的配置。

完整的 Key 只在创建时显示一次。弹窗已经关掉的话，可以在 API Keys 页重置 Key，用新弹窗导入；也可以按下一节手动添加。每个工具单独导入一次，同一个按钮点两次会导入两份，删掉多余的即可。

各工具导入的内容如下，与本文档中各工具接入指南的手动配置一致：

3. 手动添加

在 CC Switch 侧栏选中要配置的工具，点页头右侧的 添加供应商，在预设列表中选择 自定义配置，名称填写 TokenJoy，然后按工具填写下面的配置。API Key 在控制台的 API Keys 页创建。

Claude Code

配置编辑框中填写：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenjoy.org",
    "ANTHROPIC_AUTH_TOKEN": "<你的 API Key>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 让 Claude Code 从本站读取模型列表，/model 中能看到 GPT、DeepSeek 等全部模型。

Codex

Codex 的编辑框分为两部分。auth.json 部分填写 Key：

{
  "OPENAI_API_KEY": "<你的 API Key>"
}

config.toml 部分填写：

model_provider = "custom"
model = "gpt-5"

[model_providers.custom]
name = "TokenJoy"
base_url = "https://api.tokenjoy.org/v1"
wire_api = "responses"
model_catalog_url = "https://api.tokenjoy.org/v1/models"

model_catalog_url 让 Codex 从本站读取模型列表，/model 中能看到全部模型。

OpenCode、OpenClaw、Hermes、Pi

按上一节表格中的接口格式、地址和模型填写，API Key 填写本站的 Key。也可以点模型输入框旁的 获取模型列表，从本站读取可用模型后勾选。

4. 切换与生效

• 在 CC Switch 中点 TokenJoy 卡片上的 切换，卡片显示 使用中 即已切换。也可以右键系统托盘中的 CC Switch 图标，在对应工具的子菜单里切换。
• Claude Code 切换后立即生效，不需要重启。进去后输入 /status，Base URL 显示为 https://api.tokenjoy.org 即配置成功。
• Codex 切换后需要重启：命令行退出后重新运行 codex，桌面版彻底退出后再打开。
• CC Switch 切换时只改地址、Key、模型等关键字段，插件、MCP、权限等其他设置保持不变。

常见问题

其他报错见错误码和其他 Agent中的排查步骤。