Syon接入 CC Switch
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](https://github.com/farion1231/cc-switch/releases) 下载对应平台安装包：
- macOS：`.dmg` / `.zip`
- Windows：`.msi` 安装版 / Portable `.zip` 绿色版
- Linux：`.deb` / `.rpm` / `.AppImage`
首次打开如被 macOS Gatekeeper 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。
## 二、接入 Claude Code 命令行
从零安装 Claude Code：参考[Syon 接入 Claude Code命令行](/zh/docs/install-claude-code)
如果你已经装了 CC Switch 和 Claude Code，按以下步骤把 Syon 添加为 Claude Code 的供应商：
### 添加 Syon 供应商
- 打开 CC Switch，主界面顶部切到 Claude Code。
- 点击右上角 「橙色加号」 按钮，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
- 填入你的API Key：
- 点击底部 「添加」 保存。
### 启用 Syon 供应商
回到主界面 Claude Code tab，在 Syon 供应商卡片上点 「启用」，并打开Claude Code，即可使用。
## 三、接入 Claude Desktop
安装 Claude Desktop：访问 [Claude Desktop 官网](https://claude.ai/download) 下载对应平台版本：
- macOS：下载 `.dmg` 双击安装；或 `brew install --cask claude`
- Windows：下载 `.exe` 安装程序运行
如果你已经装了 CC Switch 和 Claude Desktop，按以下步骤把 Syon 添加为 Claude Desktop 的供应商：
### 添加 Syon 供应商
- 打开 CC Switch，主界面顶部切到 Claude Desktop tab。
- 点击右上角 「橙色加号」按钮，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
- 填写API Key：
- 点击右下角 「+ 添加」 保存。
### 启用 Syon 供应商
回到主界面 Claude Desktop tab，在 Syon 供应商卡片上点 「启用」。切换成功后会弹出提示：
切换成功，重启 Claude Desktop 后生效
按提示完整重启 Claude Desktop 应用，即可使用。
## 四、接入 Codex
安装 Codex：参考[接入 Codex](/zh/docs/install-codex)
如果你已经装了 CC Switch 和 Codex，按以下步骤把 Syon 添加为 Codex 的供应商：
### 添加 Syon 供应商
- 打开 CC Switch，主界面顶部切到 Codex tab。
- 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。
- 填入基础字段：「API Key」——粘贴你在 [Syon Dashboard](https://syon.ai/dashboard) 创建的 key
- 点击底部 「+ 添加」 保存。
### 启用 Syon 供应商
回到主界面 Codex tab，在 Syon 供应商卡片上点 「启用」。Codex 不支持热切换——重启你正在运行的 codex 终端进程才生效。
## 五、接入 Gemini CLI
暂不支持Gemini CLI的接入，全力开发中……
## 六、接入 OpenCode
参考[Syon接入 OpenCode](/zh/docs/install-opencode)。暂时不支持通过CC Switch接入OpenCode。
## 七、接入 OpenClaw
参考[Syon接入 OpenClaw](/zh/docs/install-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 控制台](https://syon.ai/dashboard?tab=api-keys) 创建的 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
回到终端执行：
plaintext复制
``
hermes setup
``
进入 「Select provider」 wizard，顶部提示 `↑↓ navigate ENTER/SPACE select ESC cancel`，按以下操作：
- 用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：
plaintext复制
``
syon (api.syon.ai/v1) — 模型名
``
- 按 ENTER 或 SPACE 选中。选中后这一行前面会出现 `(●)` 标记和 `← currently active` 字样：
plaintext复制
``
→ (●) syon (api.syon.ai/v1) — 模型名 ← currently active
``
之后直接执行 `hermes` 进会话，即可使用。
准备好了？三步即可开始登录控制台 · 购买额度 · 创建 API Key
[获取 API Key](/dashboard?tab=api-keys)[查看定价](/zh/pricing)
遇到问题？微信扫码加入交流群
[上一篇Cherry Studio](/zh/docs/install-cherry-studio)[下一篇OpenClaw](/zh/docs/install-openclaw)