OpenAI Codex CLI 入门：从零配置到日常编码流
OpenAI Codex CLI 实战指南：从安装、认证到跑通第一个真实代码改动，再到沙箱模式与 git worktree 协作的最佳实践，把 Codex 融入你的日常编码流。
操作步骤
装 Codex CLI 并登录
npm i -g @openai/codex。codex 启动后用 /login 选择 OPENAI_API_KEY 或 ChatGPT 订阅登录——订阅对日常用量更划算。
起一个沙箱限制改动范围
Codex 跑在 OS 沙箱里。选个模式：--sandbox read-only（只读）、--sandbox workspace-write（可改当前目录）、--sandbox danger-full-access（无限制）。Approval 是独立的——传 --ask-for-approval never 跳过。（--full-auto 是 workspace-write + 永不问的简写，已弃用。）
把 Codex 放进独立 git worktree
git worktree add ../mycodex-feature-branch main。让 Codex 在独立分支上跑，方便你审 diff 再合并。
让 Codex 改一个真实 bug
在 Codex 里用自然语言描述问题，例如 "修一下 src/foo.ts 里的 NPE"，让它读取、修改、并自检；最后用 git diff 审阅。
合并前必看的安全项
确认 Codex 没有动 secrets / lockfiles / CI 配置；用 hook 阻止敏感路径写入；按团队的 CODEOWNERS 流程 review 后再合并。
OpenAI Codex CLI 是运行在本地终端的编码 Agent，基于云端 Codex 模型，可以读取仓库、修改文件、运行命令并自我修复。
1. 概述
Codex CLI 是 OpenAI 推出的本地编码 Agent，让你在终端里直接调用 GPT 模型来读、改、跑代码。本文从安装、认证开始，带你跑通第一个真实改动，并给出团队协作的最佳实践。
2. 核心要点
- Codex CLI 在 macOS、Linux、Windows(WSL) 上一条 npm 命令就能装好
- 通过 OPENAI_API_KEY 或 ChatGPT 订阅登录；ChatGPT 计划对日常用量更划算
- 支持 /codex 等子命令交互，也支持 -q 模式批量处理任务
- Codex 跑在 OS 级沙箱里；取值：--sandbox read-only / workspace-write / danger-full-access。Approval 是独立的轴，用 --ask-for-approval 控制。--full-auto 是 workspace-write + 永不问的简写（0.128.0 起弃用）
- 最佳实践是给 Codex 一个独立 git worktree，审阅 diff 后再合并
3. 工作机制
下面分节展开。建议阅读时配合 OpenAI 官方文档 一起看。
4. 实战步骤
- 明确目标：先定义完成的标准。
- 选型：参考核心要点里的模型对比。
- 验证：跑通最小示例，记录参数与版本号。
- 集成：把示例接到你现有代码里。
- 监控：记录调用日志与失败原因，定期回看。
5. 常见错误与排查
- 报错 401：API Key 无效或过期，重新生成。
- 报错 429：触发速率限制，启用指数退避重试。
- 报错 400：参数错误，仔细核对 model 名称与 messages 结构。
- 回答质量差：换模型、补充 few-shot 示例、检查 prompt 是否过长。
6. 下一步
掌握本文后，建议继续阅读：
- 《ChatGPT 完全指南（2026）：从入门到精通》
- 《Prompt Engineering 核心模式：8 个让 GPT 表现翻倍的模板》
- 《OpenAI API 入门：第一个 GPT-5.6 调用详解》
关键要点
- Codex CLI 在 macOS、Linux、Windows(WSL) 上一条 npm 命令就能装好
- 通过 OPENAI_API_KEY 或 ChatGPT 订阅登录；ChatGPT 计划对日常用量更划算
- 支持 /codex 等子命令交互，也支持 -q 模式批量处理任务
- Codex 跑在 OS 级沙箱里；取值：--sandbox read-only / workspace-write / danger-full-access。Approval 是独立的轴，用 --ask-for-approval 控制。--full-auto 是 workspace-write + 永不问的简写（0.128.0 起弃用）
- 最佳实践是给 Codex 一个独立 git worktree，审阅 diff 后再合并
常见问题
官方参考
相关文章
Codex 预览线从 0.167 直接跳到 0.168：四天四版、无稳定版收尾（2026）
Codex 的 0.167 预览线在 GitHub 上走到 alpha.5 后没有等来稳定版——npm 的 alpha dist-tag 已于 11 月 4 日指向 0.168.0-alpha.1，而 PyPI 的 openai-codex 仍停在 0.163.0，渠道差距进一步拉大。
阅读全文Codex CLI 0.166.0 稳定版发布：GPT-6.1 Terra 扩至 Vertex AI 与 Bedrock 目录、transcript 键盘选择与 doctor --network-only
0.166.0 于 2026-10-29T19:47 UTC 转stable：GPT-6.1 Terra 目录覆盖扩至 bundled、Vertex AI 与 Bedrock 三目录，新增 transcript 键盘选择与集成搜索、codex queue --resume、codex doctor --network-only。PyPI 缺口扩至三版。
阅读全文Codex CLI 0.164–0.165 发布线解读：GPT-6.1 Terra 进目录、Vertex AI provider、/presets 与 memory v2
0.163 之后的两个稳定版一起补齐：0.164.0（10-23）带来 /presets、内联 /model 与 /permissions；0.165.0（10-27）加入内置 Vertex AI provider，并把 GPT-6.1 Terra 写进模型目录。逐项对照官方 release notes。
阅读全文订阅 GPTMap Weekly
每周一封邮件，精选 OpenAI 重要更新、深度解读与最佳实践。无广告，可随时退订。
提交后将在新标签页打开 Buttondown 完成订阅确认。