2026 年最新 Codex 安装教程与使用指南：GPT-5.5-Codex 完整指南

2026 年，OpenAI 把 Codex 从「历史上的代码补全模型」重新定义为完整的编程 Agent 平台：Codex CLI 跑在你本机终端，能读仓库、改文件、跑命令；GPT-5.5-Codex 是面向软件工程的专项模型变体。本文是中文站的安装 + 使用权威落地页——覆盖三种安装方式、ChatGPT 登录、config.toml、审批沙箱、/model 切换与第一条可验收任务。若你还在纠结和 Claude Code / Cursor 的关系，下文有结构化对比与选型矩阵。

1. 为什么 2026 年还要单独装 Codex CLI？

ChatGPT 网页能写代码，但工程团队的真实矛盾是：对话窗口里的建议无法直接变成可审计的 git diff；无法稳定跑测试循环；无法接入 CI。Codex CLI 解决的是执行边界——把 GPT-5.5 系列放进你选定的目录，在沙箱与审批策略下改文件、跑 shell。

与 2021 年「Codex 补全 API」不同，2026 年的 Codex 是Rust 编写的开源终端 Agent（仓库 openai/codex），与 ChatGPT 订阅打通，并扩展到 IDE 扩展、桌面 App 与 Codex Cloud 异步任务。真正分水岭不是「OpenAI vs Anthropic 谁更强」，而是你愿不愿意把任务委托给终端 Agent。

2. Codex 四种入口怎么分类？

安装教程聚焦 Codex CLI，但完整平台有四个面，配置共享 ~/.codex/ 目录：

本文主路径是 CLI 先行：装通 CLI 后，IDE 扩展与 App 通常只需同一账号登录即可复用配置。

3. 核心对比：Codex vs Claude Code vs Cursor

先讲人话版价格：三家入门都是大约 $20/月（约 ¥145），但买的不是同一种东西——

• Codex、Claude Code：像手机流量包，每过几小时重置额度；让 AI 一口气改很多文件，额度用得特别快。
• Cursor：像健身房月卡，每月固定 $20，天天打开 IDE 写代码最划算，账单最好估。

下表绿色高亮列是「怎么扣费、月底账单会不会吓一跳」——这才是选工具时最该看的。能力差异看左边几列，价格差异重点看绿色列。

更细的 IDE 对比见 Claude Code vs Cursor 2026；Anthropic 与 OpenAI Agent 路线之争见 Claude Code 时代叙事。

4. 场景怎么选？

5. 推荐组合（2026 工程栈）

• 个人开发者— Codex CLI（GPT-5.5-Codex）+ 现有 IDE 写小改；大任务周末开 codex 委托。
• 全栈 + iOS— 业务代码用 Codex/Cursor 本地写；Xcode 构建与签名放 Cloud Mac 或 GitHub Runner 执行节点。
• 团队 CI— codex exec 或 Codex Cloud 出 patch → Actions 里编译测试 → 人工审 PR。Runner 用一 Job 一 Workspace 隔离。
• 知识密集型仓库— Codex MCP 接 Issue 跟踪 + 可选 CodeGraph；规则写在项目 .codex/config.toml 与 AGENTS.md。

6. 安装前准备

• 账号— ChatGPT Plus / Pro / Business / Edu / Enterprise（含 Codex），或可用的 OpenAI API Key。
• 系统— macOS、Linux 为一等公民；Windows 可用 PowerShell 原生或 WSL2。
• Git 仓库— 建议在真实项目根目录验收，而非空文件夹。
• Node.js 18+— 仅在使用 npm install -g @openai/codex 时需要。

uname -a
git --version
node -v   # 走 npm 时检查
which codex # 应无输出（尚未安装）

7. 三种安装方式（2026 官方路径）

# 非交互场景（CI 镜像）可先设
export CODEX_NON_INTERACTIVE=1

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

npm install -g @openai/codex@latest
codex --version
# 若 EACCES：npm config set prefix ~/.npm-global，并把 ~/.npm-global/bin 加入 PATH

8. 登录与鉴权

首次运行 codex 会进入交互 TUI，选择：

• Sign in with ChatGPT（推荐）— 浏览器 OAuth，订阅额度计入 ChatGPT 计划。
• API Key— 适合自动化与按 token 精算；勿把 Key 提交进 git。

配置与凭据落在 ~/.codex/。团队共用机器上注意文件权限，CI 里用密钥管理注入 API Key，而不是写进仓库。

9. GPT-5.5-Codex：模型切换与 config.toml

GPT-5.5 是通用旗舰；GPT-5.5-Codex 面向代码任务优化（读仓库、应用 patch、工具链推理）。日常软件工程建议默认 Codex 变体，通用问答可切回 gpt-5.5。

会话内切换：在 TUI 输入 /model，选择 gpt-5.5-codex 并调整 reasoning 档位。

持久默认：编辑用户级配置 ~/.codex/config.toml（项目级可放 .codex/config.toml，需信任该项目）：

# 默认编程模型
model = "gpt-5.5-codex"

# 审批：on-request = Agent 需要越权时询问（推荐）
approval_policy = "on-request"

# 沙箱：read-only 起步，确认流程后再开 workspace-write
sandbox_mode = "read-only"

# 推理力度（按任务调整）
model_reasoning_effort = "medium"

配置优先级（后者覆盖前者）：内置默认 → ~/.codex/config.toml → 项目 .codex/config.toml → Profile（codex --profile ci）→ CLI 参数。详见 官方 Config basics。

10. 日常使用：TUI、审批、MCP 与脚本化

交互模式

cd your-repo
codex
# 或单行任务
codex "运行 npm test 并修复失败用例，不要改 package-lock"

审批模式（安全红线）

涉及 rm、改生产配置、访问密钥文件时务必人工点批准。企业环境可能通过 requirements.toml 禁止 never 或 danger-full-access 沙箱。

MCP 扩展

Codex 支持 Model Context Protocol，在 config.toml 声明 MCP Server 后可读 GitHub、数据库等外部上下文。与 Claude Code 的 MCP 配置思路类似，宿主不同——可参考我们的 MCP 安装教程 理解 PAT 最小权限原则。

脚本化 exec 与 Cloud

• codex exec "..." — 无头执行，适合 cron / CI 预检。
• Subagents — 大任务拆并行子 Agent（TUI 内开启）。
• 本地 Code Review — 提交前让独立 Agent 审 diff。
• Codex Cloud — 终端内发起云端任务，拉回 patch 再本地应用。

11. 常见误区

1. 把 Codex 当 ChatGPT 网页 — 不装 CLI、不审 diff，就无法形成工程闭环。
2. 一上来 sandbox_mode = danger-full-access — 省点击，但误删文件无法挽回；先 read-only 再放宽。
3. 在子目录启动 codex — Agent 只能看到 cwd 上下文；Monorepo 请在正确包根目录启动。
4. 忽视 Windows 路径差异 — 原生 PowerShell 与 WSL 的仓库路径不是同一份；选一条路径坚持。
5. 只比模型不比入口 — GPT-5.5-Codex 很强，但若你更需要 Tab 补全，应主用 Cursor + Codex 扩展，而非硬扛纯 TUI。

12. 7 步落地清单

1. 安装 CLI — 执行官方 install.sh 或 npm i -g @openai/codex，codex --version 通过。
2. 登录 — ChatGPT OAuth 或 API Key，确认 ~/.codex/ 已生成。
3. 写 config.toml — model = "gpt-5.5-codex"，approval_policy = "on-request"，sandbox_mode = "read-only"。
4. 选仓库 — cd 到熟悉的中型项目，确保 git status 干净或已在功能分支。
5. 跑冒烟任务 — codex "解释 src 目录结构并画树状图"，检查是否读对文件。
6. 跑闭环任务 — codex "运行测试命令 [你的 test cmd]，修复失败用例"，观察是否真跑 shell。
7. 接入团队栈 — 需要 24/7 构建时，把 Runner 放 Cloud Mac；需要图谱时接 MCP。

13. FAQ

Codex、Claude Code、Cursor 哪个最便宜？

表面都是 $20/月 起步，没有绝对的「最便宜」。已经在用 ChatGPT 的人，Codex 等于白送；已经在用 Claude Pro 的人，Claude Code 同理。从零开始、只想每月固定一笔钱，Cursor 最好估。AI 帮你一口气改很多文件的重度用法，两边都可能要升到 $100–$200，详见上文对比表。

Codex 需要单独付费吗？

一般不用。买了 ChatGPT Plus（$20/月）就包含 Codex。也可以用自己的 API Key 按用量付钱，但那样没有云端审代码等会员功能。具体额度见 OpenAI 说明。

GPT-5.5 和 GPT-5.5-Codex 有什么区别？

GPT-5.5 通用；GPT-5.5-Codex 为软件工程微调，更适合读代码、写 patch、跟工具链。写码默认选 Codex 变体。

Codex 和 Claude Code 能同时装吗？

可以。两者配置目录不同（~/.codex/ vs ~/.claude.json），同一仓库可分场景使用；注意统一编码规范，避免两个 Agent 来回改格式。

安装后 command not found？

脚本安装后重启 shell，或把安装路径加入 PATH。Homebrew 用户检查 /opt/homebrew/bin；npm 用户检查 ~/.npm-global/bin。

如何升级 Codex？

npm install -g @openai/codex@latest 或重新运行官方 install 脚本；Homebrew 用 brew upgrade codex。

14. 总结

2026 年的 Codex 安装教程，本质是把 OpenAI 编程 Agent 接到你的文件系统与终端。 三条命令装好 CLI，登录 ChatGPT，在 config.toml 里默认 gpt-5.5-codex，用 on-request 审批守住安全线——你就有了可复现、可脚本化、可上 Cloud 的编码工作流。它与 Claude Code 争的是「终端 Agent 入口」，与 Cursor 争的是「谁主驾写码」；多数团队最终会双持或三持，而不是押注单一品牌。

对需要真 macOS 构建的读者：Agent 写得再快，Xcode 与 Runner 仍要落在 Apple 硬件上。Cloud Mac 可与 Codex 本地改代码、远程编译的组合搭配，把「写」与「验」拆开，缩短上架路径。