پاسخ کوتاه: Claude Code چیست؟ Claude Code ابزار کدنویسی «ایجنتی» شرکت Anthropic است که کد پروژه را میخواند، فایلها را ویرایش میکند، دستور اجرا میکند و با Git کار میکند. در ترمینال، VS Code، JetBrains، اپ دسکتاپ Claude و مرورگر در دسترس است و برای استفاده به یکی از پلنهای پولی Claude یا حساب API نیاز دارد؛ پلن رایگان آن را ندارد.
این راهنما بر اساس مستندات رسمی Claude Code (صفحههای معرفی، نصب، شروع سریع، دستورها و هزینهها) و فهرست رسمی کشورهای پشتیبانیشدهی Anthropic نوشته شده که همه در ۳۰ آبان ۱۴۰۵ بررسی شدهاند. تیم وستا خودش روزانه با Claude Code روی سایت و ابزارهای داخلی کار میکند و نکتههای عملی این مطلب از همین تجربه آمده است.
Claude Code چیست و با چت Claude چه فرقی دارد؟
در چت معمولی Claude، کد را کپی میکنید، جواب را میگیرید و خودتان در فایل جا میدهید. Claude Code این رفتوبرگشت را حذف میکند. مستقیم داخل پوشهی پروژه اجرا میشود، ساختار فایلها را میبیند و تغییر را خودش اعمال میکند.
به همین دلیل به آن «ایجنت» میگویند: یک کار را از شما میگیرد، برایش برنامه میچیند، چند فایل را عوض میکند، تست یا دستور اجرا میکند و اگر خطا دید، دوباره اصلاح میکند. شما در هر مرحله میتوانید تغییر را ببینید، تأیید یا رد کنید.
Claude Code برای چه کسانی مفید است؟
- برنامهنویسها: رفع باگ، نوشتن تست، بازنویسی کد قدیمی و نوشتن پیام commit.
- طراحان سایت و وردپرسکارها: ساخت و اصلاح قالب، افزونه، PHP و CSS.
- مدیران سرور و DevOps: خواندن لاگ، نوشتن اسکریپت و خودکارسازی کارهای تکراری.
- غیربرنامهنویسها: ساخت ابزار ساده، تحلیل فایلهای داده یا مرتب کردن پوشهها، به شرط اینکه خروجی را با دقت بازبینی کنند.
قابلیتهای اصلی Claude Code
طبق صفحهی معرفی رسمی، مهمترین کارهایی که Claude Code انجام میدهد اینهاست:
- ساخت قابلیت و رفع باگ: کار را به زبان ساده مینویسید؛ برنامه میچیند، کد را در چند فایل مینویسد و درستیاش را بررسی میکند. برای باگ کافی است پیام خطا را بچسبانید.
- کار با Git: تغییرها را stage میکند، پیام commit مینویسد، شاخه میسازد و Pull Request باز میکند.
- اتصال به ابزارها با MCP: با پروتکل باز MCP میتواند به سند، تیکت یا دادهی ابزارهای دیگر وصل شود.
- حافظهی پروژه با CLAUDE.md: یک فایل متنی در ریشهی پروژه که Claude در شروع هر جلسه میخواند؛ قواعد کدنویسی و تصمیمهای پروژه را آنجا بنویسید.
- Skill و Hook: کارهای تکراری را بهشکل دستور قابلاشتراک بستهبندی میکنید و پیش یا پس از هر کار، دستور دلخواه اجرا میشود.
- ایجنتهای موازی و کار زمانبندیشده: چند ایجنت همزمان روی بخشهای مختلف کار میکنند و میشود کاری را روزانه یا هفتگی خودکار اجرا کرد.
Claude Code کجا اجرا میشود؟
| محیط | مناسب برای | نکته |
|---|---|---|
| ترمینال (CLI) | کاملترین نسخه، اسکریپت و خودکارسازی | نصب با یک دستور |
| افزونهی VS Code | دیدن تغییرها کنار کد | روی Cursor هم نصب میشود |
| افزونهی JetBrains | IntelliJ، PyCharm، WebStorm | نسخهی CLI را جدا لازم دارد |
| اپ دسکتاپ Claude (تب Code) | کسانی که با ترمینال راحت نیستند | CLI جداگانه لازم ندارد؛ پلن پولی لازم است |
| وب (claude.ai/code) | کار طولانی روی مخزن GitHub بدون نصب | از اپ موبایل Claude هم در دسترس است |
آموزش نصب Claude Code گامبهگام
حداقل سیستم لازم طبق مستندات رسمی (بررسیشده در ۳۰ آبان ۱۴۰۵): macOS 13 به بالا، Windows 10 نسخهی 1809 به بالا یا Windows Server 2019، Ubuntu 20.04 به بالا، حداقل ۴ گیگابایت رم، پردازندهی x64 یا ARM64 و اتصال اینترنت.
نصب در ویندوز
- PowerShell را باز کنید (اول خط باید
PS C:\ببینید). اجرای آن بهعنوان Administrator لازم نیست. - این دستور را اجرا کنید:
irm https://claude.ai/install.ps1 | iex - اگر در CMD هستید، دستور مخصوص CMD را از مستندات رسمی بردارید؛ پیام
'irm' is not recognizedیعنی در CMD هستید، نه PowerShell. - نصب Git for Windows اختیاری ولی توصیهشده است تا Claude Code بتواند از Git Bash استفاده کند.
- راه دیگر:
winget install Anthropic.ClaudeCode؛ این روش خودکار بهروز نمیشود و باید گاهیwinget upgrade Anthropic.ClaudeCodeبزنید.
نصب در مک و لینوکس
- ترمینال را باز کنید و بزنید:
curl -fsSL https://claude.ai/install.sh | bash - در مک، راه دیگر Homebrew است:
brew install --cask claude-code؛ این روش هم خودکار بهروز نمیشود. - نصب با npm هم ممکن است و طبق مستندات به Node.js 22 به بالا نیاز دارد، ولی روش پیشنهادی همان نصب بومی است که خودکار بهروز میشود.
بررسی نصب و ورود به حساب
- یک پنجرهی ترمینال تازه باز کنید و
claude --versionرا بزنید. باید شمارهی نسخه ببینید. - اگر پیام «claude پیدا نشد» آمد، مسیر نصب هنوز در PATH نیست؛ ترمینال را ببندید و دوباره باز کنید یا بخش عیبیابی مستندات را ببینید.
- به پوشهی پروژه بروید (
cd my-project) وclaudeرا بزنید. - بار اول مرورگر برای ورود باز میشود. با حساب Claude پولی یا حساب Console وارد شوید.
شروع کار: دستورهای اصلی Claude Code
بعد از ورود، یک خط فرمان میبینید که بالایش نسخه، مدل فعلی و پوشهی کار نوشته شده است. کار را به زبان ساده (فارسی هم قبول میکند) بنویسید. این دستورها را از روز اول لازم دارید:
| دستور | کاربرد |
|---|---|
claude |
شروع جلسهی تعاملی در پوشهی فعلی |
claude -p "سؤال" |
یک پرسش، یک جواب و خروج؛ مناسب اسکریپت |
claude -c |
ادامهی آخرین گفتگو در همین پوشه |
/init |
ساخت فایل CLAUDE.md برای معرفی پروژه |
/clear |
شروع گفتگوی تازه (با /resume برمیگردید) |
/usage |
دیدن مصرف از سقف پلن |
/help |
فهرست همهی دستورها |
Shift+Tab |
عوض کردن حالت اجازه (چه کارهایی بیپرسش انجام شود) |
یک نمونهی واقعی برای شروع
در پوشهی یک قالب وردپرس بنویسید: «ساختار این قالب را توضیح بده و بگو کدام فایلها سرعت بارگذاری را کم میکنند». Claude Code فایلها را میخواند و بدون تغییر چیزی، گزارش میدهد. بعد بخواهید یکی از پیشنهادها را اجرا کند و تغییر را پیش از تأیید ببینید. برای ایدهی بیشتر، راهنمای افزایش سرعت سایت وردپرس را ببینید.
آیا Claude Code رایگان است؟ پلن و هزینه
خیر. طبق مستندات نصب (بررسیشده در ۳۰ آبان ۱۴۰۵)، Claude Code به حساب Pro، Max، Ultra، Team، Enterprise یا Console نیاز دارد و پلن رایگان claude.ai آن را ندارد. خود ابزار جداگانه فروخته نمیشود؛ با خرید یکی از این پلنها فعال میشود.
- با اشتراک (Pro و بالاتر): مصرف Claude Code از همان سقف مشترک پلن کم میشود که چت وب و موبایل هم از آن استفاده میکنند. با
/usageمیبینید چقدر مانده است. - با حساب API (Console): پرداخت بر اساس توکن مصرفی است. مستندات رسمی هزینهها میگوید در شرکتها میانگین حدود ۱۳ دلار برای هر برنامهنویس در هر روز کاری و ۱۵۰ تا ۲۵۰ دلار در ماه است.
جدول قیمت پلنها و فرق سقف مصرفشان را در راهنمای پلنهای Claude نوشتهایم. خلاصهی تجربهی ما: برای کار سبک تا متوسط Pro کافی است؛ اگر هر روز چند ساعت پشت سر هم با Claude Code کار میکنید و مدام به سقف میخورید، Max منطقیتر است.
Claude Code یا Cursor؟
هر دو ایجنت کدنویسیاند، ولی رویکردشان فرق دارد. Cursor یک ویرایشگر کامل است که هوش مصنوعی در آن ساخته شده و چند مدل از شرکتهای مختلف را پشتیبانی میکند. Claude Code به ویرایشگر خاصی وابسته نیست؛ در ترمینال، کنار هر ویرایشگری، در اسکریپت و CI و حتی در مرورگر کار میکند و با مدلهای Claude اجرا میشود.
اگر به یک محیط گرافیکی آماده عادت دارید، Cursor راحتتر است. اگر خودکارسازی، کار روی سرور یا کارهای طولانی چندمرحلهای میخواهید، Claude Code انعطاف بیشتری دارد. جزئیات Cursor را در مقالهی Cursor چیست بخوانید.
نکتههای امنیتی و کار درست با Claude Code
- حالت اجازه را جدی بگیرید: در شروع بگذارید Claude پیش از ویرایش فایل یا اجرای دستور از شما بپرسد. وقتی به روش کارش اعتماد کردید، اجازهها را بازتر کنید.
- Git را از قبل راه بیندازید: پیش از هر کار بزرگ commit بگیرید تا اگر نتیجه را نخواستید، راحت برگردید.
- رمز و کلید را در متن ننویسید: فایلهای حاوی رمز (مثل
.env) را در گفتگو نچسبانید. - کار را کوچک و دقیق بخواهید: «دکمهی ثبت فرم تماس را درست کن» بهتر از «سایت را درست کن» جواب میدهد. اصول دستور نوشتن در راهنمای پرامپتنویسی آمده است.
- خروجی را بازبینی کنید: ایجنت هم اشتباه میکند. پیش از انتشار روی سایت اصلی، تغییر را روی نسخهی آزمایشی امتحان کنید.
نکتههای کاربران ایران
- کشورهای پشتیبانیشده: ایران در فهرست رسمی کشورهای پشتیبانیشدهی Anthropic نیست (بررسیشده در ۳۰ آبان ۱۴۰۵). یعنی استفاده از ایران خلاف شرایط سرویس است و احتمال محدود شدن حساب وجود دارد؛ این ریسک را پیش از خرید بدانید.
- پرداخت: پلنهای Claude با کارت بینالمللی پرداخت میشوند و کارت بانکی ایرانی کار نمیکند.
- اینترنت: Claude Code برای هر کار به اینترنت پایدار نیاز دارد؛ قطع و وصل شدن اتصال، کارهای طولانی را نیمهکاره میگذارد.
تهیهی اشتراک Claude برای Claude Code از وستا
سختترین بخش شروع کار با Claude Code برای کاربر ایرانی، تهیهی پلن پولی است. وستا از ۱۳۸۹ و با بیش از ۱۵ سال تجربه، اشتراک Claude و دیگر ابزارهای هوش مصنوعی را با قیمت تومانی و پرداخت از درگاه شاپرکی عرضه میکند. برای حساب API و شارژ اعتبار Console هم از خدمت پرداخت ارزی استفاده کنید. اگر مطمئن نیستید Pro کافی است یا Max لازم دارید، از مشاورهی رایگان وستا بپرسید.
پرسشهای پرتکرار
Claude Code چیست به زبان ساده؟
دستیاری است که داخل پوشهی پروژهتان کار میکند. به زبان ساده میگویید چه میخواهید و خودش کد را میخواند، تغییر میدهد و نتیجه را برای تأیید نشان میدهد.
آیا Claude Code رایگان است؟
نه. طبق مستندات رسمی، پلن رایگان Claude دسترسی به Claude Code ندارد و دستکم پلن Pro یا حساب API لازم است.
آیا Claude Code روی ویندوز کار میکند؟
بله. روی Windows 10 نسخهی 1809 به بالا با یک دستور در PowerShell نصب میشود و داخل WSL هم اجرا میشود. اپ دسکتاپ Claude هم نسخهی ویندوز دارد.
برای کار با Claude Code باید برنامهنویس باشم؟
نه لزوماً، ولی آشنایی پایه با ترمینال و Git خیلی کمک میکند. اگر با ترمینال راحت نیستید، از تب Code در اپ دسکتاپ Claude شروع کنید.
Claude Code فارسی میفهمد؟
بله. میتوانید درخواستها را فارسی بنویسید و جواب فارسی بگیرید؛ در تجربهی ما نوشتن نام دقیق فایلها و خطاها به انگلیسی، نتیجه را دقیقتر میکند.
منابع رسمی (بررسیشده در ۳۰ آبان ۱۴۰۵): معرفی Claude Code، راهنمای نصب و حداقل سیستم، شروع سریع و دستورهای اصلی، مستندات هزینه و مصرف و کشورهای پشتیبانیشدهی Anthropic.