Codex 适配
只对 Codex 有用的细则:规则从哪进、无限制授权怎么开、主持设计时怎样请本人定、子代理怎么派、升级后怎么认身份。

这个专题只补 Codex 和别处不一样的地方,AI 只在用到 Codex 特有机制时才读。最大的不同是分工:Codex 单独和本人聊时,它自己想、自己做,只有并行、量大或要全新上下文才开子代理。共同原则都在别的专题:派不派、派谁看分工与并行施工,能不能做看用户授权,重大的事动手前怎么把关看重大动作与本人验证;Claude 那边的同类细则在Claude 适配。

先认几个词
Hook:
本人每发一条新消息、Codex 每启动一个子代理时,自动运行的一小段检查程序,把当前状态写进对话给 AI 看。
个人资料状态:
本人的私人资料现在锁着还是在解锁期,见个人资料与数据处理。
无限制授权:
本人给某个对话开的限时授权,也叫本人接管,见约法 L16。
主对话:
本人直接对话的那个 AI,原文也叫“根会话”。Codex 的主对话可以是 GPT,也可以借AI工具配置管理换成别家模型,例如 DeepSeek、GLM、通义千问或本机模型。
把关:
重大的事动手前,由够格的模型确认一遍该不该做、要不要请本人验证。
codex-root、claude-root:
密码中心认得的两个受信任身份,分别是 Codex 桌面版和 Claude 桌面版。
Codex 适配
只对 Codex 有用的细则:规则从哪进、无限制授权怎么开、主持设计时怎样请本人定、子代理怎么派、升级后怎么认身份。

这个专题只补 Codex 和别处不一样的地方,AI 只在用到 Codex 特有机制时才读。最大的不同是分工:Codex 单独和本人聊时,它自己想、自己做,只有并行、量大或要全新上下文才开子代理。共同原则都在别的专题:派不派、派谁看分工与并行施工,能不能做看用户授权,重大的事动手前怎么把关看重大动作与本人验证;Claude 那边的同类细则在Claude 适配。

先认几个词
Hook:
本人每发一条新消息、Codex 每启动一个子代理时,自动运行的一小段检查程序,把当前状态写进对话给 AI 看。
个人资料状态:
本人的私人资料现在锁着还是在解锁期,见个人资料与数据处理。
无限制授权:
本人给某个对话开的限时授权,也叫本人接管,见约法 L16。
主对话:
本人直接对话的那个 AI,原文也叫“根会话”。Codex 的主对话可以是 GPT,也可以借AI工具配置管理换成别家模型,例如 DeepSeek、GLM、通义千问或本机模型。
把关:
重大的事动手前,由够格的模型确认一遍该不该做、要不要请本人验证。
codex-root、claude-root:
密码中心认得的两个受信任身份,分别是 Codex 桌面版和 Claude 桌面版。
人话要点 · 入口和无限制授权
入口和新消息
  • Codex 自己目录里的 AGENTS.md 由发布程序写进当前生效这一版的开场那一页(约法)和结尾“GPT 容易错的”那段,开对话就带着;专题按里面写的这一版的完整路径去读。开对话时的 Hook 只核对入口和生效版本:一致只回一句,不一致就提醒先读这一版的总规则,不再把约法全文塞进来。
  • 本人真发来的新消息,和自动续作、上下文压缩、工具返回的消息分开看;后三种不算新消息。
  • 个人资料状态由 Hook 带进来;缺失或投递不明时先用 StatusPersonalEnvironment 重读。根会话需要本人资料而锁着或不明时,第一步请本人验证,之后再查资料、派活和完整作答;子代理不自己验证,只交回实际缺口。纯技术工作照常。
  • 通过 MCP(外接工具接口)调用时,本机 Codex 原来的任务入口不变。新开对话、上下文压缩后和恢复时,按事实来源与任务上下文的长任务接续接上原来的任务状态,不往对话里塞决定短表或要求表;原生子代理压缩后没有这个接续事件时,也照那一节读原任务状态。
  • 技术上这是 SessionStart 的 startup、compact、resume 三种事件;Hook 找 Codex 家目录时先看 CODEX_HOME,没设才用 ~/.codex。
  • 新消息、Hook、子代理的真实身份和执行结果,都在本机正在用的入口核实;不凭标题、模型自称或别的 AI 留下的环境借身份。
  • 只读搜索不算用浏览器,直接做,不为此派子代理:查公开资料用自带的 web.run;在本人 Chrome 后台自动完成、不操作页面的只读站内搜索命令(例如 OpenCLI 的 search、hot、thread)也直接调用。
  • 要操作浏览器(在网页里点选、填表、看渲染后的页面、登录、截图)时,Codex 的主对话和它的原生子代理都不调桌面自带的浏览器工具,一律像 Claude 一样经共用包装器派 GPT 子代理去做,不用等原生名额满;派出的子代理要明确点名用本人的 Chrome(agent.browsers.get("chrome")),不用 getDefault()、getForUrl() 或应用内浏览器(iab)让运行时替它挑;应用内浏览器只用来看本机文件、本地预览,或本人这一轮点名要用时。后台标签页怎么开、Chrome 插件不通时修一次再交回、只有本机渲染自检能用无头,这些共同流程见能力与运行方式专题的浏览器一节。
  • Codex 的自动记忆关着:memories、generate_memories、use_memories 三个开关都是 false。要不要记、记到哪,收尾时按共享经验的落点判断;Codex 工具本身已核实的教训写进本专题。
  • 不碰 Claude 的登录和网页(本人禁令): 除非本人对相应动作单独授权,Codex 任何时候都不尝试登录 Claude,也不打开、拉取或读取 Claude 网页;用已登录的会话、浏览器、OpenCLI、子代理或别的工具代办,一样不行。提到 Opus、要求准备复核稿或要求复核,都不算授权。
  • 不操作本机 Claude Code(本人禁令): Codex 和它派出的代理不启动、不控制它,不读写它的会话和任务队列,不改它的运行配置,也不让脚本、其他 AI 或其他设备代办;测试、验收、复核和已有登录状态都不是例外。需要 Claude Code 协作时,给本人一条能直接复制的提示词,由本人决定转不转交。维护和同步它的规则文件、修外围启动器代码不算操作;实际启动、关闭或控制它,仍要本人对相应动作明确授权。
无限制授权
  • 本人要给当前 Codex 对话开无限制授权时,AI 直接打开密码中心的接管入口(由电脑配置与恢复装在本机),不先派个模型判断该不该开。
  • 实例:本人打“给这个对话开 8 小时无限制授权”或只打“无限制授权”,Hook 就当场替当前对话打开窗口;问“无限制授权是什么?”或者说“你需要无限制授权”,不会弹窗。
  • 只绑当前这个对话真实的编号,不借历史任务、MCP 连接或别的对话。
  • 入口生成这一次的配对和请求编号,借 Windows 自带的提权弹出一个独立窗口,本人只填时长(0.5–72 小时,默认时长照密码中心当前的设置);回执要写明这是无限制授权。
  • 本人验证完成后,由 Hook 自动读回并使用这份授权;AI 不手动一步步走配置、准备、激活、查状态,也不反复开窗口。
  • 确有必要的子代理沿用同一份请求和原来的截止时间;本地命令带上同一组三个接管值(会话引用、请求编号、截止时间),不改用户级或全机的环境变量。
  • 回执丢了先查原请求,不自动重新弹窗、也不让本人重新验证;入口真的报错才去针对性排查。
主持设计时怎样请本人定
  • 先查本任务已有的决定和授权。确有没定、又会改变本人实际体验的产品、界面、交互或视觉取舍,才请本人定;纯技术实现、前提没变的已有决定、本人明确委托 AI 选的,不重复问。
  • 先给一个完整、具体的推荐样子:本人会看到什么、按什么得到什么,需要时用图或能体验的样板;有几个真选项列几个,最多 2–3 个,讲清各自的用途和实际影响,单列“AI 建议”和理由;只有一种合理做法,给一句样子和建议就行。
  • 用汇报页现有的问题、选项和建议栏提问,保留每题“我的说明”;本人答复后再做依赖这个决定的部分,不依赖答案的已授权工作继续。
  • 默认值和 AI 的偏好不算本人拍板;不把复制按钮这类普通实现编成审批题。本人明确委托时,由 AI 择优并标“AI 建议”。
人话要点 · 入口和无限制授权
入口和新消息
  • Codex 自己目录里的 AGENTS.md 由发布程序写进当前生效这一版的开场那一页(约法)和结尾“GPT 容易错的”那段,开对话就带着;专题按里面写的这一版的完整路径去读。开对话时的 Hook 只核对入口和生效版本:一致只回一句,不一致就提醒先读这一版的总规则,不再把约法全文塞进来。
  • 本人真发来的新消息,和自动续作、上下文压缩、工具返回的消息分开看;后三种不算新消息。
  • 个人资料状态由 Hook 带进来;缺失或投递不明时先用 StatusPersonalEnvironment 重读。根会话需要本人资料而锁着或不明时,第一步请本人验证,之后再查资料、派活和完整作答;子代理不自己验证,只交回实际缺口。纯技术工作照常。
  • 通过 MCP(外接工具接口)调用时,本机 Codex 原来的任务入口不变。新开对话、上下文压缩后和恢复时,按事实来源与任务上下文的长任务接续接上原来的任务状态,不往对话里塞决定短表或要求表;原生子代理压缩后没有这个接续事件时,也照那一节读原任务状态。
  • 技术上这是 SessionStart 的 startup、compact、resume 三种事件;Hook 找 Codex 家目录时先看 CODEX_HOME,没设才用 ~/.codex。
  • 新消息、Hook、子代理的真实身份和执行结果,都在本机正在用的入口核实;不凭标题、模型自称或别的 AI 留下的环境借身份。
  • 只读搜索不算用浏览器,直接做,不为此派子代理:查公开资料用自带的 web.run;在本人 Chrome 后台自动完成、不操作页面的只读站内搜索命令(例如 OpenCLI 的 search、hot、thread)也直接调用。
  • 要操作浏览器(在网页里点选、填表、看渲染后的页面、登录、截图)时,Codex 的主对话和它的原生子代理都不调桌面自带的浏览器工具,一律像 Claude 一样经共用包装器派 GPT 子代理去做,不用等原生名额满;派出的子代理要明确点名用本人的 Chrome(agent.browsers.get("chrome")),不用 getDefault()、getForUrl() 或应用内浏览器(iab)让运行时替它挑;应用内浏览器只用来看本机文件、本地预览,或本人这一轮点名要用时。后台标签页怎么开、Chrome 插件不通时修一次再交回、只有本机渲染自检能用无头,这些共同流程见能力与运行方式专题的浏览器一节。
  • Codex 的自动记忆关着:memories、generate_memories、use_memories 三个开关都是 false。要不要记、记到哪,收尾时按共享经验的落点判断;Codex 工具本身已核实的教训写进本专题。
  • 不碰 Claude 的登录和网页(本人禁令): 除非本人对相应动作单独授权,Codex 任何时候都不尝试登录 Claude,也不打开、拉取或读取 Claude 网页;用已登录的会话、浏览器、OpenCLI、子代理或别的工具代办,一样不行。提到 Opus、要求准备复核稿或要求复核,都不算授权。
  • 不操作本机 Claude Code(本人禁令): Codex 和它派出的代理不启动、不控制它,不读写它的会话和任务队列,不改它的运行配置,也不让脚本、其他 AI 或其他设备代办;测试、验收、复核和已有登录状态都不是例外。需要 Claude Code 协作时,给本人一条能直接复制的提示词,由本人决定转不转交。维护和同步它的规则文件、修外围启动器代码不算操作;实际启动、关闭或控制它,仍要本人对相应动作明确授权。
无限制授权
  • 本人要给当前 Codex 对话开无限制授权时,AI 直接打开密码中心的接管入口(由电脑配置与恢复装在本机),不先派个模型判断该不该开。
  • 实例:本人打“给这个对话开 8 小时无限制授权”或只打“无限制授权”,Hook 就当场替当前对话打开窗口;问“无限制授权是什么?”或者说“你需要无限制授权”,不会弹窗。
  • 只绑当前这个对话真实的编号,不借历史任务、MCP 连接或别的对话。
  • 入口生成这一次的配对和请求编号,借 Windows 自带的提权弹出一个独立窗口,本人只填时长(0.5–72 小时,默认时长照密码中心当前的设置);回执要写明这是无限制授权。
  • 本人验证完成后,由 Hook 自动读回并使用这份授权;AI 不手动一步步走配置、准备、激活、查状态,也不反复开窗口。
  • 确有必要的子代理沿用同一份请求和原来的截止时间;本地命令带上同一组三个接管值(会话引用、请求编号、截止时间),不改用户级或全机的环境变量。
  • 回执丢了先查原请求,不自动重新弹窗、也不让本人重新验证;入口真的报错才去针对性排查。
主持设计时怎样请本人定
  • 先查本任务已有的决定和授权。确有没定、又会改变本人实际体验的产品、界面、交互或视觉取舍,才请本人定;纯技术实现、前提没变的已有决定、本人明确委托 AI 选的,不重复问。
  • 先给一个完整、具体的推荐样子:本人会看到什么、按什么得到什么,需要时用图或能体验的样板;有几个真选项列几个,最多 2–3 个,讲清各自的用途和实际影响,单列“AI 建议”和理由;只有一种合理做法,给一句样子和建议就行。
  • 用汇报页现有的问题、选项和建议栏提问,保留每题“我的说明”;本人答复后再做依赖这个决定的部分,不依赖答案的已授权工作继续。
  • 默认值和 AI 的偏好不算本人拍板;不把复制按钮这类普通实现编成审批题。本人明确委托时,由 AI 择优并标“AI 建议”。
人话要点 · 派子代理:Codex 的不同处

普通派活时,桌面子代理名额真满了,才自动改用现成的 GPT 包装器接能做的活;登录、参数、网络这类故障先修真原因,不当成满了。唯一例外是主对话上下文压缩后自动做的那次只读复核:它是已授权的自动任务,直接用共用的 GPT 后台包装器,记真实的 Codex 父会话号,不用等名额满,也不因此让别的任务这样调用(完整流程见事实来源与任务上下文的“压缩后的后台复核”)。它仍是当前主对话管的后台任务,不另开顶层对话;型号、权限和任务范围不放宽。包装器记的是 Codex 当前任务的完整编号,不借 Claude 的会话号;接着做时接回原来那一份,不重开一份。新版包装器一次后台订阅后内部续等;Start 默认返回,要等加 -Wait;Watch 可在任一任务结束时叫醒,Resume 沿用原线程。怎么派一单(命令、单子模板、怎么等、怎么验收)见 dispatch-work 技能,和 Claude 派单一样:能问不等、必需的文件能改、到时限只叫醒;主对话是 Sol 自己写时没有单子,交付时报加删行数、看能不能更简。派活单写清范围、授权、代码与测试上限、时限和验收方式;子任务要以本人身份和真人说话(客服、商家、卖家、房东、平台人工、微信联系人)或替本人拟要发出的消息时,派活单必须写一行“和真人说话按 reply-as-me”(即替我拟消息的规矩);出处、方案和成本估算等栏可选,不因缺栏拒派;扩时和放宽行数写理由。原生子代理和包装器子任务都一样:规则由根会话或包装器核验,子代理按需读给定版本的专题;出处由根会话负责,子代理不查出处、不报“无出处”,只按派单交付。同额度下主对话还能调用时,子代理报额度用完就在原线程接着做;主对话也调不动才算真的用完,提醒本人换账号。等候、额度和停止的共同办法见分工与并行施工。

Codex 的主对话、原生子代理和包装器子任务碰到已授权的步骤要管理员权限时,都直接静默提权做完(做法见用户授权的“申请管理员权限”),不停下、不交回主对话;派活时不用另写这一条。

Codex 和它的子代理没有本人在当前对话的明确授权,不调 Claude 的 API,不运行 Invoke-ClaudeApiChild.ps1,也不从密码中心取 Anthropic 密钥或另找路子;Claude 的 API 只在本人说“派API”时由 Claude 主对话使用(见Claude 适配)。

主对话是 GPT 时
  • 桌面子代理有空位时,用 spawn_agent,按任务选 GPT-6 Luna、GPT-6.1 Sol 或 GPT-6 Astra,显式写 model 和 reasoning_effort:现在模型清单里,GPT-6.1 Sol 只读、步骤简单、代码上限为 0 的小单,以及给定材料的摘录对齐和调用链已定的机械流程填 medium,施工、要判断的分析和难活填 ultra(不用 high);GPT-6 Luna 只照写好的提示生图、落盘,填 low,它以前的 max 等档位不再作为派单依据;Sol、Astra 原来派 xhigh 的改填 ultra;派完核对实际启动值。
  • 跨型号、跨档位时不带或只带有限历史;只有参数相同、完整历史确有用时才全带。
主对话是别家模型时
  • 桌面子代理有空位时,用 openai_child 只派 Sol、Terra、Luna,不派 Astra;入口由AI工具配置管理提供。
  • 写明类型、型号、档位、任务名和交代,不传 fork_turns。续聊走同一入口;回话、查看、等待、停止各走它对应的控制入口。
  • 子代理要再分工,回原父任务安排。Claude 派 Astra 的授权条件不套到这里,见约法 L23。
  • 鉴权、参数、上下文等入口故障先修真实原因;主对话继续能做的部分,不乱换型号或绕过真实限制。
重大动作前的把关
  • 资格与职责见重大动作与本人验证。主对话够格就自己判断;确需另派只交这次判断,不顺手实施或再委派。
  • 别家主模型的可派范围仍是 Sol、Terra、Luna,不因把关职责扩大;独立复核另按共同原则安排。
不自行新建顶层对话
  • Codex 不调用 create_thread,也不用别的办法新建侧栏里的独立对话,分工用当前对话下的子代理(本人 2026-11-05 要求)。发现规矩、流程、工具这类项目整体的毛病,也在当前对话下交独立子代理处理。
  • 本人说联系、交给、转给某个对话(或“合适的对话”),是把事发给那个已经开着的对话或线程,不新开;确实找不到是哪个,再问本人一句。
人话要点 · 派子代理:Codex 的不同处

普通派活时,桌面子代理名额真满了,才自动改用现成的 GPT 包装器接能做的活;登录、参数、网络这类故障先修真原因,不当成满了。唯一例外是主对话上下文压缩后自动做的那次只读复核:它是已授权的自动任务,直接用共用的 GPT 后台包装器,记真实的 Codex 父会话号,不用等名额满,也不因此让别的任务这样调用(完整流程见事实来源与任务上下文的“压缩后的后台复核”)。它仍是当前主对话管的后台任务,不另开顶层对话;型号、权限和任务范围不放宽。包装器记的是 Codex 当前任务的完整编号,不借 Claude 的会话号;接着做时接回原来那一份,不重开一份。新版包装器一次后台订阅后内部续等;Start 默认返回,要等加 -Wait;Watch 可在任一任务结束时叫醒,Resume 沿用原线程。怎么派一单(命令、单子模板、怎么等、怎么验收)见 dispatch-work 技能,和 Claude 派单一样:能问不等、必需的文件能改、到时限只叫醒;主对话是 Sol 自己写时没有单子,交付时报加删行数、看能不能更简。派活单写清范围、授权、代码与测试上限、时限和验收方式;子任务要以本人身份和真人说话(客服、商家、卖家、房东、平台人工、微信联系人)或替本人拟要发出的消息时,派活单必须写一行“和真人说话按 reply-as-me”(即替我拟消息的规矩);出处、方案和成本估算等栏可选,不因缺栏拒派;扩时和放宽行数写理由。原生子代理和包装器子任务都一样:规则由根会话或包装器核验,子代理按需读给定版本的专题;出处由根会话负责,子代理不查出处、不报“无出处”,只按派单交付。同额度下主对话还能调用时,子代理报额度用完就在原线程接着做;主对话也调不动才算真的用完,提醒本人换账号。等候、额度和停止的共同办法见分工与并行施工。

Codex 的主对话、原生子代理和包装器子任务碰到已授权的步骤要管理员权限时,都直接静默提权做完(做法见用户授权的“申请管理员权限”),不停下、不交回主对话;派活时不用另写这一条。

Codex 和它的子代理没有本人在当前对话的明确授权,不调 Claude 的 API,不运行 Invoke-ClaudeApiChild.ps1,也不从密码中心取 Anthropic 密钥或另找路子;Claude 的 API 只在本人说“派API”时由 Claude 主对话使用(见Claude 适配)。

主对话是 GPT 时
  • 桌面子代理有空位时,用 spawn_agent,按任务选 GPT-6 Luna、GPT-6.1 Sol 或 GPT-6 Astra,显式写 model 和 reasoning_effort:现在模型清单里,GPT-6.1 Sol 只读、步骤简单、代码上限为 0 的小单,以及给定材料的摘录对齐和调用链已定的机械流程填 medium,施工、要判断的分析和难活填 ultra(不用 high);GPT-6 Luna 只照写好的提示生图、落盘,填 low,它以前的 max 等档位不再作为派单依据;Sol、Astra 原来派 xhigh 的改填 ultra;派完核对实际启动值。
  • 跨型号、跨档位时不带或只带有限历史;只有参数相同、完整历史确有用时才全带。
主对话是别家模型时
  • 桌面子代理有空位时,用 openai_child 只派 Sol、Terra、Luna,不派 Astra;入口由AI工具配置管理提供。
  • 写明类型、型号、档位、任务名和交代,不传 fork_turns。续聊走同一入口;回话、查看、等待、停止各走它对应的控制入口。
  • 子代理要再分工,回原父任务安排。Claude 派 Astra 的授权条件不套到这里,见约法 L23。
  • 鉴权、参数、上下文等入口故障先修真实原因;主对话继续能做的部分,不乱换型号或绕过真实限制。
重大动作前的把关
  • 资格与职责见重大动作与本人验证。主对话够格就自己判断;确需另派只交这次判断,不顺手实施或再委派。
  • 别家主模型的可派范围仍是 Sol、Terra、Luna,不因把关职责扩大;独立复核另按共同原则安排。
不自行新建顶层对话
  • Codex 不调用 create_thread,也不用别的办法新建侧栏里的独立对话,分工用当前对话下的子代理(本人 2026-11-05 要求)。发现规矩、流程、工具这类项目整体的毛病,也在当前对话下交独立子代理处理。
  • 本人说联系、交给、转给某个对话(或“合适的对话”),是把事发给那个已经开着的对话或线程,不新开;确实找不到是哪个,再问本人一句。
人话要点 · 状态和升级
新消息里的状态
  • 本人每发一条真消息、Codex 每启动一个子代理,Hook 读一次当前的个人资料状态和本人接管状态,并告诉 Codex 本会话能核实的型号和思考档位。
  • 这一轮读不到的就写“未知”;子代理启动时档位一律写“未知”,不借父会话的记录。为什么:派生的子代理,记录开头复制了一份父会话的设置,照着读就会把父会话的档位当成自己的。
  • 资料锁着、未知或 Hook 出错时,根会话先重读状态;需要本人资料就先请本人验证,之后再查资料、派活和完整作答。子代理不自己验证,读取被拦、途中缺资料或到期时单行交回“需要本人资料:……”,根会话读报告处理;两者都不给降级回答,纯技术工作继续。
  • 本人接管只认正式入口读回的那份授权和原来的截止时间。
  • Hook 不按任务替 AI 决定型号的职责、档位和要不要派子代理,也不另设一本“派发许可”的登记;派发参数里已登记的前代型号和兼容档位,它按统一的模型登记换成当前值,并保留原请求。原生旧代理确实没法换型续作时,它明确返回“要迁移”(model_migration_required),由主对话交给当前型号接着做。
  • 现在有受管 Stop:从本轮真实汇报核对目标、版本、验收和缺口;有限读当前轮末尾,认真实业务的 blocked 与保护原因码,不认只读状态、子报告、源码、搜索例子或模型措辞。未实际发起解锁就拦下相应业务;普通技术任务无此信号直接放行。只向根会话给验证指令,同轮第二次只提示,最多 45 秒;解析或轮次核验失败仅放行受影响项并诊断,不输出对话、思考和报告。
官方升级
  • Codex 的版本号、构建号、带版本号的安装目录和更新批次,都不能拿来卡“能不能用”。
  • 密码中心顺着本人 Windows 账户里真实的进程祖先链往上找,找到登记过的 Codex 桌面应用本体,日常调用就自动认作 codex-root。
  • 实例:认的是 OpenAI.Codex 这个软件包里的 ChatGPT.exe 本体;同一个包里的命令行程序单独跑,不算。
  • 从 Claude 桌面版启动的 Codex 子进程,按它上面的 Claude 桌面版认作 claude-root,不按模型名字换身份。
  • 官方更新后仍按同一账户、同一软件包和桌面本体核验,不用重新绑定密钥。
  • 受管 Hook 的内容哈希只保护 Hook 自己:Hook 启动时先比对自己的哈希,对不上就只报“状态未知”,普通工作照常。
  • 缺了可选的宿主信息,只让依赖它的那一项变成不明或不可用,普通项目照常。
人话要点 · 状态和升级
新消息里的状态
  • 本人每发一条真消息、Codex 每启动一个子代理,Hook 读一次当前的个人资料状态和本人接管状态,并告诉 Codex 本会话能核实的型号和思考档位。
  • 这一轮读不到的就写“未知”;子代理启动时档位一律写“未知”,不借父会话的记录。为什么:派生的子代理,记录开头复制了一份父会话的设置,照着读就会把父会话的档位当成自己的。
  • 资料锁着、未知或 Hook 出错时,根会话先重读状态;需要本人资料就先请本人验证,之后再查资料、派活和完整作答。子代理不自己验证,读取被拦、途中缺资料或到期时单行交回“需要本人资料:……”,根会话读报告处理;两者都不给降级回答,纯技术工作继续。
  • 本人接管只认正式入口读回的那份授权和原来的截止时间。
  • Hook 不按任务替 AI 决定型号的职责、档位和要不要派子代理,也不另设一本“派发许可”的登记;派发参数里已登记的前代型号和兼容档位,它按统一的模型登记换成当前值,并保留原请求。原生旧代理确实没法换型续作时,它明确返回“要迁移”(model_migration_required),由主对话交给当前型号接着做。
  • 现在有受管 Stop:从本轮真实汇报核对目标、版本、验收和缺口;有限读当前轮末尾,认真实业务的 blocked 与保护原因码,不认只读状态、子报告、源码、搜索例子或模型措辞。未实际发起解锁就拦下相应业务;普通技术任务无此信号直接放行。只向根会话给验证指令,同轮第二次只提示,最多 45 秒;解析或轮次核验失败仅放行受影响项并诊断,不输出对话、思考和报告。
官方升级
  • Codex 的版本号、构建号、带版本号的安装目录和更新批次,都不能拿来卡“能不能用”。
  • 密码中心顺着本人 Windows 账户里真实的进程祖先链往上找,找到登记过的 Codex 桌面应用本体,日常调用就自动认作 codex-root。
  • 实例:认的是 OpenAI.Codex 这个软件包里的 ChatGPT.exe 本体;同一个包里的命令行程序单独跑,不算。
  • 从 Claude 桌面版启动的 Codex 子进程,按它上面的 Claude 桌面版认作 claude-root,不按模型名字换身份。
  • 官方更新后仍按同一账户、同一软件包和桌面本体核验,不用重新绑定密钥。
  • 受管 Hook 的内容哈希只保护 Hook 自己:Hook 启动时先比对自己的哈希,对不上就只报“状态未知”,普通工作照常。
  • 缺了可选的宿主信息,只让依赖它的那一项变成不明或不可用,普通项目照常。

原文 · E389 版,一字不改

Codex 适配

owner: E:\.agents

只在用到 Codex 特有机制时读;共同原则见其他专题。

入口和新消息

Claude 登录与网页(本人禁令,源消息 01a19bbb-5824-71d2-bbc1-eca9aebe1c36): 除非本人对相应动作单独授权,Codex 在任何时候都不得尝试登录 Claude,也不得打开、拉取或读取 Claude 网页。自行操作、使用已登录会话、调用浏览器或 OpenCLI、委派子代理或通过其他工具代为操作,都受同一禁令约束。提到 Opus、要求准备复核稿或要求复核,本身不授权登录或访问网页。

Codex home 里的 AGENTS.md 由发布器写入活动版本的完整约法和导航,加载入口时就已在上下文中;专题按文中当版的绝对路径读取。Hook 定位 Codex home 时优先用 CODEX_HOME,未设置时用 ~/.codex。开场 Hook 只核对入口和活动版本,一致只给短回执,不一致按提醒先读本版根规则,不再注入约法全文。真实的新消息和自动续作、上下文压缩、工具消息分开看;Hook 会把个人资料状态带进来,Hook 缺失或投递不明时资料状态按不明处理;不明或锁着时怎么办按个人资料的锁和解锁。调用 MCP 不改变本机 Codex 原来的任务入口。新消息、Hook、子代理的真实身份和执行结果从本机现役入口核实,不从标题、模型自述或别的宿主遗留的环境借身份。

SessionStart 的 startup/compact/resume 按长任务接续执行,不注入决定短表或要求表;原生子代理压缩跳过 SessionStart 时,也按该节读原任务状态。

根会话压缩后的只读复核按共用复核规则执行。此项已授权自动任务使用共用 GPT 后台包装器,并保留真实 Codex 父会话号;不受普通派发的“原生满槽才转包装器”条件限制,不扩大其他任务的调用范围。程序换窗是否触发与原生压缩分开核验,具体入口见运维说明(E:/.agents/docs/operations/context-hooks.md)。

Codex 自动记忆的关闭配置是 memories=false、generate_memories=false、use_memories=false;需要留下的内容统一按共享经验的落点处理,Codex 工具的已核实教训归本专题。

浏览器:搜索本身不算用浏览器,直接做、不为此派子代理:只读查公开资料用自带的 web.run;在本人 Chrome 后台自动完成、不操作页面的只读站内搜索命令(例如 OpenCLI 的 search、hot、thread)也直接调用。Codex 桌面版的主对话和它用原生机制派的子代理,要操作浏览器(在网页里点选、填表、看渲染后的页面、登录、截图)时,都不调用桌面自带的浏览器工具(Chrome 插件、电脑操作插件的 cua_repl、应用内浏览器),一律和 Claude 一样,用共用包装器(#原生容量不足时转用共用包装器)派 GPT 子代理去做:带 -ParentHarness Codex 和当前真实父任务完整编号,型号和档位按 config/model-roster.json 的浏览器场景;这类网页任务不受“原生满槽才转包装器”的限制,派单按“派活松紧怎么定”写目标、已知事实、底线和完成标准,页面或入口只作参考,不叫子代理改用 cua_repl。包装器派出的子代理用 agent.browsers.get("chrome") 在本人 Chrome 自己新开的后台标签页里操作,不用 getDefault()、getForUrl() 或 iab 让运行时代选。应用内浏览器只用于本机文件、本地预览或本人当轮点名时。本机渲染范围与子代理连不上时的处理按浏览器规则执行。这是可由本人当场改的默认。

Codex 主持设计时怎样请本人定

  • 先查本任务已有决定和授权。确有未定、会改变本人实际体验的产品、界面、交互或视觉取舍时,才请本人定;纯技术实现、前提未变的已有决定、本人明确委托 AI 选择的,不凑题、不重复问。
  • 先给一个完整、具体的推荐样子,写清本人会看到什么、按什么得到什么;需要时用图或可体验的样板表达。给出真正不同的备选,讲清各自的用途和实际影响,并单列“AI 建议”和理由。
  • 用汇报页现有 questions、options 和 advice 提问,保留每题“我的说明”;等本人答复后再施工依赖该决定的部分,不依赖答案的已授权工作继续。
  • 默认值和 AI 偏好不算本人拍板;不为凑题把复制按钮等普通实现编成审批题。本人明确委托 AI 选择时,由 AI 择优并标“AI 建议”。

读取聊天结果

仅查看进度时优先用 wait_threads 的紧凑快照;确需正文才用 read_thread。turnLimit 限制轮数,maxOutputCharsPerItem 约束工具说明列出的单项输出或聊天消息,都不是总输出大小保证。

read_thread 的消息 id 可能与原话存档的 uuid 不同;登记源消息 UUID 时,按对应原话存档的 uuid 填写,不能直接拿读取结果的 id 替代。

在 functions.exec 内解析返回的 JSON,只输出本次所需字段或消息,并对输出设总字数上限;更多内容按游标或明确选择续取,不直接 text 整个结果或把原始大数组回灌上下文。调用参数以当前工具能力为准;必须完整阅读的规则或原文仍要分段取齐。

定时任务和收尾

  • Codex 定时任务每跑一轮,同样用结论回执命令把一句人话结论写进驾驶舱,见能力与运行方式“定时任务的结论写进驾驶舱”。
  • Codex 没有结构化的收尾工具:本轮有要本人定或做的事时,最后一条回复的最后一行写“【等你】<一句人话>”,钩子据此登记驾驶舱、本人回复后关闭;没有等本人的事就不写这一行。

无限制授权

本人要给当前 Codex 对话开无限制授权时,直接运行 PCConfig 安装好的 Invoke-OwnerTakeover.ps1 -Operation Open,不先派模型判断。HostTaskId 只传当前宿主真实的线程 ID,不借历史任务、MCP 连接或别的对话。Open 会生成这次的配对和请求编号,用 Windows 现有的提权能力,弹出独立窗口让本人只填时长;回执里应有 grant_type=unrestricted。本人验证完成后,由 Hook 自动回读并使用这份授权(CheckHost);模型不手动串 Configure/Prepare/Activate/Status/Check,也不反复打开窗口。必要的子代理沿用同一请求和原截止;本地命令带同一组三个接管环境值,不改用户级或机器级环境变量。回执丢了先查原请求,不自动重弹窗口或重新验证。入口真的报错时才去定向诊断。

原文 · E389 版 · 续

派子代理:Codex 的不同处

共同原则见分工与并行施工,可派范围见 config/model-roster.json。 原生子代理和包装器子任务统一按子代理原则及派活松紧怎么定交付;核验由根或包装器完成,子代理按需读给定版本的专题。

Codex 根会话、原生子代理和包装器子任务遇到已授权步骤要管理员时,同样直接按长期授权“申请管理员权限”静默提权(首选 sudo pwsh -NoProfile -NonInteractive ...),不停下、不交回根会话;派活提示不必另写这条。

原生 GPT 的 reasoning_effort 按派子代理的原则“每次显式写型号和档位”一条和模型清单 routing.effort_rule 填写;其他厂商沿用各自设置。型号换代按新型号怎么调研重评。

  • 主对话是 GPT 时:根自己想、自己做,不把活再交给同样的型号,那只多丢一层;只有并行、量大、要全新上下文时才开子代理。要定方案:根是 Sol 交 Astra(思考摘要写一句“我要派 Astra”,途中和最后一条都说一声),根是 Astra 自己定。判断型复核:根是 Sol 交 Astra,根是 Astra 开全新上下文的 Astra。写给本人看的由根写,浏览器经包装器派 Sol,生图主对话直接做。子代理的单子写法、能问不等、必需的文件能改、到时限只叫醒,和 Claude 派单一样。根是 Sol 自己写时没有单子,交付时报加删行数、看能不能更简。容量够用时优先用原生子代理(spawn_agent),按模型清单 routing 的场景表和难度分级(表中的 GPT 型号)选型号和档位,可派型号、档位和适用范围见 hosts.codex.root_openai;表里写“交 Claude”的活怎么办见 routing.vendor_rule。显式传 model 和 reasoning_effort,派完核对实际启动值。跨型号或跨档位时 fork_turns 用 none 或有限轮数;只有身份参数相同、完整历史确实有用时才用 all。
  • 主对话是其他公司的模型时:可派型号见模型清单对应宿主的范围,不派 Astra。容量够用时优先调用宿主工具 openai_child,显式填写 agent_type、model、reasoning_effort、task_name、message,不传 fork_turns;续聊走同一入口,子代理回话走 openai_parent,查看、等待和停止走 openai_child_control。子代理要再分工时,回原父任务安排。约法 L23 里“实际调用按我给这个对话或项目的授权”说的是 Claude 调用 Codex,不给 Codex 自己派 GPT 子代理另加一次授权要求。入口因容量以外的原因不可用时,主对话继续能做的部分,说清实际缺口,不悄悄换模型,也不借别的通道绕过真实限制;容量不足按下面的例外办理。
  • 重大动作前的把关:型号、最低档位和职责统一见重大动作与本人验证。确实需要另派时,用当前宿主的普通子代理入口明确填写符合要求的型号和思考档位;主对话为其他公司的模型时仍从上面的可派范围选择,不凭把关职责扩大可派型号。独立复核按分工原则另行安排。
  • AICLI 配置和其他后端任务不是桌面原生子代理,不用来代替因鉴权、参数、上下文或真实能力限制而失败的 openai_child。仅宿主原生容量不足时,按下面的已授权例外转用共用包装器;其他失败按真实原因修好后继续,不随意换型号或通道。
  • 和真人说话:子任务要以本人身份和真人对话(客服、商家、卖家、房东、平台人工、微信联系人)或替本人拟要发出的消息时,派单必须写一行“和真人说话按 reply-as-me”。
  • “联系某个对话”是发给已开着的那个对话:本人说联系、交给、转给某个对话(或“合适的对话”),是把事发给那个已有对话或线程,不新开;确实找不到是哪个时再问本人一句。
  • Codex 不自行新建顶层对话(本人要求,2026-11-05,源消息 01a1a8b1-4edc-74c1-82a4-49e24bdf16be)。 不调用 create_thread 或通过其他方式新建侧栏里的独立对话;分工使用当前对话下的子代理。发现项目整体问题时,也在当前对话下安排独立子代理处理,不按共用规则另开顶层对话。
  • 不自己调 Claude 的 API。 Codex 及其子代理没有本人在当前对话的明确授权,不得调用 Claude 的 API,不运行 Invoke-ClaudeApiChild.ps1,也不从密码中心取 Anthropic 密钥或换别的路另辟蹊径;Claude 的 API 只在本人说“派API”时由 Claude 根会话按Claude 适配使用。

原生容量不足时转用共用包装器

实时确认宿主原生槽不足后,自动转用 E:\.agents\tools\Invoke-ClaudeGptChild.ps1,显式传 -ParentHarness Codex 和 -SessionId '<当前真实父任务完整编号>'。默认结果目录是 E:\Cache\Codex\Temp\<完整SessionId>\gpt-children,不借 Claude 会话号或截短编号。容量判断、回执不明时的核对、同额度子代理续作及后台管理统一见分工与并行施工的共用接续,不因入口改变扩大授权和业务范围。

$child = 'E:\.agents\tools\Invoke-ClaudeGptChild.ps1'
& $child -Mode Start -ParentHarness Codex -SessionId '<当前真实父任务完整编号>' -PromptFile '<任务.md绝对路径>' -Model gpt-6.1-sol -Effort ultra -NewWorktree -RepoPath '<仓库绝对路径>' -TaskName '<短名>' -ContinueOnQuota
& $child -Mode Watch -RunDirs @('<结果目录>')
& $child -Mode Resume -RunDir '<同一结果目录>' -PromptFile '<续作.md绝对路径>'

执行器监测、订阅、接续状态和参数用法只见派发说明(E:/.agents/docs/claude-gpt-child-dispatch.md),与 Claude 共用。

上例的 -ContinueOnQuota 只在同额度根会话仍能正常调用时启用;根会话也调不动时才是真的用完,按Claude 适配“模型调不动时按原因处理”提醒换账号。怎么派一单见 dispatch-work 技能,全部字段和参数见派发说明;修改仓库用任务专用工作树,只读用 -WorkDir '<已有目录>'。

新消息里的状态

Hook 每条真实新消息和子代理启动带来共享资料、本人接管及可核实的型号和档位;未知如实写,子代理启动不借父记录。根状态未知用 StatusPersonalEnvironment 回读;个人资料的判断、解锁和缺口交回按资料锁与派子代理的原则“根核验规则和判断资料需求”一条,纯技术工作继续。

Stop 与 Claude 共用版本、明确 Report 目标集合、验收和资料缺口检查;首次拦截按真实原因补解锁或验收,同轮第二次只提示。边界核验失败只放行受影响检查并留诊断码。Hook 不按任务自行决定模型职责、档位或是否委派,不加派发许可、不按关键词弹验证;结构化派发参数中的已登记前代和兼容档位,由 Hook 按统一模型登记规范化并保留原请求。原生旧代理确实无法换型续作时,返回 model_migration_required,由根按所有入口一起换代接续,不绕宿主限制。具体接线见状态钩子(E:/.agents/docs/operations/context-hooks.md#个人资料先解锁与结束兜底)。

官方升级

Codex 的版本号、构建号、带版本的安装目录和更新批次都不能当可用性门槛。密码中心沿本人 Windows 账户的真实祖先链识别登记包族的 Codex 桌面应用本体,日常调用自动选择 codex-root;从 Claude 桌面启动的 Codex 子进程按其 Claude 祖先识别为 claude-root,不按模型名称改换主体。官方更新后仍按同一账户、包族和桌面本体核验,无需运行时密钥续绑。受管 Hook 的内容哈希只保护 Hook 自身;缺了可选的宿主信息,只让依赖它的那项能力变成不明或不可用,普通项目照常。

完整尺寸