codex

终端里一句话改代码,读完文件直接跑命令

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 20659 🐛 待处理 24720 👀 关注 661
GitHub ↗
GitHub 星标 ★ 130876
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,免费使用

项目预览

codex 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队openai
定价模式🏷️完全免费
价格说明开源项目,免费使用
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Rust
GitHub 星标★ 130876
上线时间2025-04-13 00:00:00
代码更新2026-10-23
仓库体积680.5 MB
本站数据更新2026-10-26
维护状态活跃
收录时间2026-10-26
浏览次数0

项目介绍

Codex 是一个用 Rust 编写的轻量级终端编程智能体,直接在命令行中运行,把代码理解、修改与执行能力带到开发者最熟悉的终端环境。它解决的是在编辑器与浏览器之间来回切换、手动复制粘贴代码片段效率低的问题:用户用自然语言描述任务,智能体即可读取仓库文件、分析上下文、生成补丁并执行命令,形成从需求到改动的闭环。核心能力包括:在终端内进行多轮对话式编程、按指令检索和编辑项目文件、运行 shell 命令并依据输出继续推理、以轻量单二进制方式分发因而启动快、资源占用低。Rust 实现带来较好的性能与跨平台可移植性,适合脚本化、自动化和本地优先的工作流。项目星标量极高,社区关注度与迭代活跃度处于同类前列,适合希望把 AI 编程助手嵌入终端管线的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-26 · 当前星标 ★ 130876

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • macOS 或 Linux 系统,可执行 shell 脚本
  • Windows 系统,可使用 PowerShell
  • 可选:已安装 Node.js/npm(走 npm 安装方式时需要)
  • 可选:已安装 Homebrew(走 brew 安装方式时需要)
  • 终端需能访问安装脚本与安装包下载地址

安装与启动步骤

  1. 1macOS/Linux 一键安装

    在终端执行官方安装脚本,自动下载对应平台二进制并安装到本机。

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. 2Windows 一键安装

    在 PowerShell 中执行安装脚本,脚本临时放开执行策略以完成安装。

    powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
  3. 3改用 GitHub 下载源

    默认从 releases.openai.com 下载,若元数据或资源不可用,可用环境变量切到 GitHub Releases。

    curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
  4. 4npm 方式安装

    已装 Node.js 时可用 npm 全局安装,适合统一管理命令行工具的环境。

    npm install -g @openai/codex
  5. 5Homebrew 方式安装

    macOS 上可用 Homebrew 以 cask 方式安装,后续升级交给 brew 管理。

    brew install --cask codex
  6. 6手动下载二进制

    到最新 GitHub Release 页面按平台下载压缩包,解压后只有一个带平台名的可执行文件,重命名为 codex 即可。

  7. 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 编程实战手册

★ 669 2026-08-09
power-platform-skills 开源

让 AI 助手直接会写 Power Platform 方案

A plugin marketplace for GitHub Copilot and other AI agents that provides Power Plat···

★ 1053 2026-09-15
vscode-unify-chat-provider 开源

把多个 AI 订阅塞进 Copilot Chat,一个入口随便切

Integrate multiple LLM API providers into VS Code's GitHub Copilot Chat using the La···

★ 718 2026-09-15
langchain-coder 开源

说人话写代码,多模型生成还能在线跑和修 bug

Web Application that can generate code and fix bugs and run using various LLM's (GPT···

★ 124 2026-09-25
sap-skills 开源

让AI助手秒懂SAP开发,生成规范代码

Production-ready plugins for SAP development with AI coding assistants — BTP, CAP, ···

★ 472 2026-09-13
vix 开源

轻量快速的 AI 编码助手,帮你省 token 提效率

Sleek, Fast and Token Efficient AI Coding Agent

★ 280 2026-08-09
snow-cli 开源

在终端里用自然语言写代码,一个工具通吃四大AI模型。

Agentic coding in your terminal,Simultaneously compatible with OpenAI, Gemini, and C···

★ 1068 2026-08-09
chatgpt.js-chrome-starter 开源

快速搭建 ChatGPT 浏览器扩展,自带弹窗和设置管理

A starting point for developing your own Chrome extension using chatgpt.js (includin···

★ 61 2026-08-09
crit 开源

给AI代理装个反馈闭环,让每次修改都更懂你

Review AI coding agents' plans, diffs and running apps in the browser. Local-first, ···

★ 1246 2026-08-09