> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CC Switch

> 用 CC Switch 统一管理客户端接入

# 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。

![CC Switch Claude Code 标签](/images/cc-switch-latest-1.png)

- 点击右上角 「橙色加号」 按钮，弹出 「添加新供应商」 对话框。

- 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。

![选择 Syon 预设供应商](/images/cc-switch-latest-2.png)

- 填入你的API Key：

![填写 Syon API Key](/images/cc-switch-latest-3.png)

- 点击底部 「添加」 保存。

### 启用 Syon 供应商

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

![启用 Syon](/images/cc-switch-latest-4.png)

## 三、接入 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”）。

![Claude Desktop 选择 Syon 供应商](/images/cc-switch-latest-5.png)

- 填写API Key：

![Claude Desktop 填写 API Key](/images/cc-switch-latest-6.png)

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

### 启用 Syon 供应商

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

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

![Claude Desktop 启用 Syon](/images/cc-switch-latest-7.png)

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

## 四、接入 Codex

安装 Codex：参考[接入 Codex](/zh/docs/install-codex)

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

### 添加 Syon 供应商

- 打开 CC Switch，主界面顶部切到 Codex tab。

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

- 在 「预设供应商中」 找到 「Syon」（或直接搜索“Syon”）。

![Codex 选择 Syon 供应商](/images/cc-switch-latest-8.png)

- 填入基础字段：「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)

![微信扫码加入交流群](https://ama-static.floatai.cn/syon/images/kefu/contact-qr.png)遇到问题？微信扫码加入交流群

[上一篇Cherry Studio](/zh/docs/install-cherry-studio)[下一篇OpenClaw](/zh/docs/install-openclaw)
```