OpenAI Codex CLI:在终端里运行的开源编程智能体

摘要

OpenAI于2025年4月在GitHub上开源发布的终端编程智能体"Codex CLI",最近再度登上GitHub趋势榜
它支持curl、PowerShell、npm、Homebrew等多种安装方式,登录时可以选择ChatGPT付费套餐或API密钥
在同一个Codex品牌下,还分别存在IDE扩展版、桌面应用和浏览器端的"Codex Web",各自的运行方式并不相同

端坐在终端里的编程智能体

OpenAI于2025年4月开源发布的编程智能体Codex,其命令行版本"Codex CLI"最近再度登上GitHub趋势榜。该代码仓库的简介只有简短一句话:"一个在终端中运行的轻量级编程智能体"。

Codex CLI在开发者的终端中运行,能直接操作本地文件和执行命令。使用前需要登录ChatGPT账号或配置API密钥。在同一个Codex名号下,OpenAI还同时运营着代码编辑器扩展版、桌面应用,以及通过浏览器访问的云端版本,形态各不相同。

四种安装方式

代码仓库文档中列出了按操作系统分类的安装命令。macOS和Linux用户可以使用下面这段curl脚本安装。

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

Windows用户则使用PowerShell命令。

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

这个安装脚本默认会从releases.openai.com/codex获取文件,一旦出现问题会自动切换到GitHub Releases。如果把环境变量CODEX_INSTALLER_USE_RELEASES_OPENAI_COM设为false,则可以强制从一开始就只使用GitHub Releases。

代码仓库的官方README中还给出了npm和Homebrew的安装命令。

npm install -g @openai/codex

brew install --cask codex

如果想直接下载可执行文件,可以在GitHub Releases页面上选择对应版本:macOS用户可选Apple芯片版(codex-aarch64-apple-darwin.tar.gz)或英特尔版(codex-x86_64-apple-darwin.tar.gz),Linux用户则可选择x86_64版或arm64版压缩包。解压后里面只有一个带平台名称的可执行文件,仓库建议将其重命名为codex以方便使用。

GitHub 오픈AI codex 저장소 코드 탭과 폴더 및 파일 목록 화면 — 이미지: GitHub · OpenAI

具体怎么用

用上述四种方法中的任意一种完成安装后,终端里就会注册codex命令。
在终端中输入codex并回车,会弹出选择登录方式的界面。
选择"Sign in with ChatGPT"即可用账号登录。OpenAI提供"Sign in with ChatGPT"和API密钥两种登录方式。
如果没有ChatGPT订阅,也可以连接API密钥来使用,不过官方仓库说明这种方式需要额外的配置步骤。
登录完成后,只需用自然语言提出修改代码或创建新文件之类的请求,就能立刻让它开始工作。

Codex CLI、IDE、应用、网页版有什么不同

即便同属Codex品牌,运行位置和接入方式也各不相同。

形态	运行位置	接入方式
Codex CLI	本地终端	curl、npm、brew安装
Codex IDE	VS Code、Cursor、Windsurf内部	IDE安装页面
Codex 应用	桌面端	`codex app`命令或应用介绍页面
Codex Web	浏览器(云端)	chatgpt.com/codex

如果想直接在代码编辑器里使用,可以到IDE页面安装扩展程序;如果不想打开终端、希望用独立窗口操作,可以下载桌面应用。若想在没有本地环境的情况下,直接在浏览器里把工作交给它处理,可以选择基于云端的Codex Web——这一点与CLI不同,它的运算是在OpenAI服务器上完成,而不是占用本地电脑的资源。