Amux

Integrations

Last updated August 26, 2026

Connect Claude Code, Cursor, Cherry Studio, and similar tools to Amux; in most cases this only requires an address and an API key.

These tools already speak one of the supported protocols. Claude Code uses Anthropic Messages, Codex uses OpenAI, and Gemini CLI uses Google Gemini. Amux implements these protocols directly, so in most cases configuration comes down to two values: an address and an API key.

Configuring several tools at once with CC Switch

CC Switch is an open-source desktop app for managing provider configuration across these tools: Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes Agent and Pi. Add Amux once and all of them are configured, with no environment variables to export and no configuration files to edit.

Take this route if you use several of these tools, or need to switch between a subscription and an API. For a single tool, its own page is enough.

Three things are the same everywhere

Pick the address by the protocol the tool speaks, not by the model you want to call:

The tool speaksUse
OpenAI Chat Completions / Responseshttps://gateway.amux.ai/v1
Anthropic Messageshttps://gateway.amux.ai
Google Geminihttps://gateway.amux.ai

The key is an Amux key from the console. Put it wherever the tool expects the vendor's key.

Model names are canonical IDs (anthropic/claude-opus-5). Calling an OpenAI model over the Anthropic protocol is fine — protocol and model are two separate things.

A common address mistake

Filling in https://gateway.amux.ai/v1 for a tool that speaks the Anthropic protocol. That /v1 is the OpenAI path prefix, and an Anthropic client appends /v1/messages itself — so the request lands on /v1/v1/messages and comes back 404.

When in doubt, look at the shape of the default address in that tool's own docs: swap the domain, leave the path alone.

Find your tool

ToolProtocolPage
Claude CodeAnthropicClaude Code
Claude DesktopAnthropicClaude Desktop
Codex CLI / Codex appOpenAICodex
Gemini CLIGeminiGemini CLI
OpenCodeOpenAIOpenCode
Piany of the fourPi
OpenClawOpenAIOpenClaw
Hermes AgentOpenAIHermes Agent
DeepSeek HarnessOpenAIDeepSeek Harness
CursorOpenAICursor
Cline (VS Code)OpenAICline
Cherry StudioOpenAICherry Studio
Sider (browser extension)OpenAISider

Tools not listed here usually work as well. If a tool lets you set a custom base URL, choose the address that matches its protocol from the table above.