Codex 的 OPENAI_BASE_URL 要不要带 /v1
要带。这个问题之所以让人犯迷糊,是因为同一个中转域名下,OpenAI 格式和 Claude 格式的规矩正好相反。
直接回答
export OPENAI_BASE_URL=https://us-proxy.unipaxtools.com/v1
export OPENAI_API_KEY=你的API密钥OPENAI_BASE_URL 要带 /v1。
Windows PowerShell:
$env:OPENAI_BASE_URL="https://us-proxy.unipaxtools.com/v1"
$env:OPENAI_API_KEY="你的API密钥"为什么 Claude Code 那边又不带
因为两套协议的端点路径不一样,SDK 拼接的方式也不一样:
| 用途 | 变量 | 值 | 带 /v1? |
|---|---|---|---|
| Codex / OpenAI SDK | OPENAI_BASE_URL | https://us-proxy.unipaxtools.com/v1 | 带 |
| Claude Code | ANTHROPIC_BASE_URL | https://us-proxy.unipaxtools.com | 不带 |
OpenAI 那套的实际端点是 /v1/chat/completions,SDK 默认拿 base url 直接接 /chat/completions,所以 base url 得自己带上 /v1。Claude 那套由客户端自己补全路径,base url 只填到域名。
规律很简单:填 OPENAI_ 开头的变量就带 /v1,填 ANTHROPIC_ 开头的就不带。
报 Invalid API key 的那个坑
Codex 的两个变量必须同时指向 unipaxtools。只改了地址、OPENAI_API_KEY 还留着 OpenAI 官方的 key(或者反过来),就会报 Invalid API key。
先确认两个都对:
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY以前配过官方的,记得去 ~/.zshrc / ~/.bashrc 里把老的那行删掉,否则重开终端又被盖回去。
其他前置条件
Node.js 要 22 或更高。 Codex 新版对版本有要求,装完运行如果报 Cannot find module,多半就是 Node 太旧,升到 22+ 就好。
装 Codex:
npm install -g @openai/codex装完 codex --version 能出版本号就算成功,然后进项目目录直接 codex。
想要每次都自动生效
把两行 export 加进 ~/.zshrc 或 ~/.bashrc,source 一下或者重开终端。
要做多提供商、固定配置,可以写进 ~/.codex/config.toml——Codex 每次启动都会读它。
不想手动配
用 CC Switch 更省事:顶部先点 Codex 图标,再点 unipaxtools 卡片就切过去了,地址和 /v1 都不用自己记。
Codex 的 IDE 扩展、桌面客户端怎么走中转(尤其桌面客户端那条不能用带 Plus / Pro 权限的账号登录),见 ChatGPT Codex 安装与接入。
还没有账号?注册后创建密钥就能用,充值 ¥1 = $1 余额。
注册 unipaxtools
unipaxtools 文档