Codex CLI 是 OpenAI 的命令行 coding agent，可以直接在终端里读取项目、修改代码、运行命令和协助完成开发任务。它适合喜欢在 Terminal、PowerShell、VSCode 终端或 WSL 中工作的开发者。
本文根据 OpenAI Codex 官方文档和 openai/codex 官方仓库整理，给出可复制的安装命令。安装前请确认你访问的是 chatgpt.com、developers.openai.com 或 github.com/openai/codex 这些官方来源，不要从不明下载站复制安装脚本。
安装前确认
账号：ChatGPT Plus、Pro、Business、Edu 和 Enterprise 计划包含 Codex。你也可以使用 OpenAI API key 登录，但需要额外配置。
系统：Codex CLI 支持 macOS、Windows 和 Linux。Windows 用户可以在 PowerShell 原生运行，也可以在 WSL2 中使用 Linux 环境。
npm：如果选择 npm 安装，需要提前安装 Node.js 和 npm。
安全：npm 包请确认是 @openai/codex，不要安装名字相似的第三方包。
方法一：macOS / Linux 官方安装脚本
macOS 和 Linux 用户可以使用官方 standalone installer：
curl -fsSL https://chatgpt.com/codex/install.sh | sh安装完成后，关闭并重新打开终端，然后执行：
codex --version
codex第一次运行 codex 时，会引导你登录。通常建议使用 ChatGPT 账号登录；如果你使用 API credits，也可以按提示选择 API key 方式。
如果你需要无人值守安装，可以设置 CODEX_NON_INTERACTIVE=1：
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh方法二：Windows PowerShell 安装
Windows 用户可以打开 PowerShell，执行官方仓库给出的安装命令：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"安装完成后，重新打开 PowerShell，检查版本并启动：
codex --version
codex如果你的项目主要运行在 Linux 工具链里，比如 Docker、Python、Node.js 或 Rust 项目，也可以在 WSL2 里安装 Codex CLI。WSL2 中使用 macOS/Linux 那条安装命令即可。
方法三：npm 安装
如果你已经安装 Node.js 和 npm，可以使用 npm 全局安装：
npm install -g @openai/codex升级 npm 安装版本：
npm install -g @openai/codex@latest卸载 npm 安装版本：
npm uninstall -g @openai/codex不建议随手使用 sudo npm install -g。如果提示权限不足，优先检查 npm 全局目录，或者使用 nvm 重新管理 Node.js 环境。
方法四：Homebrew 安装
macOS 用户也可以用 Homebrew cask 安装：
brew install --cask codex升级 Homebrew 安装版本：
brew upgrade --cask codex卸载 Homebrew 安装版本：
brew uninstall --cask codex首次运行 Codex CLI
进入一个项目目录，然后运行：
cd your-project
codex你可以先让 Codex 做一个低风险任务，例如解释项目结构：
explain this project structure等确认它能正常读取项目、显示计划和请求权限后，再让它修改文件或运行测试。
国内网络环境下怎么处理
如果安装脚本下载失败，先判断是不是 chatgpt.com/codex/install.sh 或 install.ps1 无法访问。这类问题通常不是命令写错，而是网络访问链路不稳定。
如果你用 npm 安装，且只是 npm registry 慢，可以临时使用镜像源：
npm install -g @openai/codex --registry=https://registry.npmmirror.com但 npm 镜像只能解决下载 npm 包慢的问题，不能解决 Codex 登录、ChatGPT 账号访问、OpenAI 服务请求超时等问题。
如果 Codex CLI 已经安装成功，但运行 codex 时登录失败、请求超时或服务连接不稳定，可以先换一个稳定网络环境，也可以了解 YYLX.IO 鱼鱼连线 这类 AI 中转站，用来改善 OpenAI、Claude、Gemini 等服务的访问稳定性。
常见问题
提示 codex: command not found 怎么办？
先关闭并重新打开终端，再执行 codex --version。如果仍然失败，检查安装目录是否已经加入 PATH。npm 用户还要检查 npm 全局 bin 目录。
npm 安装卡住怎么办？
先确认 npm registry 是否能访问。可以临时使用镜像源，也可以换网络环境后重试。不要混用多个来源安装后立刻覆盖，否则排查版本会变复杂。
Codex CLI 和 Codex App 有什么区别？
Codex CLI 适合在终端里直接处理本地项目；Codex App 更适合桌面交互、项目线程和可视化审查。两者底层能力相近，但入口和体验不同。
总结
安装 Codex CLI，macOS 和 Linux 推荐先用官方 standalone installer；Windows 推荐用 PowerShell 安装；已经熟悉 Node.js 的用户可以用 npm install -g @openai/codex；macOS 用户也可以选择 Homebrew。
安装后一定执行 codex --version 和 codex。这能帮你区分“命令没装好”“PATH 没生效”“账号没权限”和“网络无法访问服务”这几类不同问题。
如果你正在搭建 AI 开发环境，希望 Codex、ChatGPT、Claude、Gemini 等工具访问更稳定，可以看看 YYLX.IO 鱼鱼连线。它更适合需要长期使用 AI 工具，但经常遇到网络不稳定的开发者。
发表回复