Codex CLI VPS 使用指南：远程服务器上如何使用 AI 编程助手

很多开发者拿到 VPS 后，第一件事就是装环境写代码。但如果能直接在终端里用 AI 帮你写、改、查代码，效率能翻几倍。Codex CLI 就是干这个的——一个基于 OpenAI 模型（GPT-4 系列）的命令行编程助手，跑在远程服务器上，不用开浏览器，全靠终端交互。本文手把手教你从零在 VPS 上装好 Codex CLI，配好 API Key，绕过常见坑，真正用起来。

Codex CLI 是什么，为什么适合 VPS

Codex CLI 是 OpenAI 官方推出的终端工具，能理解自然语言描述，直接生成、修改、解释代码。它不像 Web 版 ChatGPT 需要反复粘贴代码，而是直接操作你当前目录下的文件，甚至能自动运行测试、修复错误。对 VPS 用户来说，好处很明显：你 SSH 进服务器后，不需要再开第二个窗口，所有工作流都在同一个终端里完成，尤其适合写脚本、调配置、修 Bug 这种高频场景。

VPS 上部署 Codex CLI 的环境要求

硬件配置

•内存：1GB 起步，2GB 以上更稳。Codex CLI 本身不重，但 Node.js 和 npm 会占一些，而且模型调用时 API 请求不占本地算力，内存主要给系统和服务。

•CPU：1 核足够，因为计算都在 OpenAI 服务器端。

•磁盘：200MB 以上剩余空间，用于安装 Node.js 和 Codex CLI 缓存。

软件环境

•操作系统：Ubuntu 20.04 / 22.04 / Debian 11 最佳，CentOS 7+ 也可以但需手动装 Node.js。

•Node.js：16.0 以上，推荐 18 LTS。

•npm：7.0 以上，随 Node.js 一起安装。

•网络：必须能访问 api.openai.com，国内 VPS 可能需要代理。

安装 Codex CLI：两种方式，推荐 npx

方式一：npx 直接运行（最快，无需全局安装）

node -v # 应 >= 16
npm -v # 应 >= 7

npx @openai/codex –help

第一次运行会下载包，之后会缓存。这种方式不污染全局，适合快速测试。

方式二：全局安装（适合长期使用）

npm install -g @openai/codex
codex –help

如果安装过程中报权限错误，不要用 sudo，而是配置 npm 全局路径：

npm config set prefix ~/.npm
echo 'export PATH=~/.npm/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

验证安装

codex –version # 或 npx @openai/codex –version

能输出版本号就说明装好了。

配置 API Key：安全第一

Codex CLI 需要 OpenAI API Key，建议用环境变量，不要写死在脚本里。

export OPENAI_API_KEY="sk-your-key-here"

source ~/.bashrc

老鸟叮嘱：

• 不要用 root 用户跑 Codex CLI，建议新建一个普通用户（如 `codexuser`），权限隔离更安全。

• API Key 不要暴露在代码仓库中，VPS 上建议用 `chmod 600 ~/.bashrc` 限制读取。

• 如果 VPS 有公网 IP，确保 API Key 不会被其他进程或日志泄露。

基本使用：从自然语言到代码

生成一个新脚本

codex "写一个 Python 脚本，监控当前目录下所有 .log 文件，如果文件大小超过 100MB 就压缩并备份到 /backup/"

Codex CLI 会输出代码，并询问你是否要保存到文件。你可以直接让它创建文件。

修改现有文件

codex –edit main.py "给这个函数添加错误处理，用 try/except 包裹"

它会读取 `main.py` 内容，生成修改后的版本，并展示 diff，确认后写入。

解释代码

codex –explain deploy.sh

适合快速理解别人写的脚本。

交互模式

codex –interactive

进入对话式终端，连续提问，上下文会保留，适合逐步调试。

常见问题与排障

1. 连接超时或 SSL 错误

Codex CLI 需要访问 `api.openai.com`。国内 VPS 经常被墙，解决方案：

• 在 VPS 上配置代理（如 Clash、v2ray），并设置 `https_proxy` 环境变量。

• 或者使用 OpenAI 支持的区域中转服务（需自行评估合规性）。

2. “Command not found” 或 npx 报错

先确认 Node.js 和 npm 安装正确。如果 npx 找不到包，尝试清除缓存：

npx clear-cache
npm cache clean –force

3. 内存不足导致 Node.js 进程被 kill

Codex CLI 本身不占太多内存，但 Node.js 进程可能因系统 OOM 被杀死。检查：

dmesg | grep -i oom # 看是否有 Out of Memory 日志

如果 VPS 只有 512MB 内存，建议升级到 1GB 以上，或用 swap 应急：

fallocate -l 1G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

4. API Key 无效或配额不足

检查环境变量是否生效：

echo $OPENAI_API_KEY # 如果为空，说明没正确加载

另外，OpenAI 免费额度有限，注意查看用量。

老鸟叮嘱：避坑清单

•不要在生产环境直接修改文件：Codex CLI 的 `–edit` 会直接覆盖原文件，建议先在测试目录试用，或用 Git 做好版本控制。

•API Key 别写进命令历史：运行 `history -c` 清空历史，或者设置 `HISTCONTROL=ignorespace`，在命令前加空格避免记录。

•注意 Token 消耗：Codex CLI 每次请求都会消耗 Token，频繁使用可能烧钱。可以用 `codex –model gpt-3.5-turbo` 切换到便宜模型（如果支持）。

•权限最小化：用普通用户运行，不要给 Codex CLI 访问 `/etc`、`/root` 等敏感目录的权限。

•更新工具：`npx @openai/codex` 会自动使用最新版，全局安装的用 `npm update -g @openai/codex`。

FAQ

Q1：Codex CLI 需要什么配置的 VPS？
A：1GB 内存、1 核、10GB 磁盘即可。主要是 Node.js 环境，模型计算在云端。

Q2：能不能离线使用？
A：不能。Codex CLI 必须联网调用 OpenAI API，无法本地运行模型。

Q3：如何切换模型？
A：目前默认使用 GPT-4，部分版本支持 `–model` 参数指定 `gpt-3.5-turbo`。以官方文档为准。

Q4：VPS 上开了防火墙，需要放行什么端口？
A：Codex CLI 是客户端工具，只发起 HTTPS 出站请求（443 端口），不需要入站端口。但如果你用代理，需要放行代理端口（如 7890）。

Q5：不小心把 API Key 写进代码里了怎么办？
A：立即在 OpenAI 后台吊销这个 Key，重新生成。然后用 `git filter-branch` 或 BFG 清理历史。

Q6：Codex CLI 和 GitHub Copilot 在终端里有什么区别？
A：Copilot 主要集成在 IDE，Codex CLI 是纯终端工具，更适合服务器端开发、脚本编写、自动化任务。两者互补。

在 VPS 上用好 Codex CLI，关键是环境配置干净、API Key 安全、网络通畅。别想着一步到位，先用小脚本试水，熟悉交互模式后再接入项目。远程服务器上写代码，有 AI 在终端里帮忙，确实能省不少翻文档的时间。

—

**相关阅读：**

– [VPS部署AI工具100讲：AI Agent、Codex、Claude Code、Hermes Agent、Ollama与自动化工作流实战教程](https://www.zhujixuan.com/jishujiaocheng/9606.html)
– [n8n VPS 部署教程：搭建自己的自动化工作流平台](https://www.zhujixuan.com/jishujiaocheng/9892.html)
– [AI Agent自动化运维实战100讲：VPS巡检、日志分析、告警处理与工作流教程](https://www.zhujixuan.com/jishujiaocheng/10066.html)