𝐘𝐀𝐈

Codex Manual

Codex 专题

从零开始认识 Codex：选对入口、完成安装，并逐步掌握 CLI、App、IDE 扩展、Web/Cloud、插件、技能、XAI Router 与 GPT Image 2 图片 API。

OpenAI

这是一份面向普通用户的 Codex 入门手册。你不需要先理解代理、MCP、插件、子代理这些术语；先按章节完成安装、打开项目、发出第一个任务，再逐步进入配置、安全和进阶能力。

建议阅读顺序：

  1. 先读“Codex 是什么”，确认它适合你的使用场景。
  2. 按系统完成下载与安装。
  3. 选择 CLI、App、IDE 扩展或 Web/Cloud 入口。
  4. 在真实项目里完成一个小任务。
  5. 配置 XAI Router，并按需通过 Images API 生成或编辑图片。
  6. 最后理解权限、安全策略和进阶能力。

本手册根据 OpenAI Codex 官方手册、OpenAI 图片生成指南、/tmp/codex 本地源码仓库与站内已有文章整理，检查日期：2026-07-29。

1 Codex 是什么 用普通用户能理解的方式解释 Codex、适用场景和边界。 2 下载与安装 macOS、Windows、WSL2、Linux 的 Codex 安装方式。 3 选择使用入口 CLI、App、IDE 扩展、Web/Cloud 分别适合什么场景。 4 第一次使用 从打开真实项目到发出第一个小任务。 5 配置与登录 理解 config.toml、CODEX_HOME、环境变量和不同系统的配置位置。 6 接入 XAI Router 通过 XAI Router 统一管理 Codex 模型、Key、额度和路由。 7 GPT Image 2 图片 API 通过 XAI Router 的 OpenAI 兼容 Images API，使用 gpt-image-2 生成和编辑图片。 8 权限与安全 理解 sandbox、approval 和新手推荐的安全配置。 9 常用工作流 解释项目、修 bug、补测试、代码审查和文档更新的常见提示词。 10 进阶能力 Goals、Skills、Plugins、Subagents、MCP 与站内延伸阅读。