Codex 原生能力
Goal、Subagent、Worktree、MCP、AGENTS.md、Skills、Scheduled tasks（定时任务）和 Browser 都有产品或官方文档入口；具体可用性以当前客户端、配置和账户为准。
中文 Codex 实战手册
从一个可验证的小任务开始使用 Codex
这不是官方文档镜像，而是一份中文 Codex Desktop 实战手册；“Codex Desktop”在本指南中指 ChatGPT desktop app 中的 Codex 工作面。先完成安装、打开仓库、跑通第一个只读任务，再进入日常协作、工程、学术、定时任务和 Goal。
- 第三轮读者与专家复核无新增阻塞问题完成首页、Git 概念、CLI Worktree 及 Desktop Worktree／Hand off／清理路径复核，未发现新问题，保留既有 CLI／Desktop 分工与回归门禁。
- 补齐 CLI Worktree 路径与 Local 术语解释 CLI 占位符与仓库根目录前置条件，增加创建后状态检查，并区分 Local environment 与 Local 主工作树。
- 补齐 Git 与 Worktree 概念入口首页新增 Git 与 Worktrees 卡片，并说明 Local 前台工作区、Hand off 操作和依赖／缓存边界。
查看完整更新记录（21）
- 第三轮读者与专家复核无新增阻塞问题完成首页、Git 概念、CLI Worktree 及 Desktop Worktree／Hand off／清理路径复核，未发现新问题，保留既有 CLI／Desktop 分工与回归门禁。
- 补齐 CLI Worktree 路径与 Local 术语解释 CLI 占位符与仓库根目录前置条件，增加创建后状态检查，并区分 Local environment 与 Local 主工作树。
- 补齐 Git 与 Worktree 概念入口首页新增 Git 与 Worktrees 卡片，并说明 Local 前台工作区、Hand off 操作和依赖／缓存边界。
- 把 Git 页重构为 Worktree 主线压缩分支与 PR 介绍，补充 Worktree 的共享／独立边界、保护 Local 的高频闭环、安全清理规则和两张生成式辅助插图。
- 新增 Git 基础与项目高频操作用中文解释 repository、working tree、暂存区、commit、分支、HEAD、remote、merge 和 PR，并以匿名只读历史会话整理 dev 集成、短分支、显式 staging、验证和 PR 的项目模式。
- 根据读者与专家反馈整理首轮指南把新手首条路径、$skill-name 与插件 slash 命令、项目验证命令和 Desktop 页面边界说清，并加入公开发布路径与搜索索引覆盖门禁。
- 同步 Matt Pocock skills v1.2.2 说明更新 user-invoked / model-invoked 分层、ask-matt 到 implement 的工程主线、skills.sh 的 Codex 安装边界，以及原生 Codex plugin 暂缓和近期技能改名。
- 补齐 Desktop 界面证据与可迁移案例新增五张 Desktop 操作示意截图、screenshot registry、日常/工程/学术/权限/MCP 演示案例，以及 CLI 附录、404、robots 与 sitemap。
- 新增 whojay-skill 证据工作流说明补充 WhoJay0609/whojay-skill 的工程与学术双工作流、证据状态、授权边界与隐私去标识说明。
- 新增 dot-skills 开放格式目录说明补充 pproenca/dot-skills 的 curated/experimental 分层、Codex 安装目录、按项审查与第三方权限边界。
- 新增 OpenCodex 第三方代理说明补充 lidge-jun/opencodex 的本地 provider proxy 定位、原生 Codex 恢复路径及网络、凭据、账户和服务条款边界。
- 统一 Apple 风格界面体验系统化调整排版、材质、色彩、响应式层级与即时交互反馈，并补齐减少动态效果、减少透明度和高对比度适配。
- 调整流程图与正文配图Mermaid 流程图尺寸；权限、MCP、Subagents、提示词四页的小黑配图；配图图注与替代文本。
- 补齐资料依据与页面信息逐页资料依据、首页更新日志、权限模式表述、Skill／Plugin／MCP 分层、页脚内容与全页面响应式适配。
- 新增 GPT-5.6 提示词指南GPT-5.6 prompting guidance 中文解读、refine-user-prompt skill 介绍；移除原 Goal Entry 专题。
- 新增中文 Prompt 仓库条目awesome-chatgpt-prompts-zh 仓库说明、Codex 使用示例与提示词安全边界。
- 新增视觉与中文配图 Skillstaste-skill 与 Ian Xiaohei Illustrations 的仓库说明、使用示例和适用边界。
- 新增 Codex 生态 Top 10Skills、MCP、辅助工具榜单与官方基础设施条目。
- 新增站点清单与更新日志统一站点清单、首页最近更新、完整更新日志与站点生成数据。
- 新增 Skills 仓库选择指南第三方 Skills 仓库对比、任务选择表与安装入口。
- 新增 Compound Engineering 指南插件安装、核心流程与真实实例。
零基础：安装到第一个任务
安装 Codex Desktop，打开仓库，先跑一个只读任务，学会看验证证据。
日常协作：桌面版工作流
线程、上下文、浏览器反馈、权限审批、diff、提交和公开页面验证。
进阶用户：任务升级路线
判断何时从日常任务升级到 Goal、subagent、skill 或自动化。
Skills 仓库怎么选
先看 Codex CLI 生态 Top 10，再按任务选择 skills、MCP 或其他辅助工具。
工程 / 学术场景
从需求澄清到工程 flow，或从 research brief 到实验与写作边界。
维护者：资料和发布边界
README、AGENTS.md、local adaptation、发布验证和资料来源。
改网页首选：Desktop + Browser（内置浏览器）避免：只用口头描述问题证据：页面预览、截图/评论、
make check修测试首选：Desktop 任务 + Integrated terminal（集成终端）避免：让模型凭猜测改代码证据：失败日志、最窄测试、diff（差异）审查
长任务首选：Goal（目标）/ subagent（子代理）/ skills（技能）避免：单轮聊天里混多个目标证据：objective（目标）、validation（验证）、closeout（收口）
周期任务首选：Scheduled tasks（定时任务）避免：手工重复提醒证据：Scheduled 视图、运行记录、后台 worktree（工作树）
官方事实：OpenAI Codex docs
插件扩展：Compound Engineering / local skills
经验建议：本指南工作流沉淀
Codex 是什么
以 Codex Desktop 为主：线程、Local/Worktree、浏览器、Git、终端和自动化。
权限与安全
sandbox、approval、network、auth 和 secret 边界。
AGENTS.md
项目规则、层级、测试命令和完成证据。
Git 基础
用 status、diff 和 Worktree 命令先读现场，再进入隔离任务。
Worktrees
在 Codex Desktop 中隔离任务，理解 Local、生命周期和 Hand off 边界。
Skills
官方 skills 与本机扩展的边界。
MCP 与 Plugins
区分协议、外部服务与可安装能力包。
Subagents
何时拆分、如何约束、如何收口。
Goal
目标、验收、验证、停止条件和 closeout。
这份指南以 codex-usage-guide 自身的 Desktop 维护过程为主线：从浏览器反馈、插件资料核对、页面编辑、本地验证，到 GitHub Pages 发布。