一、开篇桌面端才是大多数人的主战场OpenAI Codex 目前有三个形态桌面 AppmacOS Windows、CLI终端命令行、IDE 扩展VS Code 等。2026 年 2 月桌面端正式发布3 月登陆 Windows——自此图形化的桌面 App 就成了绝大多数开发者的主力入口。本文以桌面端为默认视角来组织内容同时为 CLI 用户单列一章。无论你用哪种形态核心能力Skills、AGENTS.md、MCP、Automations是打通的。当前最新模型GPT-5.52026 年 4 月 23 日发布桌面端和 CLI 均可使用。Codex 也支持 GPT-5.3-Codex 和 GPT-5.3-Codex-Spark后者速度可达 1000 token/s。二、桌面端 Codex开箱即用的图形化工作台桌面端的哲学是一切皆可点——你很少需要手动编辑配置文件。点击左下角头像/齿轮 → Settings所有设置都在 GUI 里。2.1 桌面端 Settings 速览设置分类 关键选项 建议General Prevent sleep while running ✅ 开启——长任务时电脑休眠会导致 Codex 中断General Detail level 选 Coding mode——可以看到 Codex 具体执行了哪些命令General Follow-up behavior 开启——Codex 完成任务后主动问还需要我做什么Configuration Approval policy On request——涉及文件修改和命令执行时征求同意Configuration Sandbox mode Workspace write——Codex 可在工作区内自由读写但出不去Configuration Model 选 GPT-5.5Pro/Max 用户日常用 High 推理强度Personalization Personality Pragmatic简洁直接或 Friendly更亲和Personalization Custom instructions 最重要的一项——见下文 2.2Appearance Theme Light / Dark / System还有色盲友好主题Appearance Avatar 可设置一个浮动头像Codex 在后台跑任务时你能在桌面上看到它codex常规设置2.2 个性化——自定义指令如何写得精简高效桌面端入口Settings → Personalization → Custom instructions。codex个性化这里写的内容会被写入 ~/.codex/AGENTS.md全局级别影响你在这台机器上所有项目的所有会话。所以只放真正通用的规则。精简高效的核心原则❌ 不要写 ✅ 要写“请你尽量写出高质量的、符合最佳实践的代码” “TypeScript 严格模式禁止 anyReact 函数组件 Hooks”“认真对待每一个细节” “改完代码后自动运行 pnpm typecheck pnpm lint”“使用合适的错误处理方式” “API 层统一用 ResultT, AppError 模式不抛裸异常”长篇架构文档 放在项目 docs/ 下需要时用 docs/arch.md 引用一份实用的全局自定义指令示例沟通用中文回答代码注释用英文先给方案概述2-3 句再写代码涉及架构决策时列出选项和 trade-off让我选编码习惯TypeScript 严格模式禁止 any不写 TODO 注释——要么实现完整要么在 PR 描述中说明安装新依赖前先问我绝不在代码中硬编码密钥和 Token安全不修改 .env 和 production 配置文件涉及数据库 migration 必须先确认一句话口诀自定义指令不是写给 AI 的情书是你给它列的操作清单。每一条都应该是可验证的——“我能在做完后跑一条命令来确认它遵守了吗”2.3 桌面端独有功能Plugins、Automations、多 Agent桌面端有一些 CLI 不具备或体验差异很大的功能功能 干什么用 入口Plugins 一键安装 Skills、MCP 服务器、App 集成GitHub、Slack、Notion 等 90 插件 左侧栏 Plugins 图标Automations 定时任务——比如每天 9:00 让 Codex 检查 PR、生成日报 左侧栏 Automations 图标多 Agent 并行 同时跑多个 Agent 处理不同任务 新建 Chat 即可自动分配Projects 按项目组织会话各自的上下文和配置独立 左侧栏 Projects内置 Terminal 每个线程有独立终端跑测试、启 dev server 不用切换窗口 线程内 Terminal Tab三、CLI 版 Codex终端极客的进阶武器如果你更喜欢终端操作或者需要在 CI/脚本中使用 CodexCLI 版本提供了更细粒度的控制。3.1 基本启动方式codex # 启动交互式 TUIcodex “解释这个项目” # 带初始 prompt 启动codex exec “检查类型” # 非交互模式执行一次后退出codex update # 更新到最新版3.2 CLI 常用参数参数 简写 作用 示例–model -m 指定模型 codex -m gpt-5.5–sandbox -s 沙箱策略 codex -s workspace-write–ask-for-approval -a 审批时机 codex -a on-request–full-auto workspace-write on-request 一键组合 codex --full-auto–image -i 附图片 codex -i error.png “修这个”–search 启用实时联网搜索 codex --search “查最新 API”–profile -p 加载预设配置 Profile codex -p review–cd -C 指定工作目录 codex -C ./packages/api–add-dir 添加额外工作目录 codex --add-dir …/shared-lib3.3 CLI 用户什么时候需要碰 config.toml桌面端用户基本不需要手动编辑 ~/.codex/config.toml因为 Settings GUI 已经覆盖了 90% 的常见配置。但 CLI 用户在以下场景可能需要直接编辑使用非 OpenAI 模型如通过 LiteLLM 代理接入其他模型配置 MCP 服务器虽然桌面端有 GUI但 CLI 用户只能写文件精细化 HooksPreToolUse / PostToolUse / SessionStart 等生命周期钩子企业管控管理员通过 requirements.toml 强制安全策略创建多个 Profile如 dev / review / ci用 --profile 切换一个简洁的 ~/.codex/config.toml 示例model “gpt-5.5”model_reasoning_effort “high”approval_policy “on-request”sandbox_mode “workspace-write”web_search “cached”personality “pragmatic”[profiles.review]model_reasoning_effort “medium”[profiles.quick]model_reasoning_effort “low”注意config.toml 的优先级低于 CLI 参数高于桌面端 GUI 设置。如果你同时使用桌面端和 CLI建议以桌面端 GUI 为主config.toml 只放 GUI 覆盖不到的项。3.4 CLI 典型工作流日常开发codex --full-auto代码审查只读 每次确认codex -s workspace-write -a on-request “审查 src/ 代码”脚本自动化codex exec “检查 TypeScript 类型错误” --json多仓库协作codex --cd apps/frontend --add-dir …/backend --add-dir …/shared贴截图 Debugcodex -i error.png “这个报错怎么修”四、AGENTS.md 撰写指南让 Codex 真正懂你AGENTS.md 是 Codex 的持久化上下文——每次会话启动时自动加载。桌面端和 CLI 共用同一套机制。4.1 加载链与优先级Codex 按以下顺序查找 AGENTS.md~/.codex/AGENTS.md ← 全局个人偏好桌面端 Settings → Personalization 写入的└── 项目根/AGENTS.md ← 项目级规则建议提交到 Git 给团队共享└── 子目录/AGENTS.md ← 模块/目录级细化离当前工作目录越近的文件优先级越高同目录存在 AGENTS.override.md 时完全替代同目录的 AGENTS.md适合临时实验桌面端 Settings → Personalization → Custom instructions 编辑的就是 ~/.codex/AGENTS.md4.2 该写什么、不该写什么✅ 推荐写AGENTS.md技术栈前端React 18 TypeScript 5 Tailwind CSS 3后端Node.js Express 4 Prisma PostgreSQL测试Vitest单元 PlaywrightE2E包管理pnpm启动与验证安装依赖pnpm install启动 dev serverpnpm dev端口 3000类型检查pnpm typecheck运行测试pnpm testLintpnpm lint编码规范TypeScript 严格模式禁止 anyReact 函数组件 Hooks不用 classAPI 路由放在 src/app/api/遵循 App Router 约定每个组件对应一个 .test.tsx安全绝不硬编码密钥修改 DB Schema 前必须确认涉及认证/权限的改动先出方案再看代码❌ 不该写不该写的内容 原因 正确做法长文档、API 参考 占上下文窗口大部分时候用不到 放 docs/需要时 docs/api.md 引用密钥和 Token 安全隐患可能被提交到 Git 放 .env权限中禁止 Codex 读取格式化规则缩进/引号等 应让工具自动执行不靠 AI 遵守 Prettier/ESLint Hooks 自动格式化认真对待每个细节等空话 占 token 无实际约束 换成可验证命令“改完后跑 pnpm typecheck”4.3 进阶让 AGENTS.md 持续进化“两次犯同一个错就加规则”——Codex 犯一次错会话中指正它同一个错犯第二次写入 AGENTS.md。但要定期清理——每月回顾一次删掉过时或不再需要的条目。一个 40 行的 AGENTS.md 比一个 200 行的更有效。五、Skills 生态系统去哪里找、怎么选、如何取舍Skills 是 Codex 的插件——Markdown 格式的可复用指令包Codex 启动时自动发现元数据需要时才加载完整内容。桌面端和 CLI 共用同一套 Skills 目录~/.codex/skills/。5.1 Skills 核心概念~/.codex/skills/ ← 个人 Skills全局可用└── my-skill/└── SKILL.md ← 必需name、description、触发条件、执行步骤└── scripts/ ← 可选辅助脚本└── references/ ← 可选参考资料.codex/skills/ ← 项目 Skills随仓库共享给团队Skills 使用渐进式披露启动时只加载 name description元数据只有任务匹配时才拉取完整指令。即使装 50 个 Skill真正占上下文的也只有被激活的那一两个。5.2 去哪里搜寻 Skills已逐一验证平台 地址 说明CocoLoop中文 hub.cocoloop.cn 中文友好含 CLS 安全评级第三方 Skill 商店Firecrawl 精选 firecrawl.dev/blog/best-codex-skills 含详细评测 安装命令 使用示例2026 年持续更新Composio Top 10 composio.dev/content/top-codex-skills 真实使用案例测试过的 10 个 SkillsLobeHub lobehub.com/skills 500 Skills分类清晰跨 Agent 通用FAOS Marketplace faosx.ai/open-source 526 个免费 SkillsApache 2.0覆盖工程/产品/增长/数据OpenAI 官方渠道 桌面端 Plugins 面板搜索安装 最安全官方审核安装器方式 会话中skill−installer名称官方推荐skill-installer 名称 官方推荐skill−installer名称官方推荐skill-installer gh-fix-cinpx 方式 npx skills add --skill CLI 通用npx skills add mattpocock/skills --skill handoff5.3 经过验证、值得长期使用的 Skills以下 Skills 已在多个独立来源Composio、Firecrawl、社区评测、YouTube 实测中得到验证Skill 干什么用 安装方式 推荐理由grill-me 以苏格拉底式提问对你的方案进行 60 连问 npx skills add mattpocock/skills --skill grill-me 在写代码之前先锁定需求避免做完了才发现理解错了handoff 把当前会话压缩成交接文档 npx skills add mattpocock/skills --skill handoff 上下文满了一键生成文档新会话无缝继续frontend-design 生成不像AI 批量生产的前端 UI npx skills add vercel-labs/agent-skills --skill frontend-design 避免千篇一律的 AI-slop 风格110k 周安装量Firecrawl 联网搜索 抓取 爬取 浏览器操作 npx -y firecrawl-clilatest init --all --browser 做调研时查最新文档不靠训练数据瞎猜gh-fix-ci 诊断并修复 GitHub Actions CI 失败 $skill-installer gh-fix-ci CI 红了不用自己翻日志yeet 一键 stage → commit → push → 开 PR $skill-installer yeet 省掉四次手动操作gh-address-comments 读取 PR Review 评论并批量修改 $skill-installer gh-address-comments 逐个处理 Review 意见太累批量解决excalidraw 文字描述转流程图/架构图 npx skills add excalidraw/claude-code --skill excalidraw “把刚才讨论的微服务架构画成图”superpowers 子 Agent 驱动的完整开发工作流 桌面端 Plugins 面板搜索安装 TDD Agent 审查 迭代给 Codex 装上工程骨架skill-creator Codex 内置帮你创建新 Skill 无需安装直接 $skill-creator 跟它描述需求帮你生成完整 SKILL.md小剧场花 30 分钟跟 Codex 讨论支付模块架构聊得热火朝天。第二天打开想继续——上下文满了。装了 handoff 之后一句 handoff 自动生成包含所有决策、待办、技术选型理由的交接文档新会话打开直接续上仿佛从未中断。5.4 Skills 装太多了怎么办Skills 不是越多越好。保持在 15-20 个真正高频使用的体验最佳。保留 / 删除四标准标准 判断逻辑使用频率 一周用不到一次的删触发重合 两个 Skill 干差不多的事留更准的那个可被内置替代 Codex 新版可能已原生支持如 2025 年的 web-search Skill2026 年已内置维护活跃度 6 个月没更新的API 可能已变实战每月在会话中输入 /skills 列出所有已安装的 Skills逐个过——名字都看着陌生的直接删。六、Record ReplayMac 用户的录一次用一生6.1 这是什么2026 年 6 月 18 日发布的 Codex macOS 桌面端独占功能。一句话你在 Mac 上做一遍操作Codex 边看边学然后把它变成可复用的自动化 Skill。 发布时间2026 年 6 月 18 日 平台macOS 桌面端独占Windows / CLI 暂不支持 地区限制欧洲经济区、英国、瑞士暂不可用 订阅ChatGPT Plus$20/月起 前置条件需启用 Computer Use Google Chrome 插件01-record-replay-concept6.2 什么场景最适用✅ 适合 ❌ 不适合每月重复的报销流程 步骤每次都不同的探索性任务定期下载固定报表 涉及金融敏感操作的流程按模板发布视频/文章 需要大量人工判断的决策标准化创建 GitHub Issue 一次性操作6.3 操作步骤打开 Codex macOS App进入左侧栏 Plugins → 点 → 选 Record a skill审阅建议 prompt补充上下文提交Codex 请求录屏权限 → 批准开始演示工作流像平常一样操作就行完成后点菜单栏停止按钮或直接说我完成了Codex 分析录屏 → 自动生成 SKILL.md可编辑03-three-ways-skill关键认知Record Replay 生成的不是像素级宏录制而是语义级意图描述——它理解你想完成什么而不是记录你点了哪些坐标。这意味着下次界面布局变了它仍然能适应。6.4 录制后可编辑生成的 SKILL.md 完全可以手动修改——调整步骤、添加验证条件、修改输入参数。本质上就是一个文本文件跟手写的 Skill 没有任何区别只是作者换成了你的录屏。02-record-vs-session-replay七、日常使用技巧与快捷键7.1 桌面端 / CLI 通用的斜杠命令在会话中输入 / 触发命令面板命令 作用 场景/model 切换模型 简单任务切轻量模型省 token/new 开启全新会话 换个不相关的任务/resume 恢复历史会话 继续昨天的重构/fork 从当前点分叉新会话 “这个方案不确定分叉出去试试”/compact 压缩对话历史 上下文快满了/side 快速旁路提问 查个 API 用法不污染主对话/status 查看当前模型、策略、Token 用量 心里有数/copy 复制 Codex 最近一次完整输出/clear 清屏不新建会话/skills 列出所有已安装 Skills/theme 切换配色 支持色盲友好主题7.2 三种前缀前缀 作用 示例/ 斜杠命令或调用自定义 Prompt /model gpt-5.5! 绕过对话直接执行 Shell 命令 ! npm test 引用文件/目录支持 Glob src/services/UserService.ts技巧多用 ! 前缀跑命令而不是在 prompt 里描述请帮我运行 npm test 并分析结果。前者 Codex 直接读到输出后者要在对话中转一圈多烧 token。7.3 通用快捷键快捷键 作用Esc Esc 空输入框双击 Esc编辑上条消息。继续按可回溯更早的消息按 Enter 从该点分叉CtrlO 复制 Codex 最新完整输出CtrlL 清屏保留对话历史Tab Codex 运行期间按 Tab排队输入下一条消息CtrlC 中断当前生成CtrlD 退出会话CLICmd, 打开桌面端 SettingsAlt, / Alt. 降低/提高推理强度7.4 提示词三技巧① 让 Codex 先采访你我想给项目加用户权限系统但还没想清楚细节。先采访我把需求搞清楚了再动手。② 复杂任务先出计划我需要重构 UserService。先出 RFC 风格计划拆分策略、文件结构、每步风险点。我确认后再执行。③ 定义完成标准优化 UserProfile 组件减少不必要的 re-render首屏加载 1 秒现有 12 个测试全部通过。八、小结Codex 的威力不在于模型而在于你花了多少心思去养它。一个花 30 分钟写好 AGENTS.md、选好 Skills、调好 Settings 的开发者效率可能比开箱即用的高 3 倍以上。优先级清单按投入回报排序优先级 投入 时长 回报 桌面端 Settings → Personalization → Custom instructions 15 分钟 每次对话都受益 创建项目 AGENTS.md技术栈 验证命令 编码规范 20 分钟 团队共享一次写好一直用 Settings → Configuration调好审批策略和沙箱模式 5 分钟 不再踩权限坑4 安装 5-8 个核心 Skillshandoff, grill-me, firecrawl 等 15 分钟 关键场景效率翻倍5 Mac 用户用 Record Replay 录 2 个重复任务 10 分钟/个 每周省机械操作时间6 CLI 用户创建 2-3 个 Profile 精简 config.toml 10 分钟 切换场景不手忙脚乱7 每月清理 Skills 回顾 AGENTS.md 15 分钟/月 防止配置腐烂