一、核心定位与入口Codex 是直接在你的代码仓库里干活的 AI 工程师可理解、编辑、调试、重构、写单测、写文档。入口Webchatgpt.com/codex绑定 GitHubIDEVS Code 扩展「OpenAI Codex」VS Code OpenAI Codex 扩展CLInpm i -g openai/codex / brew install --cask codex二、Prompt 写法决定 80% 效果1范围锁死最重要用 文件名 或直接写路径不要让它全仓库乱找。示例plaintext只看 src/pages/login.tsx 和 src/hooks/useAuth.ts修复登录态时序 bug不要改其他文件2状态说清只读 / 修改 / 先计划只读分析先不要改代码只输出问题分析和修复思路改前先计划可以修改但动手前先给我变更计划文件步骤直接动手小改动直接修改并解释变更点3验收标准明确必须包含改什么、涉及文件、如何验证完成。示例plaintext给 utils/date.ts 补全 ISO 日期格式化函数要求兼容 UTC、写 Jest 单测、注释英文、函数纯完成标准npm test 全部通过4结构像 GitHub Issue写清背景、当前行为、期望行为、相关文件、参考代码片段。三、必用的内置命令CLI/IDE/plan先生成执行计划确认后再执行大重构必备/init自动生成 AGENTS.md 模板OpenAI/fork分叉对话并行试不同方案保留上下文/model切换模型如 gpt-5.4、o3/clear清空本轮上下文不丢会话/resume恢复历史会话四、AGENTS.md把规则固化少写重复 Prompt放在仓库根目录Codex 会自动加载优先级高于临时 PromptOpenAI。核心内容控制在 100–300 行仓库结构、关键目录启动 / 构建 / 测试 / 格式化命令代码规范命名、注释、函数长度、类型禁止项如禁止 default 参数、禁止 any完成标准与验证方式OpenAI示例片段plaintext## 代码规范- 所有函数必须显式类型标注TS- 注释只用英文- 函数≤80行组件≤300行否则拆分- 禁止 any、禁止 default 参数## 工作流- 改后必须 npm run lint npm test- 禁止自动 commit/push嵌套目录可放子 AGENTS.md子目录优先级更高。五、IDE 高效用法VS Code安装扩展后登录底部选模型。选中代码 → 右键「Ask Codex」→ 直接重构 / 解释 / 转 TS / 加单测。用 在聊天框直接引用文件自动带上下文。开启「Auto-Apply」谨慎小改动自动写入大改动先看 Diff。六、CLI 常用命令脚本 / 自动化bash运行codex # 启动交互 TUIcodex 任务描述 # 直接执行任务codex exec 写文档 # 非交互适合 CIcodex -m o3 重构 # 指定模型codex --sandbox read-only # 只读模式安全codex resume --last # 恢复上次会话七、高级技巧Skills MCP1Skills可复用工作流把高频任务如安全审查、性能优化封装成 Skill一键调用。plaintextUse $security-review to check current diff for XSS/SQLi/权限漏洞2MCP连接外部工具通过 Model Context Protocol 接入实时文档避免过时训练数据Jira/GitHub Issues设计稿、API 文档、内部系统八、避坑指南新手最常踩不要一次丢太大任务控制在几百行 / 1 小时工作量否则容易乱改。必看 Diff 再确认Codex 可能幻觉、漏依赖、改错逻辑。环境要对确保依赖安装、环境变量正确、可联网影响成功率。不要全自动化--full-auto 风险高仅用于信任的小仓库。规则别写太泛AGENTS.md 要可验证别写 “写高质量代码” 这种空话。九、最佳实践总结小步快跑拆分任务、先计划、再执行、每步验证。规则固化用 AGENTS.md 沉淀规范减少重复 Prompt。范围精准用 文件 锁定上下文避免全仓库搜索。人机协作Codex 写代码、你审逻辑、共同调试。