کتاب The Claude Code Operating Model

کتاب The Claude Code Operating Model: Build scalable AI coding systems with Skills, MCP, Hooks, agent orchestration, and SDK patterns (مدل عملیاتی Claude Code: ساخت سیستم‌های کدنویسی مقیاس‌پذیر با هوش مصنوعی با استفاده از Skills، MCP، Hooks، هماهنگ‌سازی عامل‌ها و الگوهای SDK) یک منبع فنی و پیشرفته برای توسعه‌دهندگانی است که می‌خواهند فراتر از استفادهٔ ساده از هوش مصنوعی، سیستم‌های کدنویسی مقیاس‌پذیر و خودکار مبتنی بر مدل Claude را طراحی و پیاده‌سازی کنند.

در ادامه مقدمه‌ای از کتاب The Claude Code Operating Model را از زبان نویسنده شرح خواهیم داد.

مقدمه‌ای بر کتاب The Claude Code Operating Model:

برای دو سال، صنعت بیش از هر چیز یک سؤال می‌پرسید: کدام مدل قدرتمندتر است؟ این، برای زمان خود سؤال درستی بود. اما جایی در سال ۲۰۲۵، شرایط تغییر کرد. مدل‌های پیشرو آن‌قدر توانمند و به هم نزدیک شدند که کیفیت خام مدل دیگر عامل تمایز میان یک سیستم کارآمد و سیستمی ناامیدکننده نبود. عامل تمایز، همه چیزِ پیرامون مدل بود: کانتکستی که به آن می‌دادید، ابزارهایی که در اختیارش می‌گذاشتید، محیطی که در آن اجرا می‌شد و محدودیت‌ها و سازوکارهای کنترلی که برایش تعیین می‌کردید.

این ساختار پیرامونی در این کتاب یک نام دارد: هارنس (Harness). استدلال اصلی این صفحات ساده است، اما اجرای آن دشوار: یک عامل هوشمند، حاصلِ مدل + هارنس است؛ و هنگامی که مدل‌ها به کالایی عمومی تبدیل می‌شوند، بخش اصلی مهندسی در هارنس شکل می‌گیرد.

امروزه Claude Code روشن‌ترین نمونه موجود از این ایده است. در ظاهر، یک دستیار کدنویسی خط فرمان است؛ اما در لایه زیرین، یک هارنس کامل و قابل بررسی محسوب می‌شود: فایل `CLAUDE.md` کانتکست را تزریق می‌کند، Skills و زیرعامل‌ها قابلیت‌ها را گسترش می‌دهند، Hooks و مجوزها کنترل را اعمال می‌کنند و حالت Headless، Agent SDK و افزونه‌ها، همه این اجزا را به محیط‌های اجرای واقعی منتقل می‌کنند.

این کتاب، Claude Code را سازوکار به سازوکار تحلیل می‌کند؛ نه برای تحسین آن، بلکه برای آموزش اصول بنیادین این رویکرد. هدف این است که آموخته‌های شما به هر عاملی که می‌سازید، در هر فریم‌ورکی و حتی مدت‌ها پس از تغییر ابزار فعلی، قابل انتقال باشد.

کتاب The Claude Code Operating Model یک راهنمای مهندسی عملی است، نه صرفاً یک مرور کلی. هر سازوکار با یک مسئله مشخص معرفی می‌شود، در کد واقعی پیاده‌سازی می‌گردد و تا جایی پیش می‌رود که یا کارآمدی خود را نشان دهد یا محدودیت‌هایش آشکار شود. فصل‌ها بر پایه یکدیگر ساخته می‌شوند: فصل‌های ابتدایی چهار لایه هارنس، یعنی کانتکست، ابزارها، اجرا و حاکمیت را پایه‌گذاری می‌کنند؛ و فصل‌های بعدی آن‌ها را در قالب پایپ‌لاین‌های Headless، عامل‌های سفارشی مبتنی بر SDK، افزونه‌های قابل اشتراک و در نهایت روش‌های کاری تیمی ترکیب می‌کنند تا کل سازمان بتواند بدون آشفتگی با این رویکرد کار کند.

توضیحی درباره شخصیت‌ها

در سراسر کتاب The Claude Code Operating Model، در گفت‌وگوهای کوتاه با سه شخصیت تکرارشونده روبه‌رو می‌شوید:

• شیائوبینگ (Xiaobing): مهندسی که Claude Code را در پروژه‌های واقعی به کار می‌گیرد.
• شیائوشوئه (Xiaoxue): دیدگاهی مبتنی بر تحلیل داده دارد و پرسش‌هایی را مطرح می‌کند که یک متخصص در عمل با آن‌ها روبه‌رو می‌شود.
• کاگه (Kage): مربی ارشد فنی که به آن‌ها کمک می‌کند درباره تصمیم‌های معماری استدلال کنند.

این شخصیت‌ها صرفاً تزئینی نیستند؛ هر گفت‌وگو یک چالش یا تنش طراحی را بازنمایی می‌کند که شما نیز با آن مواجه خواهید شد و فصل پس از آن، راه‌حل آن را در قالب کد ارائه می‌دهد.

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

هدف من این است که پس از پایان کتاب، فقط ندانید چگونه با Claude Code کار کنید؛ بلکه یاد بگیرید چگونه درباره هارنسِ زیرِ هر عامل هوشمند فکر کنید و چگونه هارنسی بسازید که شایسته اعتماد باشد.

کتاب The Claude Code Operating Model برای چه کسانی است؟

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

اگر Claude Code یا ابزاری مشابه را اجرا کرده‌اید، هم قدرت آن را دیده‌اید و هم با لبه‌های ناصاف و محدودیت‌هایش روبه‌رو شده‌اید؛ و اکنون می‌خواهید سازوکار درونی آن را آن‌قدر خوب درک کنید که به‌جای درگیری با آن، بتوانید شکلش دهید، این کتاب برای شما نوشته شده است.

آشنایی عملی با خط فرمان، Git و حداقل یک زبان برنامه‌نویسی ضروری فرض شده است. مثال‌ها بیشتر بر Python، JavaScript/TypeScript و Shell تکیه دارند. نیازی به تجربه قبلی در فریم‌ورک‌های عامل‌محور یا جزئیات داخلی مدل‌های زبانی بزرگ (LLM) ندارید؛ کتاب این مفاهیم را در طول مسیر، از اصول اولیه می‌سازد.

کتاب The Claude Code Operating Model چه موضوعاتی را پوشش می‌دهد؟

فصل ۱: Claude Code به‌عنوان یک فریم‌ورک عامل‌محور — مروری بر معماری فنی

این فصل از کتاب The Claude Code Operating Model دیدگاه محوری کتاب، یعنی «عامل = مدل + هارنس» را معرفی می‌کند و چهار لایه کانتکست، ابزارها، اجرا و حاکمیت را که در ادامه کتاب تکمیل می‌شوند، ترسیم می‌نماید.

فصل ۲: یادگیری از گذشته — شیوه‌های مهندسی سیستم حافظه

این فصل از کتاب The Claude Code Operating Model بررسی می‌کند که Claude Code چگونه از طریق سلسله‌مراتب `CLAUDE.md` و دامنه‌های حافظه خود، کانتکست را مدیریت می‌کند؛ همچنین می‌آموزید چگونه این کانتکست را کم‌حجم، لایه‌ای و با ترتیب بارگذاری درست نگه دارید.

فصل ۳: به جای ماهی دادن، ماهیگیری یاد بدهید — مهندسی مهارت‌های قابل استفاده مجدد

این فصل Skills را معرفی می‌کند: بسته‌های قابلیتِ اظهاری که در `SKILL.md` تعریف می‌شوند. همچنین نشان می‌دهد چگونه آن‌ها را طراحی، محدوده‌بندی و فعال کنید تا Claude در زمان مناسب به سراغ قابلیت مناسب برود.

فصل ۴: تقسیم و غلبه — هنر زیرعامل‌ها و واگذاری وظایف

این فصل از کتاب The Claude Code Operating Model به زیرعامل‌ها و ایزوله‌سازی کانتکست می‌پردازد: اینکه چگونه کار را تجزیه کنید، آن را به عامل‌های متمرکز بسپارید و خروجی‌ها را به‌صورت قطعی و قابل اتکا تجمیع نمایید.

فصل ۵: از دستورالعمل تا گاردریل — خودکارسازی کنترل با Hooks

این فصل از کتاب The Claude Code Operating Model دستورالعمل‌های نرم را با استفاده از سازوکار رویدادمحور Hooks به گاردریل‌های اجرایی تبدیل می‌کند؛ از جمله نشان می‌دهد که یک Hook چگونه پیش از اجرا، یک اقدام خطرناک را مسدود می‌کند.

فصل ۶: اتصال همه‌چیز — یکپارچه‌سازی ابزارهای خارجی با MCP

این فصل Claude Code را از طریق پروتکل کانتکست مدل (Model Context Protocol یا MCP) به دنیای بیرون متصل می‌کند؛ به‌گونه‌ای که ابزارهای خارجی، منابع داده و اطلاعات احراز هویت به‌صورت ایمن در دسترس قرار گیرند.

فصل ۷: حالت Headless و یکپارچه‌سازی CI/CD

در این فصل، Claude Code از ترمینال تعاملی خارج و وارد اتوماسیون می‌شود: اجرای Headless، محدودیت‌های بودجه و تعداد نوبت‌های پردازش، و پایپ‌لاین‌های کامل CI/CD در GitHub Actions، GitLab و Jenkins.

فصل ۸: ساخت با Claude به‌عنوان موتور — کیت توسعه عامل هوشمند Agent SDK

این فصل کتاب The Claude Code Operating Model از هدایت Claude با پارامترها فراتر می‌رود و به ارکستراسیون آن در کد می‌پردازد: ابزارهای سفارشی با دکوراتور `@tool`، خروجی ساخت‌یافته، لایه‌های مجوز و یک سرویس کامل مبتنی بر SDK.

فصل ۹: از مهارت فردی تا دارایی اشتراکی — اکوسیستم افزونه‌ها

در این فصل، Skills، زیرعامل‌ها، Hooks و MCP در قالب افزونه‌های قابل توزیع بسته‌بندی می‌شوند. همچنین می‌آموزید بازارچه‌های خصوصی چگونه پیکربندی یک مهندس را به استانداردی برای کل تیم تبدیل می‌کنند.

فصل ۱۰: از فرد تا تیم — روش‌های مهندسی برای Claude Code

این فصل از کتاب The Claude Code Operating Model لایه حاکمیت را در مقیاس سازمانی بررسی می‌کند: هزینه، رفع اشکال، امنیت، مقیاس‌پذیری، دستورالعمل‌ها و همکاری تیمی؛ تا یک تیم کامل بتواند با این شیوه کار کند، بدون آن‌که دچار آشفتگی شود.

پس‌گفتار: راه شمشیر

پس‌گفتار از استعاره راهنمای کتاب و ایده اصلی هارنس فاصله می‌گیرد و به روش‌شناسی گسترده‌تر و الگوهای طراحی مرتبط با این رویکرد اشاره می‌کند.

سرفصل‌های کتاب The Claude Code Operating Model:

• Preface
• Chapter 1: Claude Code as an Agent Framework: a Technical Architecture Overview
• Chapter 2: Learning From the Past: Engineering Practice of the Memory System
• Chapter 3: Teaching a Man to Fish: Engineering Reusable Skills
• Chapter 4: Divide and Conquer: The Art of Sub-Agents and Task Delegation
• Chapter 5: From Guidelines to Guardrails: Automating Control with Hooks
• Chapter 6: Connecting Everything: Integrating External Tools with MCP
• Chapter 7: Headless Mode and CI/CD Integration
• Chapter 8: Building with Claude as the Engine: Agent SDK Intelligent Agent Development Kit
• Chapter 9: From Personal Craft to Shared Asset: The Plugin Ecosystem
• Chapter 10: From Individual to Team: Engineering Practices for Claude Code
• Afterword: The Way of the Blade
• Other Books You May Enjoy
• Index

جهت دانلود کتاب The Claude Code Operating Model می‌توانید پس از پرداخت، دریافت کنید.