Codex Harness 配置参考

概述

Codex Harness 参考文档，覆盖 codex 插件的所有配置字段、传输选项、认证机制、模型发现和环境隔离。所有配置位于 plugins.entries.codex.config 下。

顶层配置字段：discovery（模型发现）、appServer（传输/认证/超时）、codexDynamicToolsLoading、codexDynamicToolsExclude、codexPlugins、computerUse
传输模式：stdio（默认，启动托管 Codex 二进制）或 WebSocket（连接已运行 app-server）
审批与沙箱模式：YOLO 模式（danger-full-access/never/user）或 Guardian 模式（workspace-write/on-request/auto_review）
模型发现：默认向 app-server 查询可用模型，失败时回退内置目录（GPT-5.5/5.4 mini/5.2）
工作区引导文件：转发 SOUL.md、TOOLS.md、IDENTITY.md、USER.md 等到 Codex developer instructions
环境隔离：CODEX_HOME 和 HOME 隔离到 per-agent 目录，clearEnv 可额外清除变量

appServer 关键字段：

字段	默认值	说明
`transport`	`"stdio"`	`"stdio"` 或 `"websocket"`
`mode`	`"yolo"`	`"yolo"` 或 `"guardian"`
`approvalPolicy`	`"never"`	原生 Codex 审批策略
`sandbox`	`"danger-full-access"`	原生 Codex 沙箱模式
`requestTimeoutMs`	`60000`	控制面调用超时
`turnCompletionIdleTimeoutMs`	`60000`	等待 `turn/completed` 的静默窗口
`serviceTier`	未设置	`"priority"` 快速路由，`"flex"` 弹性处理

模型发现配置：

{
  discovery: { enabled: true, timeoutMs: 2500 }
}

环境变量覆盖（本地测试用）：