跳到正文
codex.tips
目录速查模板文章社区关于
目录 / CH 04 配置与 Profiles / TIP 028

项目配置只在目录受信任时生效

没标信任,仓库里的 .codex/config.toml、hooks、rules 都不会进会话。这是特性。

刚 clone 的仓库先人工看:

  • .codex/config.toml
  • .codex/hooks.json
  • AGENTS.md

再信任。信任后项目层才会覆盖个人默认。

企业环境还可能有 requirements.toml,从上面限制你能选的模型、沙箱和功能。

来源

  • OpenAI · Config reference ↗

接着读

不信任的项目不会加载项目级 AGENTS.md

0.150 起未信任项目按设计不提供项目 AGENTS.md。0.150.1 有人复现仍会注入;用 debug prompt-input 核对。

约定写进 AGENTS.md,运行时放进 config.toml

测试命令、架构、禁止事项是指令;模型、沙箱、MCP、子代理是配置。混在一起会两边都难维护。

个人默认、项目覆盖、一次性 CLI

~/.codex/config.toml 放个人习惯,.codex/config.toml 放仓库行为,CLI 只覆盖这一次。

Profile 是独立文件,不是 [profiles] 表

旧博客里的 [profiles.fast] 已经过时。现在是 ~/.codex/fast.config.toml,用 --profile fast 加载。

Codex 实用技巧 技巧、配置与工作流