https://codexer.com/categories/%E6%95%99%E7%A8%8B/Recent content in 教程 on CodexerHugozh-cnTue, 12 May 2026 10:00:00 +0800https://codexer.com/posts/2026-05-12-codex-cli-workflow-mastery/Tue, 12 May 2026 10:00:00 +0800https://codexer.com/posts/2026-05-12-codex-cli-workflow-mastery/<h2 id="两个开发者同一把刀">两个开发者，同一把刀</h2> <p>想象两个场景。</p> <p><strong>场景 A</strong>：小王装了 Codex CLI，兴奋地敲下第一个命令。他花了半小时调试 Prompt，终于让它改了一个文件。第二天又花了二十分钟重新描述项目背景，因为上次的会话上下文丢了。一周下来，他觉得&quot;AI 编程好像也就那样&quot;。</p> <p><strong>场景 B</strong>：老张也装了 Codex CLI。他先用十五分钟写了一个 30 行的 AGENTS.md，然后开了三个 worktree，让 Codex 同时跑着三个任务。任务间隙他去喝了杯咖啡，回来后发现 Codex 已经把单元测试修好了。下午他 <code>/goal</code> 存了一个探索性任务，第二天早上 <code>codex resume --last</code> 接着干，连背景都不用重讲。</p> <p>同样的工具，天壤之别的体验。</p> <p>这，就是 Codex CLI 的真相：<strong>你花在配置上的前两个小时，决定了你后面两百个小时的效率。</strong></p> <hr> <h2 id="一个改变一切的文件agentsmd">一个改变一切的文件：AGENTS.md</h2> <p>如果你只从本文带走一件事，那就是这个：<strong>在项目根目录写一个 AGENTS.md</strong>。</p> <p>Codex CLI 在每次会话启动时都会读这个文件。Claude Code 也会读（它读的是 CLAUDE.md——你可以把其中一个软链接到另一个）。把 AGENTS.md 当成<strong>活文档</strong>来维护：每一次你纠正了 Codex 两次以上的行为，就应该变成一条规则写进去。</p> <p>一个能打的 AGENTS.md 长这样：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-markdown" data-lang="markdown"><span style="display:flex;"><span># AGENTS.md </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e">## 技术栈 </span></span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> Python 3.12, FastAPI, SQLAlchemy 2.x async </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> pytest + anyio，不用 unittest </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> Ruff 做 lint，Black 格式化，mypy --strict </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e">## 不要做 </span></span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 不要写&#34;复述代码&#34;的注释 </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 不要 import unittest.mock — 用 pytest fixtures </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 不要在 src/legacy/ 下创建新文件 </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 运行 alembic upgrade 之前必须先跟我确认 </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e">## 要做 </span></span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 每个新文件顶部加 <span style="color:#e6db74">`from __future__ import annotations`</span> </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 改完代码后跑 <span style="color:#e6db74">`make test path=&lt;文件&gt;`</span> 而不是全量测试 </span></span><span style="display:flex;"><span><span style="color:#66d9ef">-</span> 新 API 端点统一放在 src/api/v2/ </span></span></code></pre></div><p>三条黄金法则：</p>https://codexer.com/posts/codex-cli-guide/Tue, 12 May 2026 01:00:00 +0800https://codexer.com/posts/codex-cli-guide/<h2 id="一扇新的大门">一扇新的大门</h2> <p>想象这样一个场景：你盯着终端，脑子里有个功能想要实现，但还没想好怎么动手。你敲下一句话描述需求，然后——一个 AI 在你的电脑上开始工作。它翻看项目文件，理解代码结构，写出实现，甚至帮你跑测试。</p> <p>这不是科幻。<strong>Codex CLI</strong> 把这个场景变成了日常。</p> <p>今年早些时候，OpenAI 悄无声息地开源了一个重磅项目：一个能在你本地终端里运行的 AI 编程助手。它不是云端服务，不是浏览器插件，而是一个实实在在的命令行工具——安装后，它就能直接读你的代码、写你的文件、执行你的命令。</p> <hr> <h2 id="它到底是什么">它到底是什么？</h2> <p>简单说，Codex CLI 是一个<strong>本地运行的编码智能体（Coding Agent）</strong>。和你在网页上跟 ChatGPT 聊天不同，它直接住在你的电脑里。</p> <p>它能做什么？</p> <ul> <li>📖 <strong>读懂你的项目</strong>：自动扫描目录结构，理解代码之间的关系</li> <li>✍️ <strong>帮你写代码</strong>：根据自然语言描述生成、修改、重构代码</li> <li>🔧 <strong>操作文件系统</strong>：创建文件、移动目录、改配置</li> <li>🧪 <strong>跑命令和测试</strong>：在终端里执行命令，看结果，根据结果调整</li> <li>🔒 <strong>沙箱模式</strong>：危险操作先在隔离环境里试，确认没问题再放行</li> </ul> <p>用一句话概括：<strong>它是一个能动手的 AI，不只是动嘴。</strong></p> <hr> <h2 id="三步开箱">三步开箱</h2> <p>安装过程出乎意料地简单。不管你用哪个系统，基本就是一行命令的事：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#75715e"># 如果你用 npm（跨平台）</span> </span></span><span style="display:flex;"><span>npm install -g @openai/codex </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#75715e"># 或者 macOS 用户用 Homebrew</span> </span></span><span style="display:flex;"><span>brew install --cask codex </span></span></code></pre></div><p>装完后敲 <code>codex</code>，选择登录方式就行。最方便的是直接用 ChatGPT 账号——Plus、Pro 甚至免费额度都能用。如果你有 API Key，也支持。</p> <p>启动后会进入一个交互界面，你可以直接打字告诉它你要做什么，它会一步步执行，每一步都让你确认。</p> <hr> <h2 id="不只是终端">不只是终端</h2> <p>Codex 的野心显然不止于命令行。同一个工具，有四张面孔：</p> <table> <thead> <tr> <th>形态</th> <th>怎么用</th> <th>适合谁</th> </tr> </thead> <tbody> <tr> <td><strong>CLI</strong></td> <td>终端里敲 <code>codex</code></td> <td>后端开发、DevOps、脚本小子</td> </tr> <tr> <td><strong>IDE 插件</strong></td> <td>VS Code / Cursor / Windsurf</td> <td>日常写代码的开发者</td> </tr> <tr> <td><strong>桌面应用</strong></td> <td>终端里敲 <code>codex app</code></td> <td>喜欢 GUI 的用户</td> </tr> <tr> <td><strong>Web 版</strong></td> <td>chatgpt.com/codex</td> <td>不想装任何东西，直接用</td> </tr> </tbody> </table> <p>同一个账号、同一套能力，随便切。这种&quot;一次登录，处处可用&quot;的设计，是它和市面上其他 AI 编程工具拉开差距的地方。</p>