一、全局配置1.1 全局配置目录config.toml 可以理解成 Codex 的总配置文件。它告诉 Codex启动后用什么模型、连什么服务、开什么插件、信任哪些项目、允许什么权限、连接哪些 MCP 工具。他在这个目录C:\Users\a2493\.codex\config.toml其中包括方括号一句话作用[desktop]配置 Codex 桌面客户端的界面和交互行为如语言、终端位置、消息队列、主题等。[marketplaces.openai-bundled]指定 OpenAI 内置插件市场从哪个本地目录加载。[marketplaces.openai-primary-runtime]指定 OpenAI Primary Runtime 插件市场的本地来源。[plugins.xxx]控制某个 Codex 插件是否启用如浏览器、Computer Use、PDF、PPT、代码审查等。[windows]配置 Windows 本地执行/沙箱权限你的elevated表示较高权限。[features]控制 Codex 的全局实验/功能开关如 Memory、JS REPL 等。[memories]配置 Codex 记忆系统具体怎么工作如是否生成和使用记忆。[shell_environment_policy.set]设置 Codex 启动 Shell/工具时注入的环境变量。[projects.路径]给指定的本地工程目录设置权限/信任等级你的都是trusted。[model_providers.custom]定义一个模型服务提供者包括认证方式、通信协议、Responses API 等。[mcp_servers]MCP Server 配置的总入口/父配置块。[mcp_servers.node_repl]配置 Node REPL MCP 服务给 Codex 提供 JS/浏览器/Computer Use 等底层能力。[mcp_servers.node_repl.env]给 Node REPL MCP Server 设置环境变量。[mcp_servers.matlab]配置 MATLAB MCP Server让 Codex 能连接 MATLAB/Simulink 并调用其工具。比较重要的有 4 类[projects] 约束代码权限[plugins] 约束 Codex 插件能力[model_providers] 配置模型[mcp_servers] 配置 MCP 服务器配置1.2 MCP 目录在 CodeX 的设置可以看当前安装全局的 MCP在 C:\Users\a2493\.codex\config.toml在这里我有两个 MCP一个是自带的 node_repl mcp一个是我自己安装的 matlab mcp。配置格式如下[mcp_servers.node_repl] args [] command C:\Users\a2493\AppData\Local\OpenAI\Codex\runtimes\cua_node\1b30f7d4d73226ca\bin\node_repl.exe env_vars [CODEX_WINDOWS_REGISTERED_CORE] startup_timeout_sec 120[mcp_servers.matlab] command C:/Users/a2493/.matlab/agentic-toolkits/bin/matlab-mcp-server.exe args [--matlab-session-modeexisting, --extension-fileC:/Users/a2493/.matlab/agentic-toolkits/simulink/tools/tools.json] tool_timeout_sec 6001.3 Skills 目录在 CodeX 的设置可以看当前安装的全局 Skills来源主要有两个路径CodeX 使用的 Skills自己写的全局 Skills 按照格式放在这里即可C:\Users\a2493\.codex\skills全局 Skills不仅 CodeX 可以识别到别的 angent 也可以在这里找到C:\Users\a2493\.agents\skills二、工程私有配置2.1 工程配置每个项目可以有单独的配置按照下面的目录结构放置即可你的项目/ ├─ AGENTS.md ├─ .agents/ │ └─ skills/ │ └─ my-skill/ │ ├─ SKILL.md │ ├─ references/ 可选参考资料 │ └─ scripts/ 可选Skill 使用的脚本 └─ .codex/ ├─ config.toml 项目级 Codex 和 MCP 配置 ├─ hooks.json Hook 的触发时机与执行命令 └─ hooks/ └─ my-hook.ps1 可选Hook 调用的 PowerShell 脚本2.2 工程私有规则CodeX 会自动阅读目录下的 AGENTS.md。这样可以写一些提示 CodeX 注意事项。2.3 工程私有 Skills在 /agnets/skills/ 下可以放置项目私有的 Skills。2.4 工程私有的 CodeX config按照 C:\Users\a2493\.codex\config.toml 格式可以给每个工程配置单独的 config。比较有用的功能是在这里配置专属的 MCP。2.5 hookHook钩子就是“发生指定事件时自动执行一个动作”。在 Codex 中例如开始会话时 (SessionStart) → 检查工程环境调用工具前 (PreToolUse) → 检查这次操作是否符合规则工具运行后 (PostToolUse) → 运行检查或记录结果hooks.json 会在启动或恢复 Codex 会话时运行一个 PowerShell 检查脚本。matcher: startup|resume 是匹配条件startup新会话启动时resume恢复已有会话时{ hooks: { SessionStart: [ { matcher: startup|resume, hooks: [ { type: command, commandWindows: powershell.exe -NoProfile -File \D:\\project\\MotorControl\\.codex\\hooks\\check.ps1\, timeout: 10, statusMessage: 检查项目环境 } ] } ] } }三、参考文档3.1 CodeX 参考文档参考官方文档Configuration | ChatGPT Learn