Codex 官网怎么访问:CLI、Web 与桌面版入口一次说清
Codex 是 OpenAI 的编程代理,可在终端、IDE、桌面应用或网页中使用,并帮你执行代码相关任务。为什么值得现在花几分钟装好它:Codex CLI 的周下载量已经是两千多万级(npm 统计),官方 README 同期把桌面应用和 Codex Web 并列写进首页说明 —— 也就是说它已经不是只有终端一条路的新工具了。选错形态、装错版本,是眼下最多人卡住的地方。官方仓库 README 把使用形态分成四类:Codex CLI、IDE 扩展、桌面应用和 Codex Web。这四类的入口地址和安装方式都不一样,混着找很容易把文档站、下载站和 GitHub 镜像当成同一个”官网”——下面按这四类分开说。
第 1 步:先分清入口,并核对这 4 项前置条件
搜索“Codex 官网入口”时,最容易卡在同一个问题:官方同时提供多种使用形态,入口和安装命令并不相同。先在下面这张表里选一行(四种形态),再执行对应步骤。
| 使用形态 | 官方入口 | 适合场景 | 下一步 |
|---|---|---|---|
| Codex CLI | OpenAI Codex 官方仓库 | 在终端中运行编程代理 | 安装 CLI 并执行 codex |
| Codex Web | chatgpt.com/codex | 使用云端代理,不必先装本地程序 | 登录 ChatGPT 后打开任务页 |
| IDE 扩展 | Codex IDE 文档 | 在 VS Code、Cursor、Windsurf 中使用 | 从对应编辑器扩展市场安装 |
| 桌面应用 | Codex App 文档 | 想要桌面应用界面 | 按当前系统下载安装 |
按官方口径推下来,“官网”不是唯一页面:CLI 的快速开始入口在官方 GitHub 仓库,云端代理入口在 ChatGPT,产品与开发文档在 OpenAI 开发者文档站。这不是三个互不相关的服务,而是同一套 Codex 的不同入口;具体链接以官方仓库 README 当前指向的位置为准。
先确认终端里能执行命令,再打开终端输入:
node --version
npm --version
如果准备通过 npm 安装,这两个命令不能报“command not found”。Node.js 是一个运行 JavaScript 的运行环境;npm 是随 Node.js 生态使用的包管理器。缺少 Node.js 或 npm 时,先安装对应运行环境,再回到当前终端重新执行上面两条命令。已有 Node.js 的用户不必为了 Codex 特意升级;系统无法运行当前 npm 包时,再处理系统兼容问题。
其次确认系统与架构。官方仓库 README 列出的手动下载文件会区分 Apple Silicon、Intel Mac、Linux x86_64 和 Linux arm64。Apple Silicon 是苹果芯片电脑,arm64 与 x86_64 则表示不同的处理器架构。下载前执行:
uname -m
macOS 也可以执行 uname -m。输出为 arm64 时选择 arm64 文件,输出为 x86_64 时选择 x86_64 文件。不要只凭电脑型号猜,终端输出比商品名称更可靠。
账号方面,准备一个 ChatGPT 账号。官方 README 写明,运行 CLI 后可以选择 Sign in with ChatGPT,并提到 Plus、Pro、Business、Edu 和 Enterprise 计划可以使用 Codex。这里的计划范围来自官方仓库;具体套餐权益与价格可能变化,安装页显示前应以当前官方页面为准,不要依据旧教程判断是否收费。
权限方面,CLI 在本机运行,需要当前用户能够读写目标项目目录;Web 版则需要账号登录后具备相应产品访问权限。首次打开一个陌生项目前,先查看目录,不要直接在重要代码上执行代理命令。
第 2 步:按系统安装 Codex CLI
macOS 或 Linux 直接执行官方安装命令:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows PowerShell 执行:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
安装器默认从 OpenAI 的独立下载域名取得文件;官方 README 说明,如果元数据或安装资源不可用,会回退到 GitHub Releases。需要明确强制使用 GitHub Releases 时,可执行:
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
CLI 的装法一共 4 种(与上面 4 种形态不是一回事):① 官方脚本安装(macOS/Linux 用 sh,Windows 用 PowerShell,同一方式的两条命令);② npm;③ Homebrew;④ 从 GitHub Releases 手动下载归档。任选一种即可:
npm install -g @openai/codex
brew install --cask codex
这 4 种怎么选(我的判断,不是官方推荐顺序): 脚本安装最适合大多数人,它会自动处理版本更新;npm 和 Homebrew 适合你本来就在用这两套包管理器的环境,代价是更新节奏跟包管理器走、偶尔比官方脚本慢一拍;手动下载适合自动安装被网络挡住、或者你要在离线机器上装的情况。不要同时装两种 —— npm、Homebrew 和脚本装器各走各的目录,最后终端里到底跑哪一份取决于 PATH,很容易出现”装了却版本不对”的错觉。
不要同时执行多种安装方式。npm 与 Homebrew 会把程序放到各自的包管理目录,脚本安装器又是另一条路径;同时安装后,终端实际调用哪一份可能取决于 PATH 环境变量——这是根据不同安装目录的工作方式作出的经验判断,不是官方对“冲突”的正式说明。选一种安装即可;更换安装方式前,先用 which codex 和 codex --version 确认当前调用位置。
不走 CLI 路径的话:IDE、桌面版与网页版
需要 IDE 扩展时,先打开 VS Code、Cursor 或 Windsurf 的扩展市场,搜索 Codex,核对发布者信息后安装。不要安装名称相近但发布者无关的扩展。官方仓库 README 明确提到这三种编辑器,并以 Codex IDE 文档 作为安装说明入口。
需要桌面应用时,打开 Codex App 文档,在页面中选择当前系统对应的下载选项。官方仓库还提供 codex app 命令,用来启动桌面应用体验:
codex app
需要云端代理时,直接打开 Codex Web,登录 ChatGPT 账号,再从页面创建任务。CLI、IDE、App 和 Web 是不同运行位置:选择 Web 后无需为了“打开官网”额外安装 CLI;反过来,已经使用 CLI 的用户也不必切换到网页端。
第 3 步:登录,并按这 3 个信号确认真的能用
安装完成后,在终端执行:
codex
随后选择 Sign in with ChatGPT,按浏览器提示完成登录。
命令提示找不到? 先执行 which codex;没有输出通常表示程序未安装或安装目录没进 PATH,重新打开终端,或检查当前安装方式对应的环境变量。
安装器提示元数据或资源不可用? 官方 README 给出的处理路径是回退到 GitHub Releases。不想等待回退,可执行上面那条强制 Releases 命令,或从 最新 GitHub Release 手动下载。下载后若无法运行,先核对文件名是否包含正确的系统与架构(如 codex-aarch64-apple-darwin.tar.gz),再确认压缩包已完整解压。官方 README 提醒:每个 GitHub Release 里包含多个可执行文件,你要挑的是对应自己平台的那一个(macOS 分 arm64 与 x86_64,Linux 也有对应架构)。手动安装还需要把它重命名为 codex 并放入可执行路径。具体权限处理取决于系统,不要对所有文件统一提权。
登录成功却看不到 Codex? 要区分两件事:CLI 里选 ChatGPT 登录,和 Web 里直接访问 chatgpt.com/codex,是两条不同路径。若当前账号所在计划不包含相应权限,页面会限制访问 —— 这不是安装失败。先核对账号与计划,再切到官方给出的其他入口,不要通过非官方账号或破解工具绕过限制。
装好之后的 3 个确认信号
第一步,看命令是否返回版本信息:
codex --version
终端应输出 Codex 的版本号,而不是 command not found 或 shell 语法错误。第二步,执行 codex 后应出现交互界面,并能选择 Sign in with ChatGPT。第三步,进入一个测试项目目录,确认 Codex 能看到文件后再创建最小任务;不要一开始就让它批量修改重要代码。
成功标志可以按形态判断:CLI 能启动并完成账号登录;IDE 扩展出现在编辑器的扩展列表中;桌面应用能打开;Web 页面能进入 Codex 任务界面。四种入口任选其一即可,不代表必须全部安装。
官方入口与延伸阅读
优先收藏四个位置:产品与文档看 Codex 官方文档,CLI 安装和更新看 openai/codex 仓库,云端使用进 Codex Web,手动下载进 Releases。若命令或页面行为与教程不一致,以这些入口当前展示的安装说明为准。
最后做一次路径自检:
which codex
codex --version
前者应指向实际可执行文件,后者应返回版本号。这两步能快速区分“装好了但没进 PATH”和“程序根本没有安装”两类问题。
参考来源
评论区
登录后可评论。