کلاد کُد — راهنمای کامل

کلاد کُد چیه؟ 🤔

کلاد کُد یه ابزار خط فرمان (CLI) ساخته آنتروپیکه که مستقیم توی ترمینالت اجرا میشه. برخلاف کلاد چَت که توی مرورگر کار می‌کنی، اینجا کلاد مستقیم به فایل‌های پروژه‌ات دسترسی داره — کد می‌نویسه، تست اجرا می‌کنه، کامیت می‌ذاره و همه چیز رو خودش انجام میده. یه توسعه‌دهنده ارشد تموم‌وقت که توی ترمینالته. 🔥

قابلیت‌های کلاد کُد 🛠️

• خوندن، نوشتن و ویرایش مستقیم فایل‌های پروژه

• اجرای دستورات ترمینال و اسکریپت

• دیباگ، ریفکتور و تست کد

• مدیریت گیت (کامیت، برنچ، پول ریکوئست)

• اتصال به سرورهای خارجی از طریق MCP

• پشتیبانی از دستورات سفارشی Slash و Hooks

• اتصال به IDE مثل VS Code و JetBrains

• اجرای ایجنت‌های موازی برای کارهای بزرگ

ساختار پوشه پروژه در کلاد کُد 📁

وقتی یه پروژه رو با کلاد کُد باز می‌کنی، این ساختار خونده یا ایجاد میشه:

فایل CLAUDE.md چیه؟ 🧠

این فایل مغز پروژه‌ته. قبل از هر کاری، کلاد این فایل رو می‌خونه تا ساختار، قوانین و context پروژه رو بفهمه. اینجاست که مشخص می‌کنی کلاد چطور رفتار کنه، از چه تکنولوژی‌هایی استفاده بشه و چی رو نباید لمس کنه.

سه سطح دستورالعمل

• گلوبال (همه پروژه‌ها): ~/.claude/CLAUDE.md

• پروژه (اشتراکی با تیم، توی گیت): .claude/CLAUDE.md

• محلی (override شخصی، gitignored): ./CLAUDE.local.md

چرا اکثر CLAUDE.md ها کار نمی‌کنن؟ ⚠️

خیلی طولانی هستن. مدل‌ها می‌تونن حدوداً ۱۵۰ تا ۲۰۰ دستور رو دنبال کنن. پرامپت سیستمی کلاد کُد خودش حدود ۵۰ دستور داره — یعنی فایل تو فقط ۱۰۰ تا ۱۵۰ دستور فضا داره. اگه بیشتر از ۲۰۰ خطه، کلاد عمداً نادیده‌شون نمی‌گیره، فقط دیگه جا نداره.

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

هیچ سلسله‌مراتبی ندارن. همه چیز رو توی یه فایل می‌ریزن به جای اینکه از سه سطح مختلف استفاده کنن.

پنج بخش اصلی یه CLAUDE.md خوب ✅

۱. دستورات مهم

۲. نقشه معماری

۳. قوانین سخت — چیزایی که کلاد بدونشون اشتباه می‌کنه

۴. روش کار

۵. چی رو نباید بنویسی

تمپلیت آماده برای CLAUDE.md 📋

اضافه کردن MCP به پروژه 🔗

برای اضافه کردن یه سرور MCP از این دستور توی ترمینال استفاده کن:

مستندات کامل MCP: https://code.claude.com/docs/en/mcp

بهترین اسکیل‌ها 🎯

• استخراج، ویرایش و ادغام پی‌دی‌اف — PDF Processor

• ساخت و ویرایش اسناد ورد با tracked changes — Word Document Processor

• ساخت پرزنتیشن با لایه‌بندی و اسلاید نوت — PowerPoint Processor

• فرمول، تحلیل داده و نمودار اکسل — Excel Spreadsheet Processor

• ساخت اسکیل‌های سفارشی — Skill Creator

• ساخت سرور MCP اختصاصی برای هر API — MCP Builder

• ساخت artifact های پیچیده با ری‌اکت و تیلویند — Artifacts Builder

• طراحی بصری حرفه‌ای PNG و PDF — Canvas Design

• بیش از ۲۰ تکنیک اثبات‌شده (TDD، دیباگ، PR ریویو) — Superpowers

• بیش از ۸۶ اسکیل، قانون، hook و تنظیمات ایجنت — Everything Claude Code

• ساخت خودکار پول ریکوئست با کیفیت بالا — Pull Request

• مدیریت کامل ایشو و پروژه مستقیم توی کلاد — Linear

• دیپلوی اپ با preview، متغیرهای محیطی و لاگ — Vercel Deploy

• صرفه‌جویی در توکن و فشرده‌سازی پرامپت — Caveman

بهترین پلاگین‌ها 🔌

• وب اسکرپینگ سریع و قابل اطمینان برای ایجنت‌ها — Firecrawl

• اتوماسیون و تست مرورگر با زبان ساده — Playwright

• رابط کاربری حرفه‌ای با تایپوگرافی منحصربه‌فرد — Frontend Design

• فیدبک دقیق و جزئی روی کد و پول ریکوئست — Code Review / PR Review

• تزریق مستندات و context به‌روز به کلاد — Context7

• حلقه خودمختار ایجنت کدنویسی — Ralph Loop

• حفاظت از کد و اسرار پروژه — Security Guidance

• بررسی سازگاری پروژه با ایجنت‌های هوش مصنوعی — AgentLint

• هماهنگی ۲۲ ساب‌ایجنت به صورت موازی — maestro-orchestrate

• طراحی API، اسکیمای دیتابیس و معماری سیستم — backend-architect

• نوشتن و رفع خودکار تست‌ها (Jest، Pytest و...) — test-writer-fixer

• دیباگ پیشرفته و رفع stack trace — debugger + bug-fix

بهترین کانکتورها ⚡

• اتوماسیون بدون کد برای workflow های کلاد — Zapier

• ساخت و ویرایش داکیومنت و دیتابیس ساختارمند — Notion

• طراحی و دیباگ CI/CD با دسترسی ایمن — GitHub Actions

• مدیریت Workers، KV، D1 و R2 — Cloudflare

• مانیتورینگ خطا و تحلیل عملکرد — Sentry

• وب اسکرپینگ و استخراج داده (لید، رقبا) — Apify

• جستجوی پیشرفته وب برای ایجنت‌های تحقیقاتی — Exa Researcher

• حافظه دائمی بین session های مختلف — Memory MCP

• اتوماسیون workflow با اتصال به صدها سرویس — Pipedream

• ریویو خودکار کد با هوش مصنوعی — CodeRabbit

• اقدام روی بیش از ۵۰۰ اپ (Gmail، Slack، GitHub، Notion) — connect-apps Composio

• کار با بیش از ۵۰ اپ ادوبی — Adobe for Creativity

• کنترل کامل Blender با زبان طبیعی — Blender Connector

• تبدیل توضیح متنی به مدل سه‌بعدی — SketchUp Connector