OpenAI Codex 终端 AI 编程助手安装与配置指南

Codex 简介

Codex 是 OpenAI 推出的终端编程助手，支持通过自然语言指令直接生成或修改代码，并能运行任务、创建文件、调用脚本。

• 支持终端编程 CLI 模式 • 支持 VS Code 插件（也支持其他 IDE） • 本地运行，支持自然语言交互，任务可记忆 • 支持 GPT-4 系列模型

安装方式

1. 快速安装 Codex CLI

npm install -g codex-cli
codex login

安装成功后输入 codex 即可开始使用。

会出现一个交互终端，提示你输入自然语言指令，例如：

/plan 创建一个脚本：压缩文件夹、排除 node_modules

2. 安装 Codex IDE 插件

参考官网文档：https://developers.openai.com/codex/cli

直接在官网点击对应的工具安装，会自动打开工具的插件页面并识别安装官方的 Codex 插件。

安装好之后会在左侧展示侧边栏，弹出浏览器让你登录 OpenAI 账号，登录之后即可关联成功。

Codex CLI + VS Code 可作为 Cursor 的替代方案。

• 免费（需相应账号权限） • 同样可以自然语言写代码 • 支持更丰富的终端指令和模型选择

常见问题排查

安装完 Codex 后，如果遇到 stream error: unexpected status 404 Not Found 报错，通常是环境变量被污染或路径被劫持。

解决方法：

1. 检查是否安装了 Qwen CLI、Deepseek CLI 等其他兼容模式工具。
2. 打开终端，执行以下命令查看环境变量：

grep -nE 'OPENAI|DASHSCOPE|QWEN|DEEPSEEK|PROXY' ~/.zshrc ~/.zprofile ~/.bash_profile ~/.bashrc 2>/dev/null || true

3. 如果发现类似以下内容，说明可能被'劫持'，请注释掉这些行或删除后重新 source 配置文件：

export OPENAI_API_KEY=sk-...
export OPENAI_BASE_URL=https://dashscope.aliyuncs.com/...

4. 清除 Codex 配置文件：

codex logout
rm -rf ~/.codex