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,也不反复打开窗口。必要的子代理沿用同一请求和原截止;本地命令带同一组三个接管环境值,不改用户级或机器级环境变量。回执丢了先查原请求,不自动重弹窗口或重新验证。入口真的报错时才去定向诊断。








