集成概览
最近更新:2026年8月26日
将 Claude Code、Cursor、Cherry Studio 等工具接入 Amux;大多数场景下只需配置地址和密钥。
这些工具本身已经基于某一种协议工作,例如 Claude Code 使用 Anthropic Messages,Codex 使用 OpenAI,Gemini CLI 使用 Google Gemini。Amux 对这些协议均提供原生兼容,因此接入通常只需调整地址和密钥。
用 CC Switch 批量配置
CC Switch 是一个开源桌面应用,用于统一管理这类工具的供应商配置,支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 与 Pi。添加一次 Amux,这些工具即全部配置完成,无需逐个设置环境变量或编辑配置文件。
如果同时使用多个工具,或需要在订阅与 API 之间切换,建议使用这条路径。仅使用单个工具时,可直接参考对应工具的接入页。
三件事对所有工具都一样
地址应按工具使用的协议选择,而不是按目标模型选择:
| 工具说哪种协议 | 填什么 |
|---|---|
| OpenAI Chat Completions / Responses | https://gateway.amux.ai/v1 |
| Anthropic Messages | https://gateway.amux.ai |
| Google Gemini | https://gateway.amux.ai |
密钥是控制台里创建的 Amux 密钥,填进那个工具原本放厂商密钥的位置。
模型名用规范 ID(anthropic/claude-opus-5)。用 Anthropic 协议调 OpenAI 的模型也可以——协议和模型是两件事。
常见地址错误
如果工具使用的是 Anthropic 协议,却把地址填成了 https://gateway.amux.ai/v1,请求最终会落到 /v1/v1/messages 并返回 404。原因是 /v1 属于 OpenAI 路径前缀,而 Anthropic 客户端会自行补上 /v1/messages。
如果不确定应填写哪个地址,可先查看该工具官方文档中的默认地址形式,再仅替换域名部分。
按工具查找
| 工具 | 协议 | 文档 |
|---|---|---|
| Claude Code | Anthropic | Claude Code |
| Claude 桌面端 | Anthropic | Claude Desktop |
| Codex CLI / Codex 桌面端 | OpenAI | Codex |
| Gemini CLI | Gemini | Gemini CLI |
| OpenCode | OpenAI | OpenCode |
| Pi | 四种任选 | Pi |
| OpenClaw | OpenAI | OpenClaw |
| Hermes Agent | OpenAI | Hermes Agent |
| DeepSeek Harness | OpenAI | DeepSeek Harness |
| Cursor | OpenAI | Cursor |
| Cline(VS Code) | OpenAI | Cline |
| Cherry Studio | OpenAI | Cherry Studio |
| Sider(浏览器插件) | OpenAI | Sider |
未列出的工具通常也可以接入;只要支持自定义 base_url,并能按所用协议填写对应地址即可。