پنج دقیقه اول هر جلسه کدنویسی را با توضیح اینکه «به جای Prisma از Drizzle استفاده می‌کنم» تلف نکنید. Claude Code از سه لایه متمایز برای بقای داده (Persistence) استفاده می‌کند تا اطمینان حاصل شود که مدل بدون نیاز به پرامپت‌های مکرر، استک فنی، قراردادها و ترجیحات شخصی شما را به‌خاطر می‌سپارد. طبق راهنمای منتشر شده در ۷ اوت ۲۰۲۶ در وب‌سایت dev.to، انتخاب بین این ابزارها تعیین می‌کند که زمینه (Context) شما با تیم به اشتراک گذاشته شود یا در یک حساب کاربری خصوصی ایزوله باقی بماند.
این رویکرد معماری برای مدیریت حافظه در زمانی ارائه می‌شود که توسعه‌دهندگان از رابط‌های ساده‌ی چت به سمت عامل‌های هوش مصنوعی (AI Agents) در مقیاس کامل حرکت می‌کنند. همان‌طور که در پوشش پیشین ما از نبرد عامل‌های هوش مصنوعی در سال ۲۰۲۶ دیدیم — جایی که Claude Code را با OpenCode و Codex مقایسه کردیم — تمرکز اکنون از توانایی خام مدل‌ها به «تجربه توسعه‌دهنده» (DX) در مدیریت وضعیت (State Management) تغییر کرده است. مدیریت زمینه در اینجا دقیقاً مثل مدیریت یک کدبیس است: اگر تنظیمات سراسری را در یک فایل محلی قرار دهید، تداخل ایجاد می‌شود و اگر تنظیمات محلی را در یک پیکربندی سراسری قرار دهید، محیط شما آلوده می‌شود. این پیچیدگی در مدیریت پیکربندی‌ها، به‌ویژه در محیط‌های سازمانی، نیازمند ساختارهای نظارتی دقیقی است که در بررسی لایه‌ی نظارتی Claude Code و سلسله‌مراتب سخت‌گیرانه تنظیمات آن به آن پرداختیم.
سه‌گانه بقای داده
CLAUDE.md ابزار اصلی برای رابط خط فرمان (CLI) در Claude Code است. این یک فایل Markdown در سیستم فایل شماست که عامل در شروع هر جلسه به‌طور خودکار آن را می‌خواند. چون این یک فایل فیزیکی است، می‌توان آن را در Git ثبت (Commit) کرد تا تمام اعضای یک تیم با محدودیت‌های فنی یکسانی شروع کنند. این یک مزیت استراتژیک برای تیم‌ها فراهم می‌کند: وقتی توسعه‌دهنده جدیدی مخزن (Repo) را کلون می‌کند، Claude Code از پیش تمام قراردادهای داخلی را می‌شناسد و هرگونه به‌روزرسانی در این فایل، از طریق جلسه بعدی برای همه اعمال می‌شود.
- دامنه: هر پروژه یا دایرکتوری خاص.
- ساختار سلسله‌مراتبی: شما می‌توانید یک فایل سراسری در مسیر
~/.claude/CLAUDE.mdبرای استایل‌های شخصی، یک فایل در سطح پروژه در~/projects/myapp/CLAUDE.mdبرای استک اصلی، و فایل‌های مخصوص زیرپوشه (مثلاً~/projects/myapp/src/CLAUDE.md) برای زمینه‌های تخصصی هر ماژول داشته باشید. - بهترین کاربرد: استک‌های فنی (مثلاً Next.js 15، Bun)، قراردادهای نام‌گذاری و شناساندن مکان فایل‌های کلیدی.
پروژه‌های کلود (Claude Projects) به عنوان محفظه‌ای برای تاریخچه گفتگوها و اسناد مرجع آپلود شده عمل می‌کنند. برخلاف روش فایل‌محور، این پروژه‌ها روی سرورهای Anthropic ذخیره شده و مختص هر کاربر هستند. این قابلیت به شما اجازه می‌دهد تا PDFها، اسناد معماری و مشخصات فنی (Specs) را آپلود کنید تا Claude در تمام طول عمر آن پروژه به آن‌ها ارجاع دهد. این ابزار برای ویژگی‌هایی (Features) که مدت زمان توسعه طولانی دارند و در آن‌ها دلیل تصمیمات گرفته شده در سه هفته پیش به اندازه وضعیت فعلی کد اهمیت دارد، ایده‌آل است.
حافظه (Memory) ابتدایی‌ترین لایه است و به عنوان یک ذخیره‌ساز سراسری برای حقایق شخصی در تمام گفتگوها، فارغ از نوع پروژه، عمل می‌کند. برای مثال، وقتی به مدل می‌گویید «به خاطر بسپار که من Tab را به Space ترجیح می‌دهم» یا «به خاطر بسپار دیتابیس اصلی من روی Railway است و نه سیستم محلی»، این تنظیم به‌صورت جهانی اعمال می‌شود. منبع مذکور هشدار می‌دهد که استفاده از Memory برای مشخصات فنی یک پروژه خاص — مانند «از Drizzle استفاده کن نه Prisma» — یک اشتباه است، زیرا این اطلاعات به پروژه‌های نامرتبط سرایت کرده و باعث ایجاد تداخل می‌شود.
جزئیات پیاده‌سازی: تفاوت وضعیت و تاریخچه
برای پیاده‌سازی مؤثر این ابزارها، باید بین «وضعیت فعلی کدبیس» و «تاریخچه گفتگو» تفاوت قائل شوید. CLAUDE.md به مدل می‌گوید کد چیست، در حالی که پروژه‌ها به مدل می‌گویند چه تصمیماتی گرفته شده است.
پیکربندی CLAUDE.md
یک فایل CLAUDE.md باکیفیت باید به بخش‌های مشخصی تقسیم شود تا رفتار عامل را به دقت هدایت کند:
- استک فنی (The Stack): لیست دقیق کتابخانه‌های مورد استفاده و مواردی که باید از آن‌ها اجتناب شود. مثال: «Next.js 15 App Router، استفاده از Drizzle ORM با Neon Postgres (به جای Prisma)، Clerk برای احراز هویت (به جای NextAuth) و Bun (به جای npm/yarn).»
- قراردادها (Conventions): تعریف الگوهای سخت‌گیرانه. برای نمونه، مشخص کنید که مسیرهای API باید در
/src/app/api/باشند، Server Actionها در/src/actions/با عبارت 'use server' قرار گیرند و کوئری‌های دیتابیس باید در/src/lib/db/باشند، نه اینکه به‌صورت inline در کامپوننت‌ها نوشته شوند. - فایل‌های کلیدی (Key Files): نقشه‌برداری از منطق‌های حیاتی، مانند
/src/lib/auth.tsبرای کمکی‌های Clerk یا/src/lib/db/schema.tsبرای اسکیمای Drizzle. - محدودیت‌ها (Constraints): تعیین مرزهای سخت، مانند «هرگز از
anyاستفاده نکن؛ ازunknownهمراه با type guards بهره ببر» یا «بدون اشاره به Migration، فایل schema.ts را تغییر نده».
بهره‌برید از پروژه‌ها و حافظه
در حالی که CLAUDE.md «چیستی» را مدیریت می‌کند، پروژه‌ها و حافظه «کیستی» و «چگونگی» را بر عهده دارند:
- ارزش پروژه‌ها: از این‌ها برای جلسات عیب‌یابی (Debugging) استفاده کنید تا مدل به خاطر بیاورد چه مواردی قبلاً تست شده است، یا در کارهای معماری که دلیل انتخاب‌ها حیاتی است.
- کاربرد حافظه: استفاده برای ترجیحات سبک ارتباطی، قراردادهای شخصی بین‌پروژه‌ای یا زمینه کلی کارهای فعلی (مثلاً «من در حال حاضر روی ویژگی پرداخت‌ها متمرکز هستم»).
استراتژی پیاده‌سازی استراتژیک
برای به حداکثر رساندن کارایی، توسعه‌دهندگان باید یک استراتژی لایه‌بندی شده را اجرا کنند. از روز اول پروژه با دستور touch CLAUDE.md فایل را بسازید. استک را تعریف کنید، صراحتاً لیست کتابخانه‌هایی که استفاده نمی‌کنید را بنویسید تا از توهمات (Hallucinations) مدل جلوگیری شود و مسیرهای حیاتی معماری را ترسیم کنید. در این راستا، مکانیزم‌های پیشرفته‌تری مانند استفاده از «دروازه‌های بستار» در AGE Plan نیز برای مقابله با توهمات عامل‌های کدنویس و جلوگیری از خودفریبی مدل‌ها معرفی شده‌اند.
این فایل را به عنوان یک سند زنده (Living Document) در نظر بگیرید. بسیاری از توسعه‌دهندگان این اشتباه را می‌کنند که با آن به عنوان یک مستند استاتیک برخورد کنند. در عوض، هر بار که یک تصمیم معماری می‌گیرید، هر بار که Claude فرض اشتباهی درباره استک شما می‌کند یا هر زمان که یک قرارداد جدید تثبیت می‌شود، آن را به‌روز کنید. این کار نیاز مدل به حدس زدن را حذف کرده و خروجی‌های یکسانی را در محیط‌های تیمی تضمین می‌کند.
این تغییر رویکرد، نقش توسعه‌دهنده را از «مهندس پرامپت» به «متصرف زمینه» (Context Curator) تبدیل می‌کند. با انتقال هویت پروژه به یک فایل نسخه‌مند (Versioned)، بار شناختی مدل کاهش یافته و اصطکاک ناشی از ریست شدن جلسات از بین می‌رود. اثر ثانویه این روش، سرعت بخشیدن به فرآیند آنبوردینگ نیروهای جدید است؛ آن‌ها از لحظه‌ای که مخزن را کلون می‌کنند، یک عامل هوش مصنوعی کاملاً باخبر در اختیار دارند.
برای بهینه‌سازی گردش کار فعلی خود، پرامپت‌های موجود را بازبینی کرده و هرگونه محدودیت فنی تکرارپذیر را همین امروز به یک فایل CLAUDE.md در سطح پروژه منتقل کنید.
گام بعدی شما
- تمام محدودیت‌های فنی تکرارپذیر در پرامپت‌های فعلی خود را استخراج کنید.
- یک فایل
CLAUDE.mdدر ریشه پروژه ایجاد کرده و استک فنی و قراردادهای نام‌گذاری را در آن ثبت کنید. - ترجیحات شخصی (مثل سبک کدنویسی) را به بخش Memory منتقل کنید تا از پروژه‌های مختلف پاک نشوند.
اما تأثیر این مدیریت زمینه بر کاهش هزینه استنتاج در مقیاس سازمانی حتی چشم‌گیرتر است — به تحلیل ما درباره بهینه‌سازی توکن‌ها در مدل‌های استدلالی مراجعه کنید.
گفتگو