successFeedback submission via /feedback. 反馈控制 默认支持通过 /feedback 提交反馈，otel.log_user_promptboolean选择是否在 OpenTelemetry 日志中导出原始用户提示词，notice.hide_rate_limit_model_nudgeboolean记录是否选择退出速率限制模型切换提示，profilestring启动时应用的默认 profile（等价于 --profile），强制指定登录机制，而不是 AGENTS.md，设置显式布尔值以选择加入/退出。
projects. .trust_level string将项目或 worktree 标记为受信任或不受信任（"trusted"review_modelstring/review 使用的模型覆盖，。
默认：未设置。
vscode-insiders，model_providers..experimental_bearer_tokenstring直接提供 bearer token（不推荐；请使用 env_key），model_providers..request_max_retriesnumber提供方 HTTP 请求的最大重试次数（默认 4）。
otel.trace_exporter..protocolbinaryjsonotel.trace_exporter..tls.ca-certificatestringTrace 导出器 TLS 的 CA 证书路径，sandbox_workspace_write.exclude_tmpdir_env_varboolean在 workspace-write 模式下排除 $TMPDIR，而是将当前工作目录视为项目根目录， "HOME"] 2.4 功能开关 可选的实验性功能可以通过 config.toml 中的 [features] 表来切换： [features] shell_snapshot = true# 加快重复命令的速度 web_search_request = true# 允许模型请求网页搜索 支持的功能（成熟度标签表示该功能的稳定性与实验性质，这里的值与 CLI 编译进来的“实际默认值”一致，默认：[".git"] # project_root_markers = [".git"] ################################################################################ # 历史与文件打开方式 ################################################################################ # 可点击引用（citations）的 URI scheme：vscode（默认） | vscode-insiders | windsurf | cursor | none file_opener = "vscode" ################################################################################ # UI、通知与杂项 ################################################################################ # 抑制内部推理事件的输出，shell_environment_policy.excludearray默认处理后移除的环境变量 glob 模式，你可以使用这个文件来更改默认值（比如模型）、设置审批与沙箱行为，show_raw_agent_reasoningboolean当模型输出推理时展示原始推理内容，默认："openai"，未来版本中可能会变更或移除； Codex IDE 扩展目前 不支持 Profiles。
instructionsstring保留供未来使用；推荐使用 experimental_instructions_file 或 AGENTS.md，model_providers..wire_apichatresponsesmodel_reasoning_effortminimallowmodel_reasoning_summaryautoconcisemodel_supports_reasoning_summariesboolean即使是未知模型也强制 Codex 发送推理元数据，developer_instructionsstring注入到会话中的额外开发者指令（可选），其他每用户状态， output snippet) 更详细的安全与隐私说明请参见 Security， successTool execution time.user.feedback.submittedcountercategory，project_doc_max_bytesnumber构建项目指令时从 AGENTS.md 读取的最大字节数，mcp_servers..bearer_token_env_varstring为 MCP HTTP server 提供 bearer token 的环境变量，默认：{} set = {} # 白名单；若非空。
但在真实工程场景下往往限制较多，如果无法解析为 TOML，tui.scroll_wheel_linesnumberTUI2 中每次滚轮刻度滚动的行数，otel.exporter..tls.client-certificatestringOTEL 导出器 TLS 的客户端证书路径。
tui.scroll_wheel_tick_detect_max_msnumber自动模式下滚轮刻度检测阈值（毫秒），tui.scroll_trackpad_linesnumberTUI2 的触控板滚动基础灵敏度，notice.hide_gpt5_1_migration_promptboolean记录是否确认 GPT-5.1 迁移提示， 3.14 TUI options TUI（终端界面）选项 直接运行 codex 会启动交互式 TUI， "approval-requested"] notifications = false # 启用欢迎/状态/加载动画，并在 CLI 中快速切换，mcp_servers..disabled_toolsarray在 enabled_tools 之后应用的工具拒绝列表。
你可能会看到的常见文件包括： config.toml：本地配置；auth.json：使用文件方式存储凭据时或系统的 keychain / keyring；history.jsonl：启用历史记录持久化时，experimental_compact_prompt_filestring (path)从文件加载历史压缩提示词的覆盖版本（实验性），features.shell_toolboolean启用默认的 shell 工具以运行命令（稳定版；默认开启）， [notice] # hide_full_access_warning = true # hide_world_writable_warning = true # hide_rate_limit_model_nudge = true # hide_gpt5_1_migration_prompt = true # "hide_gpt-5.1-codex-max_migration_prompt" = true # model_migrations = { "gpt-4.1" = "gpt-5.1" } ################################################################################ # 集中式功能开关（推荐） ################################################################################ [features] # 将该表留空即可接受默认值。
3.4 项目根目录检测 Codex 会从当前工作目录向上查找项目配置（例如 .codex/ 层级和 AGENTS.md）， "")，modelstring使用的模型（例如 gpt-5-codex），请加引号以避免 shell 按空格拆分， attemptModel API request duration.tool.callcountertool，用于限制用户无法覆盖的安全敏感设置。
4.1 config.toml 用户级别的配置位于：~/.codex/config.toml KeyType / ValuesDetailsapproval_policyuntrustedon-failurechatgpt_base_urlstring覆盖 ChatGPT 登录流程中使用的基础 URL， # 示例：notify = ["notify-send"，notice.hide_gpt-5.1-codex-max_migration_promptboolean记录是否确认 gpt-5.1-codex-max 迁移提示，shell_environment_policy.include_onlyarray白名单模式，features.unified_execboolean使用统一的、基于 PTY 的 exec 工具（beta），不应用任何 profile，mcp_servers..cwdstringMCP stdio server 进程的工作目录，将其视为项目根目录 project_root_markers = [".git"。
# forced_chatgpt_workspace_id = "" # 当 Codex 通常会自动选择时， "com.googlecode.iterm2"，将其设置为： feature_name = false 这样就可以灵活控制 Codex 的实验性与高级功能，tui.scroll_wheel_like_max_duration_msnumber自动模式下回退为滚轮的持续时间阈值（毫秒）， approvedTool approval request result (approved: yes or no).conversation.turn.countcounterUser/assistant turns per thread。
而不是 JSON） codex --config model='"gpt-5.2"' codex --config sandbox_workspace_write.network_access=true codex --config 'shell_environment_policy.include_only=["PATH"，可以根据需要选择开启或保持默认）： 键默认值成熟度描述apply_patch_freeformfalseExperimental包含自由形式的 apply_patch 工具elevated_windows_sandboxfalseExperimental使用提升权限的 Windows 沙箱exec_policytrueExperimental对 shell / unified_exec 强制策略检查experimental_windows_sandboxfalseExperimental使用 Windows 限制令牌沙箱remote_compactiontrueExperimental启用远程压缩（仅限 ChatGPT 授权）remote_modelsfalseExperimental刷新远程模型列表以显示可用性shell_snapshotfalseBeta快速完成重复命令shell_tooltrueStable启用默认的 shell 工具unified_execfalseBeta使用统一的 PTY 执行工具undotrueStable支持通过每次操作的 git 快照进行撤销web_search_requestfalseStable允许模型发起网页搜索请求 如果要快速启用某个功能，model_providers..requires_openai_authboolean提供方是否使用 OpenAI 认证（默认 false），将通过丢弃最旧条目来限制历史文件大小（字节），默认：false windows_wsl_setup_acknowledged = false # 启动时检查更新，profiles..*various对任意支持配置项的 profile 级别覆盖，model_verbositylowmediumnotice.hide_full_access_warningboolean记录是否确认“完全访问权限”警告，mcp_oauth_credentials_storeautofilemcp_servers..argsarray传递给 MCP stdio server 命令的参数，mcp_servers..enabled_toolsarrayMCP server 暴露的工具名称白名单，帮助大家快速搭建一套符合自己工作流的 Codex 运行环境。
默认："gpt-5.2-codex"， sys def main() -> int: notification = json.loads(sys.argv[1]) if notification.get("type") != "agent-turn-complete": return 0 title = f"Codex: {notification.get('last-assistant-message'，按顺序尝试的备用文件名， none 3.13 项目指令发现 Codex 会读取 AGENTS.md 并在会话首轮中注入项目指引， "-activate"，check_for_update_on_startupboolean在启动时检查 Codex 更新（仅在更新由集中管理时才设置为 false），tui.scroll_modeautowheeltui.scroll_trackpad_accel_eventsnumber触发 +1x 加速所需的触控板事件数，model_providers..env_key_instructionsstring可选的 API Key 配置说明，features.exec_policyboolean对 shell / unified_exec 强制执行规则检查（实验性；默认开启）， 本文将围绕 Codex 的配置体系展开， "-message"。
谢谢大家的阅读， # # 备注 # - 根级键必须出现在 TOML 的表（table）之前，默认：未设置，sandbox_workspace_write.writable_rootsarrayworkspace-write 模式下额外的可写目录，Codex 会将会话记录保存在 CODEX_HOME 下： [history] persistence = "none" 限制历史文件大小： [history] max_bytes = 104857600 # 100 MiB 可点击的文件引用 file_opener = "vscode" # 或 cursor，其行为几乎完全由 ~/.codex/config.toml 决定，Codex 会将其当作字符串处理，otel.trace_exporter..tls.client-certificatestringTrace 导出器 TLS 的客户端证书路径，model_context_windownumber当前模型可用的上下文窗口 token 数，tool_output_token_limitnumber单个工具/函数输出存入历史的 token 上限，请参见 Authentication。
model_provider = "openai" # 用于 --oss 会话的默认开源提供方，默认：未设置。
features.experimental_windows_sandboxboolean运行 Windows 受限令牌沙箱（实验性），forced_login_methodchatgptapihide_agent_reasoningboolean在 TUI 和 codex exec 输出中隐藏推理事件，默认：未设置，Codex 会根据 model 自动检测， 3.5 自定义模型提供方 模型提供方定义了 Codex 如何连接模型（基础 URL、API 协议、可选 HTTP 头）， including manual and auto.task.user_shellcounterNumber of user shell actions (! in the TUI for example).task.reviewcounterNumber of reviews triggered.approval.requestedcountertool， recorded at the end of the thread.mcp.callcounterstatusMCP tool invocation result (ok or error string).model.call.duration_mshistogramstatus，跳过默认排除规则， 3.10 审批策略与沙箱模式 选择审批严格度（影响 Codex 何时暂停）以及沙箱级别（影响文件 / 网络访问）， ################################################################################ [mcp_servers] # --- 示例：STDIO 传输 --- # [mcp_servers.docs] # enabled = true# 可选；默认 true # command = "docs-server"# 必填 # args = ["--port"，是提升 Codex 使用体验的关键， "Codex"] notify = [ ] ################################################################################ # 审批与沙箱 ################################################################################ # 何时请求命令审批： # - untrusted：仅已知安全的只读命令自动执行；其余命令会提示确认 # - on-failure：在沙箱中自动执行；仅在失败时提示升级/放权 # - on-request：由模型决定何时询问（默认） # - never：从不询问（风险较大） approval_policy = "on-request" # 工具调用的文件系统/网络沙箱策略： # - read-only（默认） # - workspace-write # - danger-full-access（无沙箱；极其危险） sandbox_mode = "read-only" ################################################################################ # 认证与登录 ################################################################################ # CLI 登录凭据的持久化方式：file（默认） | keyring | auto cli_auth_credentials_store = "file" # ChatGPT 认证流程的基础 URL（不是 OpenAI API）。
mcp_servers..tool_timeout_secnumber覆盖 MCP server 默认 60 秒的单工具超时，model_providers..stream_max_retriesnumberSSE 流中断的最大重试次数（默认 5），然后运行： codex --profile 示例： model = "gpt-5-codex" approval_policy = "on-request" [profiles.deep-review] model = "gpt-5-pro" model_reasoning_effort = "high" approval_policy = "never" [profiles.lightweight] model = "gpt-4.1" approval_policy = "untrusted" 如果你想让某个 profile 成为默认值。
要进行单次覆盖（包括 TOML 引号规则）。
可以直接设置 OPENAI_BASE_URL，experimental_use_unified_exec_toolboolean启用 unified exec 的旧名称；推荐使用 [features].unified_exec 或 codex --enable unified_exec，默认：false log_user_prompt = false # 应用于遥测数据的环境标签，留空则禁用，合理配置 approval_policy、sandbox_mode、模型与 Profiles，profiles..include_apply_patch_toolboolean启用自由格式 apply_patch 的旧名称， "/path/to/notify.py"] 示例脚本： #!/usr/bin/env python3 import json， "-title"，profiles..experimental_use_unified_exec_toolboolean启用 unified exec 的旧名称，默认：true # 示例：false | ["agent-turn-complete"，skills.config..pathstring (path)包含 SKILL.md 的技能目录路径，直到找到“项目根目录”，mcp_servers..env_varsarray额外允许的 MCP stdio server 环境变量白名单，默认 300000），可在 config.toml 顶层添加： profile = "deep-review" 除非在命令行中显式覆盖。
未设置时，包括： tui.notificationstui.animationstui.scroll_* 4. 完整配置参考 原文地址：https://developers.openai.com/codex/config-reference 以下是 Codex 的 config.toml 和 requirements.toml 的完整参考文档，mcp_servers..commandstringMCP stdio server 的启动命令，skills.configarray存储在 config.toml 中的技能级别启用配置，mcp_servers..http_headersmap每次 MCP HTTP 请求都会包含的静态 Header，要从 Codex IDE 扩展打开该配置文件： 点击右上角的齿轮图标；选择 Codex 设置（Codex Settings）；然后选择 打开 config.toml（Open config.toml） CLI 与 IDE 扩展共用同一个 config.toml 文件，mcp_servers..enabledboolean在不移除配置的情况下禁用 MCP server，features.apply_patch_freeformboolean暴露自由格式的 apply_patch 工具（实验性），features.elevated_windows_sandboxboolean启用提升权限的 Windows 沙箱管道（实验性）， 使用这种优先级意味着你可以在顶层设置共享默认值。
默认： chatgpt_base_url = "https://chatgpt.com/backend-api/" # 将 ChatGPT 登录限制到指定 workspace id，"HOME"]' 注意事项： 配置键支持 点号语法 来设置嵌套值（例如：mcp_servers.context7.enabled=false）；--config 的值会按 TOML 解析；如有疑问，默认：true ignore_default_excludes = true # 要移除的（不区分大小写）glob 模式（例如："AWS_*"， # 取消注释以强制指定这些值，更深入的示例请参见 Sandbox content redacted unless explicitly enabled)codex.tool_decision (approved/denied and whether the decision came from config vs user)codex.tool_result (duration， "4000"]# 可选 # env = { "API_KEY" = "value" }# 可选：按原样复制的 key/value # env_vars = ["ANOTHER_SECRET"]# 可选：从父进程环境转发这些变量 # cwd = "/path/to/server"# 可选：工作目录覆盖 # startup_timeout_sec = 10.0# 可选；默认 10.0 秒 # # startup_timeout_ms = 10000# 可选：启动超时（毫秒）的别名 # tool_timeout_sec = 60.0# 可选；默认 60.0 秒 # enabled_tools = ["search"， 指标（Metrics） 默认情况下， ################################################################################ # 核心模型选择 ################################################################################ # Codex 使用的主模型，用来识别项目根目录的标记文件名，shell_environment_policy.experimental_use_profileboolean生成子进程时使用用户 shell profile，Codex 可以运行在本地“开源”模型提供方之上（例如 Ollama 或 LM Studio），Codex 会使用 oss_provider 作为默认值： # 使用 --oss 时的默认本地提供方 oss_provider = "ollama" # 或 "lmstudio" 3.8 Azure 提供方及单独调优 [model_providers.azure] name = "Azure" base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai" env_key = "AZURE_OPENAI_API_KEY" query_params = { api-version = "2025-04-01-preview" } wire_api = "responses" [model_providers.openai] request_max_retries = 4 stream_max_retries = 10 stream_idle_timeout_ms = 300000 3.9 模型推理、输出冗长度与限制 model_reasoning_summary = "none"# 禁用推理摘要 model_verbosity = "low"# 缩短回复 model_supports_reasoning_summaries = true # 强制启用推理 model_context_window = 128000# 上下文窗口大小 model_verbosity 仅对使用 Responses API 的提供方生效，mcp_servers..startup_timeout_msnumberstartup_timeout_sec 的毫秒别名，仅保留匹配的变量，完整配置键列表请参见 Configuration Reference，用于检测故障并了解功能使用情况。
model_providers..namestring自定义模型提供方的显示名称，默认：true [feedback] enabled = true # 产品内提示（多由 Codex 自动设置）， ① 默认模型：选择 CLI 和 IDE 中 Codex 默认使用的模型 model = "gpt-5.2" ② 审批提示： 控制 Codex 在执行生成命令之前何时暂停询问 approval_policy = "on-request" ③ 沙箱级别：调整 Codex 在执行命令时对文件系统和网络访问的程度 sandbox_mode = "workspace-write" ④ 推理强度：调整在模型支持时 Codex 使用多少推理能力 model_reasoning_effort = "high" ⑤ 命令环境：限制或扩展哪些环境变量会被传递给被启动的命令： [shell_environment_policy] include_only = ["PATH"，windows_wsl_setup_acknowledgedboolean记录 Windows 引导流程的确认状态（仅 Windows）， "codex-" + notification.get("thread-id"。
history.persistencesave-allnoneinclude_apply_patch_toolboolean启用自由格式 apply_patch 的旧名称；推荐使用 [features].apply_patch_freeform，notifyarray用于通知的命令；会接收来自 Codex 的 JSON 负载，默认：未设置，则只保留匹配的变量，尽量减少打断、提高执行效率，本文完，tui.notificationsbooleanarraytui.scroll_events_per_ticknumberTUI2 中用于标准化滚动的事件密度， # 可按需调整，默认：[] exclude = [] # 显式 key/value 覆盖（始终优先）。
以及配置 MCP 服务器，features.tui2boolean启用 TUI2 界面（实验性），默认配置虽然安全。
file_openervscodevscode-insidersforced_chatgpt_workspace_idstring (uuid)将 ChatGPT 登录限制到指定的工作区标识符。
默认：true show_tooltips = true # 可选的 TUI2 滚动调优（未设置则使用默认值），model_providers..env_keystring提供方 API Key 所在的环境变量，allowed_sandbox_modesarraysandbox_mode 允许使用的取值， # experimental_compact_prompt_file = "/absolute/or/relative/path/to/compact_prompt.txt" ################################################################################ # 通知 ################################################################################ # 外部通知程序（argv 数组）。
所有示例都在 config.toml 顶层配置中设置， model = "gpt-5.2-codex" # /review 功能（代码审查）使用的模型。
# profile = "default" ################################################################################ # Skills（按技能覆盖） ################################################################################ # 在不删除技能的情况下禁用或重新启用某个技能，默认：false exclude_slash_tmp = false ################################################################################ # 生成子进程的 Shell 环境策略（表） ################################################################################ [shell_environment_policy] # inherit：all（默认） | core | none inherit = "all" # 对名称包含 KEY/SECRET/TOKEN（不区分大小写）的变量，相关配置： project_doc_max_bytesproject_doc_fallback_filenames 详见 Custom instructions with AGENTS.md，可添加请求头： [model_providers.example] http_headers = { "X-Example-Header" = "example-value" } env_http_headers = { "X-Example-Features" = "EXAMPLE_FEATURES" } 3.6 OpenAI 基础 URL 覆盖 如果你只是想让内置 OpenAI 提供方指向一个 LLM 代理或路由器，如需禁用： [feedback] enabled = false 隐藏或显示推理事件 hide_agent_reasoning = true show_raw_agent_reasoning = true 仅在你的工作流允许的情况下启用原始推理内容， 2.3 常见配置选项 以下是最常修改的一些配置。
默认：未设置，博主已经编写了Codex相关的文章， # scroll_events_per_tick = 0 # scroll_wheel_lines = 0 # scroll_trackpad_lines = 0 # scroll_trackpad_accel_events = 0 # scroll_trackpad_accel_max = 0 # scroll_mode = "auto" # auto | wheel | trackpad # scroll_wheel_tick_detect_max_ms = 0 # scroll_wheel_like_max_duration_ms = 0 # scroll_invert = false # 控制用户是否可以通过 `/feedback` 提交反馈。
model_providers..query_paramsmap附加到请求中的额外查询参数。
未设置时， subprocess。
从基础配置到高级用法，例如启用桌面内联通知， ，然后根据你的实际环境调整相应的值，将可变的值保持在 Profile 中，如果使用 --oss 但未指定提供方，skills.config..enabledboolean启用或禁用对应技能， 在 config.toml 中通过 [profiles.] 定义profiles， 'Turn Complete!')}" message = " ".join(notification.get("input-messages"， 3. 高级配置 原文链接：https://developers.openai.com/codex/config-advanced 3.1 Profiles Profiles 允许你保存一组具名的配置集合， # - 默认值为 “未设置（unset）” 的可选键会以注释形式展示并附带说明， # instructions = "" # 历史压缩提示词（compaction prompt）的内联覆盖， shell_tool = true web_search_request = false unified_exec = false shell_snapshot = false apply_patch_freeform = false exec_policy = true experimental_windows_sandbox = false elevated_windows_sandbox = false remote_compaction = true remote_models = false powershell_utf8 = true tui2 = false ################################################################################ # 在此表下定义 MCP 服务器，sandbox_moderead-onlyworkspace-writesandbox_workspace_write.exclude_slash_tmpboolean在 workspace-write 模式下排除 /tmp， # 可选值：chatgpt | api # forced_login_method = "chatgpt" # MCP OAuth 凭据的首选存储方式：auto（默认） | file | keyring mcp_oauth_credentials_store = "auto" ################################################################################ # 项目文档控制 ################################################################################ # 从 AGENTS.md 中最多嵌入到首轮指令的字节数， title，只需将配置项和配置段复制到 ~/.codex/config.toml 中，notice.model_migrationsmap记录已确认的模型迁移映射（旧 → 新）， 1. 引言2. 基础配置2.1 配置文件2.2 配置优先级2.3 常见配置选项2.4 功能开关 3. 高级配置3.1 Profiles3.2 通过 CLI 进行单次覆盖3.3 配置与状态文件位置3.4 项目根目录检测3.5 自定义模型提供方3.6 OpenAI 基础 URL 覆盖3.7 OSS 模式（本地模型提供方）3.8 Azure 提供方及单独调优3.9 模型推理、输出冗长度与限制3.10 审批策略与沙箱模式3.11 Shell 环境变量策略3.12 可观测性与遥测3.13 项目指令发现3.14 TUI options 4. 完整配置参考4.1 config.toml4.2 requirements.toml 5. 示例配置6. 文末 1. 引言 在前几篇文章里，features.remote_modelsboolean在显示就绪状态前刷新远程模型列表（实验性）， 如果你希望 Codex 在保证安全边界的前提下， statusTool invocation result (ok or error string).tool.call.duration_mshistogramtool， [[skills.config]] # path = "/path/to/skill" # enabled = false ################################################################################ # 实验性开关（旧版；优先使用 [features]） ################################################################################ experimental_use_unified_exec_tool = false # 通过自由编辑路径包含 apply_patch（影响默认工具集），features.remote_compactionboolean启用远程历史压缩（仅 ChatGPT 登录；实验性；默认开启），默认：[] include_only = [] # 实验性：通过用户 shell profile 运行， 3.3 配置与状态文件位置 Codex 会将本地状态存储在 CODEX_HOME 目录下（默认是 ~/.codex），只要目录中包含 .git，history.max_bytesnumber如果设置，其余配置按需逐步放开即可。
5. 示例配置 下面的代码片段可以作为参考使用， # headers = { "x-otlp-meta" = "abc123" } # 示例：带双向 TLS 的 OTLP 导出器 # [otel.exporter."otlp-http"] # endpoint = "https://otel.example.com/v1/logs" # protocol = "binary" # [otel.exporter."otlp-http".headers] # "x-otlp-api-key" = "${OTLP_TOKEN}" # [otel.exporter."otlp-http".tls] # ca-certificate = "certs/otel-ca.pem" # client-certificate = "/etc/codex/certs/client.pem" # client-private-key = "/etc/codex/certs/client-key.pem" 6. 文末 本文从工程实践角度， include_logs， ".sl"] 如果设置为空数组： project_root_markers = [] 则 Codex 不再向上搜索父目录，有兴趣的童鞋可以先阅读： 《Codex 完整指南（一）：快速入门｜工程级 AI 编程代理》《Codex 完整指南（二）：核心概念详解｜工程级 AI 编程智能体》《Codex 完整指南（三）：OpenAI 官方实战指南整理｜251 篇（最新）》《Codex 完整指南（四）：多端使用全景图｜IDE、CLI、Cloud 与团队集成》 Codex 会在本地执行命令、读写文件、请求审批。
shell_environment_policy.inheritallcoreshell_environment_policy.setmap注入到每个子进程的显式环境变量，model_providers..env_http_headersmap从环境变量填充的 HTTP Header，Codex 会周期性地向 OpenAI 发送少量匿名使用与健康数据。
model_auto_compact_token_limitnumber触发自动历史压缩的 token 阈值（未设置则使用模型默认值）， Profiles 目前仍处于实验阶段，未设置时，无需修改 config.toml： export OPENAI_BASE_URL="https://api.openai.com/v1" codex 3.7 OSS 模式（本地模型提供方） 当你使用 --oss 参数时，otel.trace_exporternoneotlp-httpotel.trace_exporter..endpointstringTrace 导出端点，Codex 会提示选择， [sandbox_workspace_write] # 除工作区（cwd）外额外允许写入的根目录，默认：false show_raw_agent_reasoning = false # 禁用 TUI 中的“突发粘贴（burst-paste）”检测， Chat Completions 提供方会忽略该设置，默认情况下， "AZURE_*"）， message， "summarize"] # 可选：允许列表 # disabled_tools = ["slow-tool"]# 可选：禁用列表（在允许列表之后生效） # --- 示例：可流式 HTTP 传输 --- # [mcp_servers.github] # enabled = true# 可选；默认 true # url = "https://github-mcp.example.com/mcp" # 必填 # bearer_token_env_var = "GITHUB_TOKEN"# 可选；Authorization: Bearer # http_headers = { "X-Example" = "value" } # 可选：静态请求头 # env_http_headers = { "X-Auth" = "AUTH_ENV" } # 可选：从环境变量填充的请求头 # startup_timeout_sec = 10.0# 可选 # tool_timeout_sec = 60.0# 可选 # enabled_tools = ["list_issues"]# 可选：允许列表 ################################################################################ # 模型提供方（扩展/覆盖内置） ################################################################################ # 内置包括： # - openai（Responses API；需要登录或通过认证流程提供 OPENAI_API_KEY） # - oss（Chat Completions API；默认指向 :11434/v1） [model_providers] # --- 示例：用显式 base URL 或 headers 覆盖 OpenAI --- # [model_providers.openai] # name = "OpenAI" # base_url = "https://api.openai.com/v1"# 未设置时的默认值 # wire_api = "responses"# "responses" | "chat"（默认因情况而异） # # requires_openai_auth = true# 内置 OpenAI 默认 true # # request_max_retries = 4# 默认 4；最大 100 # # stream_max_retries = 5# 默认 5；最大 100 # # stream_idle_timeout_ms = 300000# 默认 300_000（5 分钟） # # experimental_bearer_token = "sk-example"# 可选：仅开发用途的直接 bearer token # # http_headers = { "X-Example" = "value" } # # env_http_headers = { "OpenAI-Organization" = "OPENAI_ORGANIZATION"， 关于认证（包括凭据存储方式）的更多细节，例如日志和缓存， 2.1 配置文件 Codex 将其配置存储在：~/.codex/config.toml。
]) return 0 if __name__ == "__main__": sys.exit(main()) 历史记录持久化 默认情况下，tui.scroll_trackpad_accel_maxnumber触控板滚动的最大加速倍数，默认：32768 project_doc_max_bytes = 32768 # 当某一层目录缺少 AGENTS.md 时，model_providers..base_urlstring模型提供方的 API 基础 URL。
mcp_servers..startup_timeout_secnumber覆盖 MCP server 默认 10 秒的启动超时，请参阅高级配置（Advanced Config）：https://developers.openai.com/codex/config-advanced#one-off-overrides-from-the-cli 备注：在受管理的机器上，默认：false experimental_use_profile = false ################################################################################ # 历史（表） ################################################################################ [history] # save-all（默认） | none persistence = "save-all" # 历史文件最大字节数；超过后会裁剪最旧条目，cli_auth_credentials_storefilekeyringcompact_promptstring内联覆盖用于历史压缩的提示词，默认：true check_for_update_on_startup = true ################################################################################ # Profiles（命名预设） ################################################################################ # 当前启用的 profile 名称，使用 -c / --config 示例： # 专用参数 codex --model gpt-5.2 # 通用键值覆盖（值是 TOML，feedback.enabledboolean通过 /feedback 启用跨 Codex 界面的反馈提交（默认 true），otel.trace_exporter..tls.client-private-keystringTrace 导出器 TLS 的客户端私钥路径， windsurf，tui.scroll_invertboolean反转 TUI2 的鼠标滚动方向， valueFeature values that differ from defaults (emit one row per non-default).thread.startedcounteris_gitNew thread created.task.compactcountertypeNumber of compactions per type (remote or local)，建议优先从审批策略与沙箱级别入手进行调整，请参见 Admin-enforced requirements KeyType / ValuesDetailsallowed_approval_policiesarrayapproval_policy 允许使用的取值，可以 在 config.toml 的 [features] 部分添加： feature_name = true 或者从命令行运行： codex --enable feature_name 如果要同时启用多个功能： codex --enable feature_a --enable feature_b 要停用某个功能，可以在 config.toml 中自定义该行为： # 当目录中包含以下任意标记时，mcp_servers..env_http_headersmap从环境变量填充的 HTTP Header（用于 MCP HTTP server）， [])) subprocess.check_output([ "terminal-notifier"， # model_context_window = 128000# token 数；默认：按模型自动决定 # model_auto_compact_token_limit = 0 # token 数；未设置时使用模型默认值 # tool_output_token_limit = 10000# 每个工具输出存储的 token 数；对 gpt-5.2-codex 默认是 10000 ################################################################################ # 推理与详细度（支持 Responses API 的模型） ################################################################################ # 推理强度：minimal | low | medium | high | xhigh（默认：medium；在 gpt-5.2-codex 与 gpt-5.2 上为 xhigh） model_reasoning_effort = "medium" # 推理摘要：auto | concise | detailed | none（默认：auto） model_reasoning_summary = "auto" # GPT-5 系列（Responses API）的文本输出详细度：low | medium | high（默认：medium） model_verbosity = "medium" # 为当前模型强制启用推理摘要（默认：false） model_supports_reasoning_summaries = false ################################################################################ # 指令覆盖 ################################################################################ # 额外的用户指令会在 AGENTS.md 之前注入，就会被视为项目根目录，默认：false experimental_use_freeform_apply_patch = false ################################################################################ # 沙箱设置（表） ################################################################################ # 仅在 sandbox_mode = "workspace-write" 时使用的额外设置， # Codex 示例配置（config.toml） # # 本文件列出了 Codex 会从 config.toml 读取的所有键、它们的默认值。
mcp_servers..urlstringMCP 可流式 HTTP server 的端点。
otel.exporter..protocolbinaryjsonotel.exporter..tls.ca-certificatestringOTEL 导出器 TLS 的 CA 证书路径，你可以定义额外的提供方， 2. 基础配置 原文地址：https://developers.openai.com/codex/config-basic Codex 会从 ~/.codex/config.toml 读取本地设置，默认：未设置。
review_model = "gpt-5.2-codex" # 从 [model_providers] 中选择的提供方 id， # compact_prompt = "" # 用文件路径覆盖内置的基础指令，sandbox_workspace_write.network_accessboolean允许 workspace-write 沙箱内的外部网络访问，如需完全关闭指标收集： [analytics] enabled = false 默认上下文字段（适用于所有事件 / 指标） surfaceversionauth_modemodel 指标目录 MetricTypeFieldsDescriptionfeatures.statecounterkey。
默认：[] writable_roots = [] # 允许在沙箱内进行出站网络访问。
project_root_markersarray用于查找项目根目录的标记文件名列表，tui.show_tooltipsboolean在 TUI 欢迎界面显示新手提示（默认 true），otel.trace_exporter..headersmapTrace 导出请求的静态 Header， 有关详情、路径和示例，profiles..experimental_use_freeform_apply_patchboolean启用自由格式 apply_patch 的旧名称，model_providers..http_headersmap添加到提供方请求中的静态 HTTP Header，features.powershell_utf8boolean强制 PowerShell 使用 UTF-8 输出（默认 true）。
# developer_instructions = "" #（已忽略）可选的旧版基础指令覆盖（建议使用 AGENTS.md），experimental_instructions_filestring (path)实验性：使用该文件替代内置指令， 4.2 requirements.toml requirements.toml 是由管理员强制执行的配置文件， 通知 使用 notify 在 Codex 触发事件时调用外部程序（目前支持 agent-turn-complete），示例：5242880 # max_bytes = 0 ################################################################################ # UI、通知与杂项（表） ################################################################################ [tui] # 来自 TUI 的桌面通知：布尔值或过滤列表。
model_providerstring来自 model_providers 的 provider id（默认：openai），否则 Codex 会自动加载该 profile。
oss_providerlmstudioollamaotel.environmentstring应用于 OpenTelemetry 事件的环境标签（默认 dev）， # 以及简要说明。
未设置时：禁用， "-group"，otel.exporternoneotlp-httpotel.exporter..endpointstringOTEL 日志导出端点，这些数据 不包含任何 PII（个人可识别信息）， notify = ["python3"，features.web_search_requestboolean允许模型发起 Web 搜索请求（稳定），otel.exporter..tls.client-private-keystringOTEL 导出器 TLS 的客户端私钥路径，otel.exporter..headersmapOTEL 导出请求中包含的静态 Header，你可以使用它来： 设置默认模型与提供商配置审批策略与沙箱设置配置 MCP 服务器 2.2 配置优先级 Codex 在解析值时遵循以下顺序： CLI 标志（例如 --model）；通过 --profile 指定的配置文件值（Profile）；config.toml 顶层值；内置默认值 ， success，专属配置位于 [tui] 下。
重点说明每个关键配置项的作用与影响范围，tui.animationsboolean启用终端动画（欢迎页、闪光、加载器）（默认 true）。
默认："dev" environment = "dev" # 导出器：none（默认） | otlp-http | otlp-grpc exporter = "none" # Trace 导出器：none（默认） | otlp-http | otlp-grpc trace_exporter = "none" # 示例：OTLP/HTTP 导出器配置 # [otel.exporter."otlp-http"] # endpoint = "https://otel.example.com/v1/logs" # protocol = "binary"# "binary" | "json" # [otel.exporter."otlp-http".headers] # "x-otlp-api-key" = "${OTLP_TOKEN}" # 示例：OTLP/gRPC 导出器配置 # [otel.exporter."otlp-grpc"] # endpoint = "https://otel.example.com:4317"，notice.hide_world_writable_warningboolean记录是否确认 Windows 全局可写目录警告。
默认：false network_access = false # 将 $TMPDIR 从可写根目录中排除，features.shell_snapshotboolean对 shell 环境进行快照以加速重复命令（beta），默认：false exclude_tmpdir_env_var = false # 将 /tmp 从可写根目录中排除。
默认：所有平台均为 "gpt-5.2-codex"。
默认：false disable_paste_burst = false # 记录 Windows 入门设置确认（仅 Windows）。
"OpenAI-Project" = "OPENAI_PROJECT" } # --- 示例：Azure（根据端点选择 Chat/Responses）--- # [model_providers.azure] # name = "Azure" # base_url = "https://YOUR_PROJECT_NAME.openai.azure.com/openai" # wire_api = "responses"# 或按端点使用 "chat" # query_params = { api-version = "2025-04-01-preview" } # env_key = "AZURE_OPENAI_API_KEY" # # env_key_instructions = "在环境变量中设置 AZURE_OPENAI_API_KEY" # --- 示例：本地 OSS（例如 Ollama 兼容）--- # [model_providers.ollama] # name = "Ollama" # base_url = "http://localhost:11434/v1" # wire_api = "chat" ################################################################################ # Profiles（命名预设） ################################################################################ [profiles] # [profiles.default] # model = "gpt-5.2-codex" # model_provider = "openai" # approval_policy = "on-request" # sandbox_mode = "read-only" # oss_provider = "ollama" # model_reasoning_effort = "medium" # model_reasoning_summary = "auto" # model_verbosity = "medium" # chatgpt_base_url = "https://chatgpt.com/backend-api/" # experimental_compact_prompt_file = "./compact_prompt.txt" # include_apply_patch_tool = false # experimental_use_unified_exec_tool = false # experimental_use_freeform_apply_patch = false # tools_web_search = false # features = { unified_exec = false } ################################################################################ # Projects（信任级别） ################################################################################ # 将特定 worktree 标记为可信或不可信，默认：false hide_agent_reasoning = false # 当可用时显示原始推理内容，系统整理了 Codex 的基础配置与高级配置方式，并通过 model_provider 指向它们： model = "gpt-5.1" model_provider = "proxy" [model_providers.proxy] name = "OpenAI using LLM proxy" base_url = "http://proxy.example.com" env_key = "OPENAI_API_KEY" [model_providers.ollama] name = "Ollama" base_url = "http://localhost:11434/v1" [model_providers.mistral] name = "Mistral" base_url = "https://api.mistral.ai/v1" env_key = "MISTRAL_API_KEY" 如有需要， # oss_provider = "ollama" # 可选的手动模型元数据，experimental_use_freeform_apply_patchboolean启用自由格式 apply_patch 的旧名称；推荐使用 [features].apply_patch_freeform 或 codex --enable apply_patch_freeform，profiles..oss_providerlmstudioollamaproject_doc_fallback_filenamesarray当 AGENTS.md 缺失时尝试的额外文件名，disable_paste_burstboolean在 TUI 中禁用批量粘贴检测， # - MCP 服务器、profiles（配置文件）以及模型提供方都是示例；可删除或修改， 3.2 通过 CLI 进行单次覆盖 除了编辑 ~/.codex/config.toml 之外，mcp_servers..envmap转发给 MCP stdio server 的环境变量，例如不允许 approval_policy = "never" 或 sandbox_mode = "danger-full-access"，shell_environment_policy.ignore_default_excludesboolean在其他过滤前保留包含 KEY/SECRET/TOKEN 的变量。
你的组织也可能通过 requirements.toml 强制执行约束， [projects] # [projects."/absolute/path/to/project"] # trust_level = "trusted" # 或 "untrusted" ################################################################################ # OpenTelemetry（OTEL）- 默认禁用 ################################################################################ [otel] # 在日志中包含用户提示文本。
你还可以在 单次运行时 通过 CLI 覆盖配置： 优先使用已有的专用参数（例如 --model）如需覆盖任意键，tuitableTUI 专用选项，默认：true animations = true # 在欢迎界面显示入门提示，默认：未设置，model_providers..stream_idle_timeout_msnumberSSE 流的空闲超时（毫秒。
# experimental_instructions_file = "/absolute/or/relative/path/to/instructions.txt" # 从文件加载历史压缩提示词覆盖， ".hg"，默认：[] project_doc_fallback_filenames = [] # 在向上查找父目录时。