OpenAI Codex
实用技巧 手册
按使用场景整理 CLI、桌面端、IDE 与 Cloud 的常用技巧，涵盖提示、配置、Skills、MCP 与自动化。查找操作方法、复制模板，或阅读相关资料。
章节
心智模型
把 Codex 当可配置的队友，而不是一次性聊天框。
提示与规划
Goal / Context / Constraints / Done when，以及何时先计划。
AGENTS.md
持久规则放这里：发现顺序、覆盖、体积上限与审查规则。
配置与 Profiles
config.toml 管运行时。个人默认、项目覆盖、独立 profile 文件。
沙箱与权限
approval 决定何时询问，sandbox 决定能碰哪些文件。
斜杠命令
TUI 里真正省时间的快捷键、斜杠命令与排队输入。
会话与上下文
一事一线程，/compact、/fork、/side、/goal 各管一种形状的工作。
Skills 与 Plugins
同一套步骤说第二次，就该收成 SKILL.md 或插件。
MCP
仓库外的实时数据用 MCP，不要一上来接满所有工具。
子代理
只在你明确要求时并行；重叠写文件请改用 worktree。
Hooks 与 Rules
生命周期脚本与命令规则：拦危险操作、补上下文、强制校验。
自动化与 CI
codex exec、JSONL、output-schema，以及 GitHub Action 的安全用法。
Cloud 与并行
Worktree、Cloud 任务、Best-of-N 与定时任务。
安全
密钥、供应链、沙箱失败关闭，以及不要把 API Key 交给仓库代码。
排错
doctor、指令链审计、截断、PATH 影子二进制。
工作流配方
修 CI、测试先行、本地审查、迁移与大型重构的现成配方。
先读这几条
把 Codex 当可配置的队友
一次性提示只能救急。真正变强的路径是：上下文 → AGENTS.md → config → MCP → Skills → 自动化。
按任务难度选推理强度
Low 处理边界清晰的小改动；Medium/High 给复杂变更和排错；Extra High / xhigh 留给长程推理。
提示默认写四件套
Goal、Context、Constraints、Done when。四件事写全，Codex 少猜、更好审。
把测试和构建命令交给它
不告诉 Codex 怎么跑检查，它就看不见自己的工作。这是官方点名的高频失误。
复杂任务先 /plan
模糊、多步、难描述的工作，先让 Codex 搜集上下文、提问、出方案。/plan 或 Shift+Tab。
AGENTS.md 是给 Agent 的 README
它会在开工前自动注入。写清目录、命令、约定、禁止事项和如何验收。
常见问题
- Codex Tips 是什么？
- 一份给 OpenAI Codex 的现场手册，把散落在官方文档、社区长文和社交媒体里的实用技巧编成可检索的网站，覆盖 CLI、桌面端、IDE 与 Cloud。
- 怎么检索技巧？
- 按 / 或 ⌘K 打开检索。目录页可按章节、难度和入口过滤；每条技巧都有来源链接。
- 和官方文档是什么关系？
- 本站不是官方文档镜像。动手前仍以 developers.openai.com/codex 和本机 /help 为准。