codex项目级配置是多项目协作的刚需，位于项目根目录的.codex/config.toml，优先级高于全局配置，可独立设定模型、权限与命令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让前端项目用 Qwen2-72B，后端项目用 DeepSeek-V3，客户项目禁用所有文件修改权限——但改一次全局配置，所有项目全跟着变，根本没法单独控制。Codex 的项目级配置不是可选项，而是多项目协作的刚需，它直接决定每个项目能调用哪个模型、能改哪些文件、执行什么测试命令。
确认项目根目录存在 .codex 文件夹
打开你的项目文件夹（比如 D:\Projects\client-app），检查是否存在名为 .codex 的隐藏文件夹。没有就手动新建一个，名字必须是 .codex（注意开头的英文点号，不能写成 codex 或 .Codex）。
Windows 资源管理器默认隐藏以点开头的文件夹，需在「查看」→「显示」→ 勾选「隐藏的项目」才能看见。如果直接右键新建文件夹再重命名为 .codex，部分系统会自动补全为 .codex.，导致无效——【必须通过命令行或 PowerShell 创建】：mkdir .codex。
在项目目录下写入专属 config.toml
进入刚建好的 .codex 文件夹，新建一个纯文本文件，命名为 config.toml，用记事本或 VS Code 打开。
填入你这个项目的特殊规则，例如：
[model]provider = "qwen"name = "qwen2-72b"[permissions]allow_write = ["src/", "tests/"]deny_write = ["package-lock.json", "node_modules/"][commands]test = "npm run test:unit"
保存后关闭。这个文件只对当前项目生效，不会影响其他任何路径下的项目。Codex CLI 启动时会自动读取该路径下的 .codex/config.toml，优先级高于用户级配置。
验证配置是否被正确加载
打开终端，cd 进入该项目根目录（确保 pwd 显示的是 D:\Projects\client-app 而不是用户主目录）。
执行：codex --debug config show。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
观察输出中的 effective config source 字段——如果显示 D:\Projects\client-app\.codex\config.toml，说明项目级配置已接管；如果仍显示 C:\Users\XXX\.codex\config.toml，请检查：① 当前路径是否真的是项目根目录；② .codex 文件夹是否在根目录下而非子目录中；③ config.toml 文件编码是否为 UTF-8 无 BOM。
这一步操作起来很简单，直接把终端窗口拖到项目文件夹图标上双击即可自动进入正确路径。
方法一：用 codex init 自动生成项目配置
第一步：在项目根目录打开终端。
第二步：运行 codex init --project。它会检测当前目录结构，自动生成带基础模型和权限规则的 .codex/config.toml，并提示你确认覆盖。
第三步：按提示编辑生成的文件，删掉不需要的字段（比如你不打算用 Git 集成，就删掉 [git] 区块），保留 [model] 和 [permissions] 即可。
注意：不要在非项目根目录运行此命令，否则生成的配置会被放在错误位置，Codex 无法识别。
方法二：复制模板快速初始化
从官方 GitHub 仓库下载 project-config-template.toml，重命名为 config.toml，放进项目根目录的 .codex 文件夹。
模板里已预置三档权限开关（safe/review/full）、常用测试命令占位符、禁止写入列表示例。你只需修改 provider 和 name 对应你当前项目接入的国产模型即可。
这比手写更快，也避免语法错误导致配置加载失败——TOML 格式对缩进和等号空格极其敏感，少一个空格就会让整个配置失效。
