Skip to main content

​
Syon接入 CC Switch

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

​
一、安装 CC Switch

请安装 v3.16.5 及以上版本。 macOS 用户（推荐）通过 Homebrew 安装：
或访问 CC Switch Releases 下载对应平台安装包：
  • macOS：.dmg / .zip
  • Windows：.msi 安装版 / Portable .zip 绿色版
  • Linux：.deb / .rpm / .AppImage
首次打开如被 macOS Gatekeeper 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。

​
二、接入 Claude Code 命令行

从零安装 Claude Code：参考Syon 接入 Claude Code命令行 如果你已经装了 CC Switch 和 Claude Code，按以下步骤把 Syon 添加为 Claude Code 的供应商：

​
添加 Syon 供应商

  • 打开 CC Switch，主界面顶部切到 Claude Code。
CC Switch Claude Code 标签
  • 点击右上角 「橙色加号」 按钮，弹出 「添加新供应商」 对话框。
  • 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
选择 Syon 预设供应商
  • 填入你的API Key：
填写 Syon API Key
  • 点击底部 「添加」 保存。

​
启用 Syon 供应商

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

​
三、接入 Claude Desktop

安装 Claude Desktop：访问 Claude Desktop 官网 下载对应平台版本：
  • macOS：下载 .dmg 双击安装；或 brew install --cask claude
  • Windows：下载 .exe 安装程序运行
如果你已经装了 CC Switch 和 Claude Desktop，按以下步骤把 Syon 添加为 Claude Desktop 的供应商：

​
添加 Syon 供应商

  • 打开 CC Switch，主界面顶部切到 Claude Desktop tab。
  • 点击右上角 「橙色加号」按钮，弹出 「添加新供应商」 对话框。
  • 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
Claude Desktop 选择 Syon 供应商
  • 填写API Key：
Claude Desktop 填写 API Key
  • 点击右下角 「+ 添加」 保存。

​
启用 Syon 供应商

回到主界面 Claude Desktop tab，在 Syon 供应商卡片上点 「启用」。切换成功后会弹出提示： 切换成功，重启 Claude Desktop 后生效 Claude Desktop 启用 Syon 按提示完整重启 Claude Desktop 应用，即可使用。

​
四、接入 Codex

安装 Codex：参考接入 Codex 如果你已经装了 CC Switch 和 Codex，按以下步骤把 Syon 添加为 Codex 的供应商：

​
添加 Syon 供应商

  • 打开 CC Switch，主界面顶部切到 Codex tab。
  • 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
  • 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
Codex 选择 Syon 供应商
  • 填入基础字段：「API Key」——粘贴你在 Syon Dashboard 创建的 key
  • 点击底部 「+ 添加」 保存。

​
启用 Syon 供应商

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

​
五、接入 Gemini CLI

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

​
六、接入 OpenCode

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

​
七、接入 OpenClaw

参考Syon接入 OpenClaw。

​
八、接入 Hermes Agent

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

​
添加 Syon 供应商

打开 CC Switch，主界面顶部切到 Hermes tab。
点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
填入字段： 「供应商标识」：syon（只能小写字母/数字/连字符，会作为 config.yaml 中的供应商 key）
  • 「供应商名称」：Syon
  • 「官网链接」（可选）：https://syon.ai
  • 「API 模式」：保持默认 OpenAI Chat Completions。
  • 「API 端点」：https://api.syon.ai/v1
  • 「API Key」：粘贴你在 Syon 控制台 创建的 key
「模型列表」：点 「获取模型列表」 自动拉取 Syon 可用模型，或点 「+ 添加模型」 手动填。每个模型至少填 「模型 ID」 + 「显示名称」（显示名称不能留空）。第一个模型会写入顶层 model.default，建议把 claude-opus-4-7 放第一位。
点击底部 「+ 添加」 保存。

​
启用 Syon 供应商

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

​
在 Hermes 里切换到 Syon

回到终端执行：
进入 「Select provider」 wizard，顶部提示 ↑↓ navigate ENTER/SPACE select ESC cancel，按以下操作：
  • 用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：
  • 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样：
之后直接执行 hermes 进会话，即可使用。 上一篇Cherry Studio下一篇OpenClaw