Amux

集成概览

最近更新: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 / Responseshttps://gateway.amux.ai/v1
Anthropic Messageshttps://gateway.amux.ai
Google Geminihttps://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 CodeAnthropicClaude Code
Claude 桌面端AnthropicClaude Desktop
Codex CLI / Codex 桌面端OpenAICodex
Gemini CLIGeminiGemini CLI
OpenCodeOpenAIOpenCode
Pi四种任选Pi
OpenClawOpenAIOpenClaw
Hermes AgentOpenAIHermes Agent
DeepSeek HarnessOpenAIDeepSeek Harness
CursorOpenAICursor
Cline(VS Code)OpenAICline
Cherry StudioOpenAICherry Studio
Sider(浏览器插件)OpenAISider

未列出的工具通常也可以接入;只要支持自定义 base_url,并能按所用协议填写对应地址即可。