目录
  1. 一、 第一步：选择入口与网络环境准备
  2. 1. 终端网络代理配置（CLI 必看）
  3. 2. 入口一：桌面 App（最省心、新手推荐）
  4. 3. 入口二：终端命令行工具（CLI，工程师推荐）
  5. 二、 第二步：登录与 OAuth 授权
  6. 三、 第三步：发一句话验证运行状态
  7. 四、 三大检查点对照速查
  8. 五、 常见报错与排查实录
  9. 六、 安全上手：保护你的第一行代码

Codex 新手上路实操教程：桌面 App 与终端 CLI 双端安装、梯子代理与验证全跑通指南

在众多 AI 辅助编程工具中，OpenAI 推出的 Codex 无论是作为原生桌面应用，还是嵌入在终端里的命令行 CLI，都展现出了极强的代码工程理解与自主交付能力。

但对于初次接触它的开发者或产品经理来说，官方文档往往堆砌了大量术语，很多人在第一步——甚至在安装脚本执行和网络连通性环节——就遇到了各种莫名其妙的报错与连接超时。

其实，第一次安装和跑通 Codex，根本不需要深究复杂的环境参数。只要走完三个核心动作：装上软件、登进账号、发一句话确认有回复。

Codex 新手安装 3 大刚性检查点

本文将拆解桌面 App 与终端命令行（CLI）两种入口的完整实战路径，并直截了当给出国内网络环境下梯子与终端代理的配置命令。

一、 第一步：选择入口与网络环境准备

在开始执行任何安装前，首先确保你的电脑能够稳定访问海外服务（确保能正常打开 chatgpt.com）。

1. 终端网络代理配置（CLI 必看）

很多新手常犯的一个错误是：浏览器明明开了梯子能正常打开 ChatGPT，但在终端运行下载脚本却一直报 Connection Timed Out。

这是因为终端默认不走系统全局代理。在运行任何安装命令前，Mac / Linux 用户建议在终端执行以下命令显式挂载本地代理端口（以常见的 Clash 本地 7890 端口为例）：

# 临时为当前终端设置 HTTP/HTTPS 与 SOCKS5 代理
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7890"

# 验证终端网络是否畅通
curl -I https://chatgpt.com/codex

Windows PowerShell 用户则执行：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

只要能够返回 HTTP 200 或 301 状态码，说明终端的网络隧道已经打通。

2. 入口一：桌面 App（最省心、新手推荐）

如果你习惯图形化界面，不想折腾命令行环境，直接选择桌面 App：

  1. 访问官方下载地址：https://chatgpt.com/codex；
  2. 下载对应操作系统的安装包（macOS .dmg 或 Windows .exe）；
  3. 双击直接完成安装。

桌面端的操作逻辑与日常聊天软件完全一致，直观、门槛极低。

3. 入口二：终端命令行工具（CLI，工程师推荐）

习惯在终端或者 VS Code 集成终端里沉浸式敲代码的朋友，选择 CLI 工具能带来更高效的上下文交互。

Mac / Linux 用户： 打开终端，运行官方一键安装脚本：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows 用户： 以管理员身份打开 PowerShell（注意：必须使用 PowerShell，严禁使用旧版 CMD），运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

安装脚本会自动拉取可执行二进制文件并写入系统环境变量。安装完成后，务必关闭当前终端窗口并重新打开一个新的窗口，确保全局 Path 变量重新加载。

二、 第二步：登录与 OAuth 授权

安装完成后，需要绑定你的 OpenAI / ChatGPT 账户：

  1. 桌面 App： 启动应用程序后，界面会自动弹出登录按钮，点击后跳转至默认浏览器。登录你的 ChatGPT 账号并点击「授权（Authorize）」即可。

  2. 命令行 CLI： 在终端输入启动命令：

    codex

    程序会自动在本地监听一个临时回执端口，并在系统默认浏览器中唤起授权页面。在浏览器点击确认后，终端会自动捕获 Token 并提示 Authentication successful。

三、 第三步：发一句话验证运行状态

装上了，也登录了，怎么确保它能正常干活？最简单的验证不是让它写复杂算法，而是做一次最朴素的连通性打招呼。

对于桌面 App： 在底部的输入框里直接发送：

你好

对于命令行 CLI： 强烈建议不要直接在业务代码主目录里运行！先新建一个干净的空文件夹：

mkdir codex-test
cd codex-test
codex

进入交互提示符后，同样输入：

你好

只要它能流式返回一段通顺的中文打招呼，说明本地程序执行环境、系统代理隧道、OAuth 权限认证、以及模型接口解析四层链路全部畅通无阻！

四、 三大检查点对照速查

回过头看，整个排查过程只需对照这 3 个确定性指标：

  1. 装上了：桌面客户端图标能打开，或者终端输入 codex 能输出帮助菜单或进入交互式 Shell。
  2. 登进了：浏览器完成授权后，终端不再卡在等待登录凭证状态。
  3. 说了话有回复：发送「你好」能实时收到中文回答。

五、 常见报错与排查实录

  • 报错 command not found: codex： 新安装的命令路径未被当前会话捕获。完全退出并重启终端，或手动检查 ~/.bashrc / ~/.zshrc 中的 PATH 导出路径。
  • Windows 报错 irm is not recognized： 你误用了古老的 cmd.exe。请按 Win + S 搜索并打开 PowerShell 重新执行。
  • 登录页面死活打不开或一直白屏转圈： OAuth 回调依赖浏览器能正常加载海外登录组件。检查梯子的全局代理状态，确保没有开启某些会阻断局域网本地回环的激进分流规则。
  • 脚本下载一直卡在 0%： 终端没有挂载代理。参考本文第一节的 export http_proxy 命令显式配置后再试。

六、 安全上手：保护你的第一行代码

当你开始拿真实的项目工程给 Codex 体验时，请养成一个极度重要的好习惯：刚开始接手项目的第一句话，先立规矩，不让它乱改文件。

推荐使用下面这段标准安全指令作为 Session 的开场白：

请先阅读当前工程的文件结构与 package.json，用中文向我简要概括这个项目是做什么的，以及包含哪些核心模块。
注意：本轮只做只读分析，严禁修改、创建或删除任何文件。

让 AI 先把脉、讲思路，你确认它的理解没有偏离预期之后，再给它下达具体的文件改写指令。这能让你从第一天起就远离“一觉醒来代码全被重构乱了”的惨痛教训。