https://haokw.github.io/tags/codex/Recent content in Codex on Hao · AI Agent 学习记录Hugozh-CNMon, 03 Aug 2026 00:00:00 +0800https://haokw.github.io/posts/2026-08-03-codex-notes/Mon, 03 Aug 2026 00:00:00 +0800https://haokw.github.io/posts/2026-08-03-codex-notes/<blockquote> <p>一句话：Codex 是终端里的编码 Agent——读得懂整个仓库，跑得了命令，改完自己验证。 脉络：为什么学 → 怎么装 → 怎么读项目 → 怎么跑闭环 → 怎么管上下文 → 怎么搭积木 → 怎么做团队复用 官方手册：<a href="https://learn.chatgpt.com/docs/codex/cli" class="link--external" target="_blank" rel="noreferrer" >https://learn.chatgpt.com/docs/codex/cli</a></p> </blockquote> <h2 id="1-为什么学先建心智模型">1. 为什么学：先建心智模型<a href="#1-%e4%b8%ba%e4%bb%80%e4%b9%88%e5%ad%a6%e5%85%88%e5%bb%ba%e5%bf%83%e6%99%ba%e6%a8%a1%e5%9e%8b" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <p><strong>核心思想</strong></p> <p>Codex 不是聊天窗口，而是&quot;能看懂你仓库的结对工程师&quot;。后端日常高频场景全覆盖：理解老代码、写单测、重构接口、排障、code review。它看得见 git 状态和报错，改完能自己跑测试确认。</p> <p>Agent 由四部分构成，也是后面所有小节的线索：</p> <table> <thead> <tr> <th>部件</th> <th>对应能力</th> <th>后文位置</th> </tr> </thead> <tbody> <tr> <td>大脑</td> <td>推理与规划（模型）</td> <td>全程</td> </tr> <tr> <td>手脚</td> <td>连接与执行（Tools / MCP）</td> <td>§3、§6</td> </tr> <tr> <td>记忆</td> <td>上下文与规范（Context / AGENTS.md / Skills）</td> <td>§5、§6</td> </tr> <tr> <td>流程</td> <td>验证与汇报（Skills / Hooks）</td> <td>§4、§6</td> </tr> </tbody> </table> <h2 id="2-怎么装">2. 怎么装<a href="#2-%e6%80%8e%e4%b9%88%e8%a3%85" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <p><strong>核心思想</strong>：装一个 CLI，登录后即可在项目根目录使用。</p> <p><strong>执行命令</strong></p> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <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><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">4 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <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>npm install --global @openai/codex <span style="color:#75715e"># 安装 Codex CLI</span> </span></span><span style="display:flex;"><span>codex login <span style="color:#75715e"># ChatGPT 账号或 API key 登录</span> </span></span><span style="display:flex;"><span>codex --version <span style="color:#75715e"># 验证安装</span> </span></span><span style="display:flex;"><span>codex doctor <span style="color:#75715e"># 环境出问题时的诊断命令</span> </span></span></code></pre></td></tr></table> </div> </div><p>安装后在项目根目录运行 <code>codex</code> 进入交互界面。</p>https://haokw.github.io/posts/2026-08-02-codex-deepseek-setup/Sun, 02 Aug 2026 00:00:00 +0800https://haokw.github.io/posts/2026-08-02-codex-deepseek-setup/<h2 id="1-codex-cli-安装">1. Codex CLI 安装<a href="#1-codex-cli-%e5%ae%89%e8%a3%85" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <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><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <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>npm install -g @openai/codex </span></span><span style="display:flex;"><span>codex --version </span></span><span style="display:flex;"><span>codex login <span style="color:#75715e"># 登录 OpenAI 账号</span> </span></span></code></pre></td></tr></table> </div> </div><h2 id="2-deepseek-api-配置">2. DeepSeek API 配置<a href="#2-deepseek-api-%e9%85%8d%e7%bd%ae" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <p>在 <a href="https://platform.deepseek.com" class="link--external" target="_blank" rel="noreferrer" >platform.deepseek.com</a> 创建 API Key，然后设置环境变量：</p> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <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><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <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>export DEEPSEEK_API_KEY<span style="color:#f92672">=</span><span style="color:#e6db74">&#34;sk-...&#34;</span> </span></span></code></pre></td></tr></table> </div> </div><p>DeepSeek 提供 OpenAI 兼容接口，base URL 为 <code>https://api.deepseek.com</code>， 可用 curl 快速验证：</p> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <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><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">4 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <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>curl https://api.deepseek.com/chat/completions <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span> -H <span style="color:#e6db74">&#34;Content-Type: application/json&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span> -H <span style="color:#e6db74">&#34;Authorization: Bearer </span>$DEEPSEEK_API_KEY<span style="color:#e6db74">&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span> -d <span style="color:#e6db74">&#39;{&#34;model&#34;:&#34;deepseek-chat&#34;,&#34;messages&#34;:[{&#34;role&#34;:&#34;user&#34;,&#34;content&#34;:&#34;hello&#34;}]}&#39;</span> </span></span></code></pre></td></tr></table> </div> </div><h2 id="3-codex-接入-deepseek官方一键脚本">3. Codex 接入 DeepSeek（官方一键脚本）<a href="#3-codex-%e6%8e%a5%e5%85%a5-deepseek%e5%ae%98%e6%96%b9%e4%b8%80%e9%94%ae%e8%84%9a%e6%9c%ac" class="post-heading__anchor" aria-hidden="true">#</a> </h2> <p>DeepSeek-V4-Flash 原生支持 Responses API 格式，官方针对 Codex 做了适配，并提供一键配置脚本（推荐方式）。</p>