下载即用，一键接入
装好登录后选一个应用点「接入」：Codex、Claude Code、Gemini CLI、Cherry Studio 全部自动配置完成，不用手改任何配置文件。
Aimyria API 接入文档
Aimyria 支持 OpenAI、Google Gemini、Anthropic 多种兼容格式接口。你可以把官方 SDK 的 base URL 指向 Aimyria，无需改动业务代码，即可调用 Claude / Gemini / GPT 等多家模型。
- Base URL：
https://aimyria.com - 鉴权：API Key（
sk-...） - 协议：同时支持 Anthropic 原生格式（
/v1/messages）、OpenAI 兼容格式（/v1/chat/completions）、OpenAI Responses API（/v1/responses，仅 GPT 系列）、Gemini 原生格式（/v1beta/models/{model}:generateContent）和图像生成（/v1/images）
新账号余额为 0，先充值再调用。 第一次请求前先充值。如果请求返回 402（OpenAI 格式为 400）、提示「钱包余额不足」，说明余额为 0，不是 Base URL 或 Key 配错了，充值后重试即可。
文中的 sk-xxxxxx 请替换为你自己的 Key，妥善保管、不要提交到代码仓库。
没有海外卡？也可以用 USDT 充值：在充值弹窗点「Crypto支付」，用 USDT、USDC 或 ETH，从币安、OKX 等交易所 App 转账即可——收银台会按金额显示可用网络，不用装钱包插件（教程）。
一、Base URL 与请求头
根据使用的模型选择对应的兼容格式：
安装 CC Switch 并接入 Aimyria：一键切换 Claude Code、Codex 供应商
CC Switch 是一款开源的桌面应用，把 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 七个 AI 工具的供应商配置统一管在一个面板里。
一、安装 CC Switch
请安装 v3.16.5 及以上版本。
macOS 用户（推荐）通过 Homebrew 安装：
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：参考Aimyria 接入 Claude Code命令行
如果你已经装了 CC Switch 和 Claude Code，按以下步骤把 Aimyria 添加为 Claude Code 的供应商：
添加 Aimyria 供应商
- 打开 CC Switch，主界面顶部切到 Claude Code。
- 点击右上角 「橙色加号」 按钮，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Aimyria」（或直接搜索“Aimyria”）。
- 填入你的API Key：
- 点击底部 「添加」 保存。
启用 Aimyria 供应商
回到主界面 Claude Code tab，在 Aimyria 供应商卡片上点 「启用」，并打开Claude Code，即可使用。
三、接入 Claude Desktop
安装 Claude Desktop：访问 Claude Desktop 官网 下载对应平台版本：
- macOS：下载
.dmg双击安装；或brew install --cask claude - Windows：下载
.exe安装程序运行
如果你已经装了 CC Switch 和 Claude Desktop，按以下步骤把 Aimyria 添加为 Claude Desktop 的供应商：
添加 Aimyria 供应商
- 打开 CC Switch，主界面顶部切到 Claude Desktop tab。
- 点击右上角 「橙色加号」按钮，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Aimyria」（或直接搜索“Aimyria”）。
- 填写API Key：
- 点击右下角 「+ 添加」 保存。
启用 Aimyria 供应商
回到主界面 Claude Desktop tab，在 Aimyria 供应商卡片上点 「启用」。切换成功后会弹出提示：
切换成功，重启 Claude Desktop 后生效
按提示完整重启 Claude Desktop 应用，即可使用。
四、接入 Codex
安装 Codex：参考接入 Codex
如果你已经装了 CC Switch 和 Codex，按以下步骤把 Aimyria 添加为 Codex 的供应商：
添加 Aimyria 供应商
- 打开 CC Switch，主界面顶部切到 Codex tab。
- 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
- 在 「预设供应商中」 找到 「Aimyria」（或直接搜索“Aimyria”）。
- 填入基础字段：「API Key」——粘贴你在 Aimyria Dashboard 创建的 key
- 点击底部 「+ 添加」 保存。
启用 Aimyria 供应商
回到主界面 Codex tab，在 Aimyria 供应商卡片上点 「启用」。Codex 不支持热切换——重启你正在运行的 codex 终端进程才生效。
五、接入 Gemini CLI
暂不支持Gemini CLI的接入，全力开发中……
六、接入 OpenCode
参考Aimyria接入 OpenCode。暂时不支持通过CC Switch接入OpenCode。
七、接入 OpenClaw
八、接入 Hermes Agent
安装 Hermes Agent：
如果你已经装了 CC Switch 和 Hermes Agent，按以下步骤把 Aimyria 添加为 Hermes 的供应商：
添加 Aimyria 供应商
-
打开 CC Switch，主界面顶部切到 Hermes tab。
-
点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
-
填入字段：
- 「供应商标识」：
aimyria（只能小写字母/数字/连字符，会作为config.yaml中的供应商 key） - 「供应商名称」：
Aimyria - 「官网链接」（可选）：
https://aimyria.com - 「API 模式」：保持默认
OpenAI Chat Completions。 - 「API 端点」：
https://aimyria.com/v1 - 「API Key」：粘贴你在 Aimyria 控制台 创建的 key
- 「供应商标识」：
-
「模型列表」：点 「获取模型列表」 自动拉取 Aimyria 可用模型，或点 「+ 添加模型」 手动填。每个模型至少填 「模型 ID」 + 「显示名称」（显示名称不能留空）。第一个模型会写入顶层
model.default，建议把claude-opus-4-7放第一位。 -
点击底部 「+ 添加」 保存。
启用 Aimyria 供应商
回到主界面 Hermes tab，在 Aimyria 供应商卡片上点 「启用」。CC-Switch 会把配置写入 Hermes 配置文件（默认 ~/.hermes/config.yaml，可在 CC Switch ⚙ 设置「Hermes 配置目录」覆盖）。完整退出并重启 hermes 进程 才生效。
在 Hermes 里切换到 Aimyria
回到终端执行：
hermes setup
进入 「Select provider」 wizard，顶部提示 ↑↓ navigate ENTER/SPACE select ESC cancel，按以下操作：
- 用 ↑↓ 方向键翻到列表最底部（自定义 provider 会追加在内置列表后面），找到这一行：
aimyria (aimyria.com/v1) — 模型名
- 按 ENTER 或 SPACE 选中。选中后这一行前面会出现
(●)标记和← currently active字样：
→ (●) aimyria (aimyria.com/v1) — 模型名 ← currently active
之后直接执行 hermes 进会话，即可使用。