Amux

Claude Code

最近更新：2026年8月26日

两个环境变量把 Claude Code 指向 Amux，之后可以在它里面用任意模型，不限于 Claude。

Claude Code 使用 Anthropic Messages 协议，Amux 对该协议提供原生兼容。完成接入后，可在 Claude Code 中使用的不仅限于 Claude 模型，也包括支持该协议调用路径的其他模型。

推荐：用 CC Switch 配

CC Switch 支持 Claude Code，添加一个供应商（Base URL 填 https://gateway.amux.ai）即可，还能在界面上把三档模型映射到你想用的模型。

Claude Code 支持热切换：在 CC Switch 中切换后，当前会话即可生效，无需重开终端。

下面是手动配置的写法。

一、安装 Claude Code

npm / pnpm 安装方式已经不推荐，官方改成了原生安装脚本：

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

已经用 npm 装过的，跑 claude install 迁移到原生版本。装完用 claude doctor 自检。

二、创建 Amux 密钥

在控制台的密钥页创建密钥。创建后仍可在该页面再次查看，无需重新生成。

三、配置环境变量

macOS / Linux / WSL

Terminal

export ANTHROPIC_BASE_URL=https://gateway.amux.ai
export ANTHROPIC_AUTH_TOKEN=你的 Amux 密钥
export ANTHROPIC_API_KEY=

可写入 ~/.zshrc 或 ~/.bashrc，避免每次手动导出。

Windows PowerShell

PowerShell

$env:ANTHROPIC_BASE_URL = "https://gateway.amux.ai"
$env:ANTHROPIC_AUTH_TOKEN = "你的 Amux 密钥"
$env:ANTHROPIC_API_KEY = ""

要持久生效就写进 PowerShell Profile（$PROFILE 指向的那个文件）。

三个变量各自的作用

变量作用
ANTHROPIC_BASE_URL网关地址。不要带 /v1——客户端会自己拼 /v1/messages
ANTHROPIC_AUTH_TOKEN你的 Amux 密钥
ANTHROPIC_API_KEY置空。如果同时设置，Claude Code 会优先使用它，导致请求携带错误的密钥并返回鉴权失败

可选：几个影响体验的变量

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export API_TIMEOUT_MS=600000
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 关掉与推理无关的上报流量
  • API_TIMEOUT_MS 放宽超时。默认值对长上下文 + 强推理模型偏紧，这类请求首字要等很久，超时会表现成「转半天然后失败」

四、启动

打开一个新终端，使刚写入配置文件的环境变量生效，然后进入项目目录：

cd my-project
claude

五、验证

在 Claude Code 里执行：

/status

重点确认两项：鉴权方式应显示为 auth token（而非官方登录），base URL 应为 https://gateway.amux.ai。如果不一致，请返回上一步确认环境变量是否已生效。

选模型

export ANTHROPIC_MODEL=anthropic/claude-opus-5

也可以分别指定三档，Claude Code 会按任务复杂度自己挑：

export ANTHROPIC_DEFAULT_HAIKU_MODEL=anthropic/claude-haiku-4-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic/claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=anthropic/claude-opus-5

三档不必都填 Claude。 协议和模型是两件事——openai/gpt-5.6、deepseek/deepseek-v3.2 都可以，Claude Code 照常工作。前提是那个模型的上游能承接 Anthropic 协议，模型详情页会标出来。

启动后用 /model 切换。

锁定供应商 / 指定路由策略

同一个模型往往有好几家在提供，价格与速度不同。要锁定某一家，在模型名后加冒号：

export ANTHROPIC_MODEL=anthropic/claude-opus-5:anthropic

不锁供应商时，可以用 @ 后缀指定这一次按什么排——:@price 价格优先、:@latency 延迟优先。完整说明见 API 参考。

常见问题

报 404

ANTHROPIC_BASE_URL 多带了 /v1。Claude Code 会自己拼路径，请求会打到 /v1/v1/messages 上。去掉那一段。

鉴权失败

按顺序查：

  1. ANTHROPIC_API_KEY 是不是没置空——它会抢在 ANTHROPIC_AUTH_TOKEN 前面生效
  2. 密钥是不是复制完整（首尾空格和换行是最常见的原因）
  3. 控制台里这把密钥是不是还启用着，工作区余额是否充足
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

从别的平台切过来之后行为不对

Claude Code 会缓存上一次的登录态。删掉 ~/.claude/ 下的凭据缓存后重新启动，再用 /status 确认。

模型不可用

模型 ID 要带厂商前缀（anthropic/claude-opus-5，不是 claude-opus-5）。另外不是每个模型都支持每种协议——Claude Code 说 Anthropic，所以要挑上游能承接 Anthropic 的那些，模型详情页有标注。调一个不支持的组合会明确报错，不会静默降级。

Windows 上找不到 claude 命令

用 npm 装的话，npm 全局目录不在 PATH 里。要么改用上面的原生安装脚本，要么把 npm config get prefix 输出的路径加进 PATH。

PowerShell 提示脚本被禁止运行

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

RemoteSigned 只要求从网上下载的脚本带签名，本地脚本照常运行，比 Unrestricted 稳妥。

PowerShell Profile 里的变量没生效

Test-Path $PROFILE   # 文件在不在
Get-Content $PROFILE # 内容对不对

Profile 存成非 UTF-8 编码时，中文注释会让整个文件解析失败而静默跳过——存成 UTF-8。

响应很慢或超时

长上下文加强推理模型，首字本来就慢。放宽 API_TIMEOUT_MS，或者换一档更快的模型试试。也可以用 :@latency 后缀让路由优先挑延迟低的供应商。