Claude Code /config 里 Project instructions 三种模式怎么选

2.1.277 起 /config 的 Project instructions 支持 claude-md、claude-md-or-agents-md、claude-md-and-agents-md 等取值。本文写 monorepo 与 Enterprise managed 场景下的选型，避免双文件重复指令。

Claude Code /config 里 Project instructions 三种模式怎么选

Claude Code 2.1.277 不仅会在无 CLAUDE.md 时读 AGENTS.md（见 277 总述），还在 /config → Project instructions 暴露显式策略。2026 年 9 月 19 日周报整理的典型取值包括：claude-md-or-agents-md（默认，有 CLAUDE.md 用 CLAUDE.md，否则 AGENTS.md）、claude-md-and-agents-md（同目录先 CLAUDE 后 AGENTS）、claude-md（只读 CLAUDE.md）、以及组织 managed 专用模式。选型错误会导致 Agent 重复读两份冲突指令或漏读团队 baseline。

作者：CodePass 技术编辑

三种常见模式对照

配置值 行为 适用
claude-md-or-agents-md 二选一，CLAUDE 优先 开源库只有 AGENTS.md、内部 fork 带 CLAUDE.md
claude-md-and-agents-md 同层两个都加载 CLAUDE 写 Claude 专用，AGENTS 写全员 baseline
claude-md 忽略 AGENTS.md 已完整迁移到 CLAUDE 生态、防 fork 投毒 AGENTS

Bedrock / Vertex / Foundry 路径仍可能不支持 AGENTS fallback，见 changelog；云托管团队继续以 CLAUDE.md + gateway 注入为主。

monorepo 落地步骤

  1. 根目录决定「唯一真相」：若全公司推 AGENTS.md，根层删空壳 CLAUDE.md 或设 claude-md-or-agents-md。

  2. 子包只在需要差异处加浅层 CLAUDE.md，避免与根 AGENTS 重复同一禁则。

  3. PR 检查：对 fork 来的 AGENTS.md 走 intake checklist。

  4. 与 Cursor 并存时，把 AGENTS 同步到 Cursor rules 或共用 git submodule，减少双维护。

Enterprise managed CLAUDE.md

周报提到 managed-claude-md-only 类选项（以你版本文档为准）：只加载组织下发 CLAUDE.md，忽略仓库 AGENTS。适合强合规；个人开源贡献者 clone 后可能「看不到」维护者本地 AGENTS，需在 CONTRIBUTING 写清。

参考资料