Skip to content

About

codex-study

Resources

Readme
Apache-2.0 license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

Codex 中文教程

面向零编程基础读者的中文教程网站,现在分成两条路线:

  1. ChatGPT 桌面端里的 Codex 教程:偏图文、偏口语化,适合完全没有编程基础的人先上手。覆盖 Chat / Work / Codex、项目/任务、Local/Worktree/Cloud、Review、浏览器标注、多浏览器扩展、WebMCP、Computer Use、定时与事件触发任务、技能、插件、GPT-6 Astra、GPT-5.6、多智能体、Voice、Codex Remote、Computer History、Agent 导入、线程分享、设置和安全边界。
  2. Codex CLI 教程:保留原来的终端路线,教读者用 OpenAI Codex CLI 做出可上线的产品官网。

本地预览

进入你本机克隆的项目目录,起一个本地服务器（文件夹名称以实际为准）:

cd codex-study
python3 -m http.server 8000

浏览器访问 http://localhost:8000。

必须用 HTTP server 打开,不要双击 index.html。共用 header/sidebar/footer 通过 fetch() 注入,在 file:// 协议下会被浏览器拦截。

项目结构

.
├── index.html                       双教程首页
├── 404.html
├── _headers                         Cloudflare Pages 响应头配置
├── wrangler.toml                    Cloudflare Pages / Wrangler 配置
├── app/                             桌面端 App 教程 13 章(A0-A12)
├── chapters/                        Codex CLI 教程 12 章(00-11)
├── appendix/                        附录 4 篇(A-D)
├── partials/                        全站共用 sidebar / header / footer
├── assets/
│   ├── css/                         base / layout / components / prose
│   ├── js/                          nav / progress / toc / code
│   └── img/                         章节示意图与截图素材
└── README.md

编辑约定

  • 零构建:纯 HTML/CSS/JS,无依赖,无打包器。
  • 统一布局:正文页都有 <header id="site-header">、<aside id="sidebar">、<aside class="toc"><ul id="toc-list"></ul></aside>、<footer id="site-footer"> 四个空槽,由 nav.js 在客户端用 fetch 注入。
  • 页面 body 建议保留两个 data 属性:data-title="..." 用于页面语义标识;data-chapter="..." 用于左侧栏当前节高亮 + 完读 localStorage。首页和 404 可不设 data-chapter。
  • App 教程章节 ID:使用 app-00-overview、app-01-start 这类值,并同步到 partials/sidebar.html。
  • 代码块:.code > .code__bar (lang+copy) > pre。
  • 提示词卡片:.prompt-card > .prompt-card__head (label+copy) > .prompt-card__body > .prompt-card__note。
  • 图文说明:App 教程优先使用 assets/img/app/ 下的示意图。真实产品截图可能随版本变化,没有确定截图时用“示意图”并在图注里说明。

当前交付状态

完整 App 教程:

  • App A0 · 先看懂 Codex 桌面端
  • App A1 · 安装、登录和第一句话
  • App A2 · 项目、线程和三种模式
  • App A3 · 看改动、跑命令和保存
  • App A4 · 浏览器、标注和电脑操作
  • App A5 · 自动化、技能和外部工具
  • App A6 · 设置、快捷键和安全边界
  • App A7 · 插件功能全指南
  • App A8 · Chat、Work、Codex、模型与多智能体
  • App A9 · 语音协作、多文件夹项目与移动端
  • App A10 · 2026 年 8 月功能更新
  • App A11 · 2026 年 9 月功能更新
  • App A12 · 2026 年 10 月功能更新

完整 CLI 正文章节:

  • 第 00 章 · 写在前面
  • 第 01 章 · 心态准备
  • 第 02 章 · 把工具装到电脑里
  • 第 03 章 · Codex 用法手册
  • 第 04 章 · 口语化编程内功
  • 第 05 章 · 搭出产品官网骨架
  • 第 06 章 · 让它好看
  • 第 07 章 · 当事情出错时
  • 第 08 章 · 上线:让世界看到你
  • 第 09 章 · 域名:给页面一个家
  • 第 10 章 · 上线之后
  • 第 11 章 · 进阶方向
  • 附录 A · 口语化提示词模板库
  • 附录 B · 术语小词典
  • 附录 C · 命令速查表
  • 附录 D · 常见踩坑全集

当前状态:App 教程、CLI 教程和附录都已扩写为完整正文版本。

本次 App 教程已做二次扩写:

  • A0 增加界面四区读法、新手第一周范围和练习。
  • A1 增加登录后检查、审批弹窗判断和第一次卡住时的提问方式。
  • A2 增加线程生命周期、模式示例、Handoff、本地环境动作说明。
  • A3 增加 Review 范围、行内评论流程、Staged/Unstaged、PR 评论、保存前检查。
  • A4 增加内置浏览器入口、标注流程、Developer mode、Chrome 权限、Computer Use 设置、Appshots 步骤。
  • A5 增加 Triage、耐用自动化提示词、技能/插件/MCP 选择表、AGENTS.md 示例。
  • A6 增加推荐初始设置、命令菜单、权限范围、故障入口、Deep links 和设置体检。
  • A7 新增插件专章,说明插件是什么、怎么安装、已知插件能做什么、怎样控制授权和写入风险。
  • A8 新增模型与多智能体专章,说明 Chat / Work / Codex、GPT-6 Astra、GPT-5.6、Sol / Terra / Luna、Max / Ultra、多智能体、Goal、文件标注和 Visualize。
  • A9 新增 ChatGPT Voice、Screen context、多文件夹本地项目、桌面与手机接力、Codex Micro 和 Amazon Bedrock 的通俗说明。
  • A10 新增 2026 年 8 月更新专章,说明多浏览器扩展、WebMCP、事件触发任务、Apple Messages、线程分享、Computer History、Agent 导入、Codex Remote、CLI 0.149 和 GPT-5.4 迁移。
  • A11 的 2026 年 9 月更新专章已补充到 9 月 30 日核对结果,保留月初功能,增加 6.1 Sol、跨设备 Work、dots、云端环境、插件扩展、Security Cloud 与 CLI 0.159.2。

本次最新功能补充:

  • A0 增加 Codex 桌面端最新功能总览:Worktree、线程自动化、内置浏览器、Computer Use、Appshots、Skills、Memories。
  • A2 补充 Worktree 隔离、后台任务、旧 Worktree 清理和 .worktreeinclude 的新手解释。
  • A4 补充内置浏览器适用范围、Developer mode 调试边界、Computer Use 权限边界和 $imagegen 图片生成示例。
  • A5 补充“自动化 + 技能”组合用法、MCP 共用配置提醒和网页搜索的官方资料核对提示词。
  • A6 补充 Profile、Appearance、Pets、Personalization、Context-aware suggestions、Memories、Web search、Appshots hotkey 和更多快捷键。
  • A7 补充 Codex Security、Sites、Gmail、Google Drive、Slack、Record & Replay、Computer History、Codex Remote 和常见连接能力。
  • A0/A1/A2/A6/A7 更新为 ChatGPT desktop app 最新名称与入口,并修正最新快捷键、任务术语和模型说明。
  • A8 补充 ChatGPT Work、GPT-6 Astra、GPT-5.6 模型家族、子智能体、长任务、通知、Pets、文件交付和 Visualizations。
  • A2/A4/A6/A7/A9 补充 2026 年 7 月最新能力:Voice、Screen context、多文件夹本地项目、移动端任务可视化和 Amazon Bedrock。
  • A7 补充 Codex Security 0.1.14 的扫描历史对比、安全策略、批量跟踪和标准扫描更新。
  • CLI 第 03 章与附录同步补充 GPT-5.6、/fast、/agent 和多智能体使用边界。
  • A1/A3/A4/A6/A7/A9 与 CLI 第 03 章同步补充 2026 年 8 月功能,并把已被替代的 Chronicle 说明更新为 Computer History。
  • A2/A4/A5/A7/A10 与 CLI 第 03 章、附录 C 同步补充 2026 年 8 月 24-25 日更新:线程只读快照、五种浏览器扩展、Site tools（WebMCP）、Gmail/Slack/GitHub 事件触发任务、Apple Messages、CLI Agent dashboard、消息队列、工作目录命令和增强版 codex doctor。
  • A0/A7/A8/A11 与 CLI 第 03 章、附录 C-D 同步补充 2026 年 9 月更新:GPT-6 Astra、CLI 0.154.0、实验性 Worktree、运行中提问、插件即时刷新、OAuth 登录挑战、安全修复和移动端 Remote 改进;同时把 codex mcp-server 从“已弃用”更新为“已移除”。

继续维护内容

2026-10-08 本轮补充

  • 新增 A12 十月更新专章,连接首页、侧边栏、A0 和 A11 前后章导航。保留九月历史,不把 CLI / iOS 更新写成桌面 App 同日发布。
  • A7 / CLI 第 03 章 / 附录 C:补充 /mcp login <name>、语音输入输出设备与通道,安装示例更新到 CLI 0.161.0。
  • A9:加入 iOS 任务与额度小组件、任务链接和统一 Plugins 入口,说明手机重连、队列恢复的检查顺序;修正 Bedrock 的旧模型清单。
  • A8 / A12:补充 Responses 网关兼容边界,复核 GPT-5.5 仍将于 10 月 14 日退役;Daybreak 按主动开启和账号资格解释,不建议普通用户盲目启用。
  • 附录 D 新增 7 条可搜索排错:MCP 登录、音频设备、Daybreak、网关协议、断线重复提交、手机小组件、钥匙串凭据存储。
  • 本次查到最新带日期产品日志为 10 月 7 日;Security 插件独立日志仍为 9 月 24 日的 0.1.30。功能可见性仍受账号、客户端、模型与管理策略限制。
  • 导航脚本与共享片段同步更新缓存版本,避免老访客看不到新增章节。

2026-09-30 历史补充

  • A11:增加月底功能导读、跨设备 Work 与 dots 的执行边界、Cloud 环境准备与发布步骤、Space / Team Tasks 入门。逐步开放和团队功能不写成全账号默认可用。
  • A8/A11:更新 GPT-6.1 Sol、GPT-6 Luna 与模型迁移建议,区分 Ultra 与 Ultrafast,纠正速度和额度倍率混用。
  • A8:官方当前将实验性上下文管理标为不可用,撤下旧开启示例并保留更正锚点。
  • A7:区分本地 Codex Security 与 Security Cloud,增加 Plugin Extensions、MCP Events、Bits & Bolts 和 Annotations Extensibility。Security 0.1.30 与 0.1.25 行为相同,不虚构版本新能力。
  • A4/A9/A10:补充标注扩展、更新 WebMCP 的模型与 Enterprise 范围,区分 Remote、同步 Work 和纯云端任务。
  • CLI 第 03 章/附录 C:升级示例到 0.159.2,补充复制、主动启用的 instant_interrupt、Windows 闪窗修复及已移除入口;同步 0.156 起语音和 Worktree 默认支持、F8、声音设置与用量查看。
  • 附录 D:新增 7 条可搜索排错,覆盖 6.1 Sol 不可见、Ultrafast、离线同步、插件界面与事件、上下文实验、Windows 闪窗和旧技能移除。
  • 核对日期是 9 月 30 日;带日期的产品更新日志到 9 月 29 日,Security 插件日志到 9 月 24 日。另参考官方本周功能页及专项文档,不把周标题中的未来日期当作已发生的发布。

2026-09-22 历史补充

  • A4/A6/A11:悬浮 Quick Chat、Mini、Mac/Windows 快捷键、Appshots 接收位置与项目上下文边界。
  • A8/A11:Spark 9 月 14 日停用,GPT-5.5 将于 10 月 14 日退役的范围与迁移清单;当时的上下文管理试用说明已在 9 月 30 日按新状态更正。
  • A7:Codex Security 0.1.24、修复验证、补丁风险评估、失败扫描结果恢复、访问资格提示;纠正 Spark 可用的旧说明。
  • CLI 第 03 章/附录 C:示例更新到 0.155.1,补充实验性 /voice、任务整理、MCP Touch ID 和摘要兼容性修复。
  • A9/附录 D:手机队列与 Worktree 改进;增加可搜索的 CLI 语音、推理摘要、Quick Chat 项目上下文排错,修正 Windows Appshots 说明。
  • 日期分开记录:本轮核对日期是 9 月 22 日,查到的产品更新记录截至 9 月 18 日,Security 插件记录截至 9 月 9 日。实验功能和未来退役不写成全量已生效。

打开对应的 app/*.html、chapters/XX-name.html 或 appendix/*.html,按下面的口径继续补案例、截图、提示词或官方功能更新。可以参考第 02/04/05/08/09 章、附录 A-D 和 App A0-A12 的写法:

  • 每章 5-8 个 H2 小节
  • 每章至少一个 .exercise 或 .prompt-card
  • 每章末尾至少一个总结或下一步提示
  • 口吻保持口语化:先讲“这东西干嘛用”,再讲“点哪里 / 怎么说”
  • 涉及 Codex 功能、命令或入口变化时,优先核对 OpenAI Codex 官方手册

官方资料维护

App 教程内容参考 OpenAI 官方文档,本次整理日期为 2026-10-08,查到的最新带日期产品更新记录到 2026-10-07,并核对模型、手机、网关、配置和 Security 专项说明。核对日期不等于功能发布日期,不同端与插件版本分开记录。维护时优先核对:

部署上线:Cloudflare Pages 免费方案

这个项目已经按 Cloudflare Pages 做了项目级配置:

  • wrangler.toml:项目名是 codex-study,输出目录是仓库根目录 .。
  • _headers:给静态资源加长期缓存,给全站加基础安全响应头。
  • 无 package.json,无构建步骤,是纯 HTML/CSS/JS 静态站。

方式一:GitHub 连接 Cloudflare Pages(推荐)

适合长期维护。以后只要 push 到 GitHub,Cloudflare Pages 就会自动重新部署。

  1. 先把代码推到 GitHub 仓库,例如:
git remote -v
git push origin main
  1. 打开 Cloudflare Dashboard。
  2. 进入 Workers & Pages。
  3. 选择 Pages。
  4. 点击 Create application / Create project。
  5. 选择 Connect to Git。
  6. 选择 GitHub,授权 Cloudflare 访问仓库。
  7. 选择仓库: xiaodong-wu/codex-study。
  8. 构建设置按下面填写:
字段 填法
Project name codex-study
Production branch main
Framework preset None / Other
Build command 留空
Build output directory /
Root directory 留空
  1. 点击 Save and Deploy。
  2. 部署成功后,Cloudflare 会给一个类似 https://codex-study.pages.dev 的公开链接。

Cloudflare 官方说明里提到:没有框架也可以部署 Pages;没有构建步骤时,Build command 可以留空。构建输出目录就是要上传为网站内容的目录。

方式二:Wrangler 直接上传(可选)

适合临时部署或测试。长期维护仍然推荐 GitHub 连接方式。

第一次先登录:

npx wrangler login

然后在项目根目录执行:

npx wrangler pages deploy . --project-name=codex-study --branch=main

如果项目还没创建,Wrangler 会提示你创建 Pages 项目。部署成功后也会得到一个 pages.dev 链接。

以后怎么更新

平时改完内容后:

git status
git add .
git commit -m "Update tutorial content"
git push origin main

Cloudflare Pages 会自动检测 GitHub 的新提交并重新部署。

常见问题

  • Cloudflare 看不到仓库:回到 GitHub 授权页面,确认 Cloudflare Pages 有权限访问 xiaodong-wu/codex-study。
  • 部署失败,提示找不到输出目录:确认 Build output directory 是 /,不是 dist 或 public。
  • 页面样式没更新:先强制刷新浏览器。项目里 CSS/JS 已带版本号,通常不会长时间吃旧缓存。
  • 左侧目录加载不出来:线上一般不会有这个问题。本地预览时必须用 python3 -m http.server 8000,不要直接双击 HTML。

官方文档

About

codex-study

Resources

Readme
Apache-2.0 license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages