Skip to content

Codex 实战手册

这本手册是网站的工具参考区。需要查工具时再来,不必从第一篇一路背到最后一篇。

时效说明: Codex 的界面、套餐、模型和实验能力会持续变化。本文优先讲稳定工作方法;涉及具体入口时,以你当前客户端和 OpenAI Codex 官方文档 为准。找不到某个按钮时,不要照着旧截图强行操作。

你可以把 Codex 理解成一个会读文件、会改项目、会运行检查、也会和你讨论方案的 AI 编程助手。你要学的不是“怎么写代码”,而是“怎么和它协作完成一个项目”。

如果你现在更想完成一件现实工作,可以先去:

遇到安装、提示词、权限、Skills、MCP 或自动化问题时,再回到对应章节查具体方法。

第一阶段:先跑起来

  1. 认识 Codex
  2. 核心概念速览
  3. 安装与登录
  4. 订阅与计费
  5. 接入国产模型
  6. 跑通第一个任务
  7. 桌面 App 上手
  8. 命令行 CLI 上手
  9. IDE 扩展上手
  10. Codex Cloud 上手
  11. AGENTS.md 项目说明书

第二阶段:学会稳定协作

  1. 快捷命令与操作面板
  2. 提示词写法
  3. 四类日常工作流
  4. 权限、沙箱与审批
  5. 安全与风险边界
  6. 电脑操控与浏览器

第三阶段:高级功能扩展

  1. config.toml 配置详解
  2. 跨会话上下文管理
  3. 用 MCP 接外部工具
  4. 子代理 Subagents
  5. Agent Skills 技能
  6. 插件 Plugins
  7. 规则与钩子

第四阶段:工程化与自动化

  1. Worktrees 并行隔离
  2. Git 与 GitHub 集成
  3. 自动化与 CI/CD
  4. codex exec 非交互模式
  5. Slack / Linear 与 SDK 集成

第五阶段:实战与进阶

  1. 怎么选模型
  2. 进阶技巧与提速
  3. 从 Claude Code 迁移
  4. Windows 使用要点
  5. 综合实战 TODO 小工具

第六阶段:收尾与查阅

  1. 命令与配置速查表
  2. 最佳实践
  3. 常见问题排查
  4. 术语表
  5. 企业管理与治理

学习方法

第一次使用 Codex,建议先看 01、03、06、13、15。想做自动化,再看 20、22、27。

其余章节按需查阅。每次学一个功能,都尽量回到真实项目里使用一次;能完成工作,比记住术语更重要。