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 handoff
开篇：桌面端才是大多数人的主战场
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 handoff
