Codex 项目配置未加载是因项目路径未被全局信任,需手动编辑 ~/.codex/config.toml,在 [projects] 下为路径添加独立嵌套表并设 trust_level = "trusted",保存后重启终端验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当你在 Codex 中执行命令时突然提示项目配置未加载、MCP 服务失效,或出现 Project config.toml files are disabled in the following folders 警告,说明 Codex 拒绝读取你项目目录下的 .codex/config.toml ——这不是模型或网络问题,而是项目未被显式信任,属于配置层的硬性限制,必须手动修正全局配置文件才能绕过。
确认项目是否被信任
打开终端,运行:codex --debug "test",观察日志中是否出现类似警告:⚠ Project config.toml files are disabled in the following folders. Settings in those files are ignored...。如果出现,说明当前项目路径未被列入全局信任列表。
该警告后会列出被禁用的路径,例如:/Users/you/project。把这个路径记下来,后续要写进 ~/.codex/config.toml。
修正全局 config.toml 中的项目信任格式
进入 ~/.codex/config.toml 文件(macOS/Linux)或 C:Users\.codexconfig.toml(Windows),用文本编辑器打开。
找到 [projects] 区块。如果不存在,就在文件末尾新建一行,写上 [projects]。
⚠️【不要写成 "/path/to/project" = {} 或 "/path/to/project" = true】——这是最常见的格式错误,会导致解析失败并报 invalid type: boolean `true`, expected struct ProjectConfig。
正确写法是为每个路径单独建立嵌套表:
[projects."/Users/you/project"]trust_level = "trusted"
如果你有多个项目,每条路径都要独立成块:
[projects."/Users/you/agent-project"]trust_level = "trusted"[projects."/Users/you/web-app"]trust_level = "trusted"
验证项目配置是否生效
保存 ~/.codex/config.toml 后,必须关闭所有终端窗口并重新打开一个新的终端,否则旧进程仍缓存旧配置。
进入你的项目根目录:cd /Users/you/project。
执行:codex --debug "ping"。
如果不再出现 Project config.toml files are disabled 警告,且日志中显示 Loaded project config from .codex/config.toml,说明信任已生效。
此时再运行 codex 命令,项目级配置(如 MCP 服务地址、自定义模型参数)就会被正常加载。


















