面向开发者的 Codex CLI 安装、配置与工作流实战教程，涵盖多平台安装、登录、IDE 集成与排错。
Codex CLI 是 OpenAI 推出的编码代理，运行在本地电脑上。它不是一个网页服务，而是一个命令行工具，可以直接读取你项目里的文件，执行命令，帮你完成编码任务。简单说，你可以在终端里用自然语言和它对话，让它写代码、改 bug、跑测试。
Codex CLI 和 Codex Web 不一样。Web 版是云端代理，在浏览器里用；CLI 版在本地跑，代码不出机器。和 IDE 扩展也不冲突，IDE 扩展只是把 CLI 的能力集成到编辑器里，底层还是同一个引擎。
适合谁用？如果你每天要写大量代码，或者经常处理重复性任务，比如改格式、写脚本、修 bug，Codex CLI 能省下不少时间。特别是已经订阅 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 计划的用户，可以直接用现有账号登录，不需要额外申请 API key。
Codex CLI 支持 Mac、Linux、Windows。安装方式有几种，选一种适合自己的就行。
在终端执行：
curl -fsSL https://chatgpt.com/codex/install.sh | sh这个命令会下载安装脚本并执行。脚本默认从 https://releases.openai.com/codex 下载对应平台的二进制文件，如果下载失败，会自动回退到 GitHub Releases。安装完成后，codex 命令会出现在你的 PATH 里。PATH 就是系统查找可执行文件的目录列表，你可以用 echo $PATH 查看。
Windows 用户用 PowerShell 执行：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"-ExecutionPolicy ByPass 是为了让当前进程绕过 PowerShell 的执行策略限制。如果你在公司电脑上遇到策略限制，可能需要先修改执行策略，或者手动下载安装。
如果你已经装了 Node.js，可以用 npm 全局安装：
npm install -g @openai/codex这种方式的好处是方便升级，npm update -g @openai/codex 就能更新到最新版。注意 npm 全局安装可能需要权限，如果报 EACCES 错误，不要用 sudo 硬装，建议先解决 npm 全局目录的权限问题。
macOS 用户也可以用 Homebrew：
brew install --cask codexHomebrew 会管理安装和升级，适合已经习惯用 brew 管理软件的人。
如果脚本和包管理器都不方便，比如在离线环境，可以直接从 GitHub Releases 页面下载对应平台的压缩包。常见的有：
macOS Apple Silicon：codex-aarch64-apple-darwin.tar.gz
macOS x86_64：codex-x86_64-apple-darwin.tar.gz
Linux x86_64：codex-x86_64-unknown-linux-musl.tar.gz
Linux arm64：codex-aarch64-unknown-linux-musl.tar.gz
下载后解压，里面是一个可执行文件，文件名带有平台信息。把它重命名为 codex，然后放到 PATH 目录下，比如 /usr/local/bin：
mv codex-x86_64-unknown-linux-musl /usr/local/bin/codex
chmod +x /usr/local/bin/codex国内网络访问官方下载地址可能不稳定。安装脚本默认从 releases.openai.com 下载，如果失败会回退到 GitHub Releases。你也可以强制走 GitHub：
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false shWindows 下：
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM 设为 false、0 或 no 都可以。如果你有代理，也可以先设置 http_proxy 和 https_proxy 环境变量再执行安装。
安装完成后，在终端输入：
codex如果能看到登录提示，说明安装成功。如果提示 command not found，说明 codex 不在 PATH 里，检查一下安装路径。
运行 codex 后，第一次会要求登录。选择 Sign in with ChatGPT，浏览器会打开授权页面，登录你的 ChatGPT 账号并授权。授权完成后，终端里会显示已登录。
登录后，你就进入了 Codex 的交互界面。试着输入：
“写一个 Python 脚本，打印当前时间”
Codex 会生成类似这样的代码：
from datetime import datetime
print(datetime.now())然后它会询问是否执行。你可以输入 y 让它运行，或者直接让它修改。整个过程就像和一个懂编程的同事聊天。
如果你不想用 ChatGPT 账号，也可以用 API key。但 API key 方式需要额外设置，具体步骤参考官方文档的认证部分。
Codex CLI 的基本操作就是启动、交互、退出。但除了终端，你还有几种使用方式。
默认启动后就是交互模式，你可以连续输入指令，Codex 会记住上下文。比如先让它写一个函数，再让它写测试，它会基于之前的代码继续工作。退出交互模式通常用 Ctrl+C 或输入 exit，具体以官方文档为准。
如果你用 VS Code、Cursor 或 Windsurf，可以安装官方 IDE 扩展。安装后，在编辑器里就能直接选中代码，让 Codex 解释、重构或修复。具体安装方法见官方 IDE 文档。
运行 codex app 会启动桌面版应用。桌面应用适合喜欢图形界面的用户，或者需要长时间运行任务时使用。你也可以直接访问 Codex App 页面。
如果你不想安装任何东西，可以用 Codex Web，这是 OpenAI 的云端代理，在浏览器里访问 chatgpt.com/codex 即可。注意 Web 版和 CLI 版是两种不同的产品，功能和额度可能不一样。
在终端里输入 codex --help 可以查看所有可用命令和参数。具体内容以官方文档为准。
安装方式没有绝对的好坏，看你的使用场景：
临时体验：用一键脚本，最快。
日常开发：用 npm 或 Homebrew，方便升级。
离线环境：手动下载二进制，拷贝到目标机器。
公司网络受限：设置环境变量强制走 GitHub Releases。
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM 这个环境变量可以控制安装脚本的下载源。默认从 releases.openai.com 下载，如果该地址不可用，可以设为 false 强制走 GitHub Releases。这个技巧在 CI 或代理环境下很实用。
Codex CLI 的登录状态和配置存在本地。如果你有多台电脑，需要分别登录。目前没有官方的配置同步方案，建议每台设备单独授权。
Codex CLI 的用量和你的 ChatGPT 计划绑定。Plus、Pro、Business、Edu、Enterprise 计划都包含 Codex 的使用额度，但具体额度不同。建议查看官方帮助文档了解你所在计划的限制。
我常用的工作流是：在终端里启动 codex，用自然语言描述需求，比如“写一个脚本，把日志文件按日期归档”。Codex 生成代码后，我会先审查一遍，再让它执行。如果执行出错，直接把报错信息贴给它，它会分析原因并修改。这样来回几轮，一个小工具就完成了。
遇到不熟悉的代码，可以选中一段让 Codex 解释。它也能指出潜在的问题，比如未处理的异常、性能瓶颈等。虽然不能完全替代人工审查，但能帮你快速了解代码逻辑。
比如批量修改文件、生成测试数据、格式化代码。这些任务写脚本太繁琐，手动做又无聊，交给 Codex 正合适。你只需要说清楚规则，它就能生成并执行。
假设你有一个目录，里面有很多 .tmp 文件，需要改成 .txt。运行 codex，输入：
“写一个 Python 脚本，把当前目录下所有 .tmp 文件重命名为 .txt”
Codex 会生成脚本并询问是否执行。确认后，文件全部改名。整个过程不到一分钟。
你在运行一个 Node.js 项目，报错信息是 TypeError: Cannot read property 'length' of undefined。把报错贴给 Codex，它会分析可能的原因，比如某个变量未初始化，然后给出修复建议。你可以让它直接修改代码，再重新运行。
给 Codex 一个函数，让它写单元测试。比如：
“给这个函数写几个测试用例：def add(a, b): return a + b”
它会生成 pytest 风格的测试代码，覆盖正常输入、边界情况等。你只需要把测试文件保存下来运行。
现象：执行安装命令后，卡在下载阶段，或者提示连接超时。
解决：先强制走 GitHub Releases：
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh如果还是不行，检查代理设置，或者手动下载二进制。
现象：安装完成后运行 codex，提示找不到命令。
解决：先确认安装路径。如果是手动安装，检查二进制是否在 PATH 目录下，并且有执行权限。可以用 which codex 查看，如果没输出，说明 PATH 没配置对。
现象：npm install -g @openai/codex 报权限错误。
解决：不要用 sudo 硬装。建议用 nvm 管理 Node.js，或者修改 npm 全局目录的权限。具体方法网上很多，不展开。
现象：运行 codex 后选择登录，但浏览器没自动打开。
解决：终端里通常会显示一个授权链接，手动复制到浏览器打开即可。如果链接打不开，检查网络或代理。
现象：登录成功但提示你的 ChatGPT 计划不包含 Codex。
解决：确认你的计划是 Plus、Pro、Business、Edu 或 Enterprise 之一。免费版可能无法使用。如果计划没问题，等一会儿再试，可能是服务端延迟。
官方素材没有提供卸载命令。你可以手动删除安装的二进制文件，或者用包管理器卸载。比如 npm 安装的用 npm uninstall -g @openai/codex，Homebrew 安装的用 brew uninstall --cask codex。具体以官方文档为准。
Codex CLI 的安装方式多样，从一键脚本到包管理器，覆盖了不同平台和网络环境。装好后，先跑通登录，再尝试终端、IDE、桌面应用三种形态。日常开发中，把它当成一个随时可用的编程助手，能明显提升效率。
下一步建议：打开官方文档，仔细看一遍认证和配置部分，然后试着用 Codex 完成一个小任务，比如写个脚本或重构一段代码。遇到问题多看看错误信息，基本都能解决。
注意：以上内容基于官方 README 素材，未提及的功能（如具体命令参数、配置项）请以官方文档为准。
评论 (0)
暂无评论，来发表第一条评论吧