Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md یک فایل پیکربندی markdown است که در ریشه پروژه شما قرار می‌گیرد و دستورالعمل‌های دائمی و مختص پروژه را به Claude Code ارائه می‌دهد. به عامل درباره قراردادهای کدنویسی، معماری، دستورات رایج و قوانین می‌گوید — و به‌عنوان نوعی حافظه بلندمدت که در هر جلسه آن پروژه اعمال می‌شود عمل می‌کند.

CLAUDE.md چگونه کار می‌کند

وقتی Claude Code یک جلسه را شروع می‌کند، به‌طور خودکار فایل CLAUDE.md را در ریشه پروژه شما (و هر فایل CLAUDE.md در دایرکتوری‌های والد یا زیردایرکتوری‌ها) می‌خواند. محتویات بخشی از زمینه سیستم عامل می‌شوند، بنابراین دستورالعمل‌های شما را بدون نیاز به یادآوری در هر جلسه دنبال می‌کند. این باعث می‌شود عامل به‌طور ثابت با قراردادهای تیم شما رفتار کند.

چه چیزی را در CLAUDE.md بگنجانید

  • +بررسی کلی معماری پروژه و مکان‌های فایل کلیدی
  • +قراردادهای کدنویسی (نامگذاری، قالب‌بندی، الگوهایی که باید استفاده شوند یا از آن‌ها اجتناب شود)
  • +دستورات رایج برای آزمایش، ساخت و استقرار
  • +قوانینی مانند «همیشه برای توابع جدید تست بنویس» یا «هرگز ماژول auth را مستقیماً تغییر نده»
  • +جزئیات پشته فناوری که عامل باید از آن‌ها آگاه باشد
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 را مختصر نگه دارید. عامل آن را در هر جلسه می‌خواند، پس فقط اطلاعاتی را که در طول چندین وظیفه مرتبط هستند بگنجانید. جزئیات مختص وظیفه را در دستورات خود قرار دهید.

فایل CLAUDE.md را کجا باید قرار دهم؟+
آن را در ریشه دایرکتوری پروژه خود قرار دهید. Claude Code همچنین از فایل‌های CLAUDE.md در زیردایرکتوری‌ها برای دستورالعمل‌های مختص ماژول و در دایرکتوری‌های والد برای قوانین سازمانی پشتیبانی می‌کند. تمام فایل‌های قابل اعمال با هم ادغام می‌شوند.
آیا CLAUDE.md با سایر ابزارهای هوش مصنوعی کار می‌کند؟+
CLAUDE.md مختص Claude Code است. با این حال، برخی ابزارهای دیگر مفاهیم مشابهی را پذیرفته‌اند. Cursor از .cursorrules استفاده می‌کند و سایر عوامل ممکن است فایل‌های پیکربندی سفارشی را بخوانند. مفهوم دستورالعمل‌های هوش مصنوعی در سطح پروژه در حال تبدیل شدن به یک الگوی رایج است.
CLAUDE.md باید چه طولی داشته باشد؟+
آن را زیر ۵۰۰ خط نگه دارید. بر مهم‌ترین قراردادها و قوانین تمرکز کنید. عامل همیشه می‌تواند فایل‌های جداگانه را برای جزئیات بخواند — CLAUDE.md باید زمینه سطح بالایی را که در طول وظایف اعمال می‌شود ارائه دهد.

Related terms

کدنویسی عاملیکClaude 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