Codex 全局与项目规则

Codex 会把用户级规则与项目规则合并。Loci 可以把跨项目检索流程写入 Codex Home，同时保留用户已有的其他规则。

如果还不熟悉 MCP、Skill 和全局规则的分工，请先阅读 AI 接入概览。其他客户端的路径请查看配置客户端全局规则。

一键配置

先配置 MCP，再写入全局规则：

npm install --global @boses/cli
loci mcp configure codex
loci mcp rules codex

自动化环境可以跳过两次确认：

loci mcp configure codex --yes
loci mcp rules codex --yes

桌面应用用户可以打开“系统设置 → Agent 连接”，分别点击 MCP 的“一键写入”和全局规则的“写入全局规则”。桌面端使用本机 HTTP MCP，CLI 默认使用按需启动的 stdio MCP。

默认目标是 ~/.codex/AGENTS.md。如果 ~/.codex/AGENTS.override.md 已存在，Codex 会忽略同目录的普通文件，因此 Loci 会改为写入 override 文件。

Loci 只新增或替换下面两个标记之间的内容：

<!-- loci:start -->

Loci 管理的规则
<!-- loci:end -->

区块之外的个人规则保持不变。唯一的自动迁移是下一节说明的、具有完整标记边界的 Context7 全局规则。

如果 Codex 全局文件中已经存在 Context7 强制规则，直接追加 Loci 会产生冲突。Loci 会识别以下两种完整边界：

<!-- context7 -->

Context7 规则
<!-- context7 -->

<!-- context7:start -->

Context7 规则
<!-- context7:end -->

CLI 和桌面端会用一个 Loci 受管区块替换完整的 Context7 区块。组合规则先执行 Loci 本地、云端和用户授权的官方抓取流程，只在 Loci 不可用、用户拒绝抓取、已授权获取失败或证据不足时调用 Context7。再次写入只升级这个组合区块。

如果 Context7 标记不完整、重复，或者规则包含 ctx7 命令但没有标记，Loci 会停止写入并要求手动整理边界。这个安全检查不会修改项目级 AGENTS.md、Context7 Skill 或文件中的其他个人规则。

仓库根目录的 AGENTS.md 适合保存团队共享的构建、测试和代码规范。子目录可以继续放置 AGENTS.md 或 AGENTS.override.md，为局部模块提供更具体的规则。

Codex 启动时依次读取用户级文件、项目根目录以及当前工作目录路径上的规则。更靠近当前目录的内容后合并，因此可以覆盖更宽泛的指令。

新建 Codex 会话后运行：

codex --ask-for-approval never "说明技术文档的查询流程，以及什么情况下切换到其他来源。"

预期回答会先查询 Loci 本地库，再查询云端公开目录，并在获得授权后拉取或抓取官方文档。只有 Loci 不可用、用户拒绝官方抓取、获取失败或证据仍不足时，才切换到其他来源。

配置入口请查看配置 MCP，具体工具流程请查看使用 Loci Skill。Codex 的完整加载规则请查看 Codex AGENTS.md 文档。