概览
本文介绍 Codex。这是 OpenAI 的编程智能体，可帮助你编写、审查和交付代码。
如果你想了解 ChatGPT 工作这一独立的 ChatGPT 体验，用它来处理耗时较长的研究和成果交付任务，请参阅：ChatGPT 工作与 Codex。有关 Codex 的技术细节，请参阅开发者网站上的 Codex 页面。
可用范围
所有 ChatGPT 套餐均包含 Codex，包括 Free 和 Go。Codex 云端向符合条件的 Plus、所有级别的 Pro、Business、Enterprise、Healthcare 和 Education 账号开放，具体取决于推出进度和工作空间设置。Free 和 Go 套餐不包含此功能。
开始使用
将 Codex 与你的 ChatGPT 账户关联
要通过 ChatGPT 套餐开始使用 Codex：
请使用你的 ChatGPT 账户登录。
所有 ChatGPT 套餐均包含 Codex，包括 Free 和 Go。用量限制因套餐而异。
如需了解更多信息，包括面向个人用户的更高用量选项，以及面向企业用户的 Codex 额度套餐，请访问 chatgpt.com/pricing。
启动你偏好的 Codex 客户端，按照说明使用 ChatGPT 登录：
按照所选客户端中显示的步骤完成设置。
如果在 ChatGPT 桌面应用中访问 Codex 时，系统要求你添加或验证手机号码，请参阅：手机验证的流程是什么？
自动审核
自动审核会让独立的审核方检查符合条件的操作；如果没有这项功能，这些操作会暂停并等待你的批准。如果检查批准了某项操作，Codex 就可以继续执行。如果检查拒绝了某项操作，Codex 可能会尝试更安全的方法，或征求你的意见。
使用 ChatGPT 账户登录后，自动审核的安全检查免费，且不计入套餐用量限制。这些检查不会解除工作空间的限制，也不会替代所有审批提示。
如果自动审核可用，请在 ChatGPT 桌面应用的输入框中打开审批菜单，然后选择代我批准。
有关详情和配置选项，请参阅：自动审核指南。
在终端中使用 Codex
Codex CLI 让你可以在终端中处理代码。打开项目目录，运行 codex，然后按提示使用 ChatGPT 账户登录。描述你希望 Codex 完成的任务。
新版 CLI 包含以下功能：
智能体视图：跟踪智能体及其正在执行的工作。
多智能体工具：允许智能体打开、读取或派生其他任务。
语音：工作时可以与 Codex 交谈，并收听它的回复。
工作树：在独立的 Git 工作树中分别处理不同任务。
用量统计：在 CLI 中查看用量信息。
渲染改进：在终端中查看 LaTeX 公式和 Mermaid 图表。
有关安装、更新、命令和配置的信息，请参阅：Codex CLI 指南。
在 Windows 上使用 Codex
Windows 上的 Codex 包含以下工具：
Codex 诊断工具：在 Codex CLI 中运行 codex doctor，诊断启动、连接和性能问题。
远程控制：通过 Windows 设备控制其他设备。工作空间权限以及设备的发现和控制设置仍然适用。
选择 WSL 发行版：如果安装了多个适用于 Linux 的 Windows 子系统 (WSL) 发行版，你可以选择 Codex 使用哪个 Linux 发行版。
如果应用更新由组织管理，管理员需要先通过 MDM 部署经批准的版本，你才能使用依赖该版本的功能。
使用 Codex 云端
Codex 云端利用可重复使用的云环境，在 OpenAI 管理的计算机上运行编程任务。在桌面端或网页端创建并发布环境。之后，你就可以在桌面端、网页端或移动端启动和继续云端任务。如需了解如何连接代码仓库、准备环境，以及配置凭据和网络访问，请参阅：设置和配置 Codex 云端。
计算机处于睡眠状态时，云端任务仍可继续运行。如果任务在你自己的计算机上运行，远程访问该任务仍取决于这台计算机的状态及其访问设置。
访客、K–12 和 Enterprise 仅查看席位无权创建云环境。
Codex 使用条款
当你使用现有 ChatGPT 账户登录 Codex 时，Codex 与 ChatGPT 之间共享的数据适用 ChatGPT 的使用条款和隐私政策；对于 OpenAI API 以及 ChatGPT Enterprise、Education 或 Business 用户，则适用相应的在线服务协议。
企业设置与控制
Codex 的模型默认设置
工作空间管理员和所有者可以在工作空间设置 > 模型中，为 Codex 配置初始模型、推理级别、速度、快速模式可用性，以及新对话的行为。快速模式默认启用；如果支持按角色进行控制，管理员可以为指定角色覆盖工作空间的默认设置。这些设置决定成员开始使用时的体验，不会使原本不可用的模型变为可用，也不会覆盖工作空间的强制要求。
当多项设置同时适用时，强制控制项优先：受管 requirements.toml 中的要求优先于工作空间的初始默认设置，而工作空间的初始默认设置又优先于成员在本地选择的初始设置。只有在模型对成员仍然可用，且没有强制要求阻止更改时，成员才能更改初始默认设置。
设置
有关工作空间设置说明，请参阅：企业管理员指南
云端访问
工作空间的 Codex 云端访问设置决定你能否使用云端任务。对于尚未启用云端访问的 Enterprise 工作空间，该功能默认关闭。现有的 Enterprise 云端访问设置会沿用至 Codex 云端。
云端访问权限与 Codex 本地访问权限相互独立。拥有云端访问权限且符合条件的成员可以创建和编辑自己的个人环境。创建或编辑工作空间共享环境还需要管理工作空间环境权限，该权限默认关闭。如果某项操作不可用，请让工作空间管理员检查你的访问权限。
插件
所有 ChatGPT 套餐的用户都可以查看插件目录。成员能否安装或使用插件，取决于其套餐、工作空间设置、角色、使用端，以及插件所需的应用权限。对于 Business 和 Enterprise/Edu 工作空间，管理员和所有者可在管理控制台中管理插件安装。选择目标 ChatGPT 工作空间，然后打开插件。在工作空间设置 > 应用中管理插件所依赖应用的访问权限。要从管理控制台打开应用页面，请选择目标 ChatGPT 工作空间，打开插件，然后选择管理旧版应用。有关工作空间中的应用和插件控制项，请参阅：插件和应用的管理控制、安全与合规。
插件可以包含技能、应用和应用模板。如果插件需要某个应用，必须先为成员所属角色启用该应用，Codex 才能使用由该应用支持的功能。现有应用设置继续适用，包括角色访问权限、操作控制、审批设置、同步设置、域名限制和提供商身份验证。
通过工作空间插件控制项，可以将插件针对符合条件的角色设为可用或已安装。已安装会为该角色默认安装插件；可用则允许成员自行安装。只要插件在相应端可用，这些控制项就会适用于 ChatGPT 网页端、移动端、桌面端以及 Codex。管理员无需为各端单独设置应用或插件开关。
某些本地插件或 Codex 专用插件可能只能在 Codex 中使用。如果插件是在本地创建的，可能需要先上传、导入或由管理员开放，才能供工作空间中的更多成员使用。
Codex 中的站点
站点功能是否可用，取决于你的套餐、工作空间以及想执行的操作。有关可用性的详情，请参阅：创建和使用 ChatGPT 站点。
如果 Codex 中的站点功能可用，请描述你想构建的内容，查看预览，并使用可用的分享控制项。
构建或编辑站点会计入 Codex 用量。有关完整流程，请参阅：Codex 站点开发者指南。
工作空间管理员可以通过套餐提供的设置，控制站点创建和公开发布。
可用的控制项取决于你的套餐和工作空间设置。如果找不到预期应有的控制项，请联系 OpenAI 支持团队。
浏览器使用功能和应用内浏览器的开发者模式
开发者模式可与 Chrome 中的浏览器使用功能及 Codex 应用内浏览器配合使用。它允许 Codex 在受控条件下访问 Chrome 开发者工具协议 (CDP)，以进行更深入的浏览器调试，例如检查控制台输出、网络流量、页面状态和 JavaScript 性能。
你可以在本地的 ChatGPT 桌面应用中启用此功能：打开设置 > 浏览器，然后在开发者模式下打开启用完整 CDP 访问权限。完整 CDP 访问权限允许 Codex 检查和控制浏览器敏感的内部组件，这可能给你的数据带来风险。Codex 在使用完整 CDP 访问权限检查网站前，会请求你的明确批准。
拥有 Codex 管理权限的用户可以在受管配置中将 browser_use_full_cdp_access 设为 false，以禁用完整 CDP 访问权限。禁用浏览器使用功能也会禁用 CDP。
有关设置和审批的详情，请参阅：开发者模式。请注意，管理员或所有者需要先启用应用内浏览器，然后才能启用开发者模式。
基于角色的访问控制 (RBAC)
工作空间管理员可以向特定角色授予 Codex 访问权限。有关设置说明，请参阅：RBAC
合规 API
可以通过合规 API 获取 Codex 使用记录，包括 CLI 和 IDE 扩展等本地客户端的使用记录，以及网页端使用记录或委派至云端执行的任务记录。此日志接口涵盖受支持的 Codex 客户端，与云端任务专用端点相互独立。
各套餐的用量限制
如果你即将达到或已达到 Codex 用量上限，请打开设置或用量仪表板。查看哪项用量已耗尽、剩余额度，以及页面上显示的重置时间。在进行中的 Codex CLI 会话中，输入 /status。
上线初期，标准 Codex 云端环境不单独收取虚拟机费用。模型用量计入常规 Codex 用量限制，并按适用规则扣除额度或计费。
使用 ChatGPT 账户登录后，自动审核的安全检查免费，且不计入套餐用量限制。其他 Codex 活动仍受套餐用量限制约束，并按适用标准收费。
有关最新的用量限制、费率和额度选项，请查看定价页面。
为什么可用用量会耗尽
对于采用共享用量或额度的套餐，如果套餐提供 Codex、ChatGPT 工作、ChatGPT for Excel 和工作空间智能体，这些功能会共用用量配额和额度池。用量取决于模型、任务运行位置、任务复杂程度、上下文、推理、速度和工具。长时间运行的任务可能比简短请求消耗多得多的用量。
根据基于 Token 计费的 Enterprise 协议，Codex 用量以美元 (USD) 计费，而不是扣除额度。请向管理员确认适用的计费方式。有关适用费率，请参阅：Enterprise 按 Token 计费价目表。有关计费概念，请参阅：ChatGPT Enterprise 按 Token 计费。
在桌面端的工作或 Codex 中通过 ChatGPT 语音发起的任务，也会消耗同一份用量配额。在适用灵活定价的情况下，语音连接时长会单独计量。普通聊天中的语音功能有独立的限制，不会消耗 Codex 用量。
对于基于额度计费的套餐，在支持此功能的情况下，ChatGPT 桌面版会显示工作和 Codex 中每个对话的额度用量。普通聊天用量不包括在内。只有当工作空间允许成员查看费用时，才会显示以美元计的估算金额。这些估算值仅供规划参考，并非账单。
符合条件且采用额度计费的 Enterprise 工作空间成员，可以在 ChatGPT 桌面版中打开设置 > 用量与账单。这里会显示其每月的工作和 Codex 用量配额，以及近期的额度记录。在支持的情况下，成员还可以查看本地可用的高用量工作和 Codex 对话，以及每个对话的累计额度用量。有关访问路径、数据更新情况和设置，请参阅查看工作和 Codex 用量并使用个人分析。
接下来可以怎么做
如果你的 Enterprise 工作空间按 Token 以美元计费，请联系工作空间管理员，检查工作空间预算、对你实际生效的用户限额，以及各项控制设置显示的重置周期。请按照组织的流程申请更多用量。有关工作空间控制设置，请参阅：管理 ChatGPT Enterprise 和 Edu 中的用量限制与超额用量。
查看用量限制通知，了解你的账户有哪些可用选项。你可能可以添加额度、使用可用的重置机会、升级套餐，或等待显示的重置时间。符合条件的 Plus 和 Pro 用户可以在不更换套餐的情况下购买额度。
如果已购买的额度似乎不见了，请先确认你使用的是正确的账户或工作空间，并查看近期用量。额度指南还介绍了负余额会如何影响后续购买。
如果数据看起来仍不正确
联系 OpenAI 支持团队。请提供你有疑问的用量限制或额度余额、显示的重置时间、截图、使用的 Codex 客户端和模型，以及问题发生的时间（包括时区）。请移除截图中的敏感信息。
上下文与数据控制
Codex 的一些功能可让它记住上下文、持续推进工作，并连接你选择使用的工具，从而提供更有效的帮助。这些功能包括记忆、定时任务、Codex 应用内浏览器和计算机使用。有关这些功能及其他功能的更多信息，包括如何管理这些功能存储和访问的数据，请参阅我们的开发者中心。
录制与回放
符合条件的用户在 macOS 版 ChatGPT 桌面应用中使用 Codex 时，可以使用“录制与回放”功能。只需演示一次工作流程，就能将其转化为可重复使用的技能。此功能适合流程稳定、可重复执行，且演示比描述更直观的工作流程。
“录制与回放”要求“计算机使用”功能可用且已启用，初期不向欧盟、瑞士和英国开放。录制期间，Codex 会观察学习该工作流程所需的操作和窗口内容。录制内容应仅围绕任务展开，录制期间请避免输入机密信息或敏感数据。
如需了解更多信息，请参阅录制与回放指南。
数据控制
您的 ChatGPT 训练数据控制设置适用于通过 Codex 处理的内容，包括“计算机使用”功能截取的屏幕截图。本地工作流程在您的设备上运行；云端任务在 OpenAI 管理的环境中运行。已连接的服务可能在受支持的 ChatGPT 和 Codex 界面中使用，您可以随时断开连接。
常见问题
Codex CLI 或 IDE 扩展使用哪个模型？
Codex 默认使用的模型取决于您的 CLI 或 IDE 扩展版本及配置。请查看 Codex 文档，了解可用模型及不同模型的配置方法。
OpenAI 会使用我的 Codex 使用数据进行训练吗？
Business、Enterprise 和 Edu
默认情况下，OpenAI 不会使用面向商业用户的产品（包括 ChatGPT Business、ChatGPT Enterprise 和 API）中的任何输入或输出来改进模型。不过，API 组织所有者可以自主选择与 OpenAI 共享 API 数据。某些组织无法使用此设置，包括 Enterprise 客户和已启用零数据保留的客户。
了解有关与 OpenAI 共享反馈、评估和微调数据，以及 API 输入和输出的更多信息。
Pro 和 Plus
除非你在 ChatGPT 数据控制中关闭用于训练的选项，否则对话可能会用于改进模型。如需更多信息，请参阅我们如何使用你的数据来改进模型性能。
可以在 IDE 中运行 Codex 吗？
可以，Codex VS Code 扩展与大多数 VS Code 分支版本兼容。对于其他 IDE，您也可以在 IDE 的终端中运行 Codex CLI。
工作空间权限如何应用于 ChatGPT 桌面应用中的 Codex？
受管理的工作空间可以分别控制 Codex 本地使用和 Codex 云端任务的权限。Codex 本地涵盖 CLI、IDE 扩展和桌面端工作流程，Codex 云端则涵盖委派至云端执行的任务。远程控制可能还需要工作空间启用该功能或授予 RBAC 权限，同时设备必须在 ChatGPT 桌面端设置中允许被发现和控制。
如需了解如何在工作空间中设置并开始使用 Codex，请参阅我们的详细指南：企业管理员指南
如果 Codex 卡住了，我可以尝试哪些方法？
如果 Codex 反复显示“上下文已自动压缩”，但任务没有进展，请停止该任务，开启新的 Codex 对话，并简要说明你的目标和已完成的工作。开启新对话不会重置你的使用限额。
如果 Windows 版 ChatGPT 桌面应用中的 Codex 打开了网站，却无法控制其标签页，并显示“可信 RPC 依赖项”错误，请在新的 Codex 对话中重试该任务。请保留现有对话，以供参考。请勿编辑或删除应用附带的浏览器文件或可信路径设置。
在 ChatGPT 桌面应用中使用 Codex 时遇到问题，可以在哪里找到故障排查帮助？
如果你在 ChatGPT 桌面应用中使用 Codex 时遇到问题，请参阅：故障排查。如需更多帮助，请联系 OpenAI 支持团队。
如何获取 Codex 企业分析的访问权限？
已启用 Codex 的 Enterprise 工作空间可以使用 Codex 企业分析。要使用该 API，请让工作空间所有者或管理员创建一个作用域限定为该工作空间、具有 codex.enterprise.analytics.read 权限的管理员密钥。
在管理控制台中，选择正确的 ChatGPT 工作空间，打开凭据 > 管理员密钥，然后将 Codex 分析 API 设置为读取。API 平台的组织密钥无法用于访问 ChatGPT 工作空间分析数据。
有关设置和权限的信息，请参阅：在管理控制台中管理管理员密钥。
有关端点的详细信息，请参阅：Codex 企业分析 API 参考文档。
ChatGPT 的文件上传、图像和语音限额是否适用于 Codex？
ChatGPT 的文件上传、图像生成和语音功能各有独立的使用限额、重置周期和横幅提示。例如，如果你看到“过去一天生成了 50 张图像”或“720 小时后重置”等横幅提示、达到语音使用上限，或在 ChatGPT 中上传文件时看到上传限额提示，这些限额都不适用于 Codex。
如需了解图像、视频和语音限额的详情，请参阅图像与视频生成限额和语音使用限额。如需了解 ChatGPT 文件上传限额及故障排查信息，请参阅文件上传常见问题。如需了解包括文件上传在内的各项 ChatGPT 服务状态，请查看 OpenAI 状态页面。
在桌面端的工作模式或 Codex 中使用 ChatGPT 语音时，语音用量单独计量；对于采用共享用量或额度的套餐，通过语音发起的任务则与工作模式和 Codex 共用同一智能体用量池。了解更多。
Codex 推荐邀请和储存的重置如何运作？
符合条件的用户可能会在个人资料菜单中看到 Codex 推荐邀请。个人套餐用户可能会看到邀请朋友，符合条件的 Business 工作空间成员可能会看到邀请同事。邀请对话框会显示当前优惠的详情，例如当前奖励、邀请限额、有效期及任何适用的受邀者要求。
对于部分 Plus 和 ChatGPT Pro 促销活动，成功推荐可以获得一次储存的 Codex 速率限制重置。如需使用储存的重置，请打开个人资料菜单，然后选择显示可用重置次数的用量摘要，例如有 1 次可用重置。
使用一次完整的储存重置会刷新您的 Codex 5 小时和每周用量周期，并更改每周重置日期。请前往“设置”→“用量”，查看更新后的重置时间。
推荐奖励因优惠和套餐而异。有关当前奖励、限额和资格详情，请参阅邀请朋友和同事及Codex 推荐促销活动。
如何在 Codex 中创建项目指令？
在 ChatGPT 桌面应用中使用 Codex 时，输入 /init 即可为当前项目生成 AGENTS.md 初始框架。此操作采用与 Codex CLI 相同的初始化流程。如需了解其他命令，请参阅：斜杠命令。
如果 Codex 工作时达到用量限额，会发生什么？
对于采用按 Token 计费并以美元结算的 Enterprise 工作空间，任务能否继续可能取决于工作空间预算和用户限额。请联系工作空间管理员，确认相关限额和可用选项。
对于包含配额或采用额度计费的方案，如果您在当前轮次中达到用量限额，Codex 可以在合理使用限制范围内继续完成该轮任务。该轮结束后，请查看 Codex 用量页面或限额横幅，了解您的方案可用的选项，例如添加额度、使用可用的重置机会、升级方案，或等待限额重置。
更多详情请参阅 Codex 用量限额。
Codex 中的 GPT-5.4 和 GPT-5.4 mini 有什么变化？
自 2026 年 8 月 31 日起，使用 ChatGPT 账号登录 Codex 时，将无法再使用 GPT-5.4 和 GPT-5.4 mini。
请将 GPT-5.4 替换为 GPT-5.6 Terra。
请将 GPT-5.4 mini 替换为 GPT-5.6 Luna。
请更新仍使用这些模型的工作空间默认设置、已保存的模型设置、托管配置或自动化任务。
此变更不影响 OpenAI API，也不影响使用自己的 API 密钥访问 Codex。
支持团队可以重置我的用量限额吗？
不可以。OpenAI 支持团队不会重置 ChatGPT 或 Codex 的用量限额。如果达到限额，请等待限额重置，或使用账户中显示的其他可用选项。
如果您认为用量计算有误，或在规定的重置时间后仍未恢复访问权限，请联系支持团队，以便我们调查。
一次性用量限额重置如何运作？
OpenAI 可能会不定期为符合条件的用户提供一次性的 Codex 或 ChatGPT 工作用量限额重置。资格条件、受影响的限额以及任何兑换或有效期要求可能因优惠而异。不保证以后还会提供重置。
自动重置会直接应用于公告所涵盖的用量限额。自动重置本身无法留待以后使用。重置应用后的用量将计入刷新后的用量额度。部分优惠还可能包含单独储存的重置。如果您获得了此类重置，请在账户或优惠中查看兑换方式和有效期详情。
如果您不符合一次性重置资格、未注意到已正确应用的重置，或未在规定有效期前使用储存的重置，我们不会仅因此提供额外重置、额度、退款或其他补偿。
如果用量似乎不正确、在规定的重置时间后仍未恢复访问权限，或者您认为自己有资格获得的重置未按说明应用，请联系支持团队。
为什么设置 approval_policy = "untrusted" 后 Codex 无法启动？
Codex 不再支持 untrusted 审批策略。如果配置中仍使用该策略，Codex 可能无法启动，并显示以下错误：approval_policy = "untrusted" is no longer supported; remove this setting.
此变更适用于 Codex CLI 0.149.0 及更高版本、macOS、Windows 和 Linux 上的 Codex 桌面应用 26.818.31338 及更高版本，以及 Codex VS Code 扩展 26.818.31338 及更高版本。
要解决此问题，请在 macOS 或 Linux 上打开 ~/.codex/config.toml，或在 Windows 上打开 %USERPROFILE%\.codex\config.toml，然后移除 approval_policy = "untrusted"。
还请检查当前使用的配置方案、组织托管的配置、allowed_approval_policies，以及使用 --ask-for-approval untrusted 的命令，确认是否仍引用了这一不再受支持的策略。
如果需要限制较严格的替代方案，可设置 sandbox_mode = "read-only" 和 approval_policy = "on-request"。
更新配置后，请重启 Codex。项目级的 trust_level = "untrusted" 设置是独立设置，仍受支持。