企业官网建设流程全解析

一、全局配置

1.1 全局配置目录

config.toml 可以理解成 Codex 的总配置文件。

它告诉 Codex：启动后用什么模型、连什么服务、开什么插件、信任哪些项目、允许什么权限、连接哪些 MCP 工具。

他在这个目录：

C:\Users\a2493\.codex\config.toml

其中包括：

比较重要的有 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": "检查项目环境" } ] } ] } }

三、参考文档

3.1 CodeX 参考文档

参考官方文档：

Configuration | ChatGPT Learn