发布日期：2026-06-02 | 适用版本：Codex v0.135.0（2026-05-28）
Codex 是 OpenAI 推出的 AI 编程代理，GitHub 仓库（openai/codex）截至 2026 年 6 月已获 87,300+ stars，以"one agent for everywhere you code"为定位，将 AI 编程助手从"代码补全工具"升级为"可自主执行任务的代理"。Codex 提供三种使用入口：本地终端 CLI、桌面图形界面（Desktop App）和云端 Web 版，三者共享同一套核心能力，但在执行环境和专属功能上各有侧重。它以 Rust 编写（占代码库 96%），截至 v0.135.0 已发布 805 个版本；可配合超过 1,400 个 Agent Skills 扩展能力（awesome-agent-skills，2025），支持 MCP 协议连接任意外部工具，是目前开发者生态中成长最快的 AI 编程代理之一。本文覆盖 Codex 的安装认证、三种入口对比、核心功能全览、Agent Skills 生态，以及常见使用场景与选型建议。
Codex 是什么？
Codex 是一个运行于本地终端或云端的 AI 编程代理（Agent），区别于仅在编辑器中提供行级补全的 Copilot 类工具——Codex 能感知整个代码库上下文，自主规划、执行多步骤任务，包括：
- 读取、修改和创建文件
- 运行 Shell 命令、测试套件、构建工具
- 调用外部 API（通过 MCP 协议）
- 创建 Git 提交和 Pull Request
- 并行处理多个任务（云端模式）
核心理念：你描述目标，Codex 规划路径、执行操作、验证结果，在沙盒保护下自主推进，遇到边界操作时暂停确认。
三种使用入口
| 入口 | 启动方式 | 执行环境 | 适用场景 |
|---|---|---|---|
| CLI（终端 TUI） | codex |
本地机器 | 日常编程、脚本化、CI 集成 |
| Desktop App | codex app |
本地机器 | 可视化审查、多任务并行、GUI 自动化 |
| Web（Cloud） | chatgpt.com/codex | OpenAI 云端 | 后台任务、GitHub 集成、无本地环境 |
三者共享：Agent Skills、MCP 工具、会话历史、AGENTS.md 配置文件。
安装与认证
安装（选其一）：
# 官方脚本（Mac/Linux，推荐）
curl -fsSL https://chatgpt.com/codex/install.sh | sh# Homebrew（macOS）
brew install --cask codex# npm
npm install -g @openai/codex# Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex
安装后通过 codex 启动 CLI，codex app 启动桌面端。
登录认证：
codex login # 浏览器 OAuth（推荐）
codex login --device-auth # 无浏览器设备
支持 ChatGPT Plus / Pro / Business / Edu / Enterprise 套餐，也可通过 API Key 认证。
核心功能全览
安全沙盒
Codex 默认在沙盒中运行，三档策略通过 --sandbox（或 -s）设置：
| 模式 | 参数 | 行为 |
|---|---|---|
| 工作区写入（默认） | workspace-write |
读写当前目录，出界操作需确认 |
| 只读 | read-only |
仅浏览，不修改任何文件 |
| 完全访问 | danger-full-access |
无限制，仅用于隔离环境 |
会话中随时通过 /permissions 切换权限模式。
核心 Slash 命令
| 命令 | 功能 |
|---|---|
/review |
代码审查（支持分支对比、未提交变更） |
/model |
切换 AI 模型（默认 gpt-5.5） |
/compact |
压缩会话历史，释放上下文空间 |
/diff |
查看当前会话产生的所有文件变更 |
/fork |
分叉当前会话为新分支 |
/permissions |
切换沙盒模式 |
/status |
查看 token 用量和剩余容量 |
快捷键（TUI 模式）
| 快捷键 | 功能 |
|---|---|
Ctrl+L |
清屏（保留对话） |
Ctrl+O |
复制最新输出 |
@ |
模糊搜索文件，快速引用路径 |
!cmd |
直接执行本地 Shell 命令 |
Tab（运行中） |
排队下一轮输入 |
Esc×2 |
编辑上一条消息 |
非交互执行（CI / 脚本化）
# 基础单次执行
codex exec "fix all failing tests"
codex e "refactor the auth module"# CI 场景：JSON 输出 + 保存结果
codex exec --json --output-last-message result.txt "fix CI failure"# 多模态（附截图分析）
codex exec --image screenshot.png "explain this error"# 管道输入
echo "fix the bug in main.py" | codex exec -
会话管理
codex resume # 选择历史会话继续
codex resume --last # 直接继续最近会话
codex fork --last # 分叉最近会话（不覆盖原始历史）
MCP 工具集成
# 添加 MCP 服务器
codex mcp add myserver -- /path/to/server
codex mcp add myserver --url https://example.com/mcp# 列出/删除
codex mcp list --json
codex mcp remove myserver
MCP 配置写入 ~/.codex/config.toml，会话启动时自动加载。
CLI vs Desktop vs Cloud：三种入口详细对比
CLI（终端 TUI）专属能力
codex exec：非交互单次执行，适合 CI/CD 管道和 Shell 脚本- 远程 TUI（
--remote）：通过 WebSocket 连接远程 App Server - Shell 补全（bash/zsh/fish）：
codex completion bash > ~/.bash_completion.d/codex - 本地开源模型（
--oss）：配合 Ollama 运行本地模型 codex cloud exec：从 CLI 发起云端任务，支持多方案生成（--attempts 1-4）
Desktop App（codex app）专属能力
- Worktrees：并行管理多个独立工作区
- Automations：图形界面配置定时/事件触发自动化
- Review UI：可视化审查所有文件变更，逐行接受/拒绝
- 内置浏览器 + Chrome 扩展：在 IDE 内浏览网页，AI 感知页面内容
- Computer Use：控制桌面应用，模拟鼠标和键盘操作
- Appshots：应用状态快照，便于复现和恢复场景
Cloud（Web）专属能力
- 后台并行任务：多个任务同时在云端运行，不占用本地资源
- GitHub 集成：连接仓库后可自动创建 Pull Request
@codex触发：在 GitHub Issue 或 PR 中@codex即可派发任务- 可配置网络访问：控制云端任务是否可访问公网
- 无需本地环境：适合在没有开发环境的机器上使用
Agent Skills 生态
Codex 支持 Agent Skills——以 SKILL.md 格式定义的可安装技能包，将专业知识固化为可复用的行为模块。
安装方式：
# Git 克隆
git clone https://github.com/用户名/仓库名 ~/.claude/skills/技能名# Plugin Marketplace（部分 Skill 支持）
codex plugin marketplace add 用户名/仓库名
推荐起点（各有 GitHub 链接）：
| 技能包 | 能力 | 链接 |
|---|---|---|
| agent-reach | 联网访问 17 个平台 | GitHub |
| Trail of Bits Security | 21 个安全审计技能 | GitHub |
| expo/skills | React Native 移动端 | GitHub |
| planning-with-files | 持久化任务规划 | GitHub |
| ECC（249 个技能） | 全栈开发工具矩阵 | GitHub |
策展列表：VoltAgent/awesome-agent-skills（1,400+ 技能）
常见使用场景
场景一：日常编程（CLI 交互模式）
cd your-project
codex
# 然后：修复 bug、写测试、重构代码……
场景二：CI 自动化修复
# GitHub Actions 中自动修复 CI 失败
codex exec --json --sandbox workspace-write "fix the failing CI tests"
场景三：大型代码库分析（配合子代理）
# 在 Codex 中输入：
使用子代理读取 src/payments/ 目录，分析 token refresh 逻辑，返回摘要
# 子代理独立处理文件读取，不消耗主会话上下文
场景四：GitHub 后台任务（Cloud 模式）
# 在 GitHub Issue 中直接 @codex
@codex 请修复这个 bug 并提一个 PR
场景五：配置外部模型
Codex 通过 API Key 支持接入非 OpenAI 模型。七牛云 API Key 兼容 OpenAI 标准接口，激活即得最高 600 万免费 Token，可在 Codex 配置中切换使用 Claude、DeepSeek 等模型处理复杂推理任务。更多接入指南见七牛云 AI 编程工具配置大全。
Codex vs 同类工具
| 维度 | Codex | Claude Code | Cursor | Windsurf |
|---|---|---|---|---|
| 执行环境 | 本地 + 云端 | 本地 + 云端 | 本地 IDE | 本地 IDE |
| 开源 | ✅（Apache-2.0） | ❌ | ❌ | ❌ |
| Agent Skills | ✅（1400+ 跨平台） | ✅（同生态） | 部分支持 | 部分支持 |
| MCP 支持 | ✅ | ✅ | ✅ | ✅ |
| Computer Use | ✅（Desktop） | ✅（Desktop） | ❌ | ✅ |
| 云端并行任务 | ✅（Cloud） | ✅（Cloud） | ❌ | 有限 |
GitHub @ 触发 |
✅ | ✅ | ❌ | ❌ |
| 订阅价格 | ChatGPT Plus $20/月起 | Claude Pro $20/月起 | $20/月 | $20/月 |
FAQ
Q：Codex 免费吗？
Codex CLI 代码完全开源（Apache-2.0），可免费下载安装。但使用需要 ChatGPT 账户（Plus/Pro/Business/Edu/Enterprise），Free 套餐目前无法使用。也可通过 API Key 方式接入，按 token 用量计费。
Q：Codex 和 GitHub Copilot 有什么区别？
定位根本不同。Copilot 是"在你写代码时提供补全建议"的 IDE 插件；Codex 是"你给出任务目标，AI 自主规划和执行"的编程代理。Copilot 帮你打字更快，Codex 替你完成整件事。
Q：Codex 安全吗？不会乱删文件？
三层保护：① 默认沙盒只允许读写当前工作目录；② 所有文件编辑前会自动 checkpoint（Esc×2 可回滚）；③ /permissions 随时降级到只读模式。不放心时用 --sandbox read-only 完全锁定。
Q：适合初学者用吗？
适合有基本编程基础的开发者（知道项目结构、能看懂错误信息）。对于完全无编程基础的用户，建议先用 Cloud Web 版（chatgpt.com/codex），界面更友好，无需配置本地环境。
Q：如何在 CI/CD 中使用 Codex？
用 codex exec 子命令：非交互执行，支持 --json 输出、--output-last-message 保存结果、--sandbox workspace-write 控制权限。配合 GitHub Actions 可实现自动修复失败测试、分析日志、生成发布说明等流程。
总结
Codex 以三种入口（CLI / Desktop / Cloud）覆盖了开发者的全场景需求：CLI 给终端重度用户最大的可脚本化空间，Desktop 给偏 GUI 工作流的用户提供可视化审查和 Computer Use，Cloud 让无本地环境时也能并行处理复杂任务。配合 1,400+ 社区 Agent Skills 和 MCP 协议的开放生态，Codex 正在从"一个工具"演变为"一个可定制的 AI 编程操作系统"。对于还没有试用过 AI 编程代理的开发者，从 curl -fsSL https://chatgpt.com/codex/install.sh | sh 开始，进入项目目录执行 codex，是 10 分钟内感受 Agentic 编程范式的最快路径。
相关资源
- Codex GitHub 仓库 — 源码、Issues、Releases（v0.135.0）
- Codex 官方文档 — 完整 CLI 参考与配置指南
- Codex Cloud（Web 版） — 无需本地安装，直接使用
- awesome-agent-skills — 1,400+ 跨平台 Agent Skills
- 七牛云 AI 编程工具配置大全 — Codex 接入多种 AI 模型的配置方法