diff --git a/README.md b/README.md index f1c4c23..4cfcd06 100644 --- a/README.md +++ b/README.md @@ -213,11 +213,12 @@ pnpm build 本仓库优先引用官方资料，并会在关键页面标注“最后核对日期”。当前骨架参考： -- [OpenAI Codex 产品页](https://openai.com/codex/) -- [Codex in ChatGPT Help Center](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) -- [OpenAI Codex CLI Getting Started](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started) -- [Codex cloud docs](https://platform.openai.com/docs/codex) -- [openai/codex GitHub repository](https://github.com/openai/codex) +- [Codex 产品介绍](https://openai.com/codex/) +- [Codex 与 ChatGPT 套餐](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) +- [Codex 官方文档](https://learn.chatgpt.com/docs) +- [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli) +- [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud) +- [openai/codex 源代码仓库](https://github.com/openai/codex) ## 参与贡献 diff --git a/README_en.md b/README_en.md index db25d4b..46cf94d 100644 --- a/README_en.md +++ b/README_en.md @@ -181,11 +181,12 @@ The CodexGuide WeChat community has a one-time CNY 9.9 entry fee. The small thre This repository prioritizes official sources and marks important pages with review dates where possible. The current structure references: -- [OpenAI Codex product page](https://openai.com/codex/) -- [Codex in ChatGPT Help Center](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) -- [OpenAI Codex CLI Getting Started](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started) -- [Codex cloud docs](https://platform.openai.com/docs/codex) -- [openai/codex GitHub repository](https://github.com/openai/codex) +- [Codex product overview](https://openai.com/codex/) +- [Codex and ChatGPT plans](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) +- [Official Codex documentation](https://developers.openai.com/codex/) +- [Official Codex CLI documentation](https://developers.openai.com/codex/cli/) +- [Official Codex Cloud documentation](https://developers.openai.com/codex/cloud/) +- [openai/codex source repository](https://github.com/openai/codex) ## Contributing diff --git a/docs/.vuepress/seo.ts b/docs/.vuepress/seo.ts index e3b1a17..89adb9d 100644 --- a/docs/.vuepress/seo.ts +++ b/docs/.vuepress/seo.ts @@ -51,7 +51,7 @@ export const pageDescriptions: Record = { "/start/08-task-execution.html": "Codex 任务执行与验证闭环教程，说明如何观察执行过程、检查 diff、验证结果并处理失败。", "/start/09-mobile-control.html": "手机端跟进桌面 Codex 任务教程，说明 ChatGPT App 入口、跨设备连接、任务查看和协同边界。", - "/start/10-cli-installation.html": "Codex CLI 安装教程，覆盖 Node 环境、安装命令、版本检查、登录流程和第一次运行准备。", + "/start/10-cli-installation.html": "Codex CLI 安装教程，覆盖安装命令、版本检查、登录流程和第一次运行准备。", "/start/11-cli-first-run.html": "第一次让 Codex CLI 改代码的教程，说明如何选择低风险任务、让 Codex 读仓库、修改文件并运行验证。", "/start/12-cli-options.html": "Codex CLI 选项与命令指南，覆盖交互模式、非交互执行、恢复会话、Slash Commands 和常用启动参数。", "/start/13-ide-vscode.html": "在 VS Code 中使用 Codex 的教程，介绍插件入口、文件上下文、局部修改、解释代码和编辑器内协作方式。", diff --git a/docs/advanced/00-index.md b/docs/advanced/00-index.md index 16f2675..62d70bc 100644 --- a/docs/advanced/00-index.md +++ b/docs/advanced/00-index.md @@ -4,12 +4,12 @@ permalink: /advanced/ --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本页是进阶教程索引，涉及费用、上下文、AGENTS.md、Skills、Plugins、权限、自动化、Hooks、沙盒、线程管理、配置和团队实践的细节，请以 [Codex 文档入口](https://developers.openai.com/codex/) 与各章节引用的官方资料为准。 +官方资料最后核对日期：2026-09-03。本页是进阶教程索引，涉及费用、上下文、AGENTS.md、Skills、Plugins、权限、自动化、Hooks、沙盒、线程管理、配置和团队实践的细节，请以 [Codex 官方文档总览](https://learn.chatgpt.com/docs) 与各章节引用的官方资料为准。 ::: # 进阶教程 -相信你已经能通过 [快速上手](../start/00-index.md) 完成了你到第一个任务。 +相信你已经能通过 [快速上手](../start/00-index.md) 完成了你的第一个任务。 如果你仍有好奇心，你可以按照下面的顺序深入了解 Codex 的各个方面。你将会学到一些很通用的 Agent 使用技巧。这意味着不少内容你都可以迁移到 Claude Code、KimiCode 等其他Agent上。 diff --git a/docs/advanced/01-cost-context.md b/docs/advanced/01-cost-context.md index d5dbfec..37c6e18 100644 --- a/docs/advanced/01-cost-context.md +++ b/docs/advanced/01-cost-context.md @@ -3,7 +3,7 @@ description: "Codex 费用与 Token 入门说明，解释 ChatGPT 计划额度 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-27。本文参考 [OpenAI Token 说明](https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-do-i-count-them)、[OpenAI API Pricing](https://openai.com/api/pricing/) 与 [Prompt Caching](https://platform.openai.com/docs/guides/prompt-caching)。价格、额度和可用模型会变化，真正下单或部署前请回到官方页面核对。 +官方资料最后核对日期：2026-09-04。本文参考 [OpenAI Token 帮助中心](https://help.openai.com/en/articles/4936856-what-are-tokens-and-how-to-track-them)、[ChatGPT 定价页](https://chatgpt.com/pricing/)、[OpenAI API 定价页](https://developers.openai.com/api/docs/pricing) 与 [Prompt Caching 官方文档](https://developers.openai.com/api/docs/guides/prompt-caching)。价格、额度和可用模型会变化，真正下单或部署前请回到官方页面核对。 ::: # 理解费用与上下文 @@ -44,7 +44,7 @@ Token 是模型读写文本时的基本“小块”。它不等于字数，也 Prompt caching 可以理解为：模型服务端会记住你最近用过的一段长前缀。当后续请求的开头部分和之前足够相似时，这部分输入会按 cached input tokens 计费。缓存输入通常比普通输入便宜，响应也可能更快。 -![Prompt caching 稳定前缀示例](https://cdn.canghecode.com/codexguide/docs/images/prompt-caching-stable-prefix-watermarked-small.png) +![OpenAI 模型 Prompt caching 价格示例](../images/openai-model-prompt-caching-pricing.png) | 类型 | 含义 | 费用 | | --- | --- | --- | diff --git a/docs/advanced/02-agents-md.md b/docs/advanced/02-agents-md.md index 8ac08e1..ab558c1 100644 --- a/docs/advanced/02-agents-md.md +++ b/docs/advanced/02-agents-md.md @@ -3,7 +3,7 @@ description: "AGENTS.md 项目规则指南，说明如何写入项目命令、 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-19。`AGENTS.md` 机制请以 [Codex AGENTS.md 官方文档](https://developers.openai.com/codex/guides/agents-md)、[AGENTS.md 标准网站](https://agents.md/) 和 [openai/codex GitHub repository](https://github.com/openai/codex) 为准。 +官方资料最后核对日期：2026-06-19。`AGENTS.md` 机制请以 [Codex AGENTS.md 官方文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md)、[AGENTS.md 标准网站](https://agents.md/) 和 [openai/codex 源代码仓库](https://github.com/openai/codex) 为准。 ::: # AGENTS.md diff --git a/docs/advanced/03-skills-plugins-mcp.md b/docs/advanced/03-skills-plugins-mcp.md index 5d4372c..2785bdc 100644 --- a/docs/advanced/03-skills-plugins-mcp.md +++ b/docs/advanced/03-skills-plugins-mcp.md @@ -3,7 +3,7 @@ description: "Codex Skills 和 Plugins 入门说明，介绍技能、插件、MC --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-20。本文参考 [Agent Skills 标准](https://agentskills.io/)、[Codex Skills](https://developers.openai.com/codex/skills)、[Codex Plugins](https://developers.openai.com/codex/plugins) 与 [Build plugins](https://developers.openai.com/codex/plugins/build)。如果你的界面与本文截图不完全一致，请优先以当前客户端和工作区可用功能为准。 +官方资料最后核对日期：2026-09-04。本文参考 [Agent Skills 标准](https://agentskills.io/)、[Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)、[Codex Plugins 官方文档](https://learn.chatgpt.com/docs/plugins) 与 [构建 Plugins 官方文档](https://learn.chatgpt.com/docs/build-plugins)。如果你的界面与本文截图不完全一致，请优先以当前客户端和工作区可用功能为准。 ::: # Skills 和 Plugins diff --git a/docs/advanced/04-permissions-security.md b/docs/advanced/04-permissions-security.md index c1e9afc..f0cde72 100644 --- a/docs/advanced/04-permissions-security.md +++ b/docs/advanced/04-permissions-security.md @@ -3,7 +3,7 @@ description: "Codex 权限管理指南，说明文件访问、命令审批、网 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-15。本文参考 [Codex app settings](https://developers.openai.com/codex/app/settings)、[Sandboxing](https://developers.openai.com/codex/concepts/sandboxing#how-you-control-it)、[Permissions](https://developers.openai.com/codex/permissions) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。不同版本的界面具体名称、入口和可用选项会有所不同，请以你当前使用的客户端界面为准。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex App 设置](https://learn.chatgpt.com/docs/reference/settings)、[沙盒](https://learn.chatgpt.com/docs/sandboxing)、[权限](https://learn.chatgpt.com/docs/permissions) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。不同版本的界面具体名称、入口和可用选项会有所不同，请以你当前使用的客户端界面为准。 ::: # 权限管理 @@ -12,7 +12,7 @@ description: "Codex 权限管理指南，说明文件访问、命令审批、网 1. 聊天框下方的权限选择 2. 设置里的“配置”项 -权限管理和**沙盒**（Sandbox）本质上是同一个概念。想深入可以看 [OpenAI 官方文档](https://developers.openai.com/codex/concepts/sandboxing#how-you-control-it) 或者 [沙盒与审批](./07-sandbox-approvals.html) 以了解更多。 +权限管理和**沙盒**（Sandbox）本质上是同一个概念。想深入可以看 [沙盒](https://learn.chatgpt.com/docs/sandboxing) 或者 [沙盒与审批](./07-sandbox-approvals.html) 以了解更多。 ## 聊天框里的权限选项 @@ -90,7 +90,7 @@ description: "Codex 权限管理指南，说明文件访问、命令审批、网 ![Codex App config.toml 配置示例](https://cdn.canghecode.com/codexguide/docs/images/codex-app-config-toml-settings-watermarked-small.png) -上表仅展示部分常见配置选项，更多请查看[OpenAI Premission](https://developers.openai.com/codex/permissions)。 +上表仅展示部分常见配置选项，更多请查看[权限](https://learn.chatgpt.com/docs/permissions)。 ## 推荐 diff --git a/docs/advanced/05-automation.md b/docs/advanced/05-automation.md index c255283..36110b3 100644 --- a/docs/advanced/05-automation.md +++ b/docs/advanced/05-automation.md @@ -3,7 +3,7 @@ description: "Codex 自动化指南，说明定时任务、提醒、监控、后 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 与 [Codex use cases](https://developers.openai.com/codex/use-cases/)。不同客户端、工作区套餐和权限设置下，自动化入口和可选项可能会有所不同。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) 与 [已安排任务](https://learn.chatgpt.com/docs/automations)。不同客户端、工作区套餐和权限设置下，自动化入口和可选项可能会有所不同。 ::: # Automation diff --git a/docs/advanced/06-hooks.md b/docs/advanced/06-hooks.md index f463f78..27244fa 100644 --- a/docs/advanced/06-hooks.md +++ b/docs/advanced/06-hooks.md @@ -3,7 +3,7 @@ description: "Codex Hooks 入门指南，说明 Hooks 的用途、配置位置 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-19。本文依据 [Codex Hooks 官方文档](https://developers.openai.com/codex/hooks) 和 [Codex Configuration Reference](https://developers.openai.com/codex/config-reference) 整理。 +官方资料最后核对日期：2026-09-04。本文依据 [Codex Hooks 官方文档](https://learn.chatgpt.com/docs/hooks) 和 [Codex 配置参考资料](https://learn.chatgpt.com/docs/config-file/config-reference) 整理。 ::: # Hooks diff --git a/docs/advanced/07-sandbox-approvals.md b/docs/advanced/07-sandbox-approvals.md index 78622a7..0f2bd40 100644 --- a/docs/advanced/07-sandbox-approvals.md +++ b/docs/advanced/07-sandbox-approvals.md @@ -3,7 +3,7 @@ description: "Codex 沙盒与审批指南：面向新手解释为什么 Codex --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-18。本文依据 [Codex Sandboxing](https://developers.openai.com/codex/concepts/sandboxing)、[Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)、[Permissions](https://developers.openai.com/codex/permissions)、[Rules](https://developers.openai.com/codex/rules)、[Windows](https://developers.openai.com/codex/windows) 和 [Auto-review](https://developers.openai.com/codex/concepts/sandboxing/auto-review) 整理。 +官方资料最后核对日期：2026-09-04。本文依据 [沙盒](https://learn.chatgpt.com/docs/sandboxing)、[智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)、[权限](https://learn.chatgpt.com/docs/permissions)、[规则](https://learn.chatgpt.com/docs/agent-configuration/rules)、[Windows 沙盒](https://learn.chatgpt.com/docs/windows/windows-sandbox) 和 [自动审核](https://learn.chatgpt.com/docs/sandboxing/auto-review) 整理。 ::: # 沙盒与审批 @@ -12,7 +12,7 @@ Codex 能读取代码、修改文件、执行命令。这些操作需要受控 沙盒和审批就是这套边界。 -对于绝大多数人而言，只需要把 `Auto-Reivew` 模式打开就够了。本文章旨在让你更好地理解 Codex 的沙盒机制和审批策略，同时补充一些进阶用法。 +对于绝大多数人而言，只需要把 `Auto-review` 模式打开就够了。本文章旨在让你更好地理解 Codex 的沙盒机制和审批策略，同时补充一些进阶用法。 当你在利用沙盒和权限机制来约束 Codex 行为的时候，你已经在实践 `Harness Engineering `，即“约束工程” 。 @@ -149,7 +149,7 @@ approval_policy = "on-request" approvals_reviewer = "auto_review" ``` -更多阅读：[Agent approvals & security：Automatic approval reviews](https://developers.openai.com/codex/agent-approvals-security#run-without-approval-prompts)。 +更多阅读：[自动审核](https://learn.chatgpt.com/docs/sandboxing/auto-review)。 ## 网络权限 @@ -266,7 +266,7 @@ approval_policy = { granular = { 这里的 `true` 表示该类请求保持交互审批；`false` 表示自动拒绝。它是 `on-request` 的进阶替代，不是 UI 选项。 -更多详情请阅读：[Agent approvals & security：granular approval policy](https://developers.openai.com/codex/agent-approvals-security#run-without-approval-prompts)。 +更多详情请阅读：[智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security#run-without-approval-prompts)。 ## 平台差异 diff --git a/docs/advanced/08-thread-management.md b/docs/advanced/08-thread-management.md index 601ddac..c46cc6d 100644 --- a/docs/advanced/08-thread-management.md +++ b/docs/advanced/08-thread-management.md @@ -3,7 +3,7 @@ description: "Codex 自动线程管理指南：解释 thread、resume、fork、w --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-25。本文参考 [Kimi Code Agents and Sub-Agents](https://moonshotai.github.io/kimi-code/en/customization/agents)、[OpenAI Codex Subagents](https://developers.openai.com/codex/subagents)、[Codex CLI features](https://developers.openai.com/codex/cli/features) 和 [Codex App Worktrees](https://developers.openai.com/codex/app/worktrees) 整理。不同版本的 App、CLI 和移动端界面可能会变化，请以当前客户端为准。 +官方资料最后核对日期：2026-09-04。本文参考 [Kimi Code Agents and Sub-Agents](https://moonshotai.github.io/kimi-code/en/customization/agents)、[Codex Subagents 官方文档](https://learn.chatgpt.com/docs/agent-configuration/subagents)、[Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli) 和 [Codex Worktrees 官方文档](https://learn.chatgpt.com/docs/environments/git-worktrees) 整理。不同版本的 App、CLI 和移动端界面可能会变化，请以当前客户端为准。 ::: # 自动线程管理 diff --git a/docs/advanced/09-config-toml.md b/docs/advanced/09-config-toml.md index cfd84c5..2ac5487 100644 --- a/docs/advanced/09-config-toml.md +++ b/docs/advanced/09-config-toml.md @@ -3,7 +3,7 @@ description: "Codex config.toml 配置指南，说明模型、沙盒、审批、 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 [Codex config basic](https://developers.openai.com/codex/config-basic)、[Codex config advanced](https://developers.openai.com/codex/config-advanced)、[Codex config reference](https://developers.openai.com/codex/config-reference) 与 [openai/codex config docs](https://github.com/openai/codex/blob/main/docs/config.md)。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex 配置基础](https://learn.chatgpt.com/docs/config-file/config-basic)、[Codex 高级配置](https://learn.chatgpt.com/docs/config-file/config-advanced)、[Codex 配置参考资料](https://learn.chatgpt.com/docs/config-file/config-reference) 与 [openai/codex 配置文档](https://github.com/openai/codex/blob/main/docs/config.md)。 ::: # 配置文件 config.toml @@ -25,7 +25,7 @@ description: "Codex config.toml 配置指南，说明模型、沙盒、审批、 `config.toml` 保存 Codex 的持久配置，例如模型、沙盒、审批、profiles 和 MCP server。`~/.codex/.env` 更适合放 Desktop app 或 IDE extension 启动时需要读取的环境变量，例如 provider 需要的区域变量，或排障时临时验证过的代理变量。 -OpenAI [Amazon Bedrock provider 文档](https://developers.openai.com/codex/amazon-bedrock)提醒：Desktop app 和 VS Code extension 可能不会继承当前 shell 里的环境变量；如果这些入口需要某些变量，可以把值放进 `~/.codex/.env`，然后重启 app 或 extension。 +OpenAI [Amazon Bedrock 官方文档](https://learn.chatgpt.com/docs/amazon-bedrock)提醒：Desktop app 和 VS Code extension 可能不会继承当前 shell 里的环境变量；如果这些入口需要某些变量，可以把值放进 `~/.codex/.env`，然后重启 app 或 extension。 写入前先确认两件事： @@ -52,21 +52,13 @@ export NO_PROXY="localhost,127.0.0.1,::1,*.local" model = "gpt-5.1-codex-max" approval_policy = "on-request" sandbox_mode = "workspace-write" - -[profiles.readonly] -approval_policy = "on-request" -sandbox_mode = "read-only" - -[profiles.build] -approval_policy = "on-request" -sandbox_mode = "workspace-write" ``` 这个示例表达三件事： - 默认允许在当前工作区写文件。 - 高风险命令仍需要审批。 -- 额外保留一个只读 profile，适合新仓库分析。 +- 额外的只读 profile 写成独立文件 `~/.codex/readonly.config.toml`，适合新仓库分析。不要再使用 `[profiles.*]`。 ## 常见配置项按用途理解 @@ -86,7 +78,7 @@ sandbox_mode = "workspace-write" 适合打开陌生仓库、生成项目地图、梳理测试命令。 ```toml -[profiles.readonly] +# ~/.codex/readonly.config.toml sandbox_mode = "read-only" approval_policy = "on-request" ``` @@ -106,7 +98,7 @@ codex --profile readonly 适合修测试、补文档、小范围实现。 ```toml -[profiles.coding] +# ~/.codex/coding.config.toml sandbox_mode = "workspace-write" approval_policy = "on-request" ``` @@ -122,7 +114,7 @@ approval_policy = "on-request" 适合 PR review、发布前风险扫描、diff 总结。 ```toml -[profiles.review] +# ~/.codex/review.config.toml sandbox_mode = "read-only" approval_policy = "on-request" ``` @@ -257,12 +249,12 @@ codex-provider restore ## 官方资料延伸 -- [Config basic](https://developers.openai.com/codex/config-basic) -- [Config advanced](https://developers.openai.com/codex/config-advanced) -- [Config reference](https://developers.openai.com/codex/config-reference) -- [Environment variables](https://developers.openai.com/codex/environment-variables) -- [Use Codex with Amazon Bedrock](https://developers.openai.com/codex/amazon-bedrock) -- [openai/codex config docs](https://github.com/openai/codex/blob/main/docs/config.md) +- [Codex 配置基础](https://learn.chatgpt.com/docs/config-file/config-basic) +- [Codex 高级配置](https://learn.chatgpt.com/docs/config-file/config-advanced) +- [Codex 配置参考资料](https://learn.chatgpt.com/docs/config-file/config-reference) +- [环境变量](https://learn.chatgpt.com/docs/config-file/environment-variables) +- [Amazon Bedrock 官方文档](https://learn.chatgpt.com/docs/amazon-bedrock) +- [openai/codex 配置文档](https://github.com/openai/codex/blob/main/docs/config.md) ## 下一步 diff --git a/docs/advanced/10-team-playbook.md b/docs/advanced/10-team-playbook.md index ca0c0c0..7876aca 100644 --- a/docs/advanced/10-team-playbook.md +++ b/docs/advanced/10-team-playbook.md @@ -3,7 +3,7 @@ description: "Codex 团队实践指南，整理 AGENTS.md、PR、排障、知识 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文参考 [Codex AGENTS.md 官方文档](https://developers.openai.com/codex/guides/agents-md)、[Permissions](https://developers.openai.com/codex/permissions)、[Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security) 与 [Codex App Worktrees](https://developers.openai.com/codex/app/worktrees)。团队制度、审批边界和共享规则请结合本组织实际情况确认。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex AGENTS.md 官方文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md)、[权限](https://learn.chatgpt.com/docs/permissions)、[智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security) 与 [Codex Worktrees 官方文档](https://learn.chatgpt.com/docs/environments/git-worktrees)。团队制度、审批边界和共享规则请结合本组织实际情况确认。 ::: # 团队实践 @@ -44,7 +44,7 @@ description: "Codex 团队实践指南，整理 AGENTS.md、PR、排障、知识 ## 共享规则与个人偏好 -团队的共同规则建议放进 `AGENTS.md`，例如项目结构、命令、测试要求、目录边界和安全红线。个人本机路径、私有工具习惯、临时限制和回复偏好，可以参考 [团队共享规则和本地私有规则](/advanced/02-agents-md.html#团队共享规则和本地私有规则) 拆到 `AGENTS.local.md`。 +团队的共同规则建议放进 `AGENTS.md`，例如项目结构、命令、测试要求、目录边界和安全红线。个人本机路径、私有工具习惯、临时限制和回复偏好，可以参考 [团队协作](./02-agents-md.md#团队协作) 拆到 `AGENTS.local.md`。 如果团队允许使用社区工具，可以评估 [codex-agents-local](https://github.com/samzong/codex-agents-local)。使用前先确认 `AGENTS.local.md` 和 `AGENTS.override.md` 已加入 ignore，并让 Codex 审查安装步骤对 `~/.local/bin` 与 `~/.codex/hooks.json` 的影响。 diff --git a/docs/advanced/11-troubleshooting.md b/docs/advanced/11-troubleshooting.md index 096115b..10d5ae8 100644 --- a/docs/advanced/11-troubleshooting.md +++ b/docs/advanced/11-troubleshooting.md @@ -3,7 +3,7 @@ description: "Codex 排障手册，汇总登录、安装、权限、依赖、命 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文参考 [Codex 文档入口](https://developers.openai.com/codex/)、[Windows](https://developers.openai.com/codex/windows)、[Codex CLI 官方仓库](https://github.com/openai/codex) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。排障命令、路径和界面名称会随系统、客户端和 CLI 版本变化。 +官方资料最后核对日期：2026-09-05。本文参考 [Codex 官方文档总览](https://learn.chatgpt.com/docs)、[Windows 沙盒](https://learn.chatgpt.com/docs/windows/windows-sandbox)、[openai/codex 官方仓库](https://github.com/openai/codex) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。排障命令、路径和界面名称会随系统、客户端和 CLI 版本变化。 ::: # 排障手册 @@ -65,7 +65,7 @@ description: "Codex 排障手册，汇总登录、安装、权限、依赖、命 `Reconnecting` 不是一个具体根因。它可能是主连接、会话恢复、WebSocket / SSE 流、代理协议、MCP worker 或服务端临时问题。不要一开始就重装 Codex、覆盖 `config.toml`，或者直接换账号。 ::: tip 最后核对 -官方资料和 GitHub issue 最后核对日期：2026-06-14。本文参考 OpenAI [Codex app troubleshooting](https://developers.openai.com/codex/app/troubleshooting)、[Environment variables](https://developers.openai.com/codex/environment-variables)、[Use Codex with Amazon Bedrock](https://developers.openai.com/codex/amazon-bedrock)、[Model Context Protocol](https://developers.openai.com/codex/mcp)，以及社区排障库 [Desktop Reconnecting / Proxy Triage](https://github.com/toby-bridges/community-codex-windows-troubleshooting/blob/main/DESKTOP-RECONNECTING-PROXY-GUIDE.md)。 +官方资料和 GitHub issue 最后核对日期：2026-09-04。本文参考 [Codex 排障官方文档](https://learn.chatgpt.com/docs/reference/troubleshooting)、[环境变量](https://learn.chatgpt.com/docs/config-file/environment-variables)、[Amazon Bedrock 官方文档](https://learn.chatgpt.com/docs/amazon-bedrock)、[Codex MCP 官方文档](https://learn.chatgpt.com/docs/extend/mcp)，以及社区排障库 [Windows Codex Error Guide：网络、DNS、npm、代理](https://github.com/toby-bridges/community-codex-windows-troubleshooting/blob/main/WINDOWS-CODEX-ERROR-GUIDE.md)。 ::: 先按三层判断： diff --git a/docs/guide/index.md b/docs/guide/index.md index 514edb4..17238d5 100644 --- a/docs/guide/index.md +++ b/docs/guide/index.md @@ -3,7 +3,7 @@ description: "CodexGuide 学习路线，围绕说清楚、执行、验证、交 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文用于规划 CodexGuide 阅读顺序，Codex 的入口、能力边界和账号可用性请以 [Codex 文档入口](https://developers.openai.com/codex/)、[Codex App docs](https://developers.openai.com/codex/app)、[Codex CLI features](https://developers.openai.com/codex/cli/features) 与 [Codex Cloud docs](https://platform.openai.com/docs/codex) 为准。 +官方资料最后核对日期：2026-09-02。本文用于规划 CodexGuide 阅读顺序。Codex 的产品入口、能力边界和账号可用性，请以 [Codex 官方文档总览](https://developers.openai.com/codex/)、[Codex App 官方文档](https://developers.openai.com/codex/app)、[Codex CLI 官方文档](https://developers.openai.com/codex/cli) 与 [Codex Cloud 官方文档](https://developers.openai.com/codex/cloud) 为准。 ::: # 学习路线 diff --git a/docs/images/chatgpt-codex-get-started-clean.png b/docs/images/chatgpt-codex-get-started-clean.png index 6ee97eb..03b9c5a 100644 Binary files a/docs/images/chatgpt-codex-get-started-clean.png and b/docs/images/chatgpt-codex-get-started-clean.png differ diff --git a/docs/images/codex-app-composer-controls.png b/docs/images/codex-app-composer-controls.png index 8071399..a1a2cfb 100644 Binary files a/docs/images/codex-app-composer-controls.png and b/docs/images/codex-app-composer-controls.png differ diff --git a/docs/images/codex-app-profile-menu.png b/docs/images/codex-app-profile-menu.png new file mode 100644 index 0000000..88c5b1a Binary files /dev/null and b/docs/images/codex-app-profile-menu.png differ diff --git a/docs/images/codex-app-projects-recents.png b/docs/images/codex-app-projects-recents.png new file mode 100644 index 0000000..29fe238 Binary files /dev/null and b/docs/images/codex-app-projects-recents.png differ diff --git a/docs/images/codex-app-settings-overview.png b/docs/images/codex-app-settings-overview.png new file mode 100644 index 0000000..4d89426 Binary files /dev/null and b/docs/images/codex-app-settings-overview.png differ diff --git a/docs/images/codex-scheduled-tasks-overview.png b/docs/images/codex-scheduled-tasks-overview.png new file mode 100644 index 0000000..9c42b91 Binary files /dev/null and b/docs/images/codex-scheduled-tasks-overview.png differ diff --git a/docs/images/codex-sites-overview.png b/docs/images/codex-sites-overview.png new file mode 100644 index 0000000..32e6e96 Binary files /dev/null and b/docs/images/codex-sites-overview.png differ diff --git a/docs/images/codexplusplus-overview.png b/docs/images/codexplusplus-overview.png new file mode 100644 index 0000000..bb31d74 Binary files /dev/null and b/docs/images/codexplusplus-overview.png differ diff --git a/docs/images/codexplusplus-release-assets.png b/docs/images/codexplusplus-release-assets.png new file mode 100644 index 0000000..f5c7537 Binary files /dev/null and b/docs/images/codexplusplus-release-assets.png differ diff --git a/docs/images/openai-model-prompt-caching-pricing.png b/docs/images/openai-model-prompt-caching-pricing.png new file mode 100644 index 0000000..4f952a1 Binary files /dev/null and b/docs/images/openai-model-prompt-caching-pricing.png differ diff --git a/docs/images/prompt-caching-stable-prefix-watermarked-small.png b/docs/images/prompt-caching-stable-prefix-watermarked-small.png deleted file mode 100644 index 9e52b74..0000000 Binary files a/docs/images/prompt-caching-stable-prefix-watermarked-small.png and /dev/null differ diff --git a/docs/manual/00-index.md b/docs/manual/00-index.md index 443bc29..cd01068 100644 --- a/docs/manual/00-index.md +++ b/docs/manual/00-index.md @@ -4,7 +4,7 @@ permalink: /manual/ --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文汇总 OpenAI Codex 官方资料、GitHub 仓库和关键事实来源；涉及价格、计划、模型、可用地区、功能开关和账号权限时，请优先打开原文确认。 +官方资料最后核对日期：2026-09-04。本文汇总 OpenAI Codex 官方资料、GitHub 仓库和关键事实来源；涉及价格、计划、模型、可用地区、功能开关和账号权限时，请优先打开原文确认。 ::: # 参考手册 @@ -14,27 +14,28 @@ permalink: /manual/ ## OpenAI 官方 -- [Codex 产品页](https://openai.com/codex/)：Codex 的产品定位、使用界面和团队能力概览。 -- [Codex in ChatGPT Help Center](https://help.openai.com/en/articles/11369540-codex-in-chatgpt)：计划可用性、入口和常见问题。 -- [OpenAI Codex CLI Getting Started](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started)：CLI 入门、安装和基础能力。 -- [Codex 文档入口](https://developers.openai.com/codex/)：Codex 桌面 App、CLI、Cloud、配置、安全、Skills、MCP 等官方文档入口。 -- [Codex cloud docs](https://platform.openai.com/docs/codex)：云端任务、GitHub 连接和仓库工作流入口。 -- [Introducing Codex](https://openai.com/index/introducing-codex/)：Codex 发布背景和云端软件工程代理介绍。 -- [Introducing the Codex app](https://openai.com/index/introducing-the-codex-app/)：Codex 桌面 App 相关介绍。 -- [Work with Codex from anywhere](https://openai.com/index/work-with-codex-from-anywhere/)：ChatGPT 手机 App 中的 Codex 入口、跨设备连接和可用性说明。 -- [Unrolling the Codex agent loop](https://openai.com/index/unrolling-the-codex-agent-loop/)：Codex agent loop 背后的工作方式介绍。 +- [Codex 产品介绍](https://openai.com/codex/)：Codex 的产品定位、使用界面和团队能力概览。 +- [Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt)：计划可用性、入口和常见问题。 +- [Codex CLI Help Center](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started)：CLI 入门、安装和基础能力。 +- [Codex 官方文档总览](https://learn.chatgpt.com/docs/)：Codex 桌面 App、CLI、Cloud、配置、安全、Skills、MCP 等官方文档入口。 +- [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud)：云端任务、GitHub 连接和仓库工作流入口。 +- [Codex 发布介绍](https://openai.com/index/introducing-codex/)：Codex 发布背景和云端软件工程代理介绍。 +- [Codex 桌面 App 介绍](https://openai.com/index/introducing-the-codex-app/)：Codex 桌面 App 相关介绍。 +- [Codex Remote 官方文档](https://learn.chatgpt.com/docs/remote)：ChatGPT 手机 App 中的 Codex 入口和跨设备连接。 +- [远程连接](https://learn.chatgpt.com/docs/remote-connections)：远程主机、扫码配对和 SSH 连接说明。 +- [Codex Agent Loop 介绍](https://openai.com/index/unrolling-the-codex-agent-loop/)：Codex agent loop 背后的工作方式介绍。 ## 官方文档重点页面 -- [Codex App docs（桌面端）](https://developers.openai.com/codex/app)：桌面 App 功能入口，包含本地项目、Review、Automations、Worktrees、Local Environments、In-app Browser、Computer Use 等主题。 -- [Codex CLI features](https://developers.openai.com/codex/cli/features)：CLI 交互模式、非交互模式、功能概览。 -- [AGENTS.md](https://developers.openai.com/codex/guides/agents-md)：项目规则文件的官方说明。 -- [Codex security](https://developers.openai.com/codex/agent-approvals-security)：沙盒、审批和安全边界。 -- [Codex config basic](https://developers.openai.com/codex/config-basic)：基础配置。 -- [Codex config advanced](https://developers.openai.com/codex/config-advanced)：高级配置。 -- [Codex config reference](https://developers.openai.com/codex/config-reference)：完整配置参考。 -- [Codex skills](https://developers.openai.com/codex/skills)：Skills 官方说明。 -- [Codex Cloud docs](https://platform.openai.com/docs/codex)：云端任务、环境、仓库连接和任务执行入口。 +- [Codex App 官方文档](https://learn.chatgpt.com/docs/app)：桌面 App 功能入口，包含本地项目、Review、已安排任务、Worktrees、本地环境、内置浏览器、Computer Use 等主题。 +- [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)：CLI 交互模式、非交互模式、功能概览。 +- [Codex AGENTS.md 官方文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md)：项目规则文件的官方说明。 +- [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)：沙盒、审批和安全边界。 +- [Codex 配置基础](https://learn.chatgpt.com/docs/config-file/config-basic)：基础配置。 +- [Codex 高级配置](https://learn.chatgpt.com/docs/config-file/config-advanced)：高级配置。 +- [Codex 配置参考资料](https://learn.chatgpt.com/docs/config-file/config-reference)：完整配置参考。 +- [Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)：Skills 官方说明。 +- [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud)：云端任务、环境、仓库连接和任务执行入口。 ## GitHub 官方仓库 @@ -54,7 +55,7 @@ permalink: /manual/ - 入门安装优先看 Help Center 和 GitHub README。 - 了解产品边界优先看 OpenAI Codex 产品页。 -- 做团队接入时优先看 Help Center、平台文档、App 文档和企业相关说明。 +- 做团队接入时优先看帮助中心、[Codex 官方文档总览](https://learn.chatgpt.com/docs/)、[Codex App 官方文档](https://learn.chatgpt.com/docs/app)和企业相关说明。 - 写教程时不要整段翻译原文，应转化成中文场景和可复现步骤。 - 涉及价格、计划、模型、可用地区、功能开关、账号权限时，必须打开原文重新确认。 diff --git a/docs/manual/01-codex-updates.md b/docs/manual/01-codex-updates.md index 03c9c3d..667a0e8 100644 --- a/docs/manual/01-codex-updates.md +++ b/docs/manual/01-codex-updates.md @@ -3,7 +3,7 @@ description: "近期 Codex 更新中文摘要，依据 OpenAI 官方 Codex chang --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-27。本文依据 [OpenAI Codex changelog](https://developers.openai.com/codex/changelog) 整理，仅提供中文摘要和阅读索引；功能开放范围、账号计划、地区限制、模型可用性与版本号，请以官方原文为准。 +官方资料最后核对日期：2026-09-04。本文依据 [Codex 更新日志](https://learn.chatgpt.com/docs/changelog) 整理，仅提供中文摘要和阅读索引；功能开放范围、账号计划、地区限制、模型可用性与版本号，请以官方原文为准。 ::: # 近期Codex更新 diff --git a/docs/manual/02-credits.md b/docs/manual/02-credits.md index d5fb7a2..719c6c4 100644 --- a/docs/manual/02-credits.md +++ b/docs/manual/02-credits.md @@ -3,7 +3,7 @@ description: "CodexGuide 参考来源与致谢，整理案例中涉及的第三 --- ::: tip 最后核对 -资料最后核对日期：2026-06-29。本站参考来源以原作者发布页、GitHub 仓库、视频平台和 OpenAI 官方资料为准；涉及第三方工具安装、授权、价格、维护状态和输出格式时，请打开表格中的原链接核对。 +官方资料最后核对日期：2026-09-05。本站参考来源以原作者发布页、GitHub 仓库、视频平台和 [Codex 官方文档总览](https://learn.chatgpt.com/docs/) 为准；涉及第三方工具安装、授权、价格、维护状态和输出格式时，请打开表格中的原链接核对。 ::: # 参考来源与致谢 @@ -62,9 +62,9 @@ description: "CodexGuide 参考来源与致谢，整理案例中涉及的第三 | 文档 | 相关案例 | 链接 | |------|----------|------| -| Using Codex with your ChatGPT plan | [12 Codex × Chrome](../recipes/12-chrome-browser-plugin.md) | [查看文档](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) | -| Codex Skills 官方说明 | [01 Codex × PPT Skill](../recipes/01-ppt-skill-walkthrough.md) | [查看文档](https://developers.openai.com/codex/skills) | -| Codex Use Cases | [12 Codex × Chrome](../recipes/12-chrome-browser-plugin.md) | [查看文档](https://developers.openai.com/codex/explore/) | +| Codex 与 ChatGPT 套餐帮助中心 | [12 Codex × Chrome](../recipes/12-chrome-browser-plugin.md) | [查看文档](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) | +| Codex Skills 官方文档 | [01 Codex × PPT Skill](../recipes/01-ppt-skill-walkthrough.md) | [查看文档](https://learn.chatgpt.com/docs/build-skills) | +| Codex 用例 | [12 Codex × Chrome](../recipes/12-chrome-browser-plugin.md) | [查看文档](https://learn.chatgpt.com/use-cases) | --- diff --git a/docs/recipes/00-index.md b/docs/recipes/00-index.md index 7024356..9b5ac2b 100644 --- a/docs/recipes/00-index.md +++ b/docs/recipes/00-index.md @@ -4,7 +4,7 @@ permalink: /recipes/ --- ::: tip 最后核对 -资料最后核对日期：2026-06-29。本页是实战案例索引，Codex 官方能力请以 [Codex 文档入口](https://developers.openai.com/codex/)、[Codex Skills](https://developers.openai.com/codex/skills)、[Codex Plugins](https://developers.openai.com/codex/plugins) 与 [Codex use cases](https://developers.openai.com/codex/use-cases/) 为准；第三方工具以各案例中的原仓库和官方页面为准。 +资料最后核对日期：2026-09-04。本页是实战案例索引，Codex 官方能力请以 [Codex 官方文档总览](https://learn.chatgpt.com/docs)、[Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)、[Codex Plugins 官方文档](https://learn.chatgpt.com/docs/plugins) 与 [Codex 用例](https://learn.chatgpt.com/use-cases) 为准；第三方工具以各案例中的原仓库和官方页面为准。 ::: # 实战案例库 diff --git a/docs/recipes/01-ppt-skill-walkthrough.md b/docs/recipes/01-ppt-skill-walkthrough.md index fa14aa0..f67ec82 100644 --- a/docs/recipes/01-ppt-skill-walkthrough.md +++ b/docs/recipes/01-ppt-skill-walkthrough.md @@ -3,7 +3,7 @@ description: "Codex 与 PPT Skill 案例，说明如何用一句话生成演示 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文关于 Skill 机制参考 [Codex Skills](https://developers.openai.com/codex/skills)。案例中使用的 PPT Skill 来自社区仓库：[guizang-ppt-skill](https://github.com/op7418/guizang-ppt-skill)。第三方 Skill 的安装方式、依赖要求和输出格式请以原仓库说明为准。 +官方资料最后核对日期：2026-09-04。本文关于 Skill 机制参考 [Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)。案例中使用的 PPT Skill 来自社区仓库：[guizang-ppt-skill](https://github.com/op7418/guizang-ppt-skill)。第三方 Skill 的安装方式、依赖要求和输出格式请以原仓库说明为准。 ::: # Codex × PPT Skill：一句话生成演示文稿 diff --git a/docs/recipes/02-drawio-mcp.md b/docs/recipes/02-drawio-mcp.md index b297d40..dec46ab 100644 --- a/docs/recipes/02-drawio-mcp.md +++ b/docs/recipes/02-drawio-mcp.md @@ -3,7 +3,7 @@ description: "Codex 与 Draw.io MCP 案例，说明如何用 AI 自动绘制架 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [Model Context Protocol](https://modelcontextprotocol.io/)、[jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp) 与 [draw.io](https://www.drawio.com/)。第三方 MCP 的安装命令、授权方式和兼容性请以原项目说明为准。 +官方资料最后核对日期：2026-09-04。本文关于 MCP 机制参考 [Codex MCP 官方文档](https://learn.chatgpt.com/docs/extend/mcp)。案例中使用的 Draw.io MCP 来自社区仓库：[jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp)。图形编辑器请参考 [draw.io 官方网站](https://www.drawio.com/)。第三方 MCP 的安装命令、授权方式和兼容性请以原项目说明为准。 ::: # Codex × Draw.io MCP：AI 自动绘制架构图 diff --git a/docs/recipes/03-playwright-mcp.md b/docs/recipes/03-playwright-mcp.md index 45e06e1..454cb51 100644 --- a/docs/recipes/03-playwright-mcp.md +++ b/docs/recipes/03-playwright-mcp.md @@ -3,7 +3,7 @@ description: "Codex 与 Playwright MCP 案例，说明如何让 AI 操作浏览 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [Model Context Protocol](https://modelcontextprotocol.io/)、[Playwright](https://playwright.dev/) 与 [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)。浏览器自动化能力、安装方式和可用工具名称请以原项目说明为准。 +官方资料最后核对日期：2026-09-04。本文关于 MCP 机制参考 [Codex MCP 官方文档](https://learn.chatgpt.com/docs/extend/mcp)。案例中使用的 Playwright MCP 来自仓库：[microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)。浏览器自动化请参考 [Playwright 官方网站](https://playwright.dev/)。浏览器自动化能力、安装方式和可用工具名称请以原项目说明为准。 ::: # Codex × Playwright MCP：让 AI 像人一样操控浏览器 diff --git a/docs/recipes/04-hyperframes-animation.md b/docs/recipes/04-hyperframes-animation.md index aa7ca31..c9316e8 100644 --- a/docs/recipes/04-hyperframes-animation.md +++ b/docs/recipes/04-hyperframes-animation.md @@ -3,7 +3,7 @@ description: "Codex 与 HyperFrames 案例，说明如何用代码生成动画 --- ::: tip 最后核对 -资料最后核对日期：2026-06-29。本文涉及 Codex 插件、Skill 与代码化视频生成工作流；Codex 能力请以 [Codex Skills](https://developers.openai.com/codex/skills) 和 [Codex Plugins](https://developers.openai.com/codex/plugins) 为准，延伸参考 [Remotion](https://www.remotion.dev/) 与 [wshuyi/remotion-video-skill](https://github.com/wshuyi/remotion-video-skill)。 +官方资料最后核对日期：2026-09-04。本文涉及 Codex 插件、Skill 与代码化视频生成工作流；Codex 能力请以 [Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills) 和 [Codex Plugins 官方文档](https://learn.chatgpt.com/docs/plugins) 为准，延伸参考 [Remotion 官方网站](https://www.remotion.dev/) 与社区仓库 [wshuyi/remotion-video-skill](https://github.com/wshuyi/remotion-video-skill)。 ::: # Codex × HyperFrames：用代码生成动画视频 diff --git a/docs/recipes/05-obsidian-codex.md b/docs/recipes/05-obsidian-codex.md index cd6471b..c27423a 100644 --- a/docs/recipes/05-obsidian-codex.md +++ b/docs/recipes/05-obsidian-codex.md @@ -3,7 +3,7 @@ description: "Codex 与 Obsidian 案例，说明如何在本地知识库中生 --- ::: tip 最后核对 -资料最后核对日期：2026-06-29。本文参考 [Obsidian](https://obsidian.md/)、[Codex CLI features](https://developers.openai.com/codex/cli/features) 与 [OpenAI Images guide](https://platform.openai.com/docs/guides/images)。Obsidian 插件、图床工具和图像模型能力请以各自官方说明与当前客户端为准。 +官方资料最后核对日期：2026-09-04。本文参考 [Obsidian 官方网站](https://obsidian.md/)、[Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli) 与 [OpenAI 图像生成官方文档](https://developers.openai.com/api/docs/guides/image-generation)。Obsidian 插件、图床工具和图像模型能力请以各自官方说明与当前客户端为准。 ::: # Codex × Obsidian：在知识库中自动生成配图 diff --git a/docs/recipes/06-feishu-cli-codex.md b/docs/recipes/06-feishu-cli-codex.md index 164f0e4..5f24dcb 100644 --- a/docs/recipes/06-feishu-cli-codex.md +++ b/docs/recipes/06-feishu-cli-codex.md @@ -3,7 +3,7 @@ description: "Codex 与飞书 CLI 案例，说明如何用一句话处理飞书 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [larksuite/cli](https://github.com/larksuite/cli/blob/main/README.zh.md) 与 [飞书开放平台](https://open.feishu.cn/)。飞书 CLI 的登录、授权、命令参数和 API 能力请以官方仓库与开放平台文档为准。 +官方资料最后核对日期：2026-09-04。本文参考 [飞书 CLI 官方仓库](https://github.com/larksuite/cli)、[飞书开放平台](https://open.feishu.cn/) 与 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)。飞书 CLI 的登录、授权、命令参数和 API 能力请以官方仓库与开放平台文档为准。 ::: # Codex × 飞书 CLI：一句话处理飞书数据 diff --git a/docs/recipes/07-llm-wiki-codex.md b/docs/recipes/07-llm-wiki-codex.md index 12371f5..66d2ae1 100644 --- a/docs/recipes/07-llm-wiki-codex.md +++ b/docs/recipes/07-llm-wiki-codex.md @@ -3,7 +3,7 @@ description: "Codex 与 LLM Wiki 案例，说明如何在 Obsidian 中搭建 AI --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 Andrej Karpathy 的 [LLM Wiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)、[Obsidian](https://obsidian.md/) 与 [Codex CLI features](https://developers.openai.com/codex/cli/features)。知识库结构、插件安装和外部资料抓取方式请以原项目与当前工具版本为准。 +官方资料最后核对日期：2026-09-04。本文参考 Andrej Karpathy 的 [LLM Wiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)、[Obsidian 官方网站](https://obsidian.md/) 与 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)。知识库结构、插件安装和外部资料抓取方式请以原项目与当前工具版本为准。 ::: # Codex × LLM Wiki：在 Obsidian 中搭建 AI 知识库 diff --git a/docs/recipes/08-figma-mcp-codex.md b/docs/recipes/08-figma-mcp-codex.md index e1d5be6..862fcf9 100644 --- a/docs/recipes/08-figma-mcp-codex.md +++ b/docs/recipes/08-figma-mcp-codex.md @@ -3,7 +3,7 @@ description: "Codex 与 Figma MCP 案例，说明如何读取设计稿、理解 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [Model Context Protocol](https://modelcontextprotocol.io/) 与 [Figma](https://www.figma.com/)。Figma MCP、Dev Mode、授权入口和可读取的设计信息会随 Figma 与 Codex 客户端更新变化，请以当前产品界面为准。 +官方资料最后核对日期：2026-09-04。本文关于 MCP 机制参考 [Codex MCP 官方文档](https://learn.chatgpt.com/docs/extend/mcp)。设计稿请参考 [Figma 官方网站](https://www.figma.com/)。Figma MCP、Dev Mode、授权入口和可读取的设计信息会随 Figma 与 Codex 客户端更新变化，请以当前产品界面为准。 ::: # Codex × Figma MCP：让 AI 读懂你的设计稿 diff --git a/docs/recipes/09-notion-mcp-codex.md b/docs/recipes/09-notion-mcp-codex.md index 7e5c2b1..8194bc2 100644 --- a/docs/recipes/09-notion-mcp-codex.md +++ b/docs/recipes/09-notion-mcp-codex.md @@ -3,7 +3,7 @@ description: "Codex 与 Notion MCP 案例，说明如何连接 Notion 知识空 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [Model Context Protocol](https://modelcontextprotocol.io/) 与 [Notion](https://www.notion.com/)。Notion MCP 的授权范围、可读写对象和连接入口请以 Notion 官方说明和当前 Codex 客户端为准。 +官方资料最后核对日期：2026-09-04。本文关于 MCP 机制参考 [Codex MCP 官方文档](https://learn.chatgpt.com/docs/extend/mcp)。知识空间请参考 [Notion 官方网站](https://www.notion.com/)。Notion MCP 的授权范围、可读写对象和连接入口请以 Notion 官方说明和当前 Codex 客户端为准。 ::: # Codex × Notion MCP：打通你的知识工作空间 diff --git a/docs/recipes/10-dkfile-deploy-codex.md b/docs/recipes/10-dkfile-deploy-codex.md index 04c2972..fe7d9a8 100644 --- a/docs/recipes/10-dkfile-deploy-codex.md +++ b/docs/recipes/10-dkfile-deploy-codex.md @@ -3,7 +3,7 @@ description: "Codex 与 DKFile 发布案例，说明如何用 AI 生成网页、 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [DKFile](https://dkfile.net) 与 [Codex App docs](https://developers.openai.com/codex/app)。第三方发布服务的价格、注册入口、文件限制、可用性和服务条款请以服务商官方页面为准。 +官方资料最后核对日期：2026-09-04。本文参考 [DKFile 官方网站](https://dkfile.net) 与 [Codex App 官方文档](https://learn.chatgpt.com/docs/app)。第三方发布服务的价格、注册入口、文件限制、可用性和服务条款请以服务商官方页面为准。 ::: # Codex × DKFile：AI 网页一键发布到公网 diff --git a/docs/recipes/11-remote-bug-fix.md b/docs/recipes/11-remote-bug-fix.md index 3eaadb6..d66178d 100644 --- a/docs/recipes/11-remote-bug-fix.md +++ b/docs/recipes/11-remote-bug-fix.md @@ -3,7 +3,7 @@ description: "Codex 与云服务器排障案例，说明如何远程复现问题 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文参考 [Codex CLI features](https://developers.openai.com/codex/cli/features)、[Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security) 与 [Codex Cloud docs](https://platform.openai.com/docs/codex)。远程服务器登录、凭据管理和生产环境操作请按你的组织安全规范执行。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)、[智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security) 与 [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud)。远程服务器登录、凭据管理和生产环境操作请按你的组织安全规范执行。 ::: # Codex × 云服务器：远程定位并修复 Bug diff --git a/docs/recipes/12-chrome-browser-plugin.md b/docs/recipes/12-chrome-browser-plugin.md index f752fb3..a8f85f9 100644 --- a/docs/recipes/12-chrome-browser-plugin.md +++ b/docs/recipes/12-chrome-browser-plugin.md @@ -3,7 +3,7 @@ description: "Codex Chrome 浏览器插件案例，说明如何让 AI 控制浏 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 与 [Codex use cases](https://developers.openai.com/codex/explore/)。具体插件名称、安装流程和入口位置可能会随客户端版本或工作区配置变化。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) 与 [Codex 用例](https://learn.chatgpt.com/use-cases)。具体插件名称、安装流程和入口位置可能会随客户端版本或工作区配置变化。 ::: # Codex × Chrome：让 AI 直接控制浏览器 diff --git a/docs/recipes/13-github-actions-ci-fix.md b/docs/recipes/13-github-actions-ci-fix.md index 890db9a..1a15908 100644 --- a/docs/recipes/13-github-actions-ci-fix.md +++ b/docs/recipes/13-github-actions-ci-fix.md @@ -3,7 +3,7 @@ description: "Codex 与 GitHub Actions 案例，说明 CI 失败后如何读取 --- ::: tip 最后核对 -公开资料最后核对日期：2026-06-29。本文参考 [GitHub Actions 文档](https://docs.github.com/actions)、[Codex CLI features](https://developers.openai.com/codex/cli/features) 与 [Codex Cloud docs](https://platform.openai.com/docs/codex)。CI 权限、token、分支保护和自动修复策略请以仓库当前配置为准。 +官方资料最后核对日期：2026-09-04。本文参考 [GitHub Actions 官方文档](https://docs.github.com/actions)、[Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli) 与 [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud)。CI 权限、token、分支保护和自动修复策略请以仓库当前配置为准。 ::: # Codex × GitHub Actions：CI 失败自动修复实测 diff --git a/docs/recipes/14-clinical-literature-review.md b/docs/recipes/14-clinical-literature-review.md index 664013a..9b9c9fe 100644 --- a/docs/recipes/14-clinical-literature-review.md +++ b/docs/recipes/14-clinical-literature-review.md @@ -3,7 +3,7 @@ description: "Codex 与临床文献综述案例，说明医护和科研人员如 --- ::: tip 最后核对 -公开资料最后核对日期：2026-05-27。本文只演示 Codex 辅助整理临床文献工作流，不提供医学事实结论或诊疗建议。医学资料检索请回到 [PubMed](https://pubmed.ncbi.nlm.nih.gov/)、[ClinicalTrials.gov](https://clinicaltrials.gov/) 和对应指南/论文全文核对。 +官方资料最后核对日期：2026-09-04。本文只演示 Codex 辅助整理临床文献工作流，不提供医学事实结论或诊疗建议。Codex 能力请以 [Codex 官方文档总览](https://learn.chatgpt.com/docs/) 为准。医学资料检索请回到 [PubMed 官方网站](https://pubmed.ncbi.nlm.nih.gov/)、[ClinicalTrials.gov 官方网站](https://clinicaltrials.gov/) 和对应指南/论文全文核对。 ::: # Codex × 临床文献综述：把医学问题整理成可复核证据表 diff --git a/docs/recipes/15-hatch-pet-photo.md b/docs/recipes/15-hatch-pet-photo.md index fa41c15..af5b9c6 100644 --- a/docs/recipes/15-hatch-pet-photo.md +++ b/docs/recipes/15-hatch-pet-photo.md @@ -3,7 +3,7 @@ description: "Codex Hatch Pet 功能案例，说明如何用一张照片生成 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文记录 Codex 客户端中的 Hatch Pet 使用流程，相关入口、Slash Command、素材格式和生成结果请以当前 Codex 客户端为准；通用能力说明可参考 [Codex App docs](https://developers.openai.com/codex/app) 与 [Codex Skills](https://developers.openai.com/codex/skills)。 +官方资料最后核对日期：2026-09-04。本文记录 Codex 客户端中的 Hatch Pet 使用流程，相关入口、Slash Command、素材格式和生成结果请以当前 Codex 客户端为准；通用能力说明可参考 [Codex App 官方文档](https://learn.chatgpt.com/docs/app) 与 [Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)。 ::: # Codex × Hatch Pet：用一张照片生成专属宠物 diff --git a/docs/recipes/16-android-remote-control.md b/docs/recipes/16-android-remote-control.md index b4864a4..31ee8b5 100644 --- a/docs/recipes/16-android-remote-control.md +++ b/docs/recipes/16-android-remote-control.md @@ -3,7 +3,7 @@ description: "Codex 连接安卓手机教程，说明如何通过扫码将手机 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 OpenAI 官方文章 [Work with Codex from anywhere](https://openai.com/index/work-with-codex-from-anywhere/) 与 [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan)。手机端入口、可用地区、系统支持和界面名称请以当前 ChatGPT App 与 Codex 客户端为准。 +官方资料最后核对日期：2026-09-04。本文参考 [Codex Remote 官方文档](https://learn.chatgpt.com/docs/remote)、[远程连接](https://learn.chatgpt.com/docs/remote-connections) 与 [Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt)。手机端入口、可用地区、系统支持和界面名称请以当前 ChatGPT App 与 Codex 客户端为准。 ::: # Codex × 安卓手机：扫码连接，远程操控 diff --git a/docs/recipes/17-desktop-pet.md b/docs/recipes/17-desktop-pet.md index 056fb98..de9ec84 100644 --- a/docs/recipes/17-desktop-pet.md +++ b/docs/recipes/17-desktop-pet.md @@ -3,7 +3,7 @@ description: "Codex 桌面形象设置教程，记录桌面展示效果、素材 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文记录 Codex 桌面宠物相关流程，插件入口、Slash Command、状态展示和本地文件位置请以当前 Codex 客户端为准；通用能力说明可参考 [Codex App docs](https://developers.openai.com/codex/app)、[Codex Plugins](https://developers.openai.com/codex/plugins) 与 [Codex Skills](https://developers.openai.com/codex/skills)。 +官方资料最后核对日期：2026-09-04。本文记录 Codex 桌面宠物相关流程，插件入口、Slash Command、状态展示和本地文件位置请以当前 Codex 客户端为准；通用能力说明可参考 [Codex App 官方文档](https://learn.chatgpt.com/docs/app)、[Codex Plugins 官方文档](https://learn.chatgpt.com/docs/plugins) 与 [Codex Skills 官方文档](https://learn.chatgpt.com/docs/build-skills)。 ::: # 如何设置自己的 Codex 桌面宠物 diff --git a/docs/start/00-index.md b/docs/start/00-index.md index 616db73..da8c522 100644 --- a/docs/start/00-index.md +++ b/docs/start/00-index.md @@ -4,7 +4,7 @@ permalink: /start/ --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本页是快速上手索引，Codex 的安装、账号、CLI、IDE、Cloud 与移动端入口请以 [Codex 文档入口](https://developers.openai.com/codex/)、[Codex in ChatGPT Help Center](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) 和 [Codex Cloud docs](https://platform.openai.com/docs/codex) 为准。 +官方资料最后核对日期：2026-09-02。本页是快速上手索引，Codex 的安装、账号、CLI、IDE、Cloud 与移动端入口请以 [Codex 官方文档总览](https://learn.chatgpt.com/docs)、[Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) 和 [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud) 为准。 ::: # 快速上手 @@ -21,7 +21,7 @@ permalink: /start/ 1. [Codex 是什么](./01-what-is-codex.md) 2. [Codex 桌面 App 下载与安装](./02-app-installation.md) -3. [订阅 ChatGPT Plus / Pro](./03-account-plan.md) +3. [订阅 ChatGPT 套餐](./03-account-plan.md) 4. [连接第三方 API](./04-third-party-api.md) 5. [了解 Codex 基本组成](./05-app-overview.md) 6. [用 Codex 完成第一个任务](./06-first-task.md) diff --git a/docs/start/01-what-is-codex.md b/docs/start/01-what-is-codex.md index cf3654b..98f7528 100644 --- a/docs/start/01-what-is-codex.md +++ b/docs/start/01-what-is-codex.md @@ -3,7 +3,7 @@ description: "Codex 入口地图，比较 CLI、桌面 App、Cloud、IDE、ChatG --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。参考 [OpenAI Codex 产品页](https://openai.com/codex/)、[Codex 文档入口](https://developers.openai.com/codex/)、[Codex CLI 官方仓库](https://github.com/openai/codex) 与 [Codex in ChatGPT Help Center](https://help.openai.com/en/articles/11369540-codex-in-chatgpt)。 +官方资料最后核对日期：2026-09-02。参考 [Codex 产品介绍](https://openai.com/codex/)、[Codex 官方文档总览](https://learn.chatgpt.com/docs/)、[openai/codex 源代码仓库](https://github.com/openai/codex) 与 [Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan)。 ::: # Codex 是什么 diff --git a/docs/start/02-app-installation.md b/docs/start/02-app-installation.md index e2ba938..01e3259 100644 --- a/docs/start/02-app-installation.md +++ b/docs/start/02-app-installation.md @@ -3,7 +3,7 @@ description: "Codex 桌面 App 下载与安装教程，说明 macOS、Windows --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-13。下载地址与安装方式以 [OpenAI Codex 产品页](https://openai.com/codex/) 和 [chatgpt.com/codex/get-started](https://chatgpt.com/codex/get-started/) 为准，不同地区和账号套餐下可用功能可能有所差异。 +官方资料最后核对日期：2026-09-02。下载地址与安装方式以 [Codex 产品介绍以及下载](https://openai.com/codex/) 为准，不同地区和账号套餐下可用功能可能有所差异。 ::: # Codex 桌面 App 下载与安装 @@ -13,7 +13,7 @@ description: "Codex 桌面 App 下载与安装教程，说明 macOS、Windows ## 下载 -打开 [chatgpt.com/codex/get-started](https://chatgpt.com/codex/get-started/)，页面中央会显示对应系统的下载按钮。 +打开 [Codex 产品介绍以及下载](https://chatgpt.com/zh-Hans-CN/codex/)，页面中央会显示对应系统的下载按钮。 >如果第一次注册，也可以接受邀请：[chatgpt.com/codex/](https://chatgpt.com/accept-referral?referral_context=eyJyZWZlcnJhbF9pZCI6IjZhNzk3YmQ2M2FiMDgxOTE5MTk4M2I3OTg3NTRlNzRiIiwicmVmZXJyYWxfdHlwZSI6ImNvZGV4X3JlZmVycmFsX2NvbnN1bWVyIiwiaW52aXRlX3BhZ2VfYmVuZWZpdF90ZXh0IjoiIiwiaGFzX3Jld2FyZHMiOmZhbHNlLCJlbWFpbF9yZWZlcnJlZF90byI6IjI2ODk0NTg2NTZAcXEuY29tIiwid29ya3NwYWNlX2lkIjpudWxsLCJ3b3Jrc3BhY2VfbmFtZSI6bnVsbCwicmVkZW1wdGlvbl9hY3Rpb24iOiJjb2RleF90dXJuIn0) @@ -31,10 +31,12 @@ description: "Codex 桌面 App 下载与安装教程，说明 macOS、Windows **Windows：** -![Codex 桌面 App 下载页 Windows](https://cdn.canghecode.com/codexguide/docs/images/chatgpt-codex-get-started-clean.png) +![Codex 桌面 App 下载页 Windows](../images/chatgpt-codex-get-started-clean.png) Windows 用户点击对应的下载按钮，下载完成后运行安装程序，按提示完成安装。 +微软商店可以关闭 VPN 之后尝试打开并且下载 ChatGPT + 如果点击后微软商店打不开、白屏，或一直卡在「获取」/「正在安装」，可以改用离线安装方式。核心思路是：不走微软商店客户端，直接从微软服务器解析 Codex 安装包，再手动安装。 1. 打开 [store.rg-adguard.net](https://store.rg-adguard.net/)，左侧选择 `ProductId`，输入 Codex 的产品 ID：`9PLM9XGG6VKS`，右侧选择 `RP`，点击对勾解析。 diff --git a/docs/start/03-account-plan.md b/docs/start/03-account-plan.md index a3b2e95..1f64ae9 100644 --- a/docs/start/03-account-plan.md +++ b/docs/start/03-account-plan.md @@ -3,23 +3,26 @@ description: "ChatGPT Plus 与 Pro 订阅指南，整理 Codex 可用性、账 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-13。定价与套餐以 [ChatGPT 定价页](https://chatgpt.com/pricing/) 和 [Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 为准。 +官方资料最后核对日期：2026-09-02。定价与套餐以 [ChatGPT 定价页](https://chatgpt.com/pricing/) 和 [Codex 与 ChatGPT 套餐](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 为准。 ::: -# 订阅 ChatGPT Plus / Pro +# 订阅 ChatGPT Plus / Pro 和其他套餐 ## 为什么需要订阅 -免费版 ChatGPT 可以体验基础对话，但 Codex 功能（包括桌面 App、Cloud 任务、多 agent 并行）需要付费套餐才能稳定使用。 +Codex 已包含在 ChatGPT Free、Go、Plus、Pro、Business、Enterprise 和 Edu 等套餐中，不同套餐主要区别在于使用额度、速率限制以及部分高级功能。 | 套餐 | 月费（美元） | Codex 可用情况 | -| --- | --- | --- | -| Free | 免费 | 仅限试用，额度极少 | -| Go | $8 | 在Codex中与Free没有区别 | -| Plus | $20 | 完整 Codex 访问，日常开发够用 | -| Pro 5x | $100 | Plus 的 5 倍额度，适合中高强度 | -| Pro 20x | $200 | Plus 的 20 倍额度，最大化额度 | -| Bussiness / Enterprise | 与销售团队联系 | 更高级的服务支持 | +| --- | ---: | --- | +| Free | 免费 | 可试用 Codex，适合简短的编程任务 | +| Go | $8 | 可使用 Codex，适合轻量级编程任务 | +| Plus | $20 | 完整使用 Codex，适合日常及较频繁的开发任务 | +| Pro 5x | $100 | Plus 约 5 倍的 Codex 使用额度，适合中高强度开发 | +| Pro 20x | $200 | Plus 约 20 倍的 Codex 使用额度，适合高强度开发 | +| Business | $20/用户/月（按年付费） | 包含 Codex，并提供团队工作空间、管理与安全功能 | +| Enterprise / Edu | 联系销售团队 | 包含 Codex，并提供企业级安全、管理和更灵活的使用额度 | + +> 套餐价格、Codex 使用额度和功能范围可能随 OpenAI 政策调整，请以官方最新定价页面为准。 对大多数个人开发者来说，**Plus（$20/月）是性价比最高的起点**。 @@ -370,11 +373,11 @@ Session 中包含临时登录凭证。只在地址栏确认是 `https://recharge **Q：订阅后 Codex 额度够用吗？** -Plus 按 token 计费（2026 年 4 月起），日常开发任务普通使用量通常可以撑一整个月。如果额度用完，可以单独购买额外额度，也可以等下月重置。 +Plus 按 token 计费，套餐本身包含使用额度；当前后台会依据 token、模型、上下文、推理、工具等因素换算使用消耗。只有超过包含额度后，符合条件的用户才可以购买额外 credits。当前 Codex 添加了 5 小时滚动窗口；官方现在甚至提供符合条件的 Plus/Pro 用户购买 weekly reset 的机制（2026 年 9 月起），日常开发任务普通使用量通常可以撑一整个月。如果额度用完，可以单独购买额外额度，也可以等下月重置。 **Q：Plus 和 Pro 区别大吗？** -Pro 的 Codex 使用额度是 Plus 的 5 倍，适合重度用户或需要大量并行任务的场景。普通开发者先从 Plus 开始，不够用再升级。 +Pro 提供 Plus 约 5 倍或 20 倍的 Codex 使用额度，适合重度用户或需要大量并行任务的场景。普通开发者先从 Plus 开始，不够用再升级。 **Q：可以用现有手机而不买二手设备吗？** diff --git a/docs/start/04-third-party-api.md b/docs/start/04-third-party-api.md index 85999b9..e688beb 100644 --- a/docs/start/04-third-party-api.md +++ b/docs/start/04-third-party-api.md @@ -3,7 +3,7 @@ description: "Codex 连接第三方 API 的入门说明，比较手动配置、C --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-29。本文参考 [OpenAI Codex config reference](https://developers.openai.com/codex/config-reference)。社区工具资料最后核对日期：2026-05-29，参考 [Codex++](https://github.com/BigPizzaV3/CodexPlusPlus)、[CCX](https://github.com/BenedictKing/ccx) 与 [CC Switch](https://github.com/farion1231/cc-switch)。 +官方资料最后核对日期：2026-09-02。本文参考 [OpenAI Codex 配置参考资料](https://developers.openai.com/codex/config-reference)。社区工具资料最后核对日期：2026-09-02，参考 [Codex++](https://github.com/BigPizzaV3/CodexPlusPlus)、[CCX](https://github.com/BenedictKing/ccx) 与 [CC Switch](https://github.com/farion1231/cc-switch)。 ::: # 连接第三方 API @@ -163,7 +163,7 @@ requires_openai_auth = false [Codex++](https://github.com/BigPizzaV3/CodexPlusPlus) 是面向 Codex App 的外部增强 launcher 和管理工具。根据项目 README，它不修改 Codex App 原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol 注入增强脚本。 -![](https://cdn.canghecode.com/blog/20260529171743.png) +![Codex++](../images/codexplusplus-overview.png) 它更适合这些情况： @@ -177,7 +177,7 @@ requires_openai_auth = false 1. 打开 [Codex++ Releases](https://github.com/BigPizzaV3/CodexPlusPlus/releases)，下载与你系统匹配的安装包。 -![](https://cdn.canghecode.com/blog/20260529172239.png) +![Codex++ 安装包下载列表](../images/codexplusplus-release-assets.png) 会有 「Codex++ 管理工具」和 「Codex++ app」两个安装包。 diff --git a/docs/start/05-app-overview.md b/docs/start/05-app-overview.md index 9f75fa5..172ff8a 100644 --- a/docs/start/05-app-overview.md +++ b/docs/start/05-app-overview.md @@ -3,7 +3,7 @@ description: "Codex 桌面 App 基本组成说明，介绍项目工作区、对 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-13。本章参考 [Codex App docs](https://developers.openai.com/codex/app)、[Settings](https://developers.openai.com/codex/app/settings)、[Agent approvals and security](https://developers.openai.com/codex/agent-approvals-security) 等官方资料。界面说明以当前 Codex 桌面 App 实际版本为准，不同系统、地区、客户端版本和账号套餐下显示可能略有差异。 +官方资料最后核对日期：2026-09-02。本章参考 [Codex App 官方文档](https://learn.chatgpt.com/docs/app)、[Codex App 设置](https://learn.chatgpt.com/docs/reference/settings)、[智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)、[使用 Codex 审查 GitHub 拉取请求](https://learn.chatgpt.com/docs/third-party/github)、[已安排任务](https://learn.chatgpt.com/docs/automations) 等官方资料。界面说明以当前 Codex 桌面 App 实际版本为准，不同系统、地区、客户端版本和账号套餐下显示可能略有差异。 ::: # 了解 Codex 基本组成 @@ -11,9 +11,9 @@ description: "Codex 桌面 App 基本组成说明，介绍项目工作区、对 ## 认识对话和项目 -打开 Codex，左侧栏就两个入口：**Chat（对话）** 和 **Project（项目）**。 +打开 Codex，左侧栏就两个入口：**Chat（对话）** 和 **Project（项目）**，之前有过对话的话会显示最近。而最近 Codex 和 ChatGPT 进行了一个整合，所以页面正上方就可以直接切换二者开始你的工作。 -![Codex 桌面 App 主界面](https://cdn.canghecode.com/codexguide/docs/images/codex-app-main-chat-home.png) +![Codex 项目与最近记录入口](../images/codex-app-projects-recents.png) **Chat 对话** @@ -39,7 +39,7 @@ Codex 的对话框和 ChatGPT 网页版类似，支持： 3. **控制权限**：设定 Codex 在当前任务中的操作权限 4. **选择工作目录**：指定 Codex 在哪个本地文件夹下执行任务 -![对话框功能区](https://cdn.canghecode.com/codexguide/docs/images/codex-app-composer-controls.png) +![对话框功能区](../images/codex-app-composer-controls.png) ## 插件与技能 @@ -56,15 +56,27 @@ Skills 默认包含 Skills Creator、Skills Installer、OpenAI Docs 等技能， ![Codex 插件配置](https://cdn.canghecode.com/codexguide/docs/images/codex-plugin-config-watermarked-small.png) -## 自动化 +## Pull Request -Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件等。 +左侧栏中的 **Pull requests** 用来集中查看与 GitHub 仓库关联的拉取请求。打开某个 PR 后，Codex 可以读取代码变更和相关上下文，协助审查代码、解释修改、定位问题，或根据审查意见继续调整代码。 -![Codex 自动化总览](https://cdn.canghecode.com/codexguide/docs/images/codex-automation-overview-watermarked-small.png) +Codex 也可以帮助整理提交内容并生成 PR 标题和描述。实际可查看和操作的仓库取决于已连接的 GitHub 账号及其权限，最终是否合并仍以仓库的审查流程为准。 -自动化会执行你指定的命令，你可以指定工作树、项目地址和定时的间隔。在下图中输入你的指令，并且配置即可。 +## 站点 -![Codex 创建自动化](https://cdn.canghecode.com/codexguide/docs/images/codex-automation-create-watermarked-small.png) +左侧栏中的 **Sites（站点）** 用来创建、托管、迭代和分享网站、Web 应用或小游戏。你可以从一句需求或兼容的本地项目开始，让 Codex 生成页面、修改内容并完成托管，之后再回到 Sites 中继续管理和更新。 + +![Codex 站点页面](../images/codex-sites-overview.png) + +需要注意的是，Sites 生成的部署链接属于正式上线环境。发布前应先检查页面内容、功能和访问权限；如果暂时不想上线，可以让 Codex 只保存版本而不部署。 + +## 已安排 + +左侧栏中的 **已安排（Scheduled）** 用来集中查看和管理定时任务及其运行记录。你可以让 Codex 在指定时间或按固定周期在后台执行任务，例如检查项目变化、生成报告或持续监控更新；任务可以随时暂停、恢复或修改。 + +![Codex 已安排任务总览](../images/codex-scheduled-tasks-overview.png) + +创建已安排任务时，需要填写要执行的指令，并选择项目、运行位置和执行频率。任务需要使用本地文件时，应保持电脑开机、Codex 桌面 App 运行，并确保项目文件夹仍然可以访问。 ::: tip 注意 自动化任务以默认沙盒设置运行。若工具调用需修改工作空间外文件、访问网络或操作电脑应用，该操作将执行失败。可通过规则选择性允许特定命令在沙盒外运行。 @@ -73,14 +85,16 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件 ## 设置面板 -点击左下角头像或设置图标可以打开设置面板。 +点击左下角头像或设置图标可以打开设置面板。比起之前，多了一个桌面宠物功能还有一个好友邀请功能，邀请好友可以获得对应的额度。 -![设置入口](https://cdn.canghecode.com/codexguide/docs/images/codex-app-profile-menu-settings-billing.png) - -![设置面板详情](https://cdn.canghecode.com/codexguide/docs/images/codex-app-settings-panel-detail.png) +![设置入口](../images/codex-app-profile-menu.png) 左侧是设置菜单。里面包含丰富的配置选项，详情如下： +![设置面板详情](../images/codex-app-settings-overview.png) + +c + ::: warning 先用默认配置 截图里的开关只是示例。尤其是「完全访问权限」、浏览器控制、电脑操控、钩子和 MCP 服务器，先按任务逐步开启。配置选项可参考如下。 @@ -97,54 +111,66 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
常规
    -
  • 工作模式：编程模式保留更多技术细节；日常工作模式更适合问答、整理和写作。
  • 权限：提供三个权限选项。
      -
    • 默认权限：在沙盒环境中运行，安全但部分操作可能受限，例如访问工作目录外的文件、修改本机环境变量。
      • -
    • 自动审核：也称“替我审批”，部分越权命令可以在模型审核认定安全后自动使用，无须用户授权。
      • -
    • 完全访问权限：只在明确需要时临时开启，例如启用 computer use。
      • +
    • 默认权限：Codex 可以读取和编辑当前工作区中的文件并运行常规本地命令；访问网络或超出工作区边界前会请求你的批准。
      • +
    • 自动审核：也称“替我审批”。工作区边界与默认权限相同，但额外访问请求会交给模型自动审核；自动审核仍可能判断错误。
      • +
    • 完全访问权限：Codex 可以修改电脑上的任意文件，并在无须逐次批准的情况下运行可联网命令，数据丢失或泄露风险显著提高。
    • -
  • 常规：可配置：文件打开位置、集成终端 Shell、Codex UI 的语言、底部面板、速度（指模型生成的速度）、代码审查、建议提示、从其他AI应用中导入工作内容，打开源许可证。
    - 通常而言，模型生成速度默认标准即可。仅在Pro 5x及以上的套餐才会推荐启用快速模式（消耗更多配额）。 -
    • -
  • 编辑器：可配置：上下文窗口使用情况、跟进行为、需按 ^ + 回车键发送长文本提示。
    • -
  • 弹出窗口：可配置：弹出窗口快捷键、默认使用无项目聊天。
    • -
  • 听写：可配置：按住听写快捷键、切换听写快捷键、保持听写栏可见、听写词典、最近的听写记录。
    • -
  • 通知：可配置：轮次完成通知、权限通知、问题通知。。
    • +
  • 常规选项：可配置无项目任务文件夹、默认文件打开位置、集成终端 Shell、应用界面语言和底部面板等选项。
    • +
  • 对话与运行：可要求使用 Ctrl + Enter 发送多行提示、在本地任务运行时阻止电脑休眠，并设置工作过程中发送的新消息是引导当前轮次还是排入下一轮。
    • +
  • 弹出窗口：可将当前对话弹出为独立窗口，并按需设置为始终置顶。
    • +
  • 通知：可设置轮次完成通知的出现时机，以及应用是否提示你授予系统通知权限。
-
推荐配置选项：通常而言，推荐开启自动审核、标准速度、始终轮次完成通知
+
推荐配置选项：大多数任务从默认权限开始；只有任务确实需要时再启用自动审核或完全访问权限。本地长任务可按需开启运行时防休眠。
个人资料 -

查看账号资料、Token 活动

+

查看和更新账号资料与使用活动。

    -
  • 资料：头像、名称、用户名。
    • -
  • 用量：活动、token、任务记录等个人统计。
    • +
  • 资料：头像、显示名称、用户名和个人资料卡。
    • +
  • 活动统计：累计 token、峰值 token、连续使用天数、最长任务和 token 活动等信息。
推荐配置选项：保持默认即可
+
+
+ 导入 +

从 Claude Code、Claude Cowork 或 Cursor 导入受支持的指令、设置、技能、插件、项目和近期工作。导入不会修改或删除原有智能体配置，也可以按需开启自动同步。

+
+
推荐配置选项：只有需要迁移现有工作时再使用；导入后检查仍需授权的插件和连接。
+
+
外观 -

调整 UI 和配色方案。可配置：主题导入、主题复制、强调色、背景、前景、UI 字体、代码字体、半透明侧边栏、对比度、指针光标、动态效果、字号、差异标记、宠物外观。

+

调整应用界面和配色方案。可选择基础主题，设置强调色、背景色、前景色、UI 字体和代码字体，也可以配置半透明侧边栏、对比度、指针光标和字号，并复制或分享自定义主题。

推荐配置选项：按照自己的喜好即可。
+
+
+ 语音 +

设置语音对话快捷键。语音对话用于与 ChatGPT 实时交流和协调任务；语音听写则只把语音转换成发送前可编辑的提示文字。具体可用性取决于套餐、地区和工作区设置。

+
+
推荐配置选项：需要持续语音交流时使用语音对话，只需输入文字时使用语音听写。
+
+
配置 -

管理 agent 的执行边界和config.toml的配置

+

管理 Codex 的默认行为、执行边界和 config.toml 配置。

  • 自定义 config.toml 设置：Codex 的核心配置文件。详情见：config.toml 参考
    • -
  • 工作空间依赖项：可配置 Codex 安装随附的Node.js和Python、进行诊断和重置并安装工作空间。
    • +
  • 工作空间依赖项：查看、诊断或重置 Codex 随附的 Node.js 和 Python 运行环境，并按需安装工作空间依赖项。
推荐配置选项：批准策略用按请求；沙盒用只读或工作区写入；联网按任务开启。
@@ -153,15 +179,23 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
个性化
-

选择 Codex 的性格，配置自定义指令和记忆。

+

选择友好、务实或无预设性格，并配置自定义指令。个人自定义指令会写入个人级 AGENTS.md；在可用时，也可以启用记忆，让 ChatGPT 在后续工作中使用过去对话中的有用上下文。

推荐配置选项：自定义指令写跨项目偏好。
+
+
+ 宠物 +

选择内置或自定义的动态宠物，并控制宠物浮层的显示状态。宠物属于可选的界面功能，不影响 Codex 执行任务。

+
+
推荐配置选项：按个人喜好开启或关闭。
+
+
键盘快捷键 -

查看、搜索和重设快捷键。

+

按命令名称或按键组合搜索快捷键，修改按键绑定，或将自定义快捷键恢复为默认值。

推荐配置选项：保持默认。后续根据需要自定义修改。
@@ -169,7 +203,7 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
使用情况和计费 -

查看额度和套餐状态。

+

查看当前套餐、用量限制和计费状态。具体显示内容取决于账号类型和工作区。

@@ -180,25 +214,33 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
MCP 服务器 -

给 Codex 接入外部工具和上下文，比如文档、浏览器、设计工具或内部系统。

+

给 Codex 接入外部工具和共享信息，例如文档、设计工具或内部系统。MCP 服务器负责定义工具、处理身份验证、返回结构化数据并执行外部操作。

推荐配置选项：根据项目需要配置 MCP。更多请看技能与插件。
+
+
+ 插件 +

安装和管理可复用的能力包。插件可以包含技能、连接器、MCP 服务器、浏览器扩展、钩子或已安排任务模板；安装后通常需要在新对话中使用。

+
+
推荐配置选项：只安装任务需要且来源可信的插件，并检查其权限、连接和钩子。
+
+
浏览器 -

让 Codex 打开网页、点击、输入、截图和检查页面状态。需要在插件处下载。可配置：清除浏览数据、批注截图、打开网站前审批、网站权限。

+

让 Codex 打开网站、获取最新信息并在网页中执行操作。内置浏览器使用独立于日常浏览器的资料和历史记录；可在这里安装或启用浏览器插件，并管理浏览数据、下载位置以及允许或阻止的网站。

-
推荐配置选项：通常始终包含批注截图，审批则视情况选择。
+
推荐配置选项：网页内容应视为不受信任的上下文；仅允许任务需要的网站，在共享敏感信息或执行重要操作前先检查页面和操作内容。
电脑操控 -

让 Codex 看屏幕、点应用、输入内容。Codex会读取本机上已经安装的APP，然后通过视觉识别和脚本发起键鼠操作。需要在插件处下载。

+

让 Codex 查看并操作 macOS 或 Windows 的图形界面，适合命令行或结构化集成无法完成的桌面应用操作。需要安装并启用 Computer Use 插件，再在设置中检查应用访问权限。

-
需要注意：电脑操作会接管你的电脑，一般而言AI接管过程中不建议用户操作。
+
需要注意：在 Windows 上，目标应用需保持在当前活动桌面，Computer Use 会移动指针、输入文字并占用前台。应限定任务范围，并在继续前检查权限请求。
@@ -208,22 +250,22 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
钩子 -

在 Codex 的生命周期事件中运行自定义脚本。可用于日志、提示检查、记忆整理、验证检查和按目录调整提示。详情见：Hooks。

+

在 Codex 的智能体循环和会话生命周期事件中运行脚本或 MCP 工具。可用于日志、敏感信息检查、记忆整理、验证检查和按目录调整提示。详情见：Hooks。

-
推荐配置选项：默认无需配置。当需要搭建工作流时再考虑。
+
推荐配置选项：默认无需配置。启用非托管钩子前，应检查并信任其具体定义；钩子发生变化后需要重新审核。
连接 -

管理设备远程连接。可通过手机/SSH的方式远程连接Codex。

+

管理 Codex Remote 设备连接。可在桌面 App 中生成二维码，用登录同一 ChatGPT 账号和工作区的手机配对；之后可从手机启动任务、查看进度、批准操作和检查代码变更。电脑需保持唤醒并联网。

Git -

让 Codex 按你的偏好处理 Git。可配置：分支前缀、PR 合并方法、侧边栏 PR 图标、强制推送、草稿 PR、旧工作树自动清理、保留数量、提交信息和 PR 标题/描述生成指令。

+

让 Codex 按你的偏好处理 Git。可配置分支前缀、Pull Request 合并方式、侧边栏 Pull Request 图标、强制推送、草稿 Pull Request、旧工作树自动清理与保留数量，以及提交信息和 Pull Request 标题或描述的生成指令。

推荐配置选项：保持默认即可。视实际开发需要而修改。
@@ -231,7 +273,7 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
环境 -

指定一个项目目录，告诉 Codex 这个项目该怎么构建和运行。可配置：设置脚本，清理脚本，自定义操作。例如安装依赖、构建项目、启动开发服务器和运行测试。

+

为指定项目目录配置构建和运行方式，包括设置脚本、清理脚本和自定义操作，例如安装依赖、构建项目、启动开发服务器或运行测试。

推荐配置选项：当你需要频繁地使用命令来打开一个项目时，考虑配置。
@@ -239,9 +281,9 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
工作树 -

让 Codex 为不同任务准备独立的工作区。适合同时修不同问题、比较不同方案，或把长任务放到一边继续做别的事。使用前先确认当前改动已经保存或提交。

+

在同一个 Git 仓库中为不同任务创建相互独立的检出目录，让多个对话并行工作而不干扰本地工作区。工作树仅适用于 Git 仓库，并可通过 Handoff 在本地检出目录与工作树之间移动对话和代码。

-
推荐配置选项：熟悉 Git 分支后再用。任务结束后清理不用的工作树。
+
推荐配置选项：适合并行或后台任务。完成后根据需要创建分支或移交到本地，并清理不再使用的工作树。
@@ -251,14 +293,14 @@ Codex 支持自动化执行任务，包括使用 MCP 服务器、钩子和插件
已归档对话 -

收起不再活跃的对话。可恢复。

+

查看已归档对话的日期和项目上下文，并使用“取消归档”将对话恢复。

::: tip 注意 -设置页里的名称会随着客户端迭代变化。遇到和教程截图不一致时，先看 OpenAI 官方的 [Codex App docs](https://developers.openai.com/codex/app)，再回到本教程查中文场景解释。 +设置页里的名称会随着客户端迭代变化。遇到和教程截图不一致时，先看 OpenAI 官方的 [Codex App 官方文档](https://learn.chatgpt.com/docs/app)，再回到本教程查中文场景解释。 ::: ## 下一步 diff --git a/docs/start/06-first-task.md b/docs/start/06-first-task.md index 3f6f79c..997684a 100644 --- a/docs/start/06-first-task.md +++ b/docs/start/06-first-task.md @@ -3,7 +3,7 @@ description: "用 Codex 完成第一个任务的入门教程，带你选择工 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本章以桌面 App 第一个任务为例，Codex App 的项目、工作区、权限和任务执行入口请以 [Codex App docs](https://developers.openai.com/codex/app)、[Settings](https://developers.openai.com/codex/app/settings) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security) 为准。 +官方资料最后核对日期：2026-09-02。本章以桌面 App 第一个任务为例，Codex App 的项目、工作区、权限和任务执行入口请以 [Codex App 官方文档](https://learn.chatgpt.com/docs/app)、[Codex App 设置](https://learn.chatgpt.com/docs/reference/settings) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security) 为准。 ::: # 用 Codex 完成第一个任务 diff --git a/docs/start/07-task-design.md b/docs/start/07-task-design.md index af95699..8c2c39a 100644 --- a/docs/start/07-task-design.md +++ b/docs/start/07-task-design.md @@ -3,7 +3,7 @@ description: "Codex 任务设计方法，说明如何写清目标、背景、范 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文是 Codex 任务设计方法总结，涉及上下文、指令、验证和安全边界时，请参考 [Codex 文档入口](https://developers.openai.com/codex/)、[AGENTS.md guide](https://developers.openai.com/codex/guides/agents-md) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。 +官方资料最后核对日期：2026-09-02。本文是 Codex 任务设计方法总结，涉及上下文、指令、验证和安全边界时，请参考 [Codex 官方文档总览](https://learn.chatgpt.com/docs/)、[Codex AGENTS.md 官方文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。 ::: # 任务设计 diff --git a/docs/start/08-task-execution.md b/docs/start/08-task-execution.md index 8703b9b..7882226 100644 --- a/docs/start/08-task-execution.md +++ b/docs/start/08-task-execution.md @@ -3,7 +3,7 @@ description: "Codex 任务执行与验证闭环教程，说明如何写清任务 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文是 Codex 任务执行与验证流程总结，命令执行、权限审批、沙盒边界和结果检查请参考 [Codex CLI features](https://developers.openai.com/codex/cli/features)、[Permissions](https://developers.openai.com/codex/permissions) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。 +官方资料最后核对日期：2026-09-02。本文是 Codex 任务执行与验证流程总结，命令执行、权限审批、沙盒边界和结果检查请参考 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)、[权限](https://learn.chatgpt.com/docs/permissions) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。 ::: # 任务执行与验证闭环 diff --git a/docs/start/09-mobile-control.md b/docs/start/09-mobile-control.md index b06655e..7485f8c 100644 --- a/docs/start/09-mobile-control.md +++ b/docs/start/09-mobile-control.md @@ -3,7 +3,7 @@ description: "手机端跟进桌面 Codex 任务教程，说明 ChatGPT App 入 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-13。本文参考 OpenAI 官方文章 [Work with Codex from anywhere](https://openai.com/index/work-with-codex-from-anywhere/)。具体入口、可用地区、系统支持和界面名称会随客户端更新变化，请以当前 ChatGPT 手机 App 和 Codex 桌面 App 为准。 +官方资料最后核对日期：2026-09-02。本文参考 [Codex Remote 官方文档](https://learn.chatgpt.com/docs/remote) 与 [远程连接](https://learn.chatgpt.com/docs/remote-connections)。具体入口、可用地区、系统支持和界面名称会随客户端更新变化，请以当前 ChatGPT 手机 App 和 Codex 桌面 App 为准。 ::: # 用手机远程操控 Codex diff --git a/docs/start/10-cli-installation.md b/docs/start/10-cli-installation.md index 815a675..dc78ab9 100644 --- a/docs/start/10-cli-installation.md +++ b/docs/start/10-cli-installation.md @@ -1,9 +1,9 @@ --- -description: "Codex CLI 安装与登录教程，覆盖 Node 环境、安装命令、版本检查、登录流程和首次运行准备。" +description: "Codex CLI 安装与登录教程，覆盖安装命令、版本检查、登录流程和首次运行准备。" --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。CLI 系统要求与安装方式参考 [openai/codex 官方仓库](https://github.com/openai/codex)、[CLI install 文档](https://github.com/openai/codex/blob/main/docs/install.md) 和 [Codex CLI Help Center](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started)。 +官方资料最后核对日期：2026-09-03。系统要求参考 [CLI install 文档](https://github.com/openai/codex/blob/main/docs/install.md)；安装方式参考 [openai/codex 官方仓库](https://github.com/openai/codex)、[Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli) 和 [Codex CLI Help Center](https://help.openai.com/en/articles/11096431-openai-codex-cli-getting-started)。 ::: # 安装CLI @@ -28,20 +28,42 @@ npm -v git --version ``` +独立安装脚本不依赖 Node.js。只有选择 npm 安装时，才需要 Node 和 npm。 + ![codex-cli-prerequisite-version-check](https://cdn.canghecode.com/codexguide/docs/images/codex-cli-prerequisite-version-check.png) ## 安装 CLI -常见安装方式： +官方当前推荐独立安装脚本： + +macOS / Linux： + +```bash +curl -fsSL https://chatgpt.com/codex/install.sh | sh +``` + +Windows（PowerShell）： + +```powershell +powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" +``` + +GitHub 仓库的系统要求仍写 Windows 11 通过 WSL2。如果原生安装遇到问题，可在 WSL2 里改用上面的 macOS / Linux 命令。 + +也可以用包管理器： ```bash npm install -g @openai/codex ``` -更新到最新版本： +```bash +brew install --cask codex +``` + +更新时：独立安装脚本和 npm 再执行同一条安装命令。Homebrew 使用： ```bash -npm install -g @openai/codex@latest +brew upgrade --cask codex ``` 检查版本： @@ -89,9 +111,9 @@ codex | 现象 | 可能原因 | 处理方式 | | --- | --- | --- | -| `codex` 命令找不到 | npm global bin 未进 PATH | 查看 `npm bin -g`，把目录加入 shell PATH | +| `codex` 命令找不到 | 安装目录未进 PATH | 独立安装默认在 `~/.local/bin`；npm 安装查看 `npm bin -g`，把目录加入 shell PATH | | 登录后仍提示无权限 | 账号计划、组织策略或会话状态问题 | 重新登录，并查看 Help Center 中的计划说明 | -| Windows 运行异常 | 未使用 WSL2 或 shell 环境不完整 | 按官方建议使用 Windows 11 + WSL2 | +| Windows 运行异常 | 未使用 WSL2，或原生安装后 PATH 不完整 | 仓库系统要求仍是 Windows 11 + WSL2；若使用官方 PowerShell 安装，确认 `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin` 已加入 PATH | | 仓库命令跑不起来 | 项目依赖未安装或本地环境缺失 | 先安装项目依赖，再让 Codex 读取测试配置 | ## 下一步 diff --git a/docs/start/11-cli-first-run.md b/docs/start/11-cli-first-run.md index 6e708ba..7cac9fe 100644 --- a/docs/start/11-cli-first-run.md +++ b/docs/start/11-cli-first-run.md @@ -3,7 +3,7 @@ description: "第一次让 Codex CLI 改代码的教程，说明如何选择低 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 [Codex CLI features](https://developers.openai.com/codex/cli/features)、[openai/codex getting started](https://github.com/openai/codex/blob/main/docs/getting-started.md)、[AGENTS.md guide](https://developers.openai.com/codex/guides/agents-md) 与 [Codex security](https://developers.openai.com/codex/agent-approvals-security)。 +官方资料最后核对日期：2026-09-03。本文参考 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)、[Codex AGENTS.md 官方文档](https://learn.chatgpt.com/docs/agent-configuration/agents-md) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。 ::: # 运行 CLI diff --git a/docs/start/12-cli-options.md b/docs/start/12-cli-options.md index 5c9f3f9..a375b8f 100644 --- a/docs/start/12-cli-options.md +++ b/docs/start/12-cli-options.md @@ -3,7 +3,7 @@ description: "Codex CLI 选项与命令指南，覆盖交互模式、非交互 --- ::: tip 最后核对 -官方资料最后核对日期：2026-05-27。本文参考 [Codex CLI features](https://developers.openai.com/codex/cli/features)、[Codex CLI 官方仓库](https://github.com/openai/codex)、[CLI getting started](https://github.com/openai/codex/blob/main/docs/getting-started.md)、[exec 文档](https://github.com/openai/codex/blob/main/docs/exec.md) 与 [slash commands 文档](https://github.com/openai/codex/blob/main/docs/slash_commands.md)。 +官方资料最后核对日期：2026-09-03。本文参考 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)、[openai/codex 源代码仓库](https://github.com/openai/codex)、[非交互模式](https://learn.chatgpt.com/docs/non-interactive-mode)、[CLI Slash Commands 官方文档](https://learn.chatgpt.com/docs/cli/slash-commands) 与 [CLI 命令参考](https://developers.openai.com/codex/cli/reference)。参数名和命令列表以当前 `codex --help` 为准。 ::: # CLI 选项与命令 @@ -19,6 +19,8 @@ CLI 是 Codex 最适合练基本功的入口。本页按官方教程的逻辑， | 一次性任务 | CI、脚本、批量分析、生成摘要 | `codex exec "任务说明"` | | 恢复会话 | 延续之前上下文、继续未完成任务 | `codex resume` | +官方还有 `codex review`、`codex cloud` 等入口。入门阶段先把上面三种跑熟即可。 + ## 交互模式 进入项目根目录后运行： @@ -51,6 +53,8 @@ codex codex exec "请阅读 README 和 package.json，输出本项目的本地启动命令和测试命令。不要修改文件。" ``` +默认在只读沙盒中运行。如果这次任务需要改文件，显式加上 `--sandbox workspace-write`。需要把输出交给后续命令解析时，加上 `--json`。不要再使用已弃用的 `--full-auto`。 + 适合的场景： - 批量生成仓库摘要。 @@ -88,7 +92,20 @@ codex exec "请阅读 README 和 package.json，输出本项目的本地启动 下次恢复时，把上一段总结作为第一条消息，能显著减少上下文断裂。 -示例： +交互会话可以直接恢复： + +```bash +codex resume +codex resume --last +``` + +`codex resume` 默认打开会话选择器，并优先显示当前目录的会话。非交互任务用： + +```bash +codex exec resume --last "继续上一步" +``` + +恢复后的第一条消息可以这样写： ```text 继续上一次任务。上一阶段已经完成： @@ -103,6 +120,8 @@ codex exec "请阅读 README 和 package.json，输出本项目的本地启动 Slash Commands 用于在 CLI 会话中快速查看状态、调整行为或执行常用动作。不同版本命令列表可能会变化，最稳妥的方式是在 CLI 内输入 `/` 查看当前可用命令。 +入门时可以先记住这几个：`/status`、`/model`、`/permissions`、`/compact`、`/diff`、`/resume`。 + 常见使用方式： | 命令类型 | 作用 | 使用建议 | diff --git a/docs/start/13-ide-vscode.md b/docs/start/13-ide-vscode.md index 8ee0f18..c306293 100644 --- a/docs/start/13-ide-vscode.md +++ b/docs/start/13-ide-vscode.md @@ -3,7 +3,7 @@ description: "在 VS Code 中使用 Codex 的教程，介绍插件入口、文 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文以 VS Code 为例演示 Codex IDE 入口，插件安装、登录、界面名称和可用功能请以当前编辑器插件与 [Codex 文档入口](https://developers.openai.com/codex/) 为准；CLI 基础能力可参考 [Codex CLI features](https://developers.openai.com/codex/cli/features)。 +官方资料最后核对日期：2026-06-29。本文以 VS Code 为例演示 Codex IDE 入口，插件安装、登录、界面名称和可用功能请以当前编辑器插件与 [Codex IDE 官方文档](https://learn.chatgpt.com/docs/codex/ide) 为准；CLI 基础能力可参考 [Codex CLI 官方文档](https://learn.chatgpt.com/docs/codex/cli)。 ::: # 在 VS Code 中使用 Codex diff --git a/docs/start/14-cloud.md b/docs/start/14-cloud.md index 74980ff..f00ed6b 100644 --- a/docs/start/14-cloud.md +++ b/docs/start/14-cloud.md @@ -3,7 +3,7 @@ description: "Codex Cloud 使用指南，说明云端任务、仓库连接、长 --- ::: tip 最后核对 -官方资料最后核对日期：2026-06-29。本文参考 [Codex Cloud docs](https://platform.openai.com/docs/codex)、[Using Codex with your ChatGPT plan](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan) 与 [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)。云端环境、仓库连接、任务权限和可用计划请以官方页面为准。 +官方资料最后核对日期：2026-09-03。本文参考 [Codex Cloud 官方文档](https://learn.chatgpt.com/docs/cloud)、[Codex 与 ChatGPT 套餐帮助中心](https://help.openai.com/en/articles/11369540-codex-in-chatgpt) 与 [智能体审批与安全](https://learn.chatgpt.com/docs/agent-approvals-security)。云端环境、仓库连接、任务权限和可用计划请以官方页面为准。 ::: # 使用 Codex Cloud