下载即用，一键接入
装好登录后选一个应用点「接入」：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 与请求头
根据使用的模型选择对应的兼容格式：
安装 Claude 客户端并接入 Aimyria
Claude 客户端（Claude Desktop）是 Anthropic 官方推出的桌面端应用，内置 Claude Code 编程能力。接入 Aimyria 有两种方式：使用 Aimyria One 客户端一键接入（推荐），或使用 CC Switch 手动接入。
Claude 客户端（Claude Desktop）是 Anthropic 官方推出的桌面端应用，内置 Claude Code 编程能力。通过 CC Switch 即可将其接入 Aimyria。
没有海外卡？也可以用 USDT 充值：在充值弹窗点「Crypto支付」，用 USDT、USDC 或 ETH，从币安、OKX 等交易所 App 转账即可——收银台会按金额显示可用网络，不用装钱包插件（教程）。
方式一：Aimyria One 客户端一键接入（推荐）
Aimyria One 客户端是 Aimyria 的官方桌面客户端，可以傻瓜式完成Claude客户端的下载、免订阅Aimyria接入、模型配置等流程，真正做到5分钟开箱即用，免去用户自己摸索和试错的烦恼。
【下载 Windows 版】 【】
TIP：下载安装过程中，如遇系统误报风险提示，请选择信任或继续。
安装完成后，如图所示，请完成账号注册。
进入客户端后，找到 Claude 客户端 进行下载&安装（或自行从 Claude 官网下载）。
而后，点击"一键接入"按钮，客户端会自动将您本机的 Claude 客户端，与Aimyria完成连接&配置。
若您需要切换回 Anthropic 官方订阅套餐，可点击"断开 Aimyria"按钮，即可断开Claude客户端与Aimyria的连接。
自动接入完成后，就可以正常开始使用Claude了。
您可以在Aimyria的控制台，看到每条请求的用量情况。
方式二：CC Switch 手动接入
使用 CC Switch 接入
CC Switch 是一个图形界面工具，用来管理和切换 Claude 客户端的接入地址与密钥，一键切换。
安装 Claude 客户端和 CC Switch
本节为安装教程。如果您已安装 Claude 客户端和 CC Switch，接入 Aimyria 请直接看下一节。
安装 Claude 客户端
- 到 Claude 官网 下载对应系统的 Claude 客户端并安装。
安装 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 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。
接入 Aimyria
在 CC Switch 的 Claude Desktop 标签中，点击右上角【橙色加号】按钮。
- 在 「预设供应商中」 找到 「Aimyria」（或直接搜索"Aimyria"）。
- 填入你在 Aimyria 控制台 获取的 API Key。
- 完成后，点击右下角保存。
在主页启用 Aimyria，打开 Claude 客户端即可生效。
如果已经打开了 Claude 客户端，需要重启一次生效。
打开 Claude 客户端，即可开始使用了。
您可以在Aimyria的控制台，看到每条请求的用量情况。
不装工具：在 Claude 客户端里直接配置（Cowork / Code 通用）
Claude 客户端自带第三方接入设置，Cowork 和 Code 都会使用这里配置的地址。不想安装 CC Switch 时可以这样配置（菜单名称以你的客户端版本为准）：
- 打开开发者模式：菜单栏选择「Help → Troubleshooting → Enable Developer Mode」。客户端可能会重启，之后菜单栏会出现「Developer」。
- 选择「Developer → Configure Third-Party Inference」，连接类型选「Gateway」。
- 按下表填写：
| 字段 | 填写 |
|---|---|
| Gateway base URL | https://aimyria.com（不要带 /v1） |
| Gateway API key | 你在 Aimyria 控制台 获取的 API Key |
| 鉴权方式（有这一项时） | Bearer |
| Custom inference headers | 留空 |
- 模型：如果模型列表为空，或你只想保留常用模型，在「Models」里手动添加模型 ID，例如
claude-opus-5-5、claude-sonnet-5-5。 - 保存并应用，然后完全退出 Claude 客户端，再重新打开。
之后在 Cowork 或 Code 里发一条消息，就能在 Aimyria 控制台看到这条请求的用量。
常见问题
Windows 系统用户在使用 Claude 客户端时，如遇以下报错：
Virtual Machine Platform not available
Claude's workspace requires the Virtual Machine Platform on Windows. Enable this feature, then restart.
请按照下述步骤完成操作，即可正常使用：
Win + R输入optionalfeatures回车；- 找到并勾选「虚拟机平台」（英文叫 Virtual Machine Platform），确定；
- 重启电脑，再打开 Claude 客户端，即可使用。