کلود کد (Claude Code) چیست؟ آموزش نصب، اشتراک و شروع کار

Claude Code (کلود کد یا کلاد کد) ابزار برنامه‌نویسی شرکت Anthropic است که فقط کد پیشنهاد نمی‌دهد، بلکه خودش داخل پروژهٔ شما کار می‌کند: فایل‌ها را می‌خواند، چند فایل را با هم ویرایش می‌کند، دستور اجرا می‌کند، تست می‌گیرد و تغییرات را در گیت ثبت می‌کند. کار را به زبان ساده از او می‌خواهید، او قدم‌به‌قدم انجامش می‌دهد و بسته به تنظیمات، پیش از کارهای حساس از شما اجازه می‌گیرد. Claude Code در ترمینال، افزونهٔ VS Code و JetBrains، اپ دسکتاپ Claude و نسخهٔ وب اجرا می‌شود.

نسخهٔ رایگان Claude شامل Claude Code نیست. برای استفاده از آن یکی از پلن‌های پولی Pro، Max، Team یا Enterprise لازم است، یا حساب Claude Console که هزینه را به ازای مصرف API حساب می‌کند. محصول جداگانه‌ای هم به اسم «Claude Code Pro» وجود ندارد؛ کسی که دنبال آن است در واقع اشتراک Claude Pro یا Max می‌خواهد.

کلود کد چیست و چه فرقی با چت Claude دارد؟

وقتی در چت Claude سؤال برنامه‌نویسی می‌پرسید، کد را تحویل می‌گیرید و بقیهٔ کار با خودتان است: باید آن را در فایل درست بگذارید، اجرایش کنید و اگر خطا داد، خطا را دوباره در چت بچسبانید. Claude Code این رفت‌وبرگشت را حذف می‌کند. Anthropic آن را ابزار برنامه‌نویسی «عامل‌محور» (agentic) می‌نامد؛ یعنی هدف را از شما می‌گیرد، خودش برنامهٔ کار را می‌چیند، فایل‌های لازم را پیدا و ویرایش می‌کند، دستور اجرا می‌کند و نتیجه را می‌سنجد. لازم هم نیست فایل‌ها را دستی به او بدهید؛ طبق راهنمای شروع سریع، هر فایلی را که لازم داشته باشد خودش می‌خواند.

Claude Code به چه دردی می‌خورد؟

نمونه‌هایی که مستندات Claude Code آورده، نشان می‌دهد با آن چه کارهایی می‌شود کرد:

• کارهای تکراری که مدام عقب می‌اندازید: نوشتن تست برای کدی که تست ندارد، رفع خطاهای lint در کل پروژه، حل تعارض‌های merge، به‌روز کردن وابستگی‌ها و نوشتن یادداشت نسخهٔ جدید.
• ساخت قابلیت تازه و رفع باگ: پیام خطا را می‌چسبانید یا مشکل را توضیح می‌دهید. Claude Code رد خطا را در کد دنبال می‌کند، علت را پیدا می‌کند و اصلاحش می‌کند.
• کار با گیت: تغییرات را stage می‌کند، پیام کامیت می‌نویسد، شاخهٔ تازه می‌سازد و pull request باز می‌کند.
• آشنا شدن با پروژهٔ تازه: وقتی تازه وارد پروژه‌ای شده‌اید، می‌پرسید این پروژه چه کار می‌کند یا برنامه از کدام فایل شروع می‌شود و توضیح می‌گیرید.
• اتوماسیون: با گزینهٔ `-p` می‌شود خروجی دستورهای دیگر را به آن داد؛ مثلاً ۲۰۰ خط آخر یک فایل لاگ را به آن می‌دهید تا رفتار غیرعادی را پیدا کند.

یک نمونهٔ ساده: فرض کنید فرم ثبت‌نام سایتتان فرم خالی را هم قبول می‌کند. به Claude Code می‌گویید این باگ را درست کند. او فایل فرم و کد سمت سرور را پیدا می‌کند، بررسی خالی نبودن فیلدها را اضافه می‌کند، تغییر را نشانتان می‌دهد و اگر پروژه تست داشته باشد، تست‌ها را هم اجرا می‌کند. کار شما تأیید یا رد تغییر است.

کجا اجرا می‌شود؟ ترمینال، ویرایشگر کد، دسکتاپ و وب

همهٔ این‌ها به یک موتور وصل‌اند، پس فایل CLAUDE.md، تنظیمات و سرورهای MCP پروژه در همه‌شان کار می‌کند. اگر با ترمینال راحت نیستید، اپ دسکتاپ یا افزونهٔ VS Code ساده‌ترین راه شروع است. طبق راهنمای Anthropic دربارهٔ Pro و Max، اشتراک شما افزونه‌های VS Code، Cursor و JetBrains را هم پوشش می‌دهد و مصرف آن‌ها از همان سهمیهٔ مشترک کم می‌شود.

نصب کلاد کد روی ویندوز، مک و لینوکس

طبق صفحهٔ نصب Claude Code، این‌ها پیش‌نیازهای نصب است:

• سیستم‌عامل: macOS ۱۳ به بعد، ویندوز ۱۰ نسخهٔ ۱۸۰۹ به بعد یا Windows Server 2019، و از لینوکس Ubuntu ۲۰.۰۴، Debian ۱۰ یا Alpine ۳.۱۹ به بعد
• سخت‌افزار: دست‌کم ۴ گیگابایت رم و پردازندهٔ x64 یا ARM64
• اینترنت و شل: اتصال به اینترنت و یکی از شل‌های Bash، Zsh، PowerShell یا CMD
• حساب: پلن Pro، Max، Team یا Enterprise، یا حساب Console

بعضی راهنماهای قدیمی Node.js را پیش‌نیاز نوشته‌اند. برای روش پیشنهادی امروز به Node.js نیازی ندارید و فقط روش npm آن را می‌خواهد.

روش پیشنهادی: نصب‌کنندهٔ رسمی

Anthropic نصب‌کنندهٔ خودش (Native Install) را پیشنهاد می‌کند. مزیتش این است که Claude Code را در پس‌زمینه خودکار به‌روز نگه می‌دارد. ترمینال را باز کنید و دستور مخصوص سیستمتان را بزنید.

مک، لینوکس و WSL:

`curl -fsSL https://claude.ai/install.sh | bash`

ویندوز در PowerShell:

`irm https://claude.ai/install.ps1 | iex`

ویندوز در CMD:

`curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd`

در ویندوز اگر اول خط فرمان `PS` می‌بینید (مثل `PS C:\`)، در PowerShell هستید و اگر نمی‌بینید، در CMD. لازم نیست ترمینال را با دسترسی Administrator باز کنید. نصب Git for Windows اختیاری است، ولی پیشنهاد می‌شود تا Claude Code بتواند دستورها را با Bash اجرا کند؛ بدون آن، از PowerShell استفاده می‌کند. اگر پروژه‌تان داخل WSL است، Claude Code را هم داخل خود WSL و با دستور لینوکس نصب کنید.

نصب‌کننده موقع دانلود چیزی نشان نمی‌دهد و ممکن است فکر کنید گیر کرده است؛ صبر کنید تا تمام شود. بعد یک پنجرهٔ تازهٔ ترمینال باز کنید و این را بزنید:

`claude --version`

اگر شمارهٔ نسخه همراه عبارت `(Claude Code)` چاپ شد، نصب درست بوده است. برای بررسی کامل‌تر نصب و تنظیمات، `claude doctor` را اجرا کنید.

روش‌های دیگر نصب Claude Code

• Homebrew در مک: `brew install --cask claude-code`. این نسخه خودکار به‌روز نمی‌شود و هر از گاهی باید `brew upgrade claude-code` بزنید.
• WinGet در ویندوز: `winget install Anthropic.ClaudeCode` و برای به‌روزرسانی `winget upgrade Anthropic.ClaudeCode`.
• npm: `npm install -g @anthropic-ai/claude-code`. این روش Node.js نسخهٔ ۲۲ یا بالاتر می‌خواهد و همان برنامهٔ نصب‌کنندهٔ رسمی را نصب می‌کند. مستندات صریحاً می‌گوید آن را با `sudo` اجرا نکنید، چون هم مشکل دسترسی درست می‌کند و هم ریسک امنیتی دارد.
• مدیر بسته‌های لینوکس: روی Debian، Fedora، RHEL و Alpine با apt، dnf یا apk هم نصب می‌شود.

نسخهٔ نصب‌کنندهٔ رسمی خودش به‌روز می‌شود. اگر نمی‌خواهید منتظر بمانید، `claude update` را بزنید.

آموزش Claude Code: نیم ساعت اول

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

1. Claude Code را در پوشهٔ پروژه باز کنید. در ترمینال با `cd` به پوشهٔ پروژه بروید و `claude` را بزنید.
2. وارد حساب شوید. بار اول صفحهٔ ورود در مرورگر باز می‌شود. اگر Pro یا Max دارید، با همان حساب Claude وارد شوید. اگر مرورگر خودش باز نشد، کلید `c` را بزنید تا آدرس ورود کپی شود. ورود ذخیره می‌شود و دفعه‌های بعد لازم نیست.
3. اول بپرسید، بعد تغییر بدهید. با سؤالی مثل `what does this project do?` یا `explain the folder structure` شروع کنید. Claude Code فایل‌ها را می‌خواند و ساختار پروژه را توضیح می‌دهد.
4. حالت مجوز را انتخاب کنید. حالت فعلی در نوار پایین صفحه نوشته شده و با Shift+Tab عوض می‌شود. برای جلسهٔ اول حالت Manual را انتخاب کنید تا Claude Code پیش از هر ویرایش یا اجرای دستور از شما بپرسد. حالت‌ها را پایین‌تر توضیح داده‌ایم.
5. یک تغییر کوچک بخواهید. مثلاً بخواهید یک تابع ساده به فایل اصلی اضافه کند. Claude Code فایل مناسب را پیدا می‌کند و تغییر را نشانتان می‌دهد. اگر قبولش دارید، Yes را بزنید.
6. فایل CLAUDE.md بسازید. دستور `/init` پروژه را بررسی می‌کند و فایلی با دستورهای build و تست و قواعد پروژه می‌سازد. آن را بخوانید و هر چیزی را که درست نیست اصلاح کنید.
7. تغییرات را در گیت ثبت کنید. بپرسید `what files have I changed?` و بعد بخواهید `commit my changes with a descriptive message`.
8. مصرفتان را ببینید. `/usage` نشان می‌دهد چقدر از سهمیهٔ پلن مصرف شده و کی دوباره پر می‌شود.
9. جلسه را ببندید. برای کار بعدی که به این یکی ربطی ندارد، `/clear` گفت‌وگو را از نو شروع می‌کند. با `/exit` بیرون می‌آیید و بعداً با `claude -c` آخرین گفت‌وگوی همان پوشه را ادامه می‌دهید.

توصیهٔ دیگر همان راهنما این است که درخواست را دقیق بنویسید. به‌جای «باگ را درست کن» بنویسید «باگ صفحهٔ ورود را درست کن که بعد از وارد کردن رمز اشتباه، صفحه سفید می‌شود». کار بزرگ را هم به چند قدم بشکنید. اگر آموزش منظم‌تری می‌خواهید، Anthropic در Claude Academy دوره‌های رایگانی مثل Claude Code 101 دارد.

مفاهیم کلیدی Claude Code به زبان ساده

CLAUDE.md؛ دستورالعمل ثابت پروژه

هر جلسهٔ Claude Code با گفت‌وگویی خالی شروع می‌شود. چیزی که از جلسه‌ای به جلسهٔ بعد می‌ماند، فایل CLAUDE.md است و یادداشت‌هایی که خود Claude Code در حافظهٔ خودکارش (auto memory) می‌نویسد. فایل CLAUDE.md یک فایل متنی Markdown در ریشهٔ پروژه است که Claude Code اول هر جلسه می‌خواند. چیزهایی را در آن بنویسید که هر بار مجبورید دوباره توضیح بدهید: دستور build و تست، قواعد کدنویسی، ساختار پروژه و کارهایی که همیشه باید انجام شود یا هرگز نباید انجام شود.

• `/init` نسخهٔ اولیه‌اش را می‌سازد و اگر فایل از قبل باشد، پیشنهاد اصلاح می‌دهد.
• Anthropic پیشنهاد می‌کند هر CLAUDE.md زیر ۲۰۰ خط بماند؛ فایل بلندتر جای بیشتری از حافظهٔ گفت‌وگو می‌گیرد و کمتر رعایت می‌شود.
• قواعد شخصی‌تان برای همهٔ پروژه‌ها در `~/.claude/CLAUDE.md` می‌رود.
• اگر مخزن فایل AGENTS.md دارد، Claude Code می‌تواند همان را به‌جای CLAUDE.md بخواند.

CLAUDE.md راهنماست، نه قفل. اگر کاری باید حتماً ممنوع باشد، از قواعد مجوز استفاده کنید.

حالت‌های مجوز؛ چه کاری بدون پرسیدن انجام شود

حالت مجوز تعیین می‌کند Claude Code کدام کارها را بدون پرسیدن از شما انجام بدهد. در نسخه‌های تازه، جلسه‌های ترمینال و VS Code به‌طور پیش‌فرض در حالت auto شروع می‌شوند. در این حالت به‌جای شما یک مدل دوم کارها را از نظر ایمنی بررسی می‌کند. حالت‌های اصلی این‌هاست:

با Shift+Tab بین حالت‌ها جابه‌جا می‌شوید. با `/permissions` هم می‌توانید ابزار یا دستور مشخصی را همیشه مجاز یا همیشه ممنوع کنید. قاعدهٔ ممنوع (deny) در همهٔ حالت‌ها، حتی bypassPermissions، رعایت می‌شود.

دستورهای اسلش

هر دستوری که با `/` شروع شود، خود Claude Code را کنترل می‌کند، نه پروژه را. با تایپ `/` فهرست کامل باز می‌شود. این‌ها را زودتر از بقیه لازم خواهید داشت:

• `/init` و `/memory`: ساختن و ویرایش CLAUDE.md
• `/model`: عوض کردن مدل Claude
• `/compact`: خلاصه کردن گفت‌وگوی طولانی تا جا باز شود
• `/clear`: شروع گفت‌وگوی تازه
• `/usage`: مصرف و زمان پر شدن دوبارهٔ سهمیه
• `/status`: نسخه، مدل و حسابی که الان با آن کار می‌کنید
• `/permissions`: قواعد مجاز و ممنوع
• `/mcp`: وضعیت سرورهای MCP
• `/resume`: برگشتن به گفت‌وگوی قبلی

کارهایی را که مدام تکرار می‌کنید هم می‌توانید به شکل skill بسازید تا با یک دستور اسلش مثل `/review-pr` اجرا شوند.

MCP؛ وصل کردن Claude Code به ابزارهای دیگر

MCP استانداردی باز برای وصل کردن ابزارهای هوش مصنوعی به سرویس‌های دیگر است. با آن، Claude Code می‌تواند سند طراحی را از Google Drive بخواند، تیکت Jira را به‌روز کند یا از Slack اطلاعات بگیرد. یک نمونه از خود سواپ‌ولت: با یک دستور می‌توانید MCP سواپ‌ولت را به Claude Code اضافه کنید و موجودی کیف پولتان را از همان ترمینال بپرسید:

`claude mcp add --transport http swapwallet https://swapwallet.app/mcp`

اشتراک کلاد کد: Pro، Max یا API؟

خرید Claude Code Pro؛ در واقع چه می‌خرید؟

Anthropic محصولی به اسم «Claude Code Pro» نمی‌فروشد. Claude Code جزو همهٔ پلن‌های پولی Claude است و هر کسی که «اشتراک Claude Code» می‌خرد، در واقع یکی از این‌ها را می‌گیرد:

• Claude Pro: ماهانه ۲۰ دلار، یا با پرداخت سالانه ماهی ۱۷ دلار (۲۰۰ دلار یک‌جا)، بدون احتساب مالیات. Claude Code با همین حساب در ترمینال، افزونه‌ها، دسکتاپ و وب کار می‌کند و چت Claude را هم دارید.
• Claude Max: دو سطح دارد؛ Max 5x با ماهی ۱۰۰ دلار و Max 20x با ماهی ۲۰۰ دلار، و فقط ماهانه فروخته می‌شود. در هر نشست پنج‌ساعته ۵ یا ۲۰ برابر Pro سهمیه دارد و در ساعت‌های شلوغ اولویت می‌گیرد. Max اعتبار ماهانهٔ API هم دارد، ولی طبق راهنمای Anthropic این اعتبار در Claude Code و اپ‌های Claude مصرف نمی‌شود.
• حساب Claude Console (پرداخت به ازای مصرف): اعتبار را از قبل می‌خرید و هر درخواست به نرخ استاندارد API حساب می‌شود. هزینه به مدل، اندازهٔ پروژه و شدت استفاده بستگی دارد. طبق راهنمای هزینه‌های Claude Code، در سازمان‌ها میانگین هزینه حدود ۱۳ دلار برای هر برنامه‌نویس در هر روز کاری و ۱۵۰ تا ۲۵۰ دلار در ماه است.
• Team و Enterprise: برای شرکت‌ها و تیم‌ها، با مدیریت متمرکز و صورت‌حساب سازمانی.

قیمت‌ها مربوط به ۲۰ مهر ۱۴۰۵ است و Anthropic ممکن است عوضشان کند؛ رقم روز را در صفحهٔ قیمت‌های Claude ببینید.

سهمیهٔ Claude Code چطور حساب می‌شود؟

Pro و Max نامحدود نیستند. طبق صفحهٔ قیمت‌ها و راهنمای پلن Max، سهمیه دو لایه دارد: سقف نشستی که هر پنج ساعت از نو پر می‌شود، و سقف هفتگی که هر هفته در روز و ساعتی ثابت، مخصوص حساب شما، از نو پر می‌شود. چت Claude در وب، دسکتاپ و موبایل، Claude Code در ترمینال و افزونه‌های ویرایشگر کد همه از یک سهمیه برداشت می‌کنند. پس یک جلسهٔ طولانی برنامه‌نویسی از سهم چت در همان نشست و همان هفته هم کم می‌کند.

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

• صبر کنید تا سهمیه در ساعتی که در پیام آمده دوباره پر شود.
• اعتبار مصرف (usage credits) را روشن کنید تا کار با نرخ استاندارد API ادامه پیدا کند؛ دستورش `/usage-credits` است.
• پلن را بالا ببرید؛ Anthropic به کاربر Pro که مرتب به سقف می‌خورد Max 5x را پیشنهاد می‌کند.
• برای دوره‌های کاری سنگین به حساب Console و پرداخت به ازای مصرف بروید.

اگر می‌خواهید هزینه فقط در حد اشتراک بماند، پیشنهاد استفاده از اعتبار API را رد کنید و هنگام ورود فقط با حساب Pro یا Max وارد شوید. راهنمای هزینه‌های Claude Code هم توصیه می‌کند وقتی سراغ کاری بی‌ربط می‌روید، با `/clear` گفت‌وگو را از نو شروع کنید؛ گفت‌وگوی کهنه در هر پیام بعدی دوباره مصرف حساب می‌شود.

کدام پلن به کار شما می‌آید؟

این جدول بر اساس توضیح خود Anthropic دربارهٔ هر پلن چیده شده است. برای انتخاب نهایی، یک هفته کار واقعی با Pro و نگاه کردن به `/usage` از هر جدولی دقیق‌تر است.

در حساب Console هر چه بیشتر کار کنید، بیشتر می‌پردازید و اگر شارژ خودکار (auto-reload) روشن باشد، اعتبار خودبه‌خود دوباره خریده می‌شود. برای جلوگیری از خرج ناگهانی، در Console برای هر فضای کاری سقف خرج بگذارید. برای کار روزانه و سنگین، هزینهٔ پلن ثابت قابل‌پیش‌بینی‌تر است.

کلود کد یا کرسر؟

Cursor ویرایشگر کدی است که هوش مصنوعی در خودش دارد، ولی Claude Code ابزاری است که اصلش در ترمینال است و افزونه‌اش در خود Cursor هم نصب می‌شود. پس لازم نیست حتماً یکی را انتخاب کنید و می‌شود هر دو را کنار هم به کار برد. اگر بین این دو مردد هستید، مقایسهٔ کرسر و کلاد کد را بخوانید. برای سنجیدن خود Claude در برابر رقیب‌هایش هم مقایسهٔ ChatGPT، Gemini و Claude را ببینید.

خطاهای رایج نصب، ورود و سقف مصرف

این پیام‌ها و راه‌حل‌ها از راهنمای رفع مشکل نصب و ورود و فهرست خطاهای Claude Code آمده است. اگر مشکلتان در جدول نیست، `claude doctor` را در ترمینال یا `/doctor` را داخل Claude Code بزنید.

خرید اشتراک کلاد کد از ایران

Claude Code جدا فروخته نمی‌شود و جزو اشتراک Claude است؛ پس «خرید اشتراک کلاد کد» در عمل یعنی خرید Claude Pro یا Max. Anthropic کارت بانکی ایرانی را قبول نمی‌کند و ایران هنوز در فهرست کشورهایی که Claude در آن‌ها ارائه می‌شود نیست؛ برای همین کاربران ایرانی اشتراک را معمولاً از یک واسطه می‌خرند.

برای اینکه حسابتان بی‌دردسر بماند، آن را با ایمیل خودتان بسازید، اطلاعات درست بدهید و با کسی شریک نشوید. ساخت حساب، احراز هویتی که Anthropic ممکن است بخواهد و چند عادت سادهٔ دیگر برای سالم ماندن حساب را در راهنمای ساخت اکانت کلاد در ایران توضیح داده‌ایم.

در فروشگاه سواپ‌ولت بستهٔ Claude Pro را بدون کارت خارجی و با موجودی تومانی یا تتری کیف پولتان می‌خرید و Claude Code هم جزو همین پلن است. پلن Max فعلاً در این فروشگاه نیست. پیش از پرداخت، جزئیات بسته را در اپ بخوانید. برای مقایسهٔ اشتراک‌های دیگر هوش مصنوعی و راه‌های پرداخت، راهنمای خرید اشتراک هوش مصنوعی را ببینید.