خلاصه سریع: Claude Code را میتوان از طریق نصبکنندههای اصلی در macOS، ویندوز و لینوکس از وبسایت رسمی Claude Code نصب کرد. کاربران ویندوز قبل از اجرای Claude Code باید WSL2 را نصب کنند. پس از نصب، هنگام باز شدن پنجره مرورگر توسط Claude Code برای ورود به سیستم در اولین راهاندازی، با حساب Claude خود احراز هویت کنید تا مستقیماً از ترمینال یا برنامه دسکتاپ خود با کمک هوش مصنوعی کدنویسی را شروع کنید.
Claude Code نشاندهنده تلاش Anthropic در زمینه ابزارهای توسعه هوش مصنوعی عاملگرا است. این دستیار خط فرمان، پایگاههای کد را میخواند، فایلها را ویرایش میکند، دستورات را اجرا میکند و با گردش کار توسعه ادغام میشود.
اما نصب آن همیشه مستقیم نیست. پلتفرمهای مختلف به رویکردهای متفاوتی نیاز دارند. ویندوز نیاز به تنظیمات اضافی دارد. و مستندات، اگرچه جامع هستند، میتوانند تازهکارها را سردرگم کنند.
این راهنما پیچیدگیها را ساده میکند. الزامات سیستم، مراحل نصب مخصوص پلتفرم، احراز هویت و تأیید - هر آنچه برای راهاندازی صحیح Claude Code لازم است را پوشش میدهد.
الزامات سیستم قبل از نصب
طبق مستندات رسمی Claude Code، این ابزار از macOS، ویندوز و لینوکس پشتیبانی میکند. با این حال، هر پلتفرم پیشنیازهای خاص خود را دارد.
برای macOS، الزامات حداقل هستند. سیستم به macOS 13.0 یا جدیدتر نیاز دارد. هر دو پردازنده Intel و Apple Silicon به خوبی کار میکنند.
ویندوز پیچیدگی بیشتری دارد. سیستم عامل باید Windows 10 Build 19041 یا جدیدتر، یا Windows 11 باشد. اما نکته اینجاست - Claude Code به صورت بومی روی ویندوز اجرا نمیشود.
Windows Subsystem for Linux 2 (WSL2) اجباری است. این یک محیط لینوکس ایجاد میکند که Claude Code در واقع در آن کار میکند. بدون WSL2، نصب با شکست مواجه میشود.
کاربران لینوکس به توزیع 64 بیتی نیاز دارند. مستندات رسمی پشتیبانی از اوبونتو، دبیان، فدورا و سایر توزیعهای اصلی را تأیید میکند. Alpine Linux و سیستمهای مبتنی بر musl نیاز به پیکربندی اضافی دارند.
همه پلتفرمها در طول نصب به اتصال اینترنت پایدار نیاز دارند. اندازه دانلودها متفاوت است اما معمولاً بسته به آنچه از قبل نصب شده است، از 50 مگابایت تا 500 مگابایت متغیر است.
| پلتفرم | حداقل نسخه | الزامات ویژه |
|---|---|---|
| macOS | 13.0 | بدون نیاز |
| Windows | 10 Build 19041 یا 11 | نیاز به WSL2 |
| Linux | توزیع 64 بیتی | ترجیحاً مبتنی بر glibc |
نصب Claude Code روی macOS
فرآیند نصب macOS از یک نصبکننده بومی استفاده میکند. این سادهترین مسیر در بین تمام پلتفرمها است.
ابتدا، نصبکننده را از وبسایت رسمی Claude Code دانلود کنید. صفحه دانلود به طور خودکار macOS را تشخیص داده و بسته مناسب را ارائه میدهد.
فایل .dmg دانلود شده را باز کنید. برنامه Claude Code را به پوشه Applications بکشید. نصب استاندارد macOS - هیچ چیز غیرعادی در اینجا وجود ندارد.
برخی از کاربران هنگام اولین راهاندازی با یک درخواست امنیتی مواجه میشوند. macOS به طور پیشفرض از برنامههای توسعهدهندگان ناشناس جلوگیری میکند. روی برنامه Claude Code کلیک راست کرده و "Open" را انتخاب کنید تا این هشدار یکباره را رد کنید.
ابزار خط فرمان به طور خودکار با برنامه دسکتاپ نصب میشود. ترمینال را باز کرده و `claude --version` را تایپ کنید تا تأیید شود. اگر شماره نسخه ظاهر شد، نصب موفقیتآمیز بوده است.
تأیید نصب macOS
برای تأیید اینکه همه چیز کار میکند، دستورات زیر را اجرا کنید:
| claude --version claude --help |
هر دو دستور باید بدون خطا خروجی داشته باشند. دستور نسخه، نسخه Claude Code نصب شده را نشان میدهد. دستور راهنما، گزینهها و دستورات موجود را نمایش میدهد.
ایجاد یک پوشه آزمایشی به تأیید کامل عملکرد کمک میکند. به پوشه پروژه بروید و `claude` را اجرا کنید تا یک جلسه تعاملی شروع شود. ابزار باید مقداردهی اولیه شود و در صورت عدم ورود به سیستم، درخواست احراز هویت کند.
نصب ویندوز با WSL2
نصب ویندوز شامل چندین مرحله است. این فرآیند طولانیتر از macOS است اما قابل مدیریت باقی میماند.
ابتدا باید WSL2 را نصب کنید. PowerShell را به عنوان Administrator باز کرده و اجرا کنید:
| wsl --install |
این دستور به طور پیشفرض WSL2 و اوبونتو را نصب میکند. سیستم نیاز به راهاندازی مجدد خواهد داشت. پس از راهاندازی مجدد، اوبونتو به طور خودکار برای تکمیل راهاندازی اولیه اجرا میشود.
هنگام درخواست، نام کاربری و رمز عبور یونیکس ایجاد کنید. این اعتبارنامهها از اعتبارنامههای ورود به ویندوز جدا هستند.
پس از اجرای WSL2، فرآیند نصب لینوکس اعمال میشود. ترمینال اوبونتو (نصب شده با WSL2) را باز کرده و نصبکننده Claude Code را برای لینوکس دانلود کنید.
نصب Claude Code در WSL2
طبق مستندات رسمی، دستور نصب، نصبکننده بومی را دانلود و اجرا میکند:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
این اسکریپت وابستگیها را به طور خودکار مدیریت میکند. Node.js را در صورت نیاز نصب میکند، باینری Claude Code را راهاندازی میکند و متغیرهای PATH را پیکربندی میکند.
نصب چند دقیقه طول میکشد. نوارهای پیشرفت و پیامهای وضعیت نشان میدهند که چه اتفاقی در حال رخ دادن است. پس از اتمام، ترمینال را ببندید و دوباره باز کنید تا متغیرهای محیطی بهروز شوند.
آزمایش نصب همان فرآیند macOS را دنبال میکند. `claude --version` را برای تأیید اجرا کنید.
فرآیند نصب لینوکس
کاربران لینوکس سادهترین مسیر نصب را دارند. نصبکننده بومی مستقیماً و بدون لایههای اضافی مانند WSL2 کار میکند.
اسکریپت نصب را دانلود و اجرا کنید:
| curl -fsSL claude.ai/install.sh | bash |
این اسکریپت باینری Claude Code را دانلود میکند، وابستگیها را نصب میکند و محیط پوسته را پیکربندی میکند. اسکریپت توزیع را تشخیص داده و مطابق آن تنظیم میشود.
برای سیستمهای مبتنی بر اوبونتو و دبیان، اسکریپت نصب را پیکربندی میکند. مستندات رسمی پشتیبانی از اوبونتو 20.04+، دبیان 10+ و سایر توزیعها را تأیید میکند.
ملاحظات Alpine Linux
Alpine Linux و توزیعهای مبتنی بر musl نیاز به مراحل اضافی دارند. مستندات رسمی بیان میکند که این سیستمها نیاز به پیکربندی دستی دارند.
نصبکننده استاندارد ممکن است در Alpine با شکست مواجه شود. در عوض، باینری سازگار با musl را مستقیماً از صفحه انتشار دانلود کنید. آن را در یک پوشه در PATH سیستم، معمولاً /usr/local/bin، استخراج کنید.
مجوزهای اجرایی را تنظیم کنید:
| chmod +x /usr/local/bin/claude |
کاربران Alpine باید سازگاری را قبل از ادامه کار بررسی کنند. برخی از ویژگیها ممکن است دقیقاً مانند توزیعهای مبتنی بر glibc کار نکنند.
احراز هویت و راهاندازی حساب
پس از نصب Claude Code، `claude` را در ترمینال خود اجرا کنید. در اولین راهاندازی، Claude Code پنجره مرورگر را برای ورود شما باز میکند.
این صفحه احراز هویت Claude را باز میکند. با یک حساب Claude موجود وارد شوید یا یک حساب جدید ایجاد کنید.
مرورگر یک کد مجوز نمایش میدهد. این کد را کپی کرده و به ترمینال بازگردید. کد را هنگام درخواست وارد کنید.
احراز هویت موفقیتآمیز، اعتبارنامهها را به صورت محلی ذخیره میکند. جلسات آینده نیازی به ورود به سیستم نخواهند داشت مگر اینکه اعتبارنامهها منقضی شوند یا به صورت دستی پاک شوند.
احراز هویت تیم و سازمانی
طبق مستندات رسمی احراز هویت، تیمهایی که از Claude برای تیمها یا Enterprise استفاده میکنند، گزینههای اضافی دارند. سازمانها میتوانند احراز هویت یکپارچه (SSO) یا احراز هویت ارائهدهنده ابری را پیکربندی کنند.
راهاندازی SSO نیاز به پیکربندی مدیر دارد. سپس توسعهدهندگان فردی از طریق ارائهدهنده هویت سازمان خود به جای حسابهای Claude شخصی احراز هویت میکنند.
احراز هویت ارائهدهنده ابری برای استقرار AWS، Google Cloud و Azure کار میکند. این روش از اعتبارنامههای ابری موجود به جای حسابهای Claude جداگانه استفاده میکند.
| روش احراز هویت | مورد استفاده | پیچیدگی راهاندازی |
|---|---|---|
| حساب شخصی | توسعهدهندگان فردی | ساده |
| SSO تیم/سازمانی | سازمانها | نیاز به مدیر دارد |
| ارائهدهنده ابری | کاربران AWS/GCP/Azure | متوسط |
نصب برنامه دسکتاپ
Claude Code هم برنامههای خط فرمان و هم برنامههای دسکتاپ را ارائه میدهد. برنامه دسکتاپ یک رابط گرافیکی فراهم میکند و در عین حال عملکرد کامل ترمینال را حفظ میکند.
نصبکننده دسکتاپ را از وبسایت رسمی Claude دانلود کنید. این صفحه نسخههای macOS، ویندوز و Windows ARM64 را ارائه میدهد. نسخه مناسب را برای سیستم انتخاب کنید.
نصب macOS همان فرآیند .dmg توضیح داده شده در بالا را دنبال میکند. کاربران ویندوز میتوانند برنامه دسکتاپ را برای یک رابط گرافیکی بدون نیاز به راهاندازی WSL2 دانلود کنند.
برنامه دسکتاپ شامل دسترسی ترمینال یکپارچه است. میتواند جلسات Claude Code را بدون تعویض به برنامههای ترمینال خارجی راهاندازی کند.
یکی از مزایای برنامه دسکتاپ، در دسترس بودن در پسزمینه است. طبق صفحه دانلود رسمی، برنامه "در پسزمینه آماده میماند" و میتواند از هر برنامهای بدون تعویض پنجره یا از دست دادن تمرکز فراخوانی شود.
از Get AI Perks برای یافتن اعتبار برای پشته Claude Code خود استفاده کنید
نصب بخش آسان است. هزینه واقعی معمولاً از همه چیز اطراف آن ناشی میشود: زیرساخت، ابزارهای پشتیبانی و خدمات پولی مورد استفاده در طول راهاندازی و آزمایش. Get AI Perks میتواند با لیست کردن اعتبارنامههای استارتاپ و تخفیفها در یک مکان، همراه با راهنمایی در مورد نحوه اعمال آنها، کمک کند.
با Get AI Perks، میتوانید:
- اعتبارنامهها برای ابزارهای ابری و مرتبط با هوش مصنوعی را پیدا کنید
- شرایط مزایا را قبل از درخواست بررسی کنید
- از اتلاف وقت بر روی پیشنهاداتی که ممکن است واجد شرایط آنها نباشید، خودداری کنید
- هزینه راهاندازی تنظیمات خود را کاهش دهید
برای مشاهده اینکه آیا پیشنهادات موجود با ابزارهایی که قصد دارید با Claude Code استفاده کنید مطابقت دارد، از Get AI Perks دیدن کنید.
افزونههای IDE و ادغامها
فراتر از نصب مستقل، Claude Code با محیطهای توسعه محبوب ادغام میشود. افزونههایی برای Visual Studio Code و IDE های JetBrains وجود دارد.
افزونه VS Code از طریق بازار نصب میشود. "Claude Code" را در پنل Extensions جستجو کرده و روی Install کلیک کنید. این افزونه به ابزار خط فرمان که ابتدا نصب شده است نیاز دارد.
برخی از کاربران با فایل افزونه bundled VS Code مشکل دارند. اگر نصب خودکار با خطای "End of central directory record signature not found" با شکست مواجه شد، ممکن است فایل .vsix bundled خراب شده باشد.
راه حل جایگزین شامل نصب افزونه به صورت دستی از بازار VS Code به جای اتکا به نسخه bundled CLI است. این دو جزء را جدا کرده و از تداخل نصب جلوگیری میکند.
ادغام JetBrains به طور مشابه کار میکند. افزونه را از بازار JetBrains در IntelliJ IDEA، PyCharm، WebStorm یا سایر محصولات JetBrains نصب کنید.
تأیید موفقیت نصب
تأیید صحیح تضمین میکند که Claude Code قبل از شروع وظایف واقعی توسعه به درستی کار میکند.
بررسیهای اساسی در دسترس بودن دستورات را بررسی میکنند:
| claude --help claude --version |
این دستورات باید بدون خطا اجرا شوند. دستور راهنما گزینههای موجود را لیست میکند. دستور نسخه، نسخه نصب شده را نشان میدهد.
آزمایش عملکرد نیاز به شروع یک جلسه دارد. یک پوشه آزمایشی ایجاد کنید:
| mkdir test-project cd test-project claude |
این یک جلسه تعاملی Claude Code را مقداردهی اولیه میکند. ابزار باید دایرکتوری (در این مورد خالی) را تجزیه و تحلیل کرده و یک اعلان ارائه دهد.
دستورات اولیه را در داخل جلسه امتحان کنید. برای مشاهده اقدامات موجود، `help` را تایپ کنید. درخواست وظایف ساده مانند "یک فایل README ایجاد کن" یا "توضیح بده چه کاری میتوانی انجام دهی" را درخواست کنید.
پاسخهای موفقیتآمیز نشاندهنده نصب صحیح است. اگر خطا رخ دهد، معمولاً مربوط به احراز هویت، اتصال شبکه یا وابستگیهای از دست رفته است.
مدیریت نسخه و بهروزرسانی
Claude Code به طور پیشفرض به روزرسانی خودکار را انجام میدهد. مستندات رسمی توضیح میدهد که این ابزار برای نسخههای جدید بررسی کرده و آنها را بدون دخالت کاربر نصب میکند.
رفتار بهروزرسانی را میتوان از طریق تنظیمات Claude Code پیکربندی کرد. مستندات رسمی پیکربندی کانال انتشار و گزینههای بهروزرسانی دستی را پوشش میدهد.
بهروزرسانیهای دستی نیاز به اجرای مجدد اسکریپت نصب دارند. همان دستوری که برای نصب اولیه استفاده شد، آخرین نسخه را دریافت میکند:
| curl -fsSL claude.ai/install.sh | bash |
نصب نسخههای خاص برای آزمایش یا دلایل سازگاری امکانپذیر است. مستندات راهاندازی پیشرفته، پین کردن نسخه و پیکربندی کانال انتشار را پوشش میدهد.
کانالهای انتشار شامل پایدار، بتا و شبانه هستند. پایدار برای کارهای تولیدی توصیه میشود. کانالهای بتا و شبانه دسترسی زودهنگام به ویژگیهای جدید را فراهم میکنند اما ممکن است حاوی اشکالات باشند.
مشکلات رایج نصب
چندین مشکل به طور مکرر در بحثهای جامعه در مورد نصب Claude Code ظاهر میشوند.
پیکربندی PATH بسیاری از مشکلات را ایجاد میکند. اگر دستور `claude` پس از نصب پیدا نشد، پوشه باینری در PATH سیستم نیست.
در macOS و Linux، اضافه کردن دایرکتوری به PATH معمولاً شامل ویرایش فایلهای پیکربندی پوسته مانند ~/.bashrc، ~/.zshrc یا مشابه آن است. اسکریپت نصب معمولاً این کار را به طور خودکار انجام میدهد، اما بررسی دستی به عیبیابی کمک میکند.
کاربران ویندوز در WSL2 ممکن است نیاز داشته باشند پس از نصب، ترمینال را ببندند و دوباره باز کنند. متغیرهای محیطی در جلسات موجود بهروز نمیشوند.
محدودیتهای شبکه برخی از نصبها را مسدود میکنند. فایروالهای شرکتی یا سرورهای پروکسی ممکن است از دانلود نصبکننده یا اتصال به سرورهای احراز هویت جلوگیری کنند.
پیکربندی پروکسی نیاز به متغیرهای محیطی دارد:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
خطاهای مجوز هنگام نصب در پوشههای محافظت شده رخ میدهند. نصبکننده به دسترسی نوشتن در /usr/local/bin یا مکانهای معادل نیاز دارد. اجرای با sudo این مشکل را حل میکند اما مگر در مواقع ضروری باید از آن اجتناب کرد.
سوالات متداول
آیا Claude Code میتواند بدون اتصال به اینترنت اجرا شود؟
خیر. Claude Code برای عملکرد به اتصال اینترنت نیاز دارد. این ابزار کد و کوئریها را برای پردازش به سرورهای Anthropic ارسال میکند. کش محلی ممکن است اجازه دهد برخی عملیات به طور موقت آفلاین کار کنند، اما عملکرد کامل به اتصال فعال نیاز دارد.
آیا Claude Code با ابزارهای کدنویسی هوش مصنوعی موجود کار میکند؟
بله. Claude Code میتواند در کنار GitHub Copilot، Cursor یا سایر ابزارهای توسعه هوش مصنوعی اجرا شود. آنها به طور مستقل عمل کرده و تداخلی ندارند. با این حال، استفاده همزمان از چندین دستیار هوش مصنوعی ممکن است باعث سردرگمی در مورد اینکه کدام ابزار مسئول کدام وظیفه است، شود.
آیا WSL2 برای همه ویژگیهای ویندوز مورد نیاز است؟
ابزار خط فرمان در ویندوز به WSL2 نیاز دارد. با این حال، برنامه دسکتاپ به صورت بومی روی ویندوز و بدون WSL2 اجرا میشود. برنامه دسکتاپ از طریق یک رابط گرافیکی به جای تعامل صرفاً خط فرمان، عملکرد مشابهی را ارائه میدهد.
هزینه استفاده از Claude Code چقدر است؟
هزینه بسته به میزان استفاده و سطح اشتراک متفاوت است. برای اطلاع از قیمتگذاری فعلی به وبسایت رسمی Claude مراجعه کنید، زیرا هزینهها و ساختارهای برنامه در طول زمان تغییر میکنند. برخی از ویژگیها نیاز به اشتراک Claude Pro یا Enterprise دارند.
آیا Claude Code میتواند فایلهای خارج از پوشه پروژه را ویرایش کند؟
به طور پیشفرض، Claude Code برای امنیت، دسترسی به فایل را به پوشه پروژه فعلی محدود میکند. تنظیمات پیکربندی میتوانند مجوزها را گسترش دهند، اما این کار نیاز به مجوز صریح دارد. مستندات Sandboxing جزئیات مدیریت مجوز را پوشش میدهد.
تفاوت Claude Code و Claude API چیست؟
Claude Code یک ابزار توسعه برای کمک به کدنویسی تعاملی است. Claude API دسترسی برنامهای برای ساخت برنامههایی که از قابلیتهای هوش مصنوعی Claude استفاده میکنند، فراهم میکند. آنها اهداف متفاوتی را دنبال میکنند - یکی برای توسعهدهندگانی که کد مینویسند، دیگری برای برنامههایی که ویژگیهای هوش مصنوعی را ادغام میکنند.
آیا حذف نصب تمام دادههای Claude Code را حذف میکند؟
حذف نصب، باینری برنامه را حذف میکند اما ممکن است فایلهای پیکربندی و دادههای کش را باقی بگذارد. حذف کامل نیاز به حذف دستی پوشه ~/.claude در macOS و Linux، یا مکان AppData معادل آن در ویندوز دارد.
شروع کار پس از نصب
با نصب و تأیید Claude Code، گام بعدی درک نحوه استفاده مؤثر از آن است.
مستندات شروع سریع، شروع با وظایف ساده را توصیه میکند. به یک پروژه موجود بروید و `claude` را اجرا کنید تا یک جلسه تعاملی شروع شود.
از Claude بخواهید ساختار پروژه را توضیح دهد. خلاصهای از کاری که پایگاه کد انجام میدهد را درخواست کنید. این کوئریهای اکتشافی به درک چگونگی تفسیر کد توسط ابزار کمک میکنند.
تغییرات کوچک را امتحان کنید. از Claude بخواهید به توابع کامنت اضافه کند، فایلهای تستی ساده ایجاد کند، یا بلوکهای کد اولیه را بازنویسی کند. این وظایف قابلیتهای ویرایش را بدون ریسک نشان میدهند.
ادغام Git در صورتی که پروژه از کنترل نسخه استفاده کند، به طور خودکار کار میکند. Claude Code میتواند کامیت ایجاد کند، تفاوتها را توضیح دهد و بر اساس تغییرات، بهبودهایی را پیشنهاد دهد.
مستندات رسمی شامل مثالهایی از گردش کار برای وظایف رایج توسعه است. این موارد شامل رفع اشکال، پیادهسازی ویژگی، بررسی کد و تست خودکار است.
Claude Code یک ابزار در حال تحول است. نصب فقط پایه و اساس است. درک قابلیتها، محدودیتها و بهترین شیوههای آن نیاز به آزمایش و تمرین دارد.
آماده نصب Claude Code هستید؟ نصبکننده مناسب را برای پلتفرم خود از وبسایت رسمی دانلود کرده و مراحل توضیح داده شده در این راهنما را دنبال کنید. با حساب Claude خود احراز هویت کنید، تأیید کنید که نصب به درستی کار میکند و شروع به کاوش در توسعه با کمک هوش مصنوعی کنید.
