File tree Expand file tree Collapse file tree
Expand file tree Collapse file tree Original file line number Diff line number Diff line change @@ -195,12 +195,43 @@ AI 会:
195195
196196不同 AI 工具会自动读取不同的项目指令文件:
197197
198- | AI 工具 | 注入的文件 | 配置说明 |
199- | --------------| ---------------------| -------------------------------------------|
200- | Claude Code | ` .claude/CLAUDE.md ` | 项目根目录 |
201- | Gemini CLI | ` AGENTS.md ` | 通过 ` .gemini/settings.json ` 配置 |
202- | OpenCode | ` AGENTS.md ` | 项目根目录(或 ` ~/.config/opencode/AGENTS.md ` ) |
203- | Codex CLI | ` AGENTS.md ` | 项目根目录(或 ` ~/.codex/AGENTS.md ` ) |
198+ | AI 工具 | 注入的文件 | 配置说明 |
199+ | -------------| ---------------------| -----------------------------------------|
200+ | Claude Code | ` .claude/CLAUDE.md ` | 项目根目录 |
201+ | Gemini CLI | ` AGENTS.md ` | 通过 ` .gemini/settings.json ` 配置 |
202+ | OpenCode | ` AGENTS.md ` | 项目根目录(或 ` ~/.config/opencode/AGENTS.md ` ) |
203+ | Codex CLI | ` AGENTS.md ` | 项目根目录(或 ` ~/.codex/AGENTS.md ` ) |
204+
205+ #### Claude Code 加载机制(实验验证)
206+
207+ ** 测试方法** :在不同位置创建带唯一标识符的 CLAUDE.md 文件(.claude/rules/、子目录、~ /.claude/),观察 Claude 接收到的系统上下文。
208+
209+ ** 核心结论** :
210+
211+ 1 . ** 启动时加载(永久)**
212+ - 加载位置:` .claude/CLAUDE.md ` + ` .claude/rules/*.md ` + ` ~/.claude/CLAUDE.md `
213+ - 注入方式:拼接到系统提示词(持续生效)
214+ - 合并策略:简单拼接,无智能合并
215+
216+ 2 . ** 按需加载(临时)**
217+ - 加载位置:子目录 ` CLAUDE.md ` (如 ` test-subdir/CLAUDE.md ` )
218+ - 触发时机:首次 Read 该目录下文件时
219+ - 注入方式:通过 ` <system-reminder> ` 注入到函数结果(临时生效)
220+ - 限制:Write 工具不触发加载
221+
222+ 3 . ** 文件组织建议**
223+ ```
224+ .claude/
225+ ├── CLAUDE.md # 核心配置(100-200 行)
226+ └── rules/ # 模块化规则(每个 50-100 行)
227+ ├── 01-xxx.md # 用数字前缀控制顺序
228+ └── 02-yyy.md
229+ ```
230+
231+ ** 注意事项** :
232+ - 避免重复定义规则(拼接时不去重)
233+ - 控制总长度(建议 ` .claude/ ` 总计 ≤500 行)
234+ - 子目录规则按需加载(节省 token)
204235
205236### ClaudeCode 配置
206237
You can’t perform that action at this time.
0 commit comments