CA云上创造CA云上创造
模型广场API 文档邀请返现实时价格实时折扣使用排行榜常见问题
接入指南

CC Switch

用 CC Switch 把 CA云上创造 配成 Claude Code、Claude Desktop、Codex 与 Hermes Agent 的统一供应商，一键切换。

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：参考 CA云上创造 接入 Claude Code 命令行。

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

添加 CA云上创造 供应商

  1. 1.打开 CC Switch，主界面顶部切到 Claude Code。
  2. 2.点击右上角「橙色加号」按钮，弹出「添加新供应商」对话框。
  3. 3.在「预设供应商中」找到「CA云上创造」（或直接搜索“CA云上创造”）。
  4. 4.填入你的 API Key。
  5. 5.点击底部「添加」保存。

启用 CA云上创造 供应商

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

三、接入 Claude Desktop

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

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

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

添加 CA云上创造 供应商

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

启用 CA云上创造 供应商

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

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

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

四、接入 Codex

安装 Codex：参考 接入 Codex。

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

添加 CA云上创造 供应商

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

启用 CA云上创造 供应商

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

五、接入 Gemini CLI

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

六、接入 OpenCode

参考 CA云上创造 接入 OpenCode。暂时不支持通过 CC Switch 接入 OpenCode。

七、接入 OpenClaw

参考 CA云上创造 接入 OpenClaw。

八、接入 Hermes Agent

安装 Hermes Agent：

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

添加 CA云上创造 供应商

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

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

启用 CA云上创造 供应商

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

在 Hermes 里切换到 CA云上创造

回到终端执行：

plaintext
hermes setup

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

用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：

plaintext
ca (caapi.top/v1) — 模型名

按 ENTER 或 SPACE 选中。选中后这一行前面会出现 (●) 标记和 ← currently active 字样：

plaintext
→ (●) ca (caapi.top/v1) — 模型名 ← currently active

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

上一篇Codex 命令行下一篇Cherry Studio

共 50 篇文档。文中出现的模型名与价格以模型广场的实时数据为准。