codex-usage-guide/codex.html at master · WhoJay0609/codex-usage-guide · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Codex 是什么</title><!-- guide:theme-bootstrap:start -->
<script src="assets/theme.js"></script>
<!-- guide:theme-bootstrap:end -->
  <link rel="stylesheet" href="assets/site.css">  <!-- guide:metadata:start -->
<meta name="description" content="理解 ChatGPT desktop app 中 Codex 工作面的能力与适用边界。">
<meta name="guide-build" content="ee947e14a0a9">
<link rel="icon" href="favicon.svg" type="image/svg+xml">
<link rel="canonical" href="https://whojay0609.github.io/codex-usage-guide/codex.html">
<meta property="og:type" content="website">
<meta property="og:locale" content="zh_CN">
<meta property="og:site_name" content="Codex 使用指南">
<meta property="og:title" content="Codex 是什么">
<meta property="og:description" content="理解 ChatGPT desktop app 中 Codex 工作面的能力与适用边界。">
<meta property="og:url" content="https://whojay0609.github.io/codex-usage-guide/codex.html">
<meta property="og:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="Codex 使用指南">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Codex 是什么">
<meta name="twitter:description" content="理解 ChatGPT desktop app 中 Codex 工作面的能力与适用边界。">
<meta name="twitter:image" content="https://whojay0609.github.io/codex-usage-guide/figures/social-preview.png">
<meta name="twitter:image:alt" content="Codex 使用指南">
<!-- guide:metadata:end -->
</head>
<body>
  <!-- guide:header:start -->
<script src="assets/site-data.js"></script><a class="skip-link" href="#main-content">跳到正文</a><header class="topbar"><div class="topbar-inner"><a class="brand" href="index.html"><span class="brand-mark" aria-hidden="true"></span><span>Codex 使用指南</span></a><div class="topbar-actions"><label class="theme-control"><span class="sr-only">主题</span><select class="theme-select" id="theme-select" name="theme" aria-label="主题"><option value="light" selected>浅色</option><option value="dark">深色</option></select></label><span class="theme-status sr-only" aria-live="polite"></span><button class="search-trigger" type="button" aria-haspopup="dialog" aria-controls="site-search-dialog">搜索</button><button class="menu-toggle" type="button" aria-controls="global-nav" aria-expanded="false">目录</button></div></div></header><dialog class="search-dialog" id="site-search-dialog" role="dialog" aria-modal="true" aria-labelledby="site-search-title"><div class="search-dialog-panel"><div class="search-dialog-head"><p class="search-title" id="site-search-title">搜索全站</p><button class="search-close" type="button" aria-label="关闭搜索">关闭</button></div><label class="search-label" for="site-search-input">搜索标题、正文和可复用 prompt</label><input class="search-input" id="site-search-input" type="search" role="combobox" autocomplete="off" aria-autocomplete="list" aria-controls="site-search-results" aria-describedby="site-search-status" aria-expanded="false"><p class="search-message" id="site-search-status" aria-live="polite">输入关键词开始搜索。</p><ul class="search-results" id="site-search-results" role="listbox" aria-label="搜索结果"></ul></div></dialog>
<!-- guide:header:end -->
  <!-- guide:shell-open:start -->
<div class="toolbook-shell"><aside class="global-nav" id="global-nav" aria-label="全站导航"><section class="global-nav-group"><strong>开始</strong><a data-nav href="index.html">首页</a><a data-nav href="install-desktop.html">安装</a><a data-nav href="desktop-cli.html">Desktop</a></section><section class="global-nav-group"><strong>基础概念</strong><a data-nav href="codex.html" aria-current="page">Codex</a><a data-nav href="git.html">Git</a><a data-nav href="worktrees.html">Worktrees</a><a data-nav href="permissions.html">权限</a><a data-nav href="agents-md.html">AGENTS.md</a><a data-nav href="skills.html">Skills</a><a data-nav href="mcp.html">MCP</a><a data-nav href="subagents.html">Subagents</a><a data-nav href="goal.html">Goal</a></section><section class="global-nav-group"><strong>任务路径</strong><a data-nav href="workflows.html">任务</a><a data-nav href="daily-workflow.html">日常</a><a data-nav href="engineering.html">工程</a><a data-nav href="research.html">学术</a><a data-nav href="automation.html">定时任务</a></section><section class="global-nav-group"><strong>扩展与资料</strong><a data-nav href="compound-engineering.html">Compound</a><details class="global-nav-disclosure"><summary>Skills 仓库</summary><a data-nav href="skills-repositories.html">全部仓库</a><a href="skills-repositories.html#compound-engineering">Compound Engineering</a><a href="skills-repositories.html#mattpocock-skills">Matt Pocock skills</a><a href="skills-repositories.html#academic-research-skills-codex">ARS</a><a href="skills-repositories.html#aris-auto-claude-code-research-in-sleep">ARIS</a><a href="skills-repositories.html#refine-user-prompt">refine-user-prompt</a></details><a data-nav href="prompt-guidance.html">提示词</a><a data-nav href="resources.html">资料</a></section></aside><div class="toolbook-main"><nav class="breadcrumbs" aria-label="面包屑"><a href="index.html">首页</a><span aria-hidden="true">/</span><span>基础概念</span><span aria-hidden="true">/</span><span aria-current="page">Codex</span></nav><div class="page-freshness"><span>页面更新：<time datetime="2026-07-16">2026-07-16</time></span><span>事实核验：<time datetime="2026-07-16">2026-07-16</time></span></div><aside class="page-sources" aria-label="本页资料依据"><strong>本页依据</strong><a class="page-source-link external-link" href="https://learn.chatgpt.com/docs/app" target="_blank" rel="noopener noreferrer" referrerpolicy="no-referrer"><span class="external-link-indicator" data-search-exclude aria-hidden="true">↗</span><span class="sr-only" data-search-exclude>（外部链接）</span><span class="source-kind">OpenAI 官方</span>ChatGPT desktop app</a></aside><aside class="page-toc" aria-label="本页目录"><details><summary>本页目录</summary><nav><a class="toc-h2" href="#它是什么">它是什么</a><a class="toc-h2" href="#什么时候用-不用">什么时候用 / 不用</a><a class="toc-h2" href="#可复制示例">可复制示例</a><a class="toc-h2" href="#真实实例-扩充这份网页手册">真实实例：扩充这份网页手册</a></nav></details></aside>
<!-- guide:shell-open:end -->
<main id="main-content">
    <section class="hero compact"><div class="hero-copy"><p class="hero-kicker">概念</p><h1>Codex 是什么</h1><p class="lead">Codex 是面向软件工程任务的编码代理体系。官方产品名是 <strong>ChatGPT desktop app</strong>；本指南把其中的 Codex 工作面简称为“Codex Desktop”，并以 <strong>Desktop 为主</strong>，因为它适合把对话、仓库、Browser、权限审批和验证证据放在同一个任务线程里。</p></div></section>
    <div class="doc-layout">

      <article class="doc-content">
        <section class="content-block" id="what"><p class="section-kicker">是什么</p><span class="fragment-alias" id="heading-codex-1" data-canonical-fragment="它是什么" aria-hidden="true"></span><h2 id="它是什么">它是什么<a class="heading-permalink" data-heading-permalink data-search-exclude href="#它是什么" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2><p>你可以在桌面应用里选择项目、开启线程、让 Codex 读仓库上下文、在同一个任务里查看 diff、审批操作，并打开官方称为 <strong>Integrated terminal</strong> 的终端运行命令。内置 <strong>Browser</strong> 是用户与 ChatGPT 的共享视图：你可以预览页面、留下视觉反馈或评论，也可以让 ChatGPT 与页面交互；它不是单纯的日志面板。</p><div class="route-strip"><div class="route-pill"><strong>线程</strong><span>一个目标一个线程，保留上下文、审批、终端输出和最终证据。</span></div><div class="route-pill"><strong>Local / Worktree</strong><span>Local 直接改当前项目；<a href="worktrees.html">Worktree</a> 隔离试验和并行任务。</span></div><div class="route-pill"><strong>Browser + Git</strong><span>共享预览、视觉评论与页面交互，并审查 diff 和 Git 操作。</span></div><div class="route-pill"><strong>Scheduled tasks</strong><span>把稳定重复任务放到后台运行，并在 Scheduled 视图查看结果。</span></div></div></section>
        <section class="content-block" id="when"><p class="section-kicker">何时使用</p><span class="fragment-alias" id="heading-codex-2" data-canonical-fragment="什么时候用-不用" aria-hidden="true"></span><h2 id="什么时候用-不用">什么时候用 / 不用<a class="heading-permalink" data-heading-permalink data-search-exclude href="#什么时候用-不用" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2><ul class="mini-list"><li><strong>用 Desktop</strong><span>需要看 diff、页面、截图、浏览器、审批、终端验证和多线程进度。</span></li><li><strong>先用 Local</strong><span>小改动、文档、网页、测试修复和发布验证，优先在当前项目里完成。</span></li><li><strong>改用 Worktree</strong><span>试验性修改、并行任务、自动化后台任务，或不想碰当前工作区时使用。</span></li><li><strong>Plan 模式</strong><span>当任务需要先对齐方案再动手时，可在 Desktop 里让 Codex 先输出计划并逐步确认；具体 UI 入口与行为以当前客户端为准，本指南不承诺固定按钮名称。</span></li><li><strong>不用 Codex</strong><span>任务没有明确仓库、没有验收标准，或你不愿让代理读取相关上下文。</span></li></ul></section>
        <section class="content-block" id="examples"><p class="section-kicker">示例</p><span class="fragment-alias" id="heading-codex-3" data-canonical-fragment="可复制示例" aria-hidden="true"></span><h2 id="可复制示例">可复制示例<a class="heading-permalink" data-heading-permalink data-search-exclude href="#可复制示例" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2><pre><code>我正在 Codex Desktop 里处理这个仓库。
请先读取 AGENTS.md、README.md 和失败测试日志。
目标：解释这个错误，并提出最小修复方案。
约束：只读分析，不要改文件。</code></pre></section>
        <section class="content-block" id="real-example"><p class="section-kicker">真实实例</p><span class="fragment-alias" id="heading-codex-4" data-canonical-fragment="真实实例-扩充这份网页手册" aria-hidden="true"></span><h2 id="真实实例-扩充这份网页手册">真实实例：扩充这份网页手册<a class="heading-permalink" data-heading-permalink data-search-exclude href="#真实实例-扩充这份网页手册" aria-label="本节永久链接"><span aria-hidden="true">#</span></a></h2><p>维护 <code>codex-usage-guide</code> 时，Codex 的主工作面是 Desktop：用户给出页面反馈，Codex 读取 <code>AGENTS.md</code> 和 HTML 文件，在内置终端运行静态链接检查，最后用 Git diff 和验证结果收口。这个例子展示了 Desktop 如何把读取、修改、验证、审查和发布证据放进一个可追踪的线程。</p><pre><code>真实任务输入：
请把中文 Codex 指南扩成实战手册。
要求：
- 每个主要页面都有真实实例
- 保持 GitHub Pages 可访问
- 最终报告验证和 commit</code></pre></section>
      </article>
    </div>
  </main>
<!-- guide:shell-close:start -->
<nav class="page-sequence" aria-label="前后页"><a rel="prev" href="desktop-cli.html">← Desktop</a><a rel="next" href="git.html">Git →</a></nav></div></div>
<!-- guide:shell-close:end -->
  <footer class="footer"><p><strong>Codex 使用指南</strong></p><a class="button" href="git.html">下一页：Git</a></footer>
  <!-- guide:runtime:start -->
<script src="assets/site.js"></script>
<!-- guide:runtime:end -->
</body>
</html>