MaaS 平台

把 Codex 或 Claude Code 直连 RouteAll

先选你的编程工具,再按操作系统照做。一个 sk-ra- 密钥 + 一个 baseURL,即可让现有 AI 编程工具调用 MaaS 平台 上的所有模型。

Tool
System

请妥善保管密钥。它仅保存在当前浏览器标签页,不会上传。当前生效值: sk-ra-your-key

配置步骤

下载 Codex、获取 RouteAll API Key,再写入 Codex provider 配置,让 Codex 走 RouteAll 而非 ChatGPT。

1

安装 Codex

下载并在 macOS 上安装 Codex 桌面应用,或在终端安装 Codex CLI。

npm install -g @openai/codex@latest
2

获取 RouteAll API Key

登录后台,在 控制台 → API Keys 创建密钥,并复制以 sk-ra- 开头的值。

3

设置密钥环境变量

打开终端,把密钥写入 ~/.zshrc。对于从 Finder 启动的 Codex 桌面应用或 VS Code,还需写入 macOS 图形界面环境变量。

echo 'export OPENAI_API_KEY="sk-ra-your-key"' >> ~/.zshrc
source ~/.zshrc

launchctl setenv OPENAI_API_KEY "sk-ra-your-key"
4

备份并写入 Codex 配置

此命令先备份当前配置,再写入一份精简的 RouteAll 配置。

mkdir -p ~/.codex/backups
cp ~/.codex/config.toml ~/.codex/backups/config.toml.before-routeall.$(date +%Y%m%d%H%M%S) 2>/dev/null || true

cat > ~/.codex/config.toml <<'EOF'
model = "deepseek-v4-pro"
model_provider = "routeall"

[model_providers.routeall]
name = "RouteAll"
base_url = "https://mass.hzxmfg.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
EOF

新用户可直接复制运行。若你已在 Codex 中使用 MCP、插件或项目信任设置,请保留原文件,仅手动新增/更新 model、model_provider 以及上面的 [model_providers.routeall] 块。

5

重启并验证

重新打开前彻底退出 Codex(Codex > Quit Codex)。若仍弹出登录页,重启电脑后再打开 Codex 发送 "reply only ok"。

API 调试

发送一次对话补全请求并查看结果。密钥仅在本浏览器标签页使用,不会保存。

1

准备测试请求

在上方粘贴你的 RouteAll API Key,然后复制并运行下面的 curl 命令。

2

复制并运行 curl 命令

打开终端/PowerShell 复制此命令。在 PowerShell 中,若 curl 被当作别名,请改用 curl.exe。

curl https://mass.hzxmfg.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ra-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-pro","messages":[{"role":"user","content":"reply only ok"}]}'

恢复官方配置

当你停止使用 RouteAll 密钥或想回到官方 ChatGPT / Anthropic 流程时使用。

1

备份并移除 RouteAll 配置

对 Codex,恢复官方配置并清除环境变量。

mkdir -p ~/.codex/backups
cp ~/.codex/config.toml ~/.codex/backups/config.toml.before-restore.$(date +%Y%m%d%H%M%S) 2>/dev/null || true

cat > ~/.codex/config.toml <<'EOF'
# Official Codex uses your ChatGPT / Codex account.
# Leave this file without a routeall model_provider block.
EOF

launchctl unsetenv OPENAI_API_KEY

对 Claude Code,改为移除下面两个环境变量:

2

清除 Claude 环境变量

移除 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN。

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
sed -i '' '/ANTHROPIC_BASE_URL/d;/ANTHROPIC_AUTH_TOKEN/d' ~/.zshrc

常见问题

RouteAll 直连与恢复官方配置的常见排查。

登录后台,在 控制台 → API Keys 创建密钥,并复制以 sk-ra- 开头的值。若已有有效密钥,可直接用于配置步骤。