配置键分组速查
按用途查找已展开的配置页，理解顶层键、示例值和完整 schema 的关系。
Codex 的主配置使用 TOML。顶层键必须在第一个表之前，否则会属于最近的表。示例里的模型、路径、URL 和限制值不等于产品默认值，复制时只选当前工作需要的段落。
模型和运行参数
| 键 | 用途 |
|---|---|
| model / model_provider | 模型与 provider ID |
| review_model | /review 的可选模型覆盖，未设置时使用会话模型 |
| model_reasoning_effort | 所选模型支持的推理强度 |
| plan_mode_reasoning_effort | Plan 模式的可选强度覆盖 |
| model_context_window | 手动声明上下文窗口，未设时按模型信息 |
| model_auto_compact_token_limit | 自动压缩阈值，未设时用模型默认 |
| model_catalog_json | 启动时从绝对路径读取自定义模型目录 |
| service_tier | 所选模型支持的速度/服务层 |
手动配置模型元数据不能提高模型真实能力。网关 alias 应与上游匹配，见网关配置。
按任务查配置
- 配置基础与Profiles：层次和一次性覆盖。
- Provider：认证、API 地址和 transport。
- 权限配置档与沙箱审批：文件和网络边界。
- 命令环境：环境变量筛选和显式设置。
- 终端与历史通知：交互行为。
- MCP、Hooks和Plugins：工具与扩展。
- Telemetry：事件、统计和反馈。
- 企业 requirements：不可由用户覆盖的约束。
校对完整字段
此页是分组入口，不宣称枚举全部内部配置。完整类型、枚举、成熟度与各产品支持范围查官方 Configuration Reference。官方 Sample Configuration 含默认、可选和推荐示例三类值，不应整体复制后误认为只是恢复默认。
配置不生效时先检查 TOML 所属表，再用 /debug-config 定位覆盖来源；受管 requirements、项目是否可信和当前选择的 profile 都可能改变结果。