Codex 会从多个位置读取配置。您的个人默认设置保存在 ~/.codex/config.toml 中，您可以通过 .codex/config.toml 文件添加项目级覆盖设置。出于安全考虑，Codex 仅在您信任项目时才会加载项目的 .codex/ 配置层。
Codex 配置文件
Codex 将用户级配置存储在 ~/.codex/config.toml 中。要让设置仅对特定项目或子文件夹生效，请在代码仓库中添加 .codex/config.toml 文件。
要从 Codex IDE 扩展中打开配置文件，请选择右上角的齿轮图标，然后选择 Codex 设置 > 打开 config.toml。
CLI 和 IDE 扩展共用相同的配置层。您可以通过这些配置层：
配置优先级
Codex 按以下顺序确定配置值（优先级从高到低）：
- CLI 标志和
--config覆盖设置 - 项目配置文件：
.codex/config.toml，从项目根目录到您当前的工作目录逐级排列（离当前目录最近的文件优先；仅限受信任的项目） - 通过
--profile profile-name选择的配置方案文件（~/.codex/profile-name.config.toml） - 用户配置：
~/.codex/config.toml - 云端管理的
config.toml默认设置（如果已向当前登录的工作空间下发） - 系统配置（如果存在）：Unix 上的
/etc/codex/config.toml - 内置默认设置
利用上述优先级，在 config.toml 中设置共用的默认值，并在配置方案文件中仅设置需要区别配置的值。
云端管理的配置和系统配置可以定义插件市场，并设置
是否默认启用插件。这些配置与 requirements.toml 中强制执行的
策略相互独立。请参阅配置插件市场和默认设置。
如果您将项目标记为不受信任，Codex 会跳过项目级的 .codex/ 配置层，包括项目本地的配置、钩子和规则。用户配置和系统配置仍会加载，包括用户级和全局的钩子与规则。
有关通过 -c/--config 进行单次覆盖设置的说明（包括 TOML 引号规则），请参阅高级配置。
在受管理的计算机上，您的组织还可能通过
requirements.toml 强制实施约束（例如，禁止 approval_policy = "never" 或
sandbox_mode = "danger-full-access"）。请参阅受管理的
配置和管理员强制执行的
要求。
常用配置选项
以下是一些最常修改的选项：
默认模型
选择 Codex 在 CLI 和 IDE 中默认使用的模型。
model = "gpt-5.6"审批提示
控制 Codex 在哪些情况下会先暂停并征求您的同意，再运行生成的命令。
approval_policy = "on-request"有关 on-request 和 never 的行为差异，请参阅在不显示审批提示的情况下运行和常见的沙盒与审批组合。如果现有配置使用了 approval_policy = "untrusted"，请参阅从已停用的 untrusted 审批策略迁移。
沙盒级别
调整 Codex 在执行命令时对文件系统和网络的访问权限。
sandbox_mode = "workspace-write"有关各模式的行为（包括受保护的 .git/.codex 路径和网络默认设置），请参阅沙盒与审批、可写根目录中的受保护路径和网络访问。
权限配置方案
Codex 还支持命名的权限配置方案，以便复用文件系统和
网络策略。内置配置方案包括 :read-only、:workspace 和
:danger-full-access。自定义配置方案使用 [permissions.<name>] 表，并通过
匹配的 default_permissions 值选择。请参阅权限。
Windows 沙盒模式
在 Windows 上原生运行 Codex 时，请在 windows 表中将原生沙盒模式设置为 elevated。仅当您没有管理员权限或提权设置失败时，才使用 unelevated。
[windows]
sandbox = "elevated" # Recommended
# sandbox = "unelevated" # Fallback if admin permissions/setup are unavailable网页搜索模式
Codex 默认为本地聊天启用网页搜索，并从网页搜索缓存中提供结果。该缓存是由 OpenAI 维护的网页结果索引，因此缓存模式返回的是预先编入索引的结果，而不是实时抓取网页。这降低了来自任意实时内容的提示注入风险，但您仍应将网页结果视为不受信任的内容。如果您使用 --yolo 或其他完全访问权限沙盒设置，网页搜索默认提供实时结果。使用 web_search 选择模式：
"cached"（默认）从网页搜索缓存中提供结果。"indexed"仅允许通过搜索索引准入检查的请求访问外部网页。"live"从网页获取最新数据（与--search相同）。"disabled"关闭网页搜索工具。
web_search = "cached" # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live" # fetch the most recent data from the web (same as --search)
# web_search = "disabled"推理强度
在模型支持的情况下，调整其投入的推理强度。
model_reasoning_effort = "high"沟通风格
为支持此功能的模型设置默认沟通风格。
personality = "friendly" # or "pragmatic" or "none"您可以稍后在当前会话中通过 /personality 覆盖此设置，也可以在使用 app-server API 时针对每个线程或轮次单独覆盖。
TUI 按键映射
在 tui.keymap 下自定义终端快捷键。部分编辑器操作会回退到匹配的 tui.keymap.global 按键绑定；如果支持特定上下文的绑定，则优先使用该绑定。空列表会解除该操作的按键绑定。
[tui.keymap.global]
open_transcript = "ctrl-t"
[tui.keymap.composer]
submit = ["enter", "ctrl-m"]
[tui.keymap.chat]
interrupt_turn = "f12"命令环境
控制 Codex 向启动的命令传递哪些环境变量。使用 按键名筛选的过滤器，仅保留您需要的变量：
[shell_environment_policy]
ignore_default_excludes = false
[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"ignore_default_excludes 默认为 true，这会跳过自动过滤，
不再过滤名称中包含 KEY、SECRET 或 TOKEN 的变量。要启用此自动过滤，请将其设置为 false。
有关排除规则、优先级和
旧版配置，请参阅Shell 环境
策略。
日志目录
更改 Codex 写入本地日志文件的位置。显式设置 log_dir 还会
在该目录中启用需要用户主动开启的明文 TUI 日志 codex-tui.log。
log_dir = "/absolute/path/to/codex-logs"对于单次运行，您也可以通过 CLI 设置该目录：
codex -c log_dir=./.codex-log功能标志
使用 config.toml 中的 [features] 表来启用或关闭可选功能和实验性功能。
常用功能标志
| 键 | 默认值 | 成熟度 | 说明 |
|---|---|---|---|
apps | true | 稳定 | 启用应用（连接器）集成 |
goals | true | 稳定 | 启用目标持久化和自动继续执行 |
hooks | true | 稳定 | 启用在 hooks.json 或内联 [hooks] 中配置的生命周期钩子。请参阅钩子。 |
fast_mode | true | 稳定 | 启用快速模式选择及 service_tier = "fast" 配置方式 |
memories | false | 实验性 | 启用记忆 |
multi_agent | true | 稳定 | 启用子智能体协作工具 |
personality | true | 稳定 | 启用个性选择控件 |
remote_plugin | true | 稳定 | 启用远程插件目录 |
shell_snapshot | true | 稳定 | 为您的 shell 环境创建快照，以加快重复命令的执行 |
shell_tool | true | 稳定 | 启用默认的 shell 工具 |
unified_exec | true，Windows 除外 | 稳定 | 使用基于 PTY 的统一 exec 工具 |
web_search | true | 已弃用 | 旧版开关；建议使用顶层 web_search 设置 |
web_search_cached | false | 已弃用 | 旧版开关，未设置时映射为 web_search = "cached" |
web_search_request | false | 已弃用 | 旧版开关，未设置时映射为 web_search = "live" |
此表列出了面向用户的常用功能标志，并未涵盖所有内部或 开发中的功能。“成熟度”列使用的标签包括 “实验性”“测试版”和“稳定”。有关这些标签的含义，请参阅功能 成熟度。
有关生命周期钩子的配置，请参阅钩子。
启用功能
- 在
config.toml的[features]下添加feature_name = true。 - 在 CLI 中运行
codex --enable feature_name。 - 要启用多个功能，请运行
codex --enable feature_a --enable feature_b。 - 要禁用某个功能，请在
config.toml中将对应的键设为false。