Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md, proje kökünüze yerleştirilen ve Claude Code'a kalıcı, projeye özgü talimatlar sağlayan bir markdown yapılandırma dosyasıdır. Ajana kodlama kurallarınızı, mimarinizi, yaygın komutları ve kuralları anlatır; bu proje içindeki her oturuma uygulanan uzun vadeli bellek biçiminde işlev görür.

CLAUDE.md nasıl çalışır

Claude Code bir oturum başlattığında, proje kökündeki CLAUDE.md dosyasını (ve üst dizinlerde veya alt dizinlerdeki tüm CLAUDE.md dosyalarını) otomatik olarak okur. İçerik, ajanın sistem bağlamının bir parçası haline gelir; böylece her oturumda hatırlatma yapmaya gerek kalmadan talimatlarınızı izler. Bu, ajanın ekibinizin kurallarıyla tutarlı biçimde davranmasını sağlar.

CLAUDE.md'ye neler dahil edilmeli

  • +Proje mimarisine genel bakış ve temel dosya konumları
  • +Kodlama kuralları (isimlendirme, biçimlendirme, kullanılacak veya kaçınılacak kalıplar)
  • +Test etme, derleme ve dağıtım için yaygın komutlar
  • +"Her yeni işlev için test yaz" veya "auth modülünü doğrudan değiştirme" gibi kurallar
  • +Ajanın farkında olması gereken teknoloji yığını ayrıntıları
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

CLAUDE.md'yi kısa tutun. Ajan her oturumda okur, bu nedenle yalnızca birden fazla görevle ilgili bilgileri ekleyin. Göreve özgü ayrıntıları bunun yerine istemlerinize taşıyın.

CLAUDE.md dosyasını nereye yerleştirmeliyim?+
Proje dizininizin köküne yerleştirin. Claude Code ayrıca modüle özgü talimatlar için alt dizinlerdeki ve kuruluş genelindeki kurallar için üst dizinlerdeki CLAUDE.md dosyalarını da destekler. Geçerli tüm dosyalar birleştirilir.
CLAUDE.md diğer yapay zeka araçlarıyla çalışır mı?+
CLAUDE.md, Claude Code'a özgüdür. Ancak bazı diğer araçlar benzer kavramları benimsemiştir. Cursor .cursorrules kullanır ve diğer ajanlar özel yapılandırma dosyaları okuyabilir. Proje düzeyinde yapay zeka talimatları kavramı yaygın bir kalıp haline gelmektedir.
CLAUDE.md ne kadar uzun olmalı?+
500 satırın altında tutun. En önemli kurallara ve kurallara odaklanın. Ajan ayrıntılar için her zaman tek tek dosyaları okuyabilir; CLAUDE.md görevler arasında geçerli olan üst düzey bağlamı sağlamalıdır.

Related terms

Agentic CodingClaude CodePrompt Engineering for Code

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS