CLAUDE.mdCLAUDE.md (Claude Code): konumu ve araçların dosyayı nasıl okuduğu
CLAUDE.md, Claude Code'un başlatılırken ana dizininizden, projeden ve tüm üst dizinlerden yüklediği bellek dosyasıdır. .claude/rules/ içindeki yola bağlı kurallar, yalnızca eşleşen dosyalar okunduğunda yüklenen ek yönergeler sağlar.
Konumu
- Proje: ./CLAUDE.md veya ./.claude/CLAUDE.md; commit edilir ve ekiple paylaşılır.
- Yerel: git dışında tutulan kişisel notlar için ./CLAUDE.local.md.
- Kullanıcı: her projeye uygulanan ~/.claude/CLAUDE.md.
- Kurallar: ./.claude/rules/**/*.md ve ~/.claude/rules/**/*.md; isteğe bağlı olarak paths frontmatter ile belirli yollarla sınırlandırılır.
- Yönetilen politika: macOS'ta /Library/Application Support/ClaudeCode/CLAUDE.md, Windows'ta C:\Program Files\ClaudeCode\CLAUDE.md veya managed-settings.json içindeki claudeMd anahtarı.
Biçim
Markdown. .claude/rules/ içindeki dosyalar, paths anahtarında glob kalıplarının listelendiği YAML frontmatter ile başlayabilir. @path/to/file ile başka dosyaları içe aktarabilirsiniz; iç içe aktarma en fazla 4 düzey derinliğe ulaşabilir. Belgelenmiş bir boyut sınırı yoktur, ancak Anthropic her dosyanın 200 satırın altında tutulmasını önerir.
@AGENTS.md
# Claude Code notes
- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.
## API
- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.
Öncelik ve birleştirme
Hiçbir dosyanın üzerine yazılmaz: bulunan tüm dosyalar birleştirilir. Yönetilen politika önce, ardından dosya sistemi kökünden başlatma dizinine kadar olan dosyalar yüklenir; bu nedenle daha yakın konumdaki dosyalar en son okunur. Aynı dizinde CLAUDE.local.md, CLAUDE.md dosyasından sonra yüklenir. Alt dizinlerdeki dosyalar, Claude bu dizinlerdeki dosyaları okuduğunda yüklenir; claudeMdExcludes ile yönetilen politika hariç tutulamaz.
Dosyayı okuyan araçlar
| Araç | Destek |
|---|---|
| GitHub Copilot | Kök dizindeki CLAUDE.md dosyasını, AGENTS.md yerine kullanılabilecek bir ajan talimatı olarak okur. |
İpuçları
- CLAUDE.md kullanıyorsanız dosyanın başına @AGENTS.md ekleyin; aksi takdirde varsayılan ayarda Claude Code, AGENTS.md dosyasını yok sayar.
- Bölüme özgü yönergeleri .claude/rules/ içine taşıyın ve yalnızca ilgili dosyalar için yüklenmeleri amacıyla paths frontmatter'ı ekleyin.
- İçe aktarımlar dosyayı düzenli tutar, ancak içe aktarılan metin de yüklendiğinden bağlam tüketir.
- CLAUDE.md, CLAUDE.local.md, AGENTS.md, rules ve skills dosyalarını tek seferde denetlemek için /doctor çalıştırın.
Tek bir formdan beş araç için AGENTS.md ve eşleşen kural dosyaları oluşturun. AGENTS.md oluşturucusunu açın →