
codex
终端里一句话改代码,读完文件直接跑命令
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 130876
使用教程
环境要求
- macOS 或 Linux 系统,可执行 shell 脚本
- Windows 系统,可使用 PowerShell
- 可选:已安装 Node.js/npm(走 npm 安装方式时需要)
- 可选:已安装 Homebrew(走 brew 安装方式时需要)
- 终端需能访问安装脚本与安装包下载地址
安装与启动步骤
-
1macOS/Linux 一键安装
在终端执行官方安装脚本,自动下载对应平台二进制并安装到本机。
curl -fsSL https://chatgpt.com/codex/install.sh | sh -
2Windows 一键安装
在 PowerShell 中执行安装脚本,脚本临时放开执行策略以完成安装。
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" -
3改用 GitHub 下载源
默认从 releases.openai.com 下载,若元数据或资源不可用,可用环境变量切到 GitHub Releases。
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh -
4npm 方式安装
已装 Node.js 时可用 npm 全局安装,适合统一管理命令行工具的环境。
npm install -g @openai/codex -
5Homebrew 方式安装
macOS 上可用 Homebrew 以 cask 方式安装,后续升级交给 brew 管理。
brew install --cask codex -
6手动下载二进制
到最新 GitHub Release 页面按平台下载压缩包,解压后只有一个带平台名的可执行文件,重命名为 codex 即可。
-
7启动 Codex
安装完成后直接在终端运行 codex 进入使用流程。
codex
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
CODEX_INSTALLER_USE_RELEASES_OPENAI_COM | 否 | 设为 false(0/no 亦可)时安装器强制从 GitHub Releases 下载 | false |
如何确认成功
在终端执行 codex,能正常进入 Codex 的命令行交互界面即表示安装成功。
常见问题
Q:安装脚本下载资源失败怎么办?
A:安装器默认从 releases.openai.com 获取,失败时会回退到 GitHub Releases;也可手动设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制走 GitHub。
Q:没有 npm 或 Homebrew 可以装吗?
A:可以。macOS/Linux 用 curl 安装脚本、Windows 用 PowerShell 安装脚本;也可到 GitHub Releases 下载对应平台压缩包手动使用。
Q:Windows 下脚本执行被策略拦截?
A:使用 README 给出的命令形式,脚本已带 -ExecutionPolicy ByPass 参数,在 PowerShell 中整条复制执行即可。
Q:想在编辑器里用 Codex?
A:README 说明可安装 IDE 扩展,适用于 VS Code、Cursor、Windsurf,参见官方 IDE 安装页面;桌面端体验可运行 codex app。
Q:手动下载的压缩包怎么用?
A:压缩包内只有一个文件名带平台标识的可执行文件,解压后重命名为 codex,放到 PATH 目录或直接以路径调用。
注意事项
- 安装命令会从网络拉取脚本与二进制,执行前建议确认下载地址为 README 中给出的官方地址。
- npm 与 Homebrew 为可选方式,与安装脚本方式择一即可,不建议同时安装多份。
- README 节选未提供模型、密钥等配置说明,相关设置请以官方文档为准。
核心亮点
- Rust 单二进制分发,启动快、内存占用低,适合常驻终端使用
- 在终端内完成读文件、改代码、执行命令的闭环,减少编辑器与浏览器切换
- 多轮对话式交互,能依据命令输出继续推理并迭代修改
不足之处
- 终端交互对复杂重构和可视化 diff 的呈现不如图形化 IDE 直观
- 智能体自主执行命令存在误操作风险,需要谨慎配置权限与确认策略
适用场景
- 在远程服务器或容器内无图形界面时,用终端直接完成代码修改与调试
- 批量脚本化任务:让智能体读取日志、定位问题并提交修复补丁
- 本地仓库快速原型开发,用自然语言描述需求后自动生成并运行代码
替代项目
aider、OpenHands、Cline
上一篇:brooks-lint
下一篇:codex-security
同类项目推荐
codex-orange-book
开源
跟着橙皮书,从零上手 Codex,AI 编程少走弯路
OpenAI Codex: The Complete Guide · 橙皮书系列 · GPT-5.5 时代的 AI 编程实战手册
power-platform-skills
开源
让 AI 助手直接会写 Power Platform 方案
A plugin marketplace for GitHub Copilot and other AI agents that provides Power Plat···
vscode-unify-chat-provider
开源
把多个 AI 订阅塞进 Copilot Chat,一个入口随便切
Integrate multiple LLM API providers into VS Code's GitHub Copilot Chat using the La···
langchain-coder
开源
说人话写代码,多模型生成还能在线跑和修 bug
Web Application that can generate code and fix bugs and run using various LLM's (GPT···
sap-skills
开源
让AI助手秒懂SAP开发,生成规范代码
Production-ready plugins for SAP development with AI coding assistants — BTP, CAP, ···
vix
开源
轻量快速的 AI 编码助手,帮你省 token 提效率
Sleek, Fast and Token Efficient AI Coding Agent
snow-cli
开源
在终端里用自然语言写代码,一个工具通吃四大AI模型。
Agentic coding in your terminal,Simultaneously compatible with OpenAI, Gemini, and C···
chatgpt.js-chrome-starter
开源
快速搭建 ChatGPT 浏览器扩展,自带弹窗和设置管理
A starting point for developing your own Chrome extension using chatgpt.js (includin···
crit
开源
给AI代理装个反馈闭环,让每次修改都更懂你
Review AI coding agents' plans, diffs and running apps in the browser. Local-first, ···