Skip to content

Commit 2433c0e

Browse files
CodeCasterXclaude
andcommitted
docs(ai-agents): 添加 Claude Code 文件加载机制实验验证文档
在配置文件注入机制章节下新增 Claude Code 加载机制子章节,记录通过实验验证的文件加载行为: - 启动时加载:.claude/CLAUDE.md + .claude/rules/*.md + ~/.claude/CLAUDE.md(永久生效) - 按需加载:子目录 CLAUDE.md 在首次 Read 时临时注入 - 合并策略:简单拼接,无智能合并 - 文件组织建议和注意事项 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 3c901c7 commit 2433c0e

1 file changed

Lines changed: 37 additions & 6 deletions

File tree

.ai-agents/README.md

Lines changed: 37 additions & 6 deletions
Original file line numberDiff line numberDiff 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

0 commit comments

Comments
 (0)