Codex CLI 国内接入中转站完整教程 2026

OpenAI Codex CLI 是一款强大的 AI 编程代理工具，能在终端里直接理解并修改代码。 由于国内网络限制，直连 OpenAI API 需要稳定代理，且官方不支持人民币支付。 本文介绍如何通过 OpenMux 中转站在国内无障碍使用 Codex CLI。

前置条件

• 已安装 Node.js（用于通过 npm 安装 Codex）或使用官方安装脚本
• 已在 OpenMux 注册账号并创建 API Key

第一步：安装 Codex CLI

macOS / Linux（官方安装脚本）：

curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh
export PATH="$HOME/.local/bin:$PATH"
codex --version  # 验证安装成功

Windows / 通用（npm）：

# 如果 npm 访问慢，先切换镜像
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex
codex --version

第二步：配置 OpenMux 中转

Codex CLI 不支持通过环境变量设置 Base URL，必须写入配置文件 ~/.codex/config.toml。

# ~/.codex/config.toml

model = "gpt-5.4"          # 或其他支持的模型
model_provider = "openmux"
wire_api = "responses"

[model_providers.openmux]
name        = "OpenMux"
base_url    = "https://openmux.ai/v1"
env_key     = "OPENMUX_KEY"
wire_api    = "responses"

然后设置环境变量（建议加入 ~/.zshrc 或 ~/.bashrc）：

export OPENMUX_KEY="om-sk-你的key"  # 替换为你的 OpenMux API Key

第三步：验证配置

codex exec "用一句话解释什么是 API"

看到模型回复即说明配置成功，Codex 已通过 OpenMux 中转站正常运行。

支持的模型

OpenMux 支持 OpenAI 全系列模型，推荐 Codex 使用以下配置：

• gpt-5.4 — Codex 官方推荐，综合编程能力最强
• gpt-5.5 — 能力更强，适合复杂重构任务
• gpt-5.3-codex — Codex 专用优化版本

常见问题

Q：配置后提示 "Selected model is at capacity"

OpenMux 会自动故障转移到备用节点，通常在 5 秒内完成，无需手动干预。 如果持续出现，可在控制台检查余额。

Q：Windows 上 OPENMUX_KEY 环境变量不生效

# cmd.exe
set OPENMUX_KEY=om-sk-你的key
codex exec "hello"

# PowerShell
$env:OPENMUX_KEY="om-sk-你的key"
codex exec "hello"

完整配置说明见：Codex CLI 接入文档