Mixtoken接入 CC Switch

官方 Base URL 对照

不同 Agent 对协议路径的拼接规则不同，请按字段填写准确值。

Agent 字段 官方值
Codex config.toml · base_url https://api.mixtoken.ai/v1
Claude Code ANTHROPIC_BASE_URL https://api.mixtoken.ai
cc-switch · Claude Base URL / ANTHROPIC_BASE_URL https://api.mixtoken.ai
cc-switch · Codex Base URL https://api.mixtoken.ai/v1
WorkBuddy Endpoint https://api.mixtoken.ai/v1

Codex、cc-switch 的 Codex Provider 与 WorkBuddy 使用带 /v1 的 OpenAI-compatible Base URL；Claude Code 与 cc-switch 的 Claude Provider 使用 Mixtoken 根地址，由客户端请求 /v1/messages。

CC Switch 是一款开源的桌面应用，把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七个 AI 工具的供应商配置统一管在一个面板里。

一、安装 CC Switch

请安装 v3.16.5 及以上版本。

macOS 用户（推荐）通过 Homebrew 安装：

plaintext 
brew install --cask cc-switch

或访问 CC Switch Releases 下载对应平台安装包：

  • macOS：.dmg / .zip
  • Windows：.msi 安装版 / Portable .zip 绿色版
  • Linux：.deb / .rpm / .AppImage

首次打开如被 macOS Gatekeeper 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。

二、接入 Claude Code 命令行

从零安装 Claude Code：参考Mixtoken 接入 Claude Code命令行

如果你已经装了 CC Switch 和 Claude Code，按以下步骤把 Mixtoken 添加为 Claude Code 的供应商：

添加 Mixtoken 供应商

  1. 打开 CC Switch，主界面顶部切到 Claude Code。

CC Switch Claude Code 标签

  1. 点击右上角 「橙色加号」 按钮，弹出 「添加新供应商」 对话框。
  2. 选择「自定义供应商」，填写以下必填项：
    • 「供应商名称」：Mixtoken
    • 「API Key」：粘贴你在 Mixtoken 控制台 创建的 key
    • 「请求地址」：https://api.mixtoken.ai（不要添加 /v1/messages，末尾不要加斜杠）

    「备注」「官网链接」「需要模型映射」和「手动指定模型列表」均为可选项，保持默认即可。

  1. 点击底部 「添加」 保存。

启用 Mixtoken 供应商

回到主界面 Claude Code tab，在 Mixtoken 供应商卡片上点 「启用」，并打开Claude Code，即可使用。

三、接入 Claude Desktop

安装 Claude Desktop：访问 Claude Desktop 官网 下载对应平台版本：

  • macOS：下载 .dmg 双击安装；或 brew install --cask claude
  • Windows：下载 .exe 安装程序运行

如果你已经装了 CC Switch 和 Claude Desktop，按以下步骤把 Mixtoken 添加为 Claude Desktop 的供应商：

添加 Mixtoken 供应商

  1. 打开 CC Switch，主界面顶部切到 Claude Desktop tab。
  2. 点击右上角 「橙色加号」按钮，弹出 「添加新供应商」 对话框。
  3. 选择「自定义供应商」，填写以下必填项：
    • 「供应商名称」：Mixtoken
    • 「API Key」：粘贴你在 Mixtoken 控制台 创建的 key
    • 「请求地址」：https://api.mixtoken.ai（末尾不要加斜杠）

    「备注」「官网链接」「需要模型映射」和「手动指定 Claude Desktop 模型列表」均为可选项。使用 claude-sonnet-*、claude-opus-*、claude-haiku-* 模型时，保持默认即可。

  1. 点击右下角 「+ 添加」 保存。

启用 Mixtoken 供应商

回到主界面 Claude Desktop tab，在 Mixtoken 供应商卡片上点 「启用」。切换成功后会弹出提示：

切换成功，重启 Claude Desktop 后生效

按提示完整重启 Claude Desktop 应用，即可使用。

四、接入 Codex

安装 Codex：参考接入 Codex

如果你已经装了 CC Switch 和 Codex，按以下步骤把 Mixtoken 添加为 Codex 的供应商：

添加 Mixtoken 供应商

  1. 打开 CC Switch，主界面顶部切到 Codex tab。
  2. 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
  3. 选择「自定义供应商」，并填写：
    • 「供应商名称」：mixtoken
    • 「Base URL」：https://api.mixtoken.ai/v1
    • 「API Key」：粘贴你在 Mixtoken 控制台 创建的 key
    • 「默认模型」：gpt-5.6-sol
    • 「Wire API」：responses
    • 「Requires OpenAI Auth」：开启
  4. 点击底部 「+ 添加」 保存。

启用 Mixtoken 供应商

回到主界面 Codex tab，在 Mixtoken 供应商卡片上点 「启用」。Codex 不支持热切换——重启你正在运行的 codex 终端进程才生效。

五、接入 Gemini CLI

暂不支持Gemini CLI的接入，全力开发中……

六、接入 OpenCode

参考Mixtoken接入 OpenCode。暂时不支持通过CC Switch接入OpenCode。

七、接入 OpenClaw

参考Mixtoken接入 OpenClaw。

八、接入 Hermes Agent

安装 Hermes Agent：

如果你已经装了 CC Switch 和 Hermes Agent，按以下步骤把 Mixtoken 添加为 Hermes 的供应商：

添加 Mixtoken 供应商

  1. 打开 CC Switch，主界面顶部切到 Hermes tab。

  2. 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。

  3. 填入字段：

    1. 「供应商标识」：mixtoken（只能小写字母/数字/连字符，会作为 config.yaml 中的供应商 key）
    2. 「供应商名称」：Mixtoken
    3. 「官网链接」（可选）：https://api.mixtoken.ai
    4. 「API 模式」：保持默认 OpenAI Chat Completions。
    5. 「API 端点」：https://api.mixtoken.ai/v1
    6. 「API Key」：粘贴你在 Mixtoken 控制台 创建的 key

  4. 「模型列表」：点 「获取模型列表」 自动拉取 Mixtoken 可用模型，或点 「+ 添加模型」 手动填。每个模型至少填 「模型 ID」 + 「显示名称」（显示名称不能留空）。第一个模型会写入顶层 model.default，建议把 claude-opus-4-7 放第一位。

  5. 点击底部 「+ 添加」 保存。

启用 Mixtoken 供应商

回到主界面 Hermes tab，在 Mixtoken 供应商卡片上点 「启用」。CC-Switch 会把配置写入 Hermes 配置文件（默认 ~/.hermes/config.yaml，可在 CC Switch ⚙ 设置「Hermes 配置目录」覆盖）。完整退出并重启 hermes 进程 才生效。

在 Hermes 里切换到 Mixtoken

回到终端执行：

plaintext 
hermes setup

进入 「Select provider」 wizard，顶部提示 ↑↓ navigate ENTER/SPACE select ESC cancel，按以下操作：

  1. 用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：
plaintext 
mixtoken (api.mixtoken.ai/v1) — 模型名
  1. 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样：
plaintext 
→ (●) mixtoken (api.mixtoken.ai/v1) — 模型名   ← currently active

之后直接执行 hermes 进会话，即可使用。

cc-switch 自定义供应商字段

新增供应商时请选择「自定义供应商」。

Claude Code / Claude Desktop Provider

Provider Type: Custom
Provider Name: Mixtoken
API Key: <你的 Mixtoken API Key>
Request URL: https://api.mixtoken.ai

备注、官网链接、模型映射和手动模型列表均为可选项。

Codex Provider

Provider Type: Custom
Provider Name: mixtoken
Base URL: https://api.mixtoken.ai/v1
API Key: <你的 Mixtoken API Key>
Default Model: gpt-5.6-sol
Wire API: responses
Requires OpenAI Auth: true

Claude 的请求地址不要添加 /v1，客户端会请求 /v1/messages；Codex 的 Base URL 必须包含 /v1，Codex 会继续请求 /responses。

准备好了？三步即可开始登录控制台 · 购买额度 · 创建 API Key
获取 API Key查看定价