CodeX 的插件、MCP、Skills 目录分析-优快云博客

一、全局配置

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-mode=existing", "--extension-file=C:/Users/a2493/.matlab/agentic-toolkits/simulink/tools/tools.json"]
tool_timeout_sec = 600

1.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 hook

Hook（钩子）就是“发生指定事件时，自动执行一个动作”。

在 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": "检查项目环境"
          }
        ]
      }
    ]
  }
}