Codex CLI 及桌面版安装教程

一、Codex 是什么

Codex 是 OpenAI 推出的 AI 编程智能体，能够直接读取代码库、执行命令、完成端到端的工程任务。它深度集成在 ChatGPT 中，同时也提供独立的桌面应用（Codex App）和命令行工具（Codex CLI），可在 ChatGPT、IDE 和终端之间无缝协作。

二、Codex 桌面版安装

1. 下载方式

Codex 桌面版可以直接从 OpenAI 官网下载，支持 Windows、macOS 等平台。访问 chatgpt.com/codex，点击页面中的「下载 Windows 版」或对应系统按钮即可。

2. 系统要求

• Windows 10 或更高版本
• macOS 12 或更高版本
• 需要 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 账号

3. 安装与登录

1. 下载安装包后双击运行，按向导完成安装。
2. 打开 Codex 桌面版，使用 ChatGPT 账号登录。
3. 登录后即可在桌面端创建任务、查看进度、审查代码变更。

三、Codex CLI 安装

1. 环境要求

• macOS（Apple Silicon 或 Intel）
• Linux（x86_64 或 arm64）
• Windows（PowerShell 支持）
• 需要 Node.js 环境（npm 安装方式）

2. 安装命令

方式一：官方脚本（推荐）

Mac / Linux：

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

Windows PowerShell：

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

方式二：npm 安装

npm install -g @openai/codex

方式三：Homebrew（macOS）

brew install --cask codex

方式四：GitHub Releases 下载二进制

访问 OpenAI Codex Releases，下载对应平台的压缩包，解压后将二进制文件重命名为 codex 并放到系统 PATH 中。

四、启动与登录

安装完成后，在终端输入：

codex

首次运行会提示登录。选择「Sign in with ChatGPT」，使用你的 ChatGPT 账号授权即可。Codex CLI 支持 Plus、Pro、Business、Edu 和 Enterprise 订阅。

五、Codex IDE 扩展

除了桌面版和 CLI，Codex 还提供 IDE 扩展，支持 VS Code、Cursor、Windsurf 等编辑器。在对应编辑器的扩展商店搜索「Codex」并安装即可。

六、常见问题

• 无法登录？ 确认你的 ChatGPT 账号有有效订阅，并且网络可以访问 OpenAI 服务。
• CLI 命令找不到？ 检查 npm 全局包路径是否在系统 PATH 中，或者尝试使用官方脚本重新安装。
• 桌面版闪退？ 尝试更新显卡驱动或以管理员身份运行。

七、总结

Codex 提供桌面版、CLI 和 IDE 扩展三种形态，覆盖了从图形界面到终端的不同使用场景。建议新手先从桌面版入手体验完整功能，开发者可以安装 Codex CLI 将其集成到日常工作流中。所有版本都通过同一个 ChatGPT 账号连接，任务和会话可以在不同设备间同步。

参考来源：

• OpenAI Codex 官网
• OpenAI Codex GitHub