给 Agent 看的配置指南

Claude Code

把下方全部内容复制粘贴给终端里正在运行的 claude 或 codex,让它自己读步骤、自己动手把 Claude Code 接到 OpenMux。

你是一个跑在终端(macOS)或命令提示符(Windows)里的 AI 编程助手。用户想让你把 Claude Code CLI 的请求改走 OpenMux(一个兼容 OpenAI/Anthropic 协议的 API 中转网关),而不是走 Anthropic 官方默认地址。请你自己动手执行下面的命令,不要只是把命令打印出来给用户看。

第一步：拿到 API Key

如果用户还没给,请他粘贴自己的 OpenMux API Key(以 om-sk-、om-sa- 或 om-ss- 开头)。如果他还没创建过 key,提示他去 openmux.ai/dashboard/keys 创建。

第二步：如果还没装 Claude Code，先装上

先检查——如果 claude --version 已经能跑,跳过这步。没装就用官方安装脚本装(已实测端到端跑通:自动下载二进制、装好,并重新导出一次 PATH,同一个终端窗口里马上能用,不用重开):

macOS / Linux：

bash

command -v claude >/dev/null 2>&1 || curl -fsSL https://claude.ai/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"

Windows（cmd.exe）：

bash

where claude >nul 2>nul || (curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd)

第三步：设置环境变量

Claude Code 读取 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这两个环境变量。先判断当前跑在什么系统上,用对应语法。

macOS / Linux（bash/zsh）：

bash

export ANTHROPIC_BASE_URL="https://openmux.ai"
export ANTHROPIC_AUTH_TOKEN="<用户的 key>"

Windows（cmd.exe）：

bash

set ANTHROPIC_BASE_URL=https://openmux.ai
set ANTHROPIC_AUTH_TOKEN=<用户的 key>

Windows（PowerShell）：

bash

$env:ANTHROPIC_BASE_URL="https://openmux.ai"
$env:ANTHROPIC_AUTH_TOKEN="<用户的 key>"

关键：一定要用 `ANTHROPIC_AUTH_TOKEN`,不要用 `ANTHROPIC_API_KEY`。像 OpenMux 这类第三方网关只有走 auth-token 才能稳定生效——用 `ANTHROPIC_API_KEY` 即使 key 是对的,也可能一直报 "Not logged in · Please run /login"。

另外 base URL 不要加 `/v1`。Claude Code 会自己拼接成 `/v1/messages`,如果你手动再加 `/v1` 就会变成 `/v1/v1/messages`,导致 404。

第四步：检查是否有其它中转站留下的残留变量

如果用户以前用过别的中转站接 Claude Code,系统里可能已经永久设置了旧的 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY,会悄悄覆盖你刚才在当前会话里设的值。检查方法：

macOS/Linux： 运行 env | grep ANTHROPIC,看是否有当前会话之外设置的值(比如写在 ~/.zshrc、~/.bashrc 里,或者通过 launchctl setenv 设的)。如果有,先问用户要不要清掉,不清会一直冲突。

Windows（PowerShell），检查并清除永久残留：

bash

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN",$null,"User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY",$null,"User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL",$null,"User")

清完之后用户需要关闭并重新打开终端才会生效。

第五步：验证

运行：

bash

claude -p "hi"

如果收到文字回复,说明接通了,告诉用户配置完成。如果看到 "Not logged in" 或连接错误,先回去检查第三步(auth token 是否用错成 API key)和第四步(是否有残留变量),别急着改别的地方。