سبد خرید شما خالی است.
آموزش Claude Code؛ نصب در ویندوز و مک و شروع اولین پروژه
9دقیقه
آنچه در این مقاله می‌خوانید [پنهان‌سازی]
ابزار Claude Code دستیار برنامه‌نویسی شرکت Anthropic است. فرقش با چت Claude این است که روی فایل‌های واقعی کار می‌کند: پوشه پروژه را خودش می‌خواند، فایل‌ها را ویرایش می‌کند و دستورهای خط فرمان را اجرا می‌کند. برای شروع، یک دستور نصب در ترمینال می‌زنید، در پوشه پروژه claude را اجرا می‌کنید و با حساب Claude وارد می‌شوید.
پلن رایگان Claude شامل Claude Code نیست. به یکی از پلن‌های Pro، Max، Ultra، Team یا Enterprise، یا به حساب Claude Console نیاز دارید. اگر با ترمینال راحت نیستید، اپ دسکتاپ Claude همین ابزار را در زبانه Code دارد و نصب جداگانه نمی‌خواهد.
این راهنما برای کسانی است که به Claude دسترسی رسمی دارند. فهرست کشورهایی که Anthropic در آن‌ها سرویس می‌دهد، Claude Code را هم در بر می‌گیرد. پیش از خرید پلن، این فهرست را در سایت خود Anthropic ببینید.
پیش‌نیاز برای تازه‌کارها: اگر هنوز با پرامپت‌نویسی و ارزیابی خروجی ابزارهای AI آشنا نیستید، قبل از شروع پروژه، نقشه راه ۳۰ روزه آموزش هوش مصنوعی از صفر را مرور کنید. Claude Code به انجام کارهای برنامه‌نویسی کمک می‌کند، اما جای یادگیری مبانی کدنویسی و بازبینی مستقل تغییرات را نمی‌گیرد.
کار Claude Code با چت Claude چه فرقی دارد؟
در چت، کد را در گفت‌وگو می‌چسبانید و جواب را دستی به پروژه برمی‌گردانید. در Claude Code لازم نیست چیزی را کپی کنید. وقتی می‌پرسید «این پروژه چه کار می‌کند؟»، خودش فایل‌های لازم را باز می‌کند و می‌خواند. وقتی تغییری می‌خواهید، تغییر را نشان می‌دهد و بسته به حالت اجازه‌ها، پیش از اعمال از شما تأیید می‌گیرد.
کاربردش فقط نوشتن برنامه نیست. هر کاری که با فایل و دستور انجام شود در محدوده‌اش است: ساختن یک صفحه HTML، مرتب کردن فایل‌های یک پوشه، یا ساختن ویدیو با کد. در فروشگاه پلی‌مدیا چند راهنما برای ساختن ترنزیشن، افکت متن فارسی و زیرنویس ریلز با Claude Code هست. نمونه کامل ساخت ویدیو با این ابزار در آموزش ادیت ویدیو با کلود آمده است.
این ابزار چند شکل دارد و همه به یک موتور وصل‌اند. فایل‌های دستور پروژه، تنظیمات و اتصال‌های MCP در همه آن‌ها یکسان کار می‌کنند. پس اگر امروز از اپ دسکتاپ شروع کنید و بعداً به ترمینال بروید، تنظیمات پروژه با شما می‌آید.
پیش از نصب، این موارد را بررسی کنید
| مورد | شرط رسمی |
|---|---|
| سیستم‌عامل | ویندوز 10 (نسخه 1809 به بعد)، ویندوز سرور 2019 به بعد، مک‌اواس 13 به بعد، و لینوکس‌های اوبونتو 20.04، دبیان 10 و آلپاین 3.19 به بعد |
| سخت‌افزار | دست‌کم ۴ گیگابایت رم و پردازنده x64 یا ARM64 |
| اینترنت | اتصال اینترنت لازم است |
| حساب | پلن Pro، Max، Ultra، Team یا Enterprise، یا حساب Claude Console که هزینه را بر اساس مصرف API حساب می‌کند. پلن رایگان کافی نیست. |
| کشور | فقط کشورهایی که در فهرست رسمی Anthropic آمده‌اند |
| گیت در ویندوز | اختیاری است. با نصب Git for Windows، ابزار Bash در اختیار Claude Code قرار می‌گیرد. بدون آن، دستورها با PowerShell اجرا می‌شوند. |
ترمینال، اپ دسکتاپ یا VS Code؟
| نسخه | مناسب برای | نکته |
|---|---|---|
| ترمینال | کسی که با خط فرمان کار می‌کند | کامل‌ترین نسخه است و با یک دستور نصب می‌شود. |
| اپ دسکتاپ Claude | کسی که نمی‌خواهد با ترمینال کار کند | زبانه Code همان Claude Code است و نصب جدا لازم ندارد. برای ویندوز (x64 و ARM64) و مک عرضه شده و نسخه لینوکس آن برای اوبونتو و دبیان آزمایشی است. پلن پولی لازم دارد. |
| افزونه VS Code | برنامه‌نویسی که در VS Code یا Cursor کار می‌کند | تغییرها را کنار کد نشان می‌دهد. |
| نسخه وب | کار بدون نصب، روی مخزن‌هایی که روی کامپیوترتان نیستند | از نشانی claude.ai/code در مرورگر و از اپ موبایل Claude باز می‌شود. |
اگر تازه‌کارید، از اپ دسکتاپ شروع کنید. تغییرها را به‌صورت تصویری می‌بینید و می‌توانید چند جلسه را کنار هم باز کنید. اگر برنامه‌نویس هستید، نسخه ترمینال کامل‌ترین امکانات را دارد و افزونه VS Code کار را داخل ویرایشگر نگه می‌دارد. برای محیط‌های JetBrains مثل PyCharm هم افزونه هست، ولی آن افزونه به نسخه ترمینال تکیه می‌کند و باید آن را جدا نصب کنید.
نصب Claude Code در ترمینال، قدم‌به‌قدم
- ترمینال را باز کنید. در ویندوز، PowerShell را از منوی استارت باز کنید. اگر ابتدای خط
PS C:\دیدید، در PowerShell هستید. اگر فقطC:\دیدید، در CMD هستید. برای نصب در ویندوز به دسترسی مدیر سیستم نیاز ندارید. - دستور نصب سیستم خودتان را اجرا کنید. این دستورها از راهنمای رسمی Anthropic است. هنگام دانلود، نوار پیشرفتی نمایش داده نمی‌شود؛ صبر کنید تا کار تمام شود.
برای مک، لینوکس و 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- نصب را بررسی کنید. یک پنجره ترمینال تازه باز کنید و
claude --versionرا بزنید. اگر نصب درست باشد، شماره نسخه و بعد از آن عبارت(Claude Code)نمایش داده می‌شود. - در صورت نیاز، بررسی کامل بگیرید. دستور
claude doctorبدون باز کردن جلسه، سلامت نصب و تنظیمات را گزارش می‌کند و برای هر هشدار راه‌حل پیشنهاد می‌دهد.
نسخه‌ای که با این دستورها نصب شود، خودش در پس‌زمینه به‌روز می‌شود. راه‌های دیگر هم هست: در ویندوز winget install Anthropic.ClaudeCode و در مک brew install --cask claude-code. این دو روش خودکار به‌روز نمی‌شوند و باید هر چند وقت یک بار دستور به‌روزرسانی‌شان را بزنید. نصب با npm هم ممکن است، ولی به Node.js نسخه 22 یا بالاتر نیاز دارد و راهنمای رسمی صریحاً می‌گوید آن را با sudo اجرا نکنید.
سه خطای رایج هنگام نصب
| پیامی که می‌بینید | معنی و راه‌حل |
|---|---|
پیام 'irm' is not recognized | در CMD هستید، نه PowerShell. دستور مخصوص CMD را بزنید یا PowerShell را باز کنید. |
پیام The token '&&' is not a valid statement separator | در PowerShell هستید. دستور مخصوص PowerShell را بزنید. |
دستور claude شناخته نمی‌شود | پوشه نصب هنوز در مسیر سیستم (PATH) نیست. اول یک پنجره ترمینال تازه باز کنید. اگر حل نشد، بخش «Fix your PATH» در راهنمای رفع خطای نصب را ببینید. |
برای خطاهای دیگر، مثل خطای 403، صفحه «Troubleshoot installation» در مستندات Claude Code هر پیام را با راه‌حلش آورده است.
اگر در ویندوز Git for Windows نصب کرده‌اید ولی Claude Code آن را پیدا نمی‌کند، مسیر bash.exe را با متغیر CLAUDE_CODE_GIT_BASH_PATH در فایل settings.json معرفی کنید. نمونه‌اش در بخش تجربه پلی‌مدیا آمده است.
اولین جلسه: ورود، اولین پرسش و اجازه‌ها
در ترمینال به پوشه پروژه بروید و Claude Code را اجرا کنید:
cd your-project
claudeبار اول از شما می‌خواهد وارد حساب شوید و ورود را در مرورگر تمام می‌کنید. اطلاعات ورود ذخیره می‌شود و دفعه‌های بعد لازم نیست دوباره وارد شوید. بالای خط فرمان، نسخه، مدل فعلی و پوشه کاری نمایش داده می‌شود.
اولین پرسش را ساده بگیرید: «این پروژه چه کار می‌کند؟» یا «ساختار پوشه‌ها را توضیح بده». لازم نیست فایلی را دستی معرفی کنید؛ خودش هر فایلی را که لازم باشد می‌خواند. بعد یک تغییر کوچک بخواهید و ببینید تغییر را چطور نشان می‌دهد.
مهم‌ترین تنظیم جلسه اول، حالت اجازه‌هاست. در نسخه‌های جدید، جلسه‌های ترمینال و VS Code در حالت auto شروع می‌شوند. در این حالت، کارها با بررسی‌های ایمنی پس‌زمینه بدون پرسیدن انجام می‌شوند و راهنمای رسمی می‌گوید این حالت ایمنی را تضمین نمی‌کند. برای اولین پروژه بهتر است با کلید Shift+Tab به حالت Manual بروید تا پیش از هر ویرایش یا اجرای دستور از شما بپرسد. حالت Plan هم وقتی به کار می‌آید که اول نقشه کار را ببینید و بعد اجازه تغییر بدهید. حالت bypassPermissions همه پرسش‌ها را حذف می‌کند و طبق مستندات فقط برای محیط‌های ایزوله مثل کانتینر و ماشین مجازی است.
| دستور | کارش |
|---|---|
claude -c | ادامه آخرین گفت‌وگو در همین پوشه |
claude -r | انتخاب و ادامه یکی از گفت‌وگوهای قبلی |
/help | فهرست دستورهای موجود |
/clear | شروع گفت‌وگوی تازه، وقتی سراغ کار نامرتبطی می‌روید |
/init | ساختن فایل CLAUDE.md برای پروژه |
/usage | نمایش مصرف و محدودیت پلن |
/exit | خروج از Claude Code |
فایل CLAUDE.md؛ دستورهای ثابت هر پروژه
هر جلسه Claude Code با حافظه خالی شروع می‌شود. فایل CLAUDE.md راه رساندن دستورهای ثابت به هر جلسه است و در ابتدای هر جلسه خوانده می‌شود. قواعد کدنویسی، دستور ساخت و آزمایش پروژه، و کارهایی را که نباید انجام شود، همین‌جا بنویسید.
لازم نیست از صفر بنویسید. دستور /init پروژه را بررسی می‌کند و یک CLAUDE.md اولیه با دستورهای ساخت، آزمایش و قراردادهایی که پیدا کرده می‌سازد. اگر فایل از قبل باشد، به‌جای بازنویسی، پیشنهاد اصلاح می‌دهد.
- برای یک پروژه: فایل
CLAUDE.mdدر ریشه پروژه. می‌توانید آن را در گیت بگذارید تا هم‌تیمی‌ها هم از آن استفاده کنند. - برای همه پروژه‌های خودتان: فایل
~/.claude/CLAUDE.mdدر پوشه کاربری.
فایل را کوتاه نگه دارید. مستندات Anthropic پیشنهاد می‌کند CLAUDE.md زیر ۲۰۰ خط بماند، چون در هر جلسه کامل خوانده می‌شود و جا می‌گیرد. دستورهای مفصل یک کار خاص، مثل روند انتشار یا بازبینی، بهتر است اسکیل شوند؛ اسکیل فقط وقتی لازم شود بارگذاری می‌شود. روش اضافه کردن اسکیل در راهنمای نصب اسکیل در Claude آمده است.
مصرف را چطور زیر نظر بگیریم
اگر با پلن اشتراکی وارد شوید، مصرف Claude Code جزو همان پلن است و محدودیت دوره‌ای دارد. اگر با حساب Console وارد شوید، هزینه بر اساس توکن مصرفی حساب می‌شود. در هر دو حالت، /usage وضعیت را نشان می‌دهد. چند عادت ساده مصرف را پایین نگه می‌دارد:
- بین کارهای نامرتبط با
/clearگفت‌وگوی تازه شروع کنید. گفت‌وگوی طولانی در هر پیام دوباره خوانده می‌شود. - مدل را با کار جور کنید. طبق مستندات، Sonnet بیشتر کارهای برنامه‌نویسی را خوب انجام می‌دهد و ارزان‌تر از Opus است. Opus را برای تصمیم‌های پیچیده نگه دارید. مدل را با
/modelعوض می‌کنید. - درخواست مشخص بدهید. «کد را بهتر کن» باعث می‌شود کل پروژه گشته شود. «به فرم ورود در فایل auth.ts بررسی ورودی اضافه کن» کار را کوتاه می‌کند.
تجربه پلی‌مدیا: یک پروژه واقعی با Claude Code
از ۳ آبان ۱۴۰۵، کار سئوی همین سایت در زبانه Code اپ دسکتاپ Claude روی ویندوز انجام می‌شود. دستورها فارسی نوشته می‌شوند و Claude Code آن‌ها را اجرا می‌کند: بررسی صفحه‌ها، آماده کردن پیش‌نویس مقاله‌ها و ساختن اسکیل. اسکیل مقاله‌نویسی مجله پلی‌مدیا در همین روند ساخته شد و در پوشه ~/.claude/skills قرار دارد. هر تغییری روی سایت، پیش از اجرا به تأیید مدیر سایت می‌رسد.
یک نکته ویندوزی از همین پروژه: روی این کامپیوتر، Git for Windows به‌صورت نسخه قابل‌حمل (PortableGit) در پوشه کاربری نصب شده است، نه در مسیر پیش‌فرض. برای همین، مسیر bash.exe آن با همان متغیر CLAUDE_CODE_GIT_BASH_PATH در بخش env فایل settings.json معرفی شده است و ابزار Bash در جلسه‌های این پروژه با همین Git کار می‌کند.
بعد از نصب، اسکیل‌ها را اضافه کنید
وقتی Claude Code را نصب کردید، با اسکیل می‌توانید روش انجام یک کار مشخص را یک بار به آن یاد بدهید. اسکیل‌های هوش مصنوعی پلی‌مدیا برای کارهایی مثل موشن فارسی، ریلز و PDF فارسی آماده شده‌اند. اگر می‌خواهید چند ابزار پرکاربرد کلود را با راهنمای فارسی نصب کنید، پک راهنمای نصب ۱۵ ابزار کلود را ببینید.
اطلاعات این مطلب در تاریخ ۱۱ آبان ۱۴۰۵ با منابع رسمی Anthropic بررسی شده است: Claude Code overview، Advanced setup، Quickstart، Permission modes، CLAUDE.md و حافظه، Manage costs و فهرست کشورهای پشتیبانی‌شده. دستورها و نام منوها ممکن است در به‌روزرسانی‌های بعدی تغییر کنند.
این مطلب با کمک ابزار هوش مصنوعی تهیه و پیش از انتشار توسط فرشاد فراهانی بازبینی شده است.
