Skip to content

配置系统

Codex 的配置管理:config.toml 配置文件、JSON Schema 验证、多级配置合并。

涵盖内容

章节核心主题
概念配置文件结构、Schema 验证、配置优先级
练习配置编写、Schema 分析
代码走读配置解析代码走读

核心概念

配置系统控制 Codex 的运行时行为:

  • config.toml:主配置文件,定义模型、沙箱策略、MCP 服务器等
  • JSON Schema:配置文件的类型定义和验证规则
  • 多级配置:全局配置、项目配置、命令行参数的优先级合并
  • 默认值:合理的默认配置确保开箱即用

前置知识

  • 完成架构概览主题
  • TOML 配置格式
  • JSON Schema 基本概念

学习路径

读完本主题后,你将理解:

  • config.toml 的完整配置项和结构
  • JSON Schema 如何验证配置的合法性
  • 多级配置的合并规则和优先级
  • 配置如何影响代理的运行时行为

→ 下一步:应用服务器协议