服务器安装 Codex CLI 并配置中转 API 教程，解决 Codex 仍然调用官方接口的问题

Meta Description：
本文详细介绍如何在 Linux 服务器上安装 OpenAI Codex CLI，并通过 config.toml 配置自定义中转 API 地址，解决 Codex 默认请求 api.openai.com、401 Unauthorized、invalid_api_key 等问题。

关键词：
Codex CLI, OpenAI Codex, Codex 中转 API, Codex 配置教程, OPENAI_API_KEY, OPENAI_BASE_URL, config.toml, Linux 服务器安装 Codex

推荐 URL：

/server-codex-cli-proxy-api-config

---

一、为什么要在服务器上安装 Codex CLI？

Codex CLI 是 OpenAI 提供的命令行 AI 编程助手，可以直接在服务器终端中读取项目文件、执行命令、分析日志、排查部署问题。

比如网站出现：

502 Bad Gateway
Docker 容器正常但 Nginx 访问失败
API 服务无法连通
配置文件错误

这类问题时，Codex 可以直接在服务器环境中辅助排查，而不是只靠人工一条条复制命令。

不过，很多人在服务器上安装 Codex CLI 后，会遇到一个问题：即使填写了自己的中转 API Key，Codex 仍然请求 OpenAI 官方接口：

https://api.openai.com/v1/responses

最终报错：

401 Unauthorized
invalid_api_key

这通常是因为 Codex 的自定义接口地址没有配置成功。

---

二、安装 Node.js、npm 和 Codex CLI

如果服务器提示：

npm: command not found

说明服务器还没有安装 npm。可以先安装 Node.js 和 npm：

apt update
apt install -y nodejs npm

安装完成后检查版本：

node -v
npm -v

然后安装 Codex CLI：

npm install -g @openai/codex

如果安装后提示：

codex: command not found

可以先查一下 npm 全局目录：

npm config get prefix

例如你的服务器路径可能是：

/www/server/nodejs/v20.18.3

那么临时加入 PATH：

export PATH="/www/server/nodejs/v20.18.3/bin:$PATH"

然后测试：

codex --version

如果可以显示版本号，说明 Codex CLI 已安装成功。

---

三、让 Codex 默认使用中转 API

Codex CLI 默认会使用 OpenAI 官方接口。如果要改为中转 API，推荐使用配置文件方式。

创建配置目录：

mkdir -p ~/.codex
nano ~/.codex/config.toml

写入下面配置：

model = "gpt-5.5"
model_provider = "myproxy"

[model_providers.myproxy]
name = "My Proxy"
base_url = "https://你的中转域名/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
supports_websockets = false

[projects."/www/wwwroot/api.pvai.cc"]
trust_level = "trusted"

[projects."/root"]
trust_level = "trusted"

[tui.model_availability_map]
"gpt-5.5" = 3

注意把这里换成你的真实中转地址：

base_url = "https://你的中转域名/v1"

例如：

base_url = "https://api.example.com/v1"

---

四、最容易写错的地方：env_key 不是 API Key

很多人会把配置写成这样：

env_key = "sk-xxxxxxxxxxxx"

这是错误的。

正确写法是：

env_key = "OPENAI_API_KEY"

env_key 的意思是：Codex 从哪个环境变量读取 API Key。
真正的 API Key 应该通过环境变量设置：

export OPENAI_API_KEY="你的中转API_KEY"

不要把 API Key 明文写进 config.toml，也不要把带 Key 的截图发到网上。

---

五、保存并退出 nano 编辑器

如果你使用的是 nano 编辑器，保存退出步骤是：

Ctrl + O
Enter
Ctrl + X

如果 Ctrl + X 无法退出，可以尝试：

Esc
X

退出后会回到普通命令行界面：

root@server:~#

---

六、启动 Codex CLI

每次启动前，可以先设置 PATH 和 API Key：

export PATH="/www/server/nodejs/v20.18.3/bin:$PATH"
export OPENAI_API_KEY="你的中转API_KEY"
cd /www/wwwroot/api.pvai.cc
codex

如果希望以后登录服务器自动生效，可以写入 .bashrc：

echo 'export PATH="/www/server/nodejs/v20.18.3/bin:$PATH"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的中转API_KEY"' >> ~/.bashrc
source ~/.bashrc

以后就可以直接运行：

codex

---

七、如何判断 Codex 是否已经走中转 API？

启动 Codex 后，如果仍然看到类似错误：

url: https://api.openai.com/v1/responses
invalid_api_key

说明它还在请求 OpenAI 官方接口，配置没有生效。

重点检查这几项：

model_provider = "myproxy"

是否和下面的 provider 名称一致：

[model_providers.myproxy]

还要检查：

base_url = "https://你的中转域名/v1"
env_key = "OPENAI_API_KEY"

以及当前 shell 是否设置了 API Key：

echo $OPENAI_API_KEY

如果没有输出，重新执行：

export OPENAI_API_KEY="你的中转API_KEY"

---

八、用 Codex 排查服务器网站部署问题

进入项目目录后启动 Codex：

cd /www/wwwroot/api.pvai.cc
codex

然后可以给 Codex 输入这样的任务：

请排查 api.pvai.cc 的 502 问题。项目目录是 /www/wwwroot/api.pvai.cc。

请检查 docker compose 状态、sub2api 日志、nginx 站点配置、反向代理 proxy_pass、Host/X-Forwarded-Proto 请求头、curl 本机和容器 IP 的连通性。

不要删除数据，不要重装系统，不要改数据库。
如果需要修改 nginx 或 docker 配置，请先说明要改哪几行、为什么改，再让我确认。

这样 Codex 就可以在服务器现场读取配置、分析日志，并辅助定位问题。

---

九、常见问题 FAQ

1. Codex 安装成功，但提示 command not found 怎么办？

一般是 npm 全局目录没有加入 PATH。可以执行：

export PATH="/www/server/nodejs/v20.18.3/bin:$PATH"

然后再运行：

codex

2. Codex 为什么还是访问 api.openai.com？

说明自定义 provider 没有生效。请检查 ~/.codex/config.toml 中是否设置了：

model_provider = "myproxy"

并且 [model_providers.myproxy] 里的 base_url 是否是你的中转地址。

3. env_key 应该填什么？

应该填环境变量名：

env_key = "OPENAI_API_KEY"

不要填真实 API Key。

4. 中转 API 必须支持什么接口？

建议中转 API 支持 OpenAI 兼容格式，并支持 Responses API。配置中使用的是：

wire_api = "responses"

如果中转只支持 Chat Completions，可能会出现兼容性问题。

5. API Key 泄露了怎么办？

立刻去中转平台后台删除或重置这个 Key，然后重新生成一个新 Key。不要继续使用已经截图或公开过的 Key。

---

十、总结

在服务器上使用 Codex CLI 排查网站部署问题非常方便，但如果你使用的是中转 API，不能只填写 API Key，还需要正确配置 ~/.codex/config.toml。

核心配置只有三点：

model_provider = "myproxy"
base_url = "https://你的中转域名/v1"
env_key = "OPENAI_API_KEY"

然后通过环境变量设置真实 Key：

export OPENAI_API_KEY="你的中转API_KEY"

配置完成后，Codex 就可以在服务器上辅助排查 Docker、Nginx、502、反向代理、日志和端口连通性等问题。

---

参考资料：

• OpenAI Codex 官方文档：https://developers.openai.com/codex/
• OpenAI Codex CLI 说明：https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started
• OpenAI Models 文档：https://developers.openai.com/api/docs/models