راهنمای حرفهای Claude Code: از CLAUDE.md تا ساخت سابجنت
هوش مصنوعیخلاصهٔ کاملتر
Claude Code بین کاربر معمولی و کاربر حرفهای یه شکاف بزرگ داره. کاربر حرفهای ازش به عنوان یه ایجنت قابل برنامهریزی استفاده میکنه — نه یه چتبات که منتظر دستور بعدیه. مهمترین اصل طبق گفته Boris Cherny از تیم Anthropic اینه: به Claude راهی بده تا کارش رو خودش تأیید کنه. بدون این، تنها حلقه بازخورد خود توسعهدهندهست؛ با این، Claude تا زمانی که همه چیز درست کار کنه ادامه میده و این به تنهایی کیفیت خروجی رو ۲ تا ۳ برابر بهبود میده.
پوشه .claude/ یه سیستم پیکربندی لایهایه. فایل CLAUDE.md در هر سشن لود میشه و تیم رو هماهنگ نگه میداره. CLAUDE.local.md فقط روی ماشین شماست و هرگز به گیت نمیره — جای ایدهآلی برای نگه داشتن فیدبکهای شخصی code review. فایل settings.json برای دسترسیها و هوکهاست، و .mcp.json سرورهای MCP مشترک تیم رو تعریف میکنه.
CLAUDE.md دو قانون طلایی داره: کوتاهش نگهدار و بذار Claude خودش قوانین رو بنویسه. هر بار که Claude اشتباه میکنه، آخر پرامپت بنویس: «Update CLAUDE.md so you do not repeat this.» Boris میگه Claude به طرز عجیبی در تبدیل اشتباهاتش به قوانین دقیق مهارت داره. یه بخش «Gotchas» در CLAUDE.md همین اشتباههای گرفتهشده رو ثبت میکنه:
# Gotchas
- `User` and `UserRecord` are distinct types. UserRecord is the DB row, User is the runtime object.
- `formatCurrency` assumes USD. For international use `formatCurrencyByLocale`.Skills واحد دانش قابل استفاده مجدد در Claude Code هستن. هر Skill یه پوشه زیر .claude/skills// با یه فایل SKILL.md و frontmatterه. اسم پوشه به Slash Command تبدیل میشه. قدرت Skills اینه که Claude فقط توضیح frontmatter رو در شروع سشن بارگذاری میکنه (~۱۰۰ توکن)، و محتوای کامل رو فقط موقع نیاز میخونه. میشه داخل Skill با خط ! یه دستور شل اجرا کرد و خروجیش رو مستقیم به Claude تزریق کرد.
Subagentها ابزار کارهای سنگینه. هر Subagent در context window جداگانه خودش اجرا میشه، با دسترسیهای ابزاری مستقل، و فقط یه خلاصه برمیگردونه. یعنی میتونه ۵۰ فایل بخونه بدون اینکه context سشن اصلی پر بشه. برای ساخت Subagent کافیه یه فایل Markdown با frontmatter زیر .claude/agents/ بذاری. ریپوی mattpocock/skills با نزدیک به ۱۰۰ هزار ستاره، Skills محبوبی مثل /tdd، /grill-me و /diagnose داره که با npx skills@latest add mattpocock/skills نصب میشن.
نکات کلیدی:
- به Claude راهی بده تا کارش رو خودش تست کنه — این بزرگترین اهرم کیفیته
- CLAUDE.md رو کوتاه و پر از نکات عملی نگهدار، نه توضیح کلی درباره کدبیس
- از CLAUDE.local.md برای فیدبکهای code review شخصی استفاده کن
- Skills رو به گیت commit کن تا دانش تیمی انباشته بشه
- Subagentها برای وظایف سنگین مثل code review یا تست موازی ایدهآلن
- از disable-model-invocation: true در Skills با side effect استفاده کن
