故障排查

先写出症状，再选一个能区分原因的检查。重装和清缓存会改变太多条件，通常不适合作为第一步。本栏每篇给出一条本方实际复现路径，其他分支会标明依据与未测范围。

观察到的症状	从这里开始	第一次检查
项目规则没出现或似乎被忽略	AGENTS.md 不生效	文件是否进入实际上下文
改了配置仍看到旧值	config.toml 修改未生效	文件层级、项目信任与启动参数
终端找不到 codex 或其他命令	命令与 PATH	当前进程把名字解析到哪里
MCP 无工具或启动失败	MCP 连接失败	进程启动、握手、发现、调用哪个阶段失败

本站复现平台为 macOS，CLI 实验标注版本。IDE、App、Windows 和远端服务的同名现象可能有不同原因。复制 问题报告模板，记录你的真实环境后再比较。