پرش به محتوای اصلی
پرش به محتوای مقاله

پشتهٔ پیکربندی Claude Code؛ گذار از چت ساده به مهندسی برنامه‌ریزی‌شده

·۳۱ خرداد ۱۴۰۵۳ دقیقه مطالعه
راهنما
پشته پیکربندی Claude Code: فراتر از CLAUDE.md
پشته پیکربندی Claude Code: فراتر از CLAUDE.md
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

معرفی یک معماری لایه‌بندی‌شده برای Claude Code که در آن نقش «اجبار سیستم» (توسط هوک‌ها) جایگزین «خواهش از مدل» (توسط پرامپت) شده است.

اگر هنوز با Claude Code فقط چت می‌کنید، احتمالاً بخشی از قدرت واقعی این ابزار را از دست داده‌اید. برای تبدیل این دستیار به یک مهندس دقیق، باید از «گفتگوی ساده» فاصله بگیرید و به سراغ ساختار «پشتهٔ پیکربندی» بروید. این گذار از چت‌های ابتدایی به برنامه‌ریزی کامل سیستم در چارچوبی که در ۲۱ ژوئن ۲۰۲۶ در وب‌سایت dev.to منتشر شد، به تفصیل شرح داده شده است. این راهنما مجموعه‌ای از ابزارهای لایه‌بندی شده را برای مقیاس‌بندی توسعه معرفی می‌کند.

این تغییر رویکرد در حالی رخ می‌دهد که توسعه‌دهندگان از تعاملات پراکنده و تک‌باره فاصله گرفته و به سمت گردش‌های کاری عامل‌محور (Agentic) و پایدار حرکت می‌کنند. برای درک بهتر، پیش‌تر گزارش داده بودیم که چگونه یک توسعه‌دهنده مستقل تقریباً ۸,۹۰۰ دلار هزینه کرد تا شش پروژه را در دو هفته عرضه کند؛ اکنون تمرکز از «حجم خروجی خام» به «دقت پیکربندی زیربنایی» تغییر یافته است. این پشتهٔ فنی را می‌توان شبیه تفاوت بین درخواست یک لطف کوچک از یک فریلنسر و نوشتن یک قانون‌اساسی رسمی برای یک شرکت دانست؛ در حالت دوم، هیچ‌چیز به شانس سپرده نمی‌شود و همه چیز ساختاریافته است.

درک پشتهٔ پیکربندی

bسیاری از کاربران با Claude Code مانند یک ابزار تکمیل خودکار (Autocomplete) هوشمند برخورد می‌کنند. اما واقعیت این است که این یک سیستم کاملاً برنامه‌پذیر است. هدف نهایی این است که ابزاری که برای «چت کردن» استفاده می‌شود از ابزاری که برای «مهندسی» به کار می‌رود، جدا شود. این هدف از طریق پشته‌ای از مکانیزم‌های پیکربندی محقق می‌شود که در آن هر ابزار مسئله‌ای متمایز را حل می‌کند تا توسعه‌دهنده بتواند محیطی سبک و بهینه (Lean) داشته باشد.

بر اساس راهنماهای dev.to، پایه و اساس این ساختار فایل CLAUDE.md است. این فایل مانند «منبع حقیقت» (Source of Truth) پروژه عمل می‌کند و در شروع هر جلسه خوانده می‌شود تا پشتهٔ تکنولوژی (مثلاً تعیین دقیق استفاده از Next.js 15 به‌جای نسخه ۱۴) و چیدمان دایرکتوری‌ها را تعریف کند. این فایل حاوی حقایقی است که همیشه در پروژه صادق‌اند: قراردادهای خاص کدنویسی و بخش‌هایی که Claude هرگز نباید به آن‌ها دست بزند. اما یک هشدار مهم وجود دارد؛ اگر این فایل بیش از حد مفصل و طولانی شود، منجر به کاهش عملکرد می‌گردد. وقتی فایل بیش از حد بزرگ شود، Claude ممکن است شروع به نادیده گرفتن قوانین حیاتی کند.

برای حل این مشکل و جلوگیری از臃肿 (bloated) شدن فایل markdown، توسعه‌دهندگان تشویق می‌شوند تا از مکانیزم‌های پیشرفته‌تر زیر استفاده کنند:

جزئیات پیاده‌سازی

  • دستورات اسلش (Slash Commands): این‌ها در واقع قالب‌های پرامپت قابل استفاده مجدد هستند که با نام فراخوانی می‌شوند. هر چیزی که به طور مکرر تایپ می‌کنید — مانند فرمت خاص برای کامیت‌ها یا چک‌لیست بازبینی کد — می‌تواند به دستوری تبدیل شود که با یک علامت / فعال می‌گردد. برای مثال، فایلی در مسیر # .claude/commands/review.md می‌تواند طوری تنظیم شود که تغییرات Stage شده را از نظر امنیت، استایل و پوشش تست‌ها بررسی کرده و یافته‌ها را بر اساس شدت خطا گزارش دهد.
  • عامل‌های فرعی (Subagents): این‌ها نمونه‌های جداگانه‌ای از کلود با پنجرهٔ زمینه (Context Window) مستقل هستند. آن‌ها برای کارهای تفویض‌شده‌ای که نیاز به اکتشاف سنگین دارند استفاده می‌شوند؛ مثلاً دستوری مانند «برو کل کدبیس را بخوان و به من بگو سیستم احراز هویت (Auth) چگونه کار می‌کند». عامل فرعی عملیات خواندن را انجام داده و فقط پاسخ نهایی را برمی‌گرداند، به‌گونه‌ای که زمینهٔ (Context) جلسهٔ اصلی پاک و بهینه بماند.
  • هوک‌ها (Hooks): این‌ها اسکریپت‌های رویداد-محور هستند که کد واقعی را اجرا می‌کنند. در حالی که CLAUDE.md از کلود «می‌خواهد» که قانونی را رعایت کند، یک هوک این قانون را در سطح سیستم «اجبار» می‌کند. این یعنی به‌جای یک درخواست، یک تضمین داریم. هوک‌ها به توسعه‌دهندگان اجازه می‌دهند دستورات خطرناک را مسدود کنند یا به‌طور خودکار بعد از هر ویرایش، یک فرمتر (Formatter) را اجرا نمایند.
  • مهارت‌ها و پلاگین‌ها (Skills and Plugins): مهارت‌ها قابلیت‌های مورد نیاز را در اختیار می‌گیرند که تنها زمانی بارگذاری می‌شوند که مرتبط باشند؛ این کار مانع از حجیم شدن CLAUDE.md می‌شود. پلاگین‌ها نیز دستورات، عامل‌های فرعی، هوک‌ها و مهارت‌ها را در یک واحد نسخه‌بندی شده (Versioned Unit) جمع می‌کنند. این ساختار اجازه می‌دهد پیکربندی از یک پروژه تک‌نفره به سطح یک سازمان کامل مقیاس یابد.

پشته پیکربندی Claude Code: فراتر از CLAUDE.md

انتخاب ابزار مناسب

انتخاب مکانیزم درست به ماهیت نیاز شما بستگی دارد:

  • CLAUDE.md: برای مواردی که «همیشه» صادق هستند.
  • دستور اسلش: برای مواردی که «تکرار» می‌شوند.
  • مهارت (Skill): برای قابلیت‌هایی که باید «در صورت نیاز» بارگذاری شوند.
  • عامل فرعی (Subagent): برای کارهایی که باید «خارج از زمینه اصلی» باقی بمانند.
  • هوک (Hook): برای مواردی که حتماً باید «اجبار» شوند.
  • پلاگین: برای بسته‌بندی و اشتراک‌گذاری کل تنظیمات.

از دیدگاه عملی، این بدان معناست که توسعه‌دهندگان دیگر فقط در حال «پرامپت‌نویسی» برای یک AI نیستند، بلکه در حال ساخت یک سیستم‌عامل محلی برای کدبیس خود هستند. مزیت اصلی این است که هدایت بر اساس درخواست (Request-based) به اجرای قطعی و معین (Deterministic Enforcement) تغییر می‌یابد. در حالی که یک فایل markdown از AI می‌خواهد قانونی را دنبال کند، یک هوک آن را تضمین می‌کند.

از نظر اقتصادی و گردش کار، این رویکرد «مالیات زمینه» (Context Tax) و تکرار توهمات (Hallucinations) ناشی از فایل‌های پرامپت حجیم را کاهش می‌دهد. با سپردن کارهای سنگین به عامل‌های فرعی، توسعه‌دهندگان می‌توانند یک جلسه اصلی با عملکرد بالا و سبک را حفظ کنند.

برای شروع مقیاس‌بندی، با یک CLAUDE.md سبک شروع کنید و تنها زمانی هوک‌ها و پلاگین‌ها را معرفی کنید که الگوی تکرار یا نیاز به اجبار سخت‌گیرانه ظاهر شود. کاربران می‌توانند برای دسترسی به مثال‌های توضیح‌داده شده و تست‌های تک‌خطی از «برگه تقلب شروع سریع CLAUDE.md» یا برای یک برنامه ۳۰ روزه و walkthroughهای واقعی از «راهنمای کامل پیکربندی Claude Code» استفاده کنند.

گام بعدی شما

  • یک فایل CLAUDE.md بسیار سبک بنویسید و فقط موارد حیاتی را در آن قرار دهید.
  • الگوهای تکراری در چت‌های خود را شناسایی کرده و آن‌ها را به دستورات اسلش تبدیل کنید.
  • برای اجرای فرمترهای کد یا تست‌های امنیتی، از هوک‌های سیستمی به‌جای درخواست‌های متنی استفاده کنید.

اما داستان سخت‌افزاری این تحول حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی تراشه‌های Blackwell مراجعه کنید.

چرا این موضوع مهم است؟

این متدولوژی با کاهش حجم داده‌های ورودی در هر جلسه، هزینه استنتاج را کاهش و دقت را افزایش می‌دهد. تخصص در مدیریت این پشتهٔ پیکربندی، مرز بین یک کاربر عادی و یک مهندس AI را تعیین خواهد کرد.

تأثیر برای ایران

به‌دلیل محدودیت‌های دسترسی به APIهای پیشرفته کلود در ایران، این متدولوژی بیشتر برای توسعه‌دهندگانی کاربرد دارد که از طریق سرویس‌های واسط یا VPN به Claude Code دسترسی دارند.

·نگاه ما
تحریریه دات‌هوش

جایگزینی دستورات متنی با هوک‌های سیستمی، نقطهٔ گذار از «همکاری با هوش مصنوعی» به «برنامه‌ریزی هوش مصنوعی» است. این رویکرد نشان می‌دهد که آیندهٔ بهره‌وری نه در مهندسی پرامپت‌های پیچیده، بلکه در ساخت محیط‌های اجرایی است که مدل را مجبور به رعایت استانداردهای سخت‌گیرانه می‌کند.

منابع

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.