خلاصه سریع: Claude Code یک دستیار کدنویسی مبتنی بر هوش مصنوعی از Anthropic است که به توسعهدهندگان کمک میکند کد بنویسند، اشکالات را رفع کنند و وظایف را از طریق دستورات زبان طبیعی خودکار کنند. این برنامه به عنوان یک برنامه دسکتاپ، ابزار CLI و افزونه IDE در دسترس است، مستقیماً در گردش کار توسعه ادغام میشود و میتوان آن را به صورت رایگان از وبسایت رسمی Anthropic برای macOS، Windows و Linux دانلود کرد.
Claude Code به یکی از قدرتمندترین ابزارهای کدنویسی عامل در دسترس توسعهدهندگان تبدیل شده است. این برنامه که توسط Anthropic ساخته شده است، کل پایگاههای کد را درک میکند، وظایف پیچیده را اجرا میکند و به طور یکپارچه با گردش کارهای توسعه موجود ادغام میشود.
اما نکته اینجاست که شروع کار نیازمند دانستن این است که کدام نسخه را دانلود کنید و چگونه آن را به درستی راهاندازی کنید. این پلتفرم گزینههای نصب متعددی را ارائه میدهد، از برنامههای دسکتاپ گرفته تا رابطهای خط فرمان، که هر کدام برای گردش کارهای مختلف مناسب هستند.
این راهنما به بررسی تمام موارد لازم برای دانلود، نصب و پیکربندی Claude Code در پلتفرمهای مختلف میپردازد. چه در ویندوز، macOS یا لینوکس مستقر شوید، فرآیند راهاندازی با دنبال کردن مراحل درست فقط چند دقیقه طول میکشد.
Claude Code چیست؟
Claude Code یک دستیار کدنویسی عامل است که در ترمینالهای توسعهدهندگان، IDEها و برنامههای دسکتاپ زندگی میکند. برخلاف ابزارهای تکمیل کد سنتی، این ابزار وظایف چند مرحلهای را انجام میدهد، زمینه پروژه را درک میکند و دستورات را به طور مستقل اجرا میکند.
این ابزار میتواند کل پایگاههای کد را بخواند، چندین فایل را به طور همزمان ویرایش کند، دستورات ترمینال را اجرا کند و با سیستمهای کنترل نسخه ادغام شود. این ابزار از دستورالعملهای زبان طبیعی پشتیبانی میکند و عملیات پیچیده را از طریق اعلانهای مکالمه ساده در دسترس قرار میدهد.
بر اساس مستندات رسمی Claude API، این پلتفرم از طریق چندین گزینه استقرار عمل میکند: یک برنامه دسکتاپ مستقل، یک رابط خط فرمان برای استفاده در ترمینال، و افزونههایی برای IDEهای محبوب از جمله Visual Studio Code و محصولات JetBrains.
نیازمندیهای سیستم
قبل از دانلود Claude Code، بررسی کنید که سیستم نیازمندیهای حداقل را برآورده میکند. برنامه دسکتاپ و ابزار CLI مشخصات متفاوتی بسته به سیستم عامل دارند.
| پلتفرم | حداقل نیازمندیها | پیشنهادی |
|---|---|---|
| macOS | macOS 13.0 یا بالاتر | macOS 12.0+ با Apple Silicon |
| Windows | Windows 10 1809+ یا Windows Server 2019+ | Windows 11 با WSL2 |
| Linux | Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ | Ubuntu 22.04+ (مبتنی بر glibc) |
| حافظه | 4GB RAM | 8GB+ RAM |
| فضای ذخیرهسازی | 500MB فضای خالی | 2GB+ برای کش کردن |
Alpine Linux و توزیعهای مبتنی بر musl نیاز به پیکربندی اضافی دارند. مستندات رسمی اشاره میکنند که این سیستمها برای عملکرد صحیح به لایههای سازگاری glibc نیاز دارند.

قبل از دانلود، مزایای ابزار هوش مصنوعی را بررسی کنید
دانلود Claude Code یک مرحله است. بررسی اینکه آیا میتوانید برای Claude یا ابزارهای هوش مصنوعی مرتبط اعتبار دریافت کنید، مرحله دیگری است. Get AI Perks اعتبار استارتاپ و تخفیف نرمافزار برای ابزارهای هوش مصنوعی و ابری را در یک مکان جمعآوری میکند. بنیانگذاران میتوانند بیش از 200 پیشنهاد را مرور کنند، شرایط را بررسی کنند و مراحل واضحی را برای ادعای آنها دنبال کنند.
به دنبال مزایای Claude یا سایر ابزارهای هوش مصنوعی هستید؟
برای موارد زیر Get AI Perks را بررسی کنید:
- اعتبار و تخفیف ابزار هوش مصنوعی را در یک مکان پیدا کنید
- قبل از درخواست، شرایط مزایا را بررسی کنید
- پیشنهادات استارتاپ موجود را راحتتر پیگیری کنید
👉 برای مرور مزایای فعلی نرمافزار هوش مصنوعی به Get AI Perks مراجعه کنید.
گزینههای دانلود توضیح داده شده
Claude Code سه روش نصب اصلی را ارائه میدهد که هر کدام برای موارد استفاده مختلف طراحی شدهاند. درک اینکه کدام گزینه برای گردش کار خاص مناسب است، باعث صرفهجویی در زمان و سادهسازی فرآیند راهاندازی میشود.
برنامه دسکتاپ
برنامه دسکتاپ کاربرپسندترین تجربه را ارائه میدهد. این برنامه شامل یک رابط گرافیکی برای مدیریت جلسات، مشاهده تغییرات کد و کنترل مجوزهای ابزار از طریق کادرهای محاورهای بصری است.
این گزینه برای توسعهدهندگانی که بازخورد بصری را ترجیح میدهند و میخواهند به سرعت بین پروژهها جابجا شوند، بهترین کارایی را دارد. برنامه به طور خودکار بهروزرسانی میشود و احراز هویت را از طریق یک جریان مرورگر داخلی مدیریت میکند.
رابط خط فرمان
نسخه CLI مستقیماً در گردش کار ترمینال ادغام میشود. این ابزار برای توسعهدهندگانی که بیشتر وقت خود را در ترمینال میگذرانند و میخواهند خروجی را به ابزارهای دیگر ارسال کنند، ایدهآل است.
ادغام ترمینال امکان خودکارسازی را از طریق اسکریپتهای شل فراهم میکند و سربار منابع کمتری نسبت به برنامه دسکتاپ دارد. بسیاری از تیمها این را برای استقرار سرور از راه دور ترجیح میدهند.
افزونههای IDE
افزونههایی برای Visual Studio Code و IDEهای JetBrains، Claude Code را مستقیماً در محیطهای توسعه موجود تعبیه میکنند. این نسخهها عملکرد اصلی یکسانی را به اشتراک میگذارند اما تعاملات را از طریق رابطهای بومی IDE نمایش میدهند.
افزونه Visual Studio Code در نوار کناری ظاهر میشود، در حالی که ادغام JetBrains از سیستم پنجره ابزار داخلی استفاده میکند.

نصب گام به گام
فرآیند نصب بسته به پلتفرم کمی متفاوت است. در اینجا نحوه دانلود و راهاندازی Claude Code در هر سیستم عامل اصلی آمده است.
نصب در macOS
نصبکننده macOS را مستقیماً از وبسایت رسمی Anthropic دانلود کنید. این بسته روی پردازندههای Intel و Apple Silicon کار میکند.
فایل DMG دانلود شده را باز کرده و برنامه Claude Code را به پوشه Applications بکشید. برنامه را از Launchpad یا Spotlight اجرا کنید.
در اولین اجرا، macOS ممکن است یک هشدار امنیتی برای برنامههای توسعهدهندگان شناسایی شده نمایش دهد. برای ادامه به System Preferences > Security & Privacy بروید و روی "Open Anyway" کلیک کنید.
برنامه دسکتاپ به طور خودکار ابزار CLI را شامل میشود. با انتخاب "Install Terminal Command" از طریق نوار منو، به آن دسترسی پیدا کنید تا دستور claude را به مسیر شل اضافه کنید.
نصب در ویندوز
نصب ویندوز نیاز به دانلود نصبکننده EXE از سایت رسمی دارد. نصبکننده تمام وابستگیها را به طور خودکار مدیریت میکند.
نصبکننده را با دسترسی ادمین اجرا کنید. انتخاب کنید که آیا برای کاربر فعلی نصب شود یا برای همه کاربران سیستم.
برای دسترسی CLI در ویندوز، نصبکننده ابزار را به PATH سیستم اضافه میکند. PowerShell یا Command Prompt را باز کرده و با اجرای claude --version نصب را تأیید کنید.
کاربران Windows Subsystem for Linux میتوانند نسخه لینوکس را در داخل WSL برای یک تجربه یونیکس بومی نصب کنند. این رویکرد ادغام بهتری با ابزارهای توسعه مبتنی بر لینوکس فراهم میکند.
نصب در لینوکس
نصب لینوکس فرمتهای بسته متعددی را ارائه میدهد. مستندات رسمی بستههای .deb را برای سیستمهای Debian/Ubuntu و بستههای .rpm را برای توزیعهای Fedora/RHEL ارائه میدهد.
برای سیستمهای مبتنی بر Debian، بسته .deb را دانلود کرده و با استفاده از دستور زیر نصب کنید:
| sudo dpkg -i claude-code_*.debsudo apt-get install -f |
دستور دوم به طور خودکار هرگونه وابستگی از دست رفته را حل میکند.
Alpine Linux و سایر توزیعهای مبتنی بر musl نیاز به راهاندازی اضافی دارند. مستندات رسمی استفاده از بستههای سازگاری glibc یا اجرای Claude Code از طریق یک کانتینر را توصیه میکند.
احراز هویت و راهاندازی API
پس از نصب، Claude Code نیاز به احراز هویت با حساب Anthropic دارد. این فرآیند نصب محلی را به نقاط پایانی Claude API برای استنتاج متصل میکند.
Claude Code را راهاندازی کرده و هنگام درخواست، روی "Sign In" کلیک کنید. این یک پنجره مرورگر را برای احراز هویت از طریق کنسول Claude باز میکند. با یک حساب Anthropic موجود وارد شوید یا یک حساب جدید ایجاد کنید.
جریان احراز هویت یک کلید API تولید میکند که به صورت ایمن در keychain سیستم ذخیره میشود. این کلید به Claude Code اجازه میدهد تا از طرف کاربر احراز هویت شده، درخواستهایی را به مدلهای Claude ارسال کند.
برای استقرار تیمی، مدیران میتوانند تنظیمات مدیریت شده توسط سرور را پیکربندی کنند که احراز هویت، مجوزها و سیاستهای استفاده را در چندین استقرار کنترل میکند.
گزینههای پیکربندی
Claude Code از سفارشیسازی گسترده از طریق فایلهای پیکربندی پشتیبانی میکند. تنظیمات در سه دامنه وجود دارند: مدیریت شده (استقرار یافته توسط IT)، کاربر (تنظیمات شخصی عمومی) و پروژه (مخصوص مخزن).
| دامنه پیکربندی | مکان | مورد استفاده |
|---|---|---|
| مدیریت شده | رجیستری/plist در سطح سیستم | سیاستهای سراسری سازمان |
| کاربر | ~/.claude/ directory | ترجیحات شخصی |
| پروژه | .claude/ in repository | تنظیمات مشترک تیمی |
| محلی | .claude/settings.local.json | همپوشانیهای مخصوص دستگاه |
فایلهای پیکربندی در سطح پروژه در کنترل نسخه کامیت میشوند و تنظیمات را با تمام اعضای تیم به اشتراک میگذارند. تنظیمات محلی خصوصی باقی میمانند و پیشفرضهای پروژه را نادیده میگیرند.
گزینههای کلیدی قابل پیکربندی شامل انتخاب مدل، قوانین مجوز برای استفاده از ابزار، محدودیتهای سندباکس و میانبرهای صفحه کلید سفارشی هستند. مستندات رسمی تمام تنظیمات موجود را در مرجع تنظیمات Claude Code لیست میکند.
کار با SDK
کاربران پیشرفته میتوانند قابلیتهای Claude Code را از طریق Agent SDK در برنامههای سفارشی ادغام کنند. این کتابخانهها که در Python، TypeScript، Java، Go، Ruby، C# و PHP موجود هستند، دسترسی برنامهنویسی به ویژگیهای عامل Claude را فراهم میکنند.
Python SDK نیاز به Python 3.10 یا بالاتر دارد، در حالی که TypeScript نیاز به نسخه 4.9+ و Node.js 20+ دارد. نصب از گردش کار مدیر بسته استاندارد پیروی میکند.
برای پایتون:
| pip install claude-agent-sdk |
برای TypeScript/Node.js:
| npm install @anthropic-ai/sdk |
SDK امکان ساخت ابزارهای سفارشی، تعریف مهارتهای تخصصی در Markdown و ایجاد دستورات اسلش برای وظایف رایج را فراهم میکند. پروژهها میتوانند عملکرد Claude Code را از طریق افزونههایی که قابلیتهای خاص دامنه را اضافه میکنند، گسترش دهند.
نمونههای جامعه در مخزن رسمی GitHub anthropics/claude-agent-sdk-demos موجود است که الگوهایی برای خودکارسازی ایمیل، تجزیه و تحلیل دادهها و خراشیدن وب را نشان میدهد.

ویژگیهای مختص پلتفرم
گزینههای استقرار مختلف، قابلیتهای منحصر به فردی را متناسب با گردش کار خاص ارائه میدهند. درک این تفاوتها به توسعهدهندگان کمک میکند تا نصب مناسب را برای نیازهای خود انتخاب کنند.
کنترل از راه دور و دسترسی موبایل
نسخههای دسکتاپ و وب از کنترل از راه دور پشتیبانی میکنند و به توسعهدهندگان اجازه میدهند جلسات را در دستگاههای مختلف ادامه دهند. کار را روی یک دستگاه دسکتاپ شروع کنید، سپس همان جلسه را روی تلفن یا تبلت ادامه دهید.
این ویژگی از طریق برنامه iOS Claude و رابط وب در claude.ai کار میکند. جلسات با احراز هویت با همان حساب به طور خودکار همگامسازی میشوند.
ادغام بازبینی کد
Claude Code با GitHub Actions و GitLab CI/CD pipelines برای بازبینی کد خودکار ادغام میشود. این ادغامها درخواستهای pull را تجزیه و تحلیل میکنند، بهبودهایی را پیشنهاد میدهند و مشکلات احتمالی را قبل از ادغام شناسایی میکنند.
ویژگی GitHub Code Review نظرات درون خطی را روی diffها ارائه میدهد و باعث میشود تکرار بازخوردها در گردش کار عادی PR آسان باشد.
ادغام Slack
تیمهایی که از Slack استفاده میکنند میتوانند گزارشهای اشکال و درخواستهای ویژگی را مستقیماً از طریق یک ادغام اختصاصی به Claude Code هدایت کنند. پیامها در کانالهای مشخص شده، تجزیه و تحلیل خودکار را راهاندازی میکنند و میتوانند درخواستهای pull را به طور خودکار تولید کنند.
حریم خصوصی و نگهداری دادهها
درک نحوه مدیریت دادهها توسط Claude Code برای تیمهایی که با پایگاههای کد حساس کار میکنند، حیاتی است. این پلتفرم چندین سیاست نگهداری داده را ارائه میدهد.
به طور پیشفرض، اعلانها و خروجیها ممکن است برای بهبود مدلهای Claude استفاده شوند، مگر اینکه تنظیمات نگهداری داده متفاوت پیکربندی شده باشند. مشتریان سازمانی میتوانند نگهداری صفر داده را فعال کنند و اطمینان حاصل کنند که هیچ ورودی یا خروجی فراتر از چرخه عمر درخواست ذخیره نمیشود.
مستندات رسمی بیان میکند که گزارشهای مکالمه به طور پیشفرض محلی باقی میمانند، با همگامسازی اختیاری ابری برای دسترسی بین دستگاهی. تیمها میتوانند همگامسازی را به طور کامل برای محیطهای air-gapped غیرفعال کنند.
عیبیابی مسائل رایج
بیشتر مشکلات نصب ناشی از مسائل احراز هویت، محدودیتهای شبکه یا پیکربندیهای سیستمی ناسازگار است. در اینجا نحوه حل رایجترین مشکلات آورده شده است.
شکستهای احراز هویت
اگر ورود به سیستم با شکست مواجه شد، تأیید کنید که سیستم میتواند به api.anthropic.com در پورت 443 دسترسی پیدا کند. فایروالهای شرکتی گاهی اوقات نقاط پایانی API را مسدود میکنند.
تنظیمات پروکسی را در فایل پیکربندی در ~/.claude/settings.json بررسی کنید. این پلتفرم از پروکسیهای HTTP و SOCKS5 برای محیطهای سازمانی پشتیبانی میکند.
خطاهای Command Not Found
هنگامی که ابزار CLI پس از نصب شناخته نمیشود، متغیر محیطی PATH احتمالاً نیاز به بهروزرسانی دارد. در macOS و Linux، دایرکتوری نصب را به PATH در ~/.bashrc یا ~/.zshrc اضافه کنید.
برای ویندوز، تأیید کنید که نصبکننده دایرکتوری نصب را از طریق تنظیمات Environment Variables به PATH سیستم اضافه کرده است.
مسائل عملکرد
زمان پاسخگویی کند معمولاً ناشی از پنجرههای زمینه بزرگ یا تأخیر شبکه است. Prompt Caching را در پیکربندی فعال کنید تا پردازش مجدد الگوهای کد رایج کاهش یابد.
طبق مستندات رسمی Claude Developer Platform، Prompt Caching میتواند با کش کردن و استفاده مجدد از محتوای اعلان، هزینهها را تا 90% و تأخیر را تا 80% کاهش دهد.
سوالات متداول
آیا Claude Code برای دانلود و استفاده رایگان است؟
Claude Code به عنوان یک دانلود رایگان از وبسایت رسمی Anthropic در دسترس است. استفاده نیاز به حساب Anthropic دارد و اعتبارات API را بر اساس مدلهای Claude مورد استفاده مصرف میکند. صفحه قیمتگذاری رسمی را برای نرخهای فعلی API بررسی کنید، زیرا هزینهها بسته به سطح مدل متفاوت است.
آیا Claude Code میتواند آفلاین کار کند؟
خیر، Claude Code برای عملکرد به اتصال فعال اینترنت نیاز دارد. تمام استنتاج از طریق نقاط پایانی API Anthropic انجام میشود. این ابزار برای ارسال اعلانها و دریافت پاسخها از مدلهای Claude نیاز به دسترسی به شبکه دارد.
Claude Code از کدام زبانهای برنامهنویسی پشتیبانی میکند؟
Claude Code با تمام زبانهای برنامهنویسی اصلی از جمله Python، JavaScript، TypeScript، Java، C++، Go، Rust، PHP، Ruby و موارد دیگر کار میکند. این ابزار نحو و اصطلاحات زبان را در دهها زبان و چارچوب درک میکند.
Claude Code چگونه با GitHub Copilot متفاوت است؟
در حالی که GitHub Copilot بر تکمیل کد خط به خط تمرکز دارد، Claude Code رویکرد عامل را در پیش میگیرد. این ابزار میتواند وظایف چند مرحلهای را اجرا کند، دستورات ترمینال را اجرا کند، چندین فایل را به طور همزمان ویرایش کند و کل زمینههای پروژه را درک کند. این ابزارها اهداف مکمل اما متفاوتی را انجام میدهند.
آیا تیمها میتوانند پیکربندیهای Claude Code را به اشتراک بگذارند؟
بله، فایلهای پیکربندی سطح پروژه در دایرکتوری .claude را میتوان در کنترل نسخه کامیت کرد. این به تیمها اجازه میدهد تا مهارتها، دستورات سفارشی، مجوزها و تنظیمات مخصوص پروژه را در بین تمام توسعهدهندگان فعال در مخزن به اشتراک بگذارند.
آیا Claude Code از استقرار سازمانی پشتیبانی میکند؟
Anthropic، Claude for Enterprise را با ویژگیهایی از جمله تنظیمات مدیریت شده توسط سرور، احراز هویت متمرکز، تجزیه و تحلیل استفاده و سیاستهای نگهداری صفر داده ارائه میدهد. استقرارهای سازمانی میتوانند سیاستهای امنیتی و مجوزهای ابزار را در سراسر سازمانها اعمال کنند.
چه مدلهایی Claude Code را نیرو میدهند؟
طبق مستندات رسمی overview Models، Claude Code میتواند از هر مدلی در خانواده Claude استفاده کند. از آخرین مستندات، این شامل Claude Opus 4.6 برای استدلال پیچیده، Claude Sonnet 4.6 برای عملکرد متعادل، و Claude Haiku 4.5 برای وظایف بهینه شده از نظر سرعت است.
نتیجهگیری
دانلود و نصب Claude Code تنها چند دقیقه طول میکشد، اما تأثیر آن بر گردش کار توسعه میتواند دگرگونکننده باشد. قابلیتهای عامل پلتفرم بسیار فراتر از تکمیل کد ساده است و یک همکار برنامهنویس واقعی مبتنی بر هوش مصنوعی را ارائه میدهد که زمینه را درک میکند و وظایف پیچیده را به طور مستقل اجرا میکند.
چه برنامه دسکتاپ را برای گردش کارهای بصری، CLI را برای ادغام ترمینال، یا افزونههای IDE را برای تجربههای ویرایشگر بومی مستقر کنید، Claude Code با شیوههای توسعه موجود سازگار میشود تا اینکه مجبور به استفاده از شیوههای جدید باشد.
برای دانلود Claude Code و شروع به کدنویسی با کمک هوش مصنوعی، از وبسایت رسمی Anthropic دیدن کنید. مستندات گسترده پلتفرم و جامعه فعال، منابعی را برای توسعهدهندگان در هر سطح مهارتی فراهم میکنند.

