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

در این راهنما از آکادمی برنامه نویسی بدیعی می‌بینید Claude Code چیست، با چت‌بات معمولی چه فرقی دارد، چطور شروع کنید، چه درخواست‌هایی جواب بهتری می‌دهد و چطور تغییرات آن را امن بررسی کنید.

Claude Code چیست و چه فرقی با چت‌بات دارد؟

Claude Code یک ایجنت کدنویسی است؛ یعنی به‌جای این‌که فقط جواب متنی بدهد، می‌تواند فایل‌های پروژه را بخواند، ویرایش کند و دستورهایی مثل اجرای تست را اجرا کند. در چت‌بات، شما کد را کپی می‌کنید و جواب را برمی‌گردانید. در Claude Code، ابزار خودش در پروژه کار می‌کند و شما تأیید و بررسی می‌کنید.

ویژگی چت‌بات (مثل Claude در مرورگر) Claude Code

محیط کار صفحه گفت‌وگو ترمینال و پوشه پروژه (و افزونه‌های ویرایشگر)

دسترسی به کد فقط چیزی که کپی می‌کنید خواندن فایل‌های پروژه

تغییر فایل شما دستی اعمال می‌کنید خودش ویرایش می‌کند، با اجازه شما

اجرای دستور ندارد می‌تواند تست، build و دستورهای دیگر را اجرا کند

مناسب برای یادگیری، سوال، تکه‌کد کارهای چندفایلی و چندمرحله‌ای

⚠️ امکانات، محیط‌های پشتیبانی‌شده (ترمینال، افزونه ویرایشگر، نسخه وب یا دسکتاپ) و طرح‌های اشتراک Claude Code مدام تغییر می‌کند .

برای آشنایی کلی با سه دسته ابزار (چت‌بات، دستیار IDE و ایجنت)، مقاله آموزش ابزارهای کدنویسی با هوش مصنوعی را بخوانید.

Claude Code برای چه کسانی مناسب است؟

Claude Code برای کسانی مفیدتر است که مبانی برنامه‌نویسی، کار با ترمینال و Git را بلدند. چون ایجنت تغییرات واقعی در پروژه ایجاد می‌کند، باید بتوانید آن تغییرات را بخوانید و قضاوت کنید.

برنامه‌نویس‌های شاغل: برای کارهای تکراری، نوشتن تست، بازنویسی کد و بررسی پروژه‌های ناآشنا.

دانشجوها و یادگیرندگان سطح متوسط: برای فهم ساختار پروژه‌های بزرگ‌تر، به شرط این‌که هر تغییر را بخوانند.

فریلنسرها: برای سرعت بیشتر در کارهای روتین پروژه‌ها.

مبتدی‌های مطلق: بهتر است اول با چت‌بات و مبانی شروع کنند و بعد سراغ ایجنت بیایند.

پیش‌نیازهای شروع کار با Claude Code

قبل از شروع به یک حساب کاربری، دسترسی به سرویس، یک پروژه تحت Git و آشنایی پایه با ترمینال نیاز دارید.

حساب و اشتراک یا کلید API: ⚠️ روش‌های دسترسی و طرح‌های قیمت‌گذاری تغییر می‌کند انتشار .

دسترسی از ایران: ⚠️ سرویس‌های Anthropic برای کاربران ایرانی ممکن است محدودیت دسترسی، ثبت‌نام یا پرداخت داشته باشند. قوانین و شرایط استفاده را از منابع رسمی بررسی کنید .

ترمینال: دستورهای پایه مثل جابه‌جایی بین پوشه‌ها.

Git: برای ذخیره نسخه سالم و بررسی تغییرات.

یک پروژه تمرینی: شروع روی پروژه کم‌اهمیت، نه کد اصلی شرکت.

نصب و شروع Claude Code

روند کلی ساده است: ابزار را نصب می‌کنید، در پوشه پروژه دستور شروع را می‌زنید، وارد حساب می‌شوید و به زبان طبیعی درخواست می‌دهید.

⚠️ روش نصب و دستورهای زیر ممکن است تغییر کرده باشد؛ همیشه دستور به‌روز را از مستندات رسمی Anthropic بگیرید . یکی از روش‌های نصب شناخته‌شده، نصب از طریق npm است:

npm install -g @anthropic-ai/claude-code

cd my-project

claude

بعد از اجرای دستور claude در پوشه پروژه، یک محیط گفت‌وگو در ترمینال باز می‌شود. از این‌جا می‌توانید درخواست بدهید، مثلا «ساختار این پروژه را توضیح بده».

اولین درخواست پیشنهادی

قبل از هر تغییری، از Claude Code بخواهید پروژه را بشناسد:

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

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

فایل CLAUDE.md؛ دستورالعمل دائمی پروژه

CLAUDE.md یک فایل متنی در پروژه است که قراردادها و نکته‌های مهم پروژه را برای Claude Code توضیح می‌دهد تا لازم نباشد هر بار تکرارشان کنید. این فایل یکی از مؤثرترین راه‌ها برای بهتر کردن کیفیت خروجی است.

چیزهایی که خوب است در CLAUDE.md بنویسید:

تکنولوژی‌ها: زبان، فریم‌ورک و نسخه‌ها.

دستورهای اجرا و تست: مثلا dotnet build و dotnet test .

قراردادهای کدنویسی: نام‌گذاری، ساختار لایه‌ها، الگوهای مورد استفاده.

محدودیت‌ها: مثلا «بدون هماهنگی پکیج جدید اضافه نکن».

نمونه ساده برای یک پروژه ASP.NET Core:

# راهنمای پروژه

- پروژه ASP.NET Core با معماری تمیز (Domain، Application، Infrastructure، Web)

- دسترسی به داده فقط با EF Core و از طریق Repository

- سرویس‌ها با Dependency Injection ثبت می‌شوند

- اجرای تست: dotnet test

- قبل از اضافه کردن پکیج NuGet جدید سوال کن

⚠️ ابزار ممکن است دستوری برای ساخت خودکار این فایل داشته باشد (مثلا /init )؛ نام و رفتار دستورها را در مستندات رسمی بررسی کنید .

گردش‌کار امن با Claude Code

گردش‌کار امن یعنی قبل از هر کار نسخه سالم را در Git ذخیره کنید، اول برنامه بخواهید، تغییرات کوچک بدهید و همه چیز را با diff و تست بررسی کنید.

قدم ۱: ذخیره وضعیت فعلی

git status

git add .

git commit -m "نسخه سالم قبل از کار با Claude Code"

قدم ۲: اول برنامه، بعد اجرا

«می‌خواهم امکان جست‌وجوی محصول بر اساس نام اضافه شود. اول برنامه‌ات را بگو: کدام فایل‌ها را تغییر می‌دهی و چرا. تا تأیید نکرده‌ام کد ننویس.»

قدم ۳: تأیید آگاهانه مجوزها

Claude Code برای ویرایش فایل یا اجرای دستور معمولا از شما اجازه می‌گیرد. هر درخواست را بخوانید و فقط کارهایی را تأیید کنید که می‌فهمید. ⚠️ حالت‌های مجوز و اجرای خودکار در نسخه‌های مختلف متفاوت است .

قدم ۴: بررسی تغییرات

git diff

هر خط تغییر را بخوانید. اگر بخشی را نفهمیدید، از خود Claude Code بخواهید توضیح دهد.

قدم ۵: اجرای تست و برنامه

برنامه را اجرا کنید و قابلیت جدید را دستی هم امتحان کنید. اگر تست دارید، از ابزار بخواهید تست‌ها را اجرا کند و نتیجه را گزارش دهد.

قدم ۶: commit یا برگشت

اگر نتیجه خوب بود commit کنید. اگر نه، با Git به نسخه قبلی برگردید و درخواست را دقیق‌تر تکرار کنید.

نمونه درخواست‌های کاربردی برای Claude Code

بهترین درخواست‌ها کار مشخص، محدوده روشن و معیار درستی دارند. این نمونه‌ها را برای پروژه خودتان تغییر دهید:

فهم کد: «توضیح بده درخواست ورود کاربر از کنترلر تا پایگاه داده از کدام کلاس‌ها عبور می‌کند.»

نوشتن تست: «برای کلاس OrderService تست واحد بنویس. حالت‌های سبد خالی و تخفیف منقضی‌شده را هم پوشش بده. بعد تست‌ها را اجرا کن.»

رفع باگ: «این تست شکست می‌خورد: [نام تست]. علت را پیدا کن، قبل از تغییر توضیح بده و بعد کمترین تغییر لازم را بده.»

بازنویسی: «متد CalculateTotal خیلی طولانی است. آن را بدون تغییر رفتار به متدهای کوچک‌تر بشکن و بعد تست‌ها را اجرا کن.»

بررسی امنیت: «کنترلرهای این پروژه را از نظر اعتبارسنجی ورودی و مجوز دسترسی بررسی کن و فقط گزارش بده، چیزی را تغییر نده.»

مستندسازی: «برای این پروژه یک README بنویس که نحوه اجرا و ساختار پوشه‌ها را توضیح دهد.»

نکته‌ها:

یک کار در هر درخواست. کار بزرگ را به چند مرحله بشکنید.

محدوده را بگویید: «فقط پوشه Services را تغییر بده».

معیار پایان را مشخص کنید: «وقتی همه تست‌ها پاس شد کار تمام است».

محدودیت‌ها و ریسک‌های Claude Code

Claude Code قدرتمند است، اما خطاناپذیر نیست؛ ممکن است کد اشتباه بنویسد، چیزی را بیش از حد تغییر دهد یا راه‌حل پیچیده‌تری از لازم ارائه کند.

کد اشتباه با ظاهر درست: همیشه تست و بررسی کنید.

تغییرات بیش از درخواست: با محدود کردن محدوده و بررسی diff کنترل کنید.

اجرای دستورهای حساس: دستورهایی که فایل حذف می‌کنند یا به سرور وصل می‌شوند را با دقت تأیید کنید.

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

هزینه و محدودیت مصرف: ⚠️ کارهای طولانی ممکن است سهمیه یا هزینه بیشتری مصرف کنند .

وابستگی به ابزار: اگر خودتان کد را نفهمید، در نگهداری پروژه به مشکل می‌خورید.

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

Claude Code در کنار ابزارهای دیگر

Claude Code جایگزین همه ابزارها نیست؛ بسیاری از برنامه‌نویس‌ها آن را در کنار یک چت‌بات و دستیار داخل ویرایشگر استفاده می‌کنند. هر ابزار برای یک نوع کار مناسب‌تر است:

چت‌بات: برای یادگیری مفهوم و پرسیدن سوال‌های کلی.

دستیار داخل IDE: برای تکمیل خودکار هنگام تایپ.

Claude Code و ایجنت‌های مشابه: برای کارهای چندفایلی، تست و بازنویسی.

برای مقایسه Claude Code با ابزارهایی مثل Cursor و GitHub Copilot، مقاله بهترین هوش مصنوعی برای برنامه‌نویسی در سال ۲۰۲۶ را بخوانید. اگر بیشتر با ChatGPT کار می‌کنید، مقاله برنامه نویسی با ChatGPT را ببینید.

چرا هنوز باید برنامه‌نویسی را اصولی یاد بگیرید؟

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

مهارت‌هایی که کار با Claude Code را مؤثرتر می‌کند:

شیءگرایی و الگوهای طراحی: برای فهم و ارزیابی ساختار کد.

معماری تمیز یا پیازی: برای این‌که بگویید هر کد کجا باید قرار بگیرد.

تست‌نویسی: برای این‌که درستی تغییرات را خودکار بسنجید.

Git: برای کنترل کامل روی تغییرات.

جمع‌بندی

آموزش Claude Code بیشتر از آن‌که درباره دستورها باشد، درباره روش کار است: پروژه را تحت Git نگه دارید، با فایل CLAUDE.md زمینه بدهید، اول برنامه بخواهید، تغییرات کوچک بدهید و هر تغییر را با diff و تست بررسی کنید. این ابزار سرعت برنامه‌نویس آگاه را زیاد می‌کند، اما جای دانش او را نمی‌گیرد.

اگر می‌خواهید پایه‌ای بسازید که با آن ایجنت‌هایی مثل Claude Code را با اطمینان هدایت کنید ، دوره جامع فول‌استک وب طلایی آکادمی برنامه نویسی بدیعی با C#، ASP.NET Core، کد تمیز، SOLID، معماری تمیز و Git را ببینید یا از صفحه اصلی سایت مشاوره رایگان بگیرید.

سوالات متداول

Claude Code چیست؟

یک ایجنت کدنویسی از شرکت Anthropic است که در پوشه پروژه کار می‌کند و می‌تواند با اجازه شما فایل‌ها را بخواند، ویرایش کند و دستور اجرا کند.

آیا Claude Code رایگان است؟

⚠️ معمولا به اشتراک یا اعتبار API نیاز دارد. طرح‌ها و قیمت‌ها تغییر می‌کند، پس آن را از سایت رسمی بررسی کنید .

آیا مبتدی‌ها می‌توانند از Claude Code استفاده کنند؟

می‌توانند، اما بهتر است اول مبانی برنامه‌نویسی، ترمینال و Git را یاد بگیرند تا بتوانند تغییرات ایجنت را بفهمند و بررسی کنند.

فرق Claude Code با چت‌بات Claude چیست؟

چت‌بات فقط جواب متنی می‌دهد و شما کد را دستی منتقل می‌کنید. Claude Code مستقیم در پروژه کار می‌کند و فایل‌ها را تغییر می‌دهد.

فایل CLAUDE.md چه کاربردی دارد؟

قراردادها، دستورهای اجرا و محدودیت‌های پروژه را برای Claude Code توضیح می‌دهد تا خروجی با سبک پروژه شما هماهنگ باشد.

آیا Claude Code با پروژه‌های C# و ASP.NET Core کار می‌کند؟

بله، با بیشتر زبان‌ها و فریم‌ورک‌های رایج کار می‌کند. کیفیت نتیجه به زمینه‌ای که می‌دهید و بررسی شما بستگی دارد.