Codex：OpenAI 的開源編程智能體

1. 項目概述

Codex 是 OpenAI 的開源編程代理，在您的終端本地運行，讓開發者能夠與 AI 對話，該 AI 可以閱讀代碼庫、編輯文件、在沙箱中運行命令，並在不移出命令行的情況下迭代更改。

2. 背景與定位

Codex 旨在將 OpenAI 的智能體編程能力直接帶到開發者的機器上，而不是將其限制在雲端 IDE 或聊天窗口中。其核心使命是為工程師提供一種快速、可腳本化且尊重隱私的方式，將真正的工程工作——閱讀陌生代碼、起草補丁、運行測試、調試失敗——委派給一個使用與人類開發者相同的終端和文件系統的 AI 智能體。

與其他 AI 編程助手相比，Codex 在以下三個方面區別於眾：

本地優先執行：智能體作為輕量級二進制文件在開發者機器上運行（最初使用 TypeScript 編寫，現在已重寫為 Rust 以獲得更好的性能和可靠性），而不是每個會話都需要託管容器。
可配置的沙箱和審批：智能體想要運行的每個命令都要經過明確的沙箱和審批策略，因此用戶可以在自主性和監督之間調整平衡——從「每次操作前詢問」到「完全自主」。
多個入口點，同一個智能體：相同的 Codex 引擎作為終端 CLI、IDE 擴展（VS Code、Cursor、Windsurf）和桌面應用程序公開，因此團隊不會被鎖定在單一工作流程中。

3. 功能類別

🖥️ 終端智能體 — 核心交互體驗

codex — 在當前存儲庫中啟動交互式會話
codex exec "<prompt>" — 運行一次性、非交互式任務（適用於腳本/CI）
具有工作目錄完整上下文的多輪對話
內聯差異和命令輸出直接流式傳輸到終端
目的：讓開發者在不移出 Shell 的情況下驅動實際的代碼更改。

🛡️ 沙箱與審批 — 安全控制

只讀模式：智能體可以檢查文件但不能修改任何內容或運行任意命令
工作區寫入 / 自動模式：智能體可以編輯文件並運行受限於項目目錄的命令
全自動模式：智能體在沙箱內執行多步計劃而無需每條命令確認
平台原生沙箱（例如 macOS Seatbelt、Linux 容器/命名空間）以限制文件系統和網絡訪問
目的：讓用戶選擇授予智能體多少自主權。

🔌 集成 — 將 Codex 連接到您的項目和工具

AGENTS.md — 描述智能體應遵循的約定、命令和上下文的項目級文件
MCP（模型上下文協議）服務器支持，用於通過外部工具擴展智能體
存儲在 .codex/skills 下的技能，用於可重用、特定於項目的智能體功能
VS Code、Cursor 和 Windsurf 的 IDE 擴展
目的：使 Codex 了解特定於項目的規則，並通過自定義工具進行擴展。

☁️ 多智能體協調 — 協調較大的任務

跨多個 Codex 實例的任務分解
智能體之間的通信和共享上下文
當多個智能體接觸重疊代碼時的衝突解決
目的：將智能體從單個文件編輯擴展到協調較大、多部分的項目。

⚙️ 企業與自動化 — 在人類終端之外運行 Codex

鉤子系統（例如用戶提示鉤子）以攔截、審計或增強智能體提示
適合 CI/自動化的非交互式模式
具有共享策略的團隊的配置配置文件
目的：讓組織將 Codex 嵌入管道並實施治理。

4. 關鍵亮點

基於 Rust 的重寫：CLI 的執行引擎（codex-rs）是用 Rust 實現的，優先考慮啟動速度、低內存佔用率和長運行智能體會話的可靠性。
可配置的自主性：沙箱和審批設置範圍從嚴格只讀到完全自主，因此同一工具既適合謹慎的首次使用，也適合無人的自動化。
靈活的身份驗證：使用現有的 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 計劃登錄，或使用 API 密鑰進行身份驗證——大多數用戶不需要單獨的帳戶。
通過 AGENTS.md 感知項目上下文：團隊可以在 AGENTS.md 中記錄一次約定，智能體將在整個會話中始終遵循它們。
通過 MCP 擴展：模型上下文協議允許 Codex 連接到本地文件系統和 Shell 之外的外部工具和數據源。
多個表面，同一引擎：相同的智能體作為終端 CLI、IDE 擴展和桌面應用程序可用，因此它適合團隊已經使用的任何工作流程。

5. 按角色劃分的用例

一般開發人員 — 使用 Codex 探索陌生的代碼庫、起草錯誤修復、生成測試或直接从終端構架新功能，並在應用之前審查差異。

DevOps / SRE — 在 CI 管道或腳本中以非交互式（codex exec）模式運行 Codex，以自動化常規維護任務、配置更新或日誌驅動的分類，受審批策略保護。

項目經理 — 使用 Codex 快速生成代碼庫結構或近期更改的摘要，降低理解技術進展的門檻，而無需閱讀原始差異。

6. 入門指南

查找所需內容

瀏覽存儲庫和文檔：github.com/openai/codex
在提交新問題之前搜索現有問題和討論

安裝 / 集成

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

# via npm
npm install -g @openai/codex

# via Homebrew
brew install --cask codex

# start a session in your project
codex

貢獻

git clone https://github.com/openai/codex.git
cd codex/codex-rs
cargo build

有關編碼標準和拉取請求流程，請參閱存儲庫的貢獻指南。

7. 項目結構

codex/
├── codex-cli/    # CLI wrapper and npm packaging
├── codex-rs/     # Rust implementation of the agent engine
├── sdk/          # SDK for embedding Codex in other tools
├── docs/         # User and developer documentation
└── tools/        # Utility and release scripts

codex-rs/ 包含核心智能體循環、沙箱邏輯和模型交互代碼——大多數工程貢獻都在此處完成。
codex-cli/ 打包編譯後的二進制文件以通過 npm 分發。
docs/ 包含本文檔中引用的配置、沙箱和使用指南。

8. 相關生態系統

ChatGPT plans (Plus, Pro, Business, Edu, Enterprise) — 提供 Codex 的身份驗證和使用權限，無需單獨的 API 密鑰。
OpenAI API — 對於偏好基於密鑰計費的用戶，另一種身份驗證路徑。
Model Context Protocol (MCP) — Codex 用於連接到外部工具和數據源的開放協議。
IDE integrations — VS Code、Cursor 和 Windsurf 擴展，將相同的智能體嵌入編輯器中。

9. 許可證

Codex 根據 Apache-2.0 許可證發布。

✅ 免費使用、修改和分發，包括商業用途
✅ 包含專利授權，涵蓋來自項目的貢獻
❌ 不提供任何擔保；使用風險自負
ℹ️ 修改版本必須保留原始許可證和版權聲明，並說明重大更改

10. 常見問題

問：我需要 API 密鑰才能使用 Codex 嗎？
答：不需要——您可以使用現有的 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 計劃登錄，或者如果您願意，可以使用 API 密鑰。

問：Codex 可以不經詢問就修改我的文件嗎？
答：只有在你配置它這樣做時才可以。沙箱和審批設置範圍從只讀到全自動，因此你控制智能體擁有多少自主權。

問：支持哪些平台？
答：macOS、Linux 和 Windows，通過預構建二進制文件、npm 或 Homebrew。

問：如何在腳本或 CI 管道中運行 Codex？
答：使用非交互式命令，例如 codex exec "run the test suite and summarize failures"。

問：Codex 如何學習我項目的約定？
答：在你的存儲庫中添加一個 AGENTS.md 文件來描述命令、風格和上下文；Codex 會在每個會話中自動讀取它。

11. 快速鏈接

Repository: https://github.com/openai/codex
Documentation: https://github.com/openai/codex/tree/main/docs
Contributing guide: https://github.com/openai/codex/blob/main/docs/contributing.md
Discussions: https://github.com/openai/codex/discussions

12. 總結

Codex 將 OpenAI 的編程智能體帶入任何開發者的終端、IDE 或 CI 管道，並配備可配置的沙箱，以便團隊可以選擇授予多少自主權。它非常適合那些希望在不離開現有命令行工作流程的情況下獲得 AI 輔助編程的開發者，以及需要在清晰、可審計的安全控制下自動化常規工程任務的團隊。