OpenAI Codex 安装与配置指南 (Win & WSL & Linux)

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

写这篇是因为最近身边好多人装 Codex 翻车，问来问去，十个有九个都栽在同一个坑——代理劫持了本地回调地址。所以我把踩过的坑整理成一份保姆级教程，按照 “配环境 → 测网络 → 装软件 → 配 IDE” 的顺序来，照着走一遍基本不会出问题。

Codex 本身分三个东西：桌面端 App、CLI 命令行工具、VS Code 插件，按需安装就行。

官网：https://openai.com/codex/

⭐ 安装前必做！磨刀不误砍柴工。

不管你用什么系统，先把这两件事搞定：

这步是重中之重，搞不好后面全白忙。

打开你准备装 Codex 的终端（Windows 用 PowerShell/CMD，Linux 用 Terminal），注入代理，同时一定要排除本地回调地址：

Windows (CMD/PowerShell):

Linux / macOS:

export HTTP_PROXY=”http://127.0.0.1:7890”
export HTTPS_PROXY=”http://127.0.0.1:7890”
export NO_PROXY=“127.0.0.1,localhost”

在刚才配好代理的同一个终端里，依次跑这三条命令：

curl ipinfo.io —— 确认国家代码不是 CN，而是 US/JP/HK 之类的。
curl https://api.openai.com/v1/models —— 返回 Missing bearer authentication 说明 API 通了。
curl https://auth.openai.com —— 返回 Just a moment… 说明授权域名没问题。

三条全过了？别关这个终端窗口，接着往下走！

Windows 下有两种方案：带界面的桌面端 和 命令行 CLI 端，看你喜好。

Codex 桌面端提供了一个独立窗口，可以管理项目、审查代码，适合不爱敲命令的同学。

在第零步配好代理的终端里执行：

凭据文件自动保存在 C:\Users <你的windows用户名> .codex\auth.json。

⭐ 免登录大法，省心省力。

官方其实更推荐 Windows 用户在 WSL2（Linux 子系统）里跑 Codex。原因很简单：Linux 沙箱更稳，文件读写也更快。

更妙的是，我们可以直接把 Windows 端的凭据复制过来，完美绕开 WSL 里配网络代理的各种折腾。

别用 apt 装 node，版本太老。打开 WSL 终端执行：

在 WSL 终端里执行：

搞定！在 WSL 终端里直接输入 codex 就能用了，不用再登录一次。

如果是 Linux 物理机或云服务器，Codex 主要靠 CLI 和 VS Code 扩展。

Codex 的沙箱和 PTY（伪终端）底层依赖系统构建工具。在已配好代理（第零步）的终端中执行：

Ubuntu / Debian:
sudo apt update && sudo apt install curl build-essential python3 p7zip-full -y
Fedora / RHEL:
sudo dnf groupinstall ‘Development Tools’ && sudo dnf install python3 p7zip curl
Arch Linux:
sudo pacman -S base-devel python p7zip curl

装完后用 nvm 安装 Node.js，方法和 WSL 那节一样。

桌面版 Linux：会自动弹浏览器完成授权。
无界面的云服务器（Headless）：终端会输出一个 https://auth.openai.com/xxx 的链接，复制到你本地电脑（已挂代理）的浏览器里打开，授权后服务器终端会自动收到回调。

进阶：Linux 桌面版开源替代 想在 Linux 上用带 UI 的 Codex App？社区有个脚本，能把 macOS 版重构为 Linux Electron 应用：

命令行配好后，搭配 VS Code 才是完全体：

安装插件：打开 VS Code 插件市场，搜索安装 openai.chatgpt。
WSL 用户注意：先在 Windows 的 VS Code 里装好 WSL 插件。打开 WSL 终端，进入代码目录（注意：代码要放在 ~/ 下，别放 /mnt/c/）。输入 code .，VS Code 会自动连接 WSL 环境。
重启 VS Code，侧边栏就能看到 Codex 图标了。因为底层 CLI 已经登录过，插件会自动读取凭证，开箱即用！

1. 终端提示 command not found: codex

原因是 Node 全局安装路径没加进系统环境变量。用了 NVM 的话一般不会有这个问题。手动解决：把 ~/.npm-global/bin（Linux/Mac）或 %USERPROFILE%\AppData\Roaming\npm（Windows）加到 $PATH 里。

2. 登录时浏览器显示成功，但终端一直卡着不动

八成是本地回调服务器（http://localhost:1455）被代理劫持了。回去严格执行第零步，登录前务必设好 NO_PROXY=127.0.0.1,localhost。

3. Codex 改代码时提示 “Sandbox permission denied”

Codex 默认在严格沙箱中运行来保护系统安全。解决办法：别把项目放在系统根目录或受保护目录下。可以在项目根目录建一个 AGENTS.md 文件，声明允许 Codex 读写的目录边界。