نصب Claude Code در ویندوز و لینوکس؛ آموزش کامل از صفر تا اجرا

اگر می‌خواهید از Claude Code برای برنامه‌نویسی و کار با پروژه‌های نرم‌افزاری استفاده کنید، اولین قدم درست، نصب Claude Code به روش مناسب سیستم‌عامل شماست. برخلاف چیزی که ممکن است در نگاه اول به نظر برسد، نصب Claude Code فقط اجرای یک دستور نیست؛ انتخاب روش مناسب در ویندوز، تفاوت Windows Native و WSL، شناخت PowerShell و CMD، بررسی PATH، احراز هویت، به‌روزرسانی و رفع خطاهای احتمالی، همگی روی تجربه استفاده شما تأثیر دارند.

نکته مهم: Claude Code مرتباً به‌روزرسانی می‌شود و روش‌های نصب یا جزئیات بعضی نسخه‌ها ممکن است تغییر کند. دستورهای این مقاله بر اساس مستندات رسمی فعلی Anthropic نوشته شده‌اند؛ برای تغییرات آینده، مستندات رسمی را ملاک نهایی قرار دهید.

قطعا به کارتان می آید: آموزش اتصال Claude Code به ترمینال 💎 آپدیت 9 شهریور 1405

هر آنچه که در این مقاله می خوانید:

1. نصب Claude Code؟
2. پیش‌نیازهای نصب Claude Code
3. نصب Claude Code در ویندوز
4. نصب Claude Code با PowerShell
5. نصب Claude Code با CMD
6. نصب Claude Code با WinGet
7. نصب Claude Code در WSL
8. نصب Claude Code در لینوکس
9. چگونه نصب Claude Code را بررسی کنیم؟
10. چگونه Claude Code را اجرا کنیم؟
11. مشکل command not found در Claude Code
12. خطاهای رایج هنگام نصب Claude Code
13. Claude Code را چگونه آپدیت کنیم؟
14. چگونه Claude Code را حذف کنیم؟
15. Windows Native یا WSL؛ کدام را انتخاب کنیم؟
16. بعد از نصب Claude Code چه کنیم؟
17. سوالات متداول نصب Claude Code

نصب Claude Code؟

نصب Claude Code به فرایندی گفته می‌شود که طی آن ابزار Claude Code روی سیستم شما قرار می‌گیرد و فرمان claude برای اجرا در محیط خط فرمان در دسترس قرار می‌گیرد. Claude Code اکنون برای Windows، macOS، Linux و WSL ارائه می‌شود و مستندات رسمی Anthropic نصب Native را روش پیشنهادی معرفی می‌کند. در ویندوز می‌توانید Claude Code را مستقیماً روی خود Windows اجرا کنید یا آن را داخل WSL قرار دهید.

این نکته مهم است که نصب Claude Code با نحوه استفاده از Claude Code یکی نیست. در این مقاله هدف اصلی، راه‌اندازی صحیح و سالم نرم‌افزار است. بعد از اینکه نصب را انجام دادید، می‌توانید برای یادگیری کار با Terminal، اجرای دستورات، کار در پوشه پروژه و Workflowهای توسعه، سراغ مقاله اختصاصی ما درباره آموزش اتصال Claude Code به ترمینال بروید.

به بیان ساده، در این صفحه قرار است کاری کنیم که:

Claude Code نصب شود → سیستم آن را بشناسد → نسخه نصب‌شده قابل بررسی باشد → احراز هویت انجام شود → آماده شروع اولین Session شوید.

پیش‌نیازهای نصب Claude Code

قبل از اینکه سراغ دستورهای نصب بروید، بهتر است مطمئن شوید سیستم شما حداقل شرایط لازم را دارد.

بر اساس مستندات رسمی فعلی Anthropic، Claude Code روی Windows 10 نسخه 1809 به بعد یا Windows Server 2019 به بعد، Ubuntu 20.04 به بعد، Debian 10 به بعد و Alpine Linux 3.19 به بعد پشتیبانی می‌شود. حداقل 4 گیگابایت RAM و پردازنده x64 یا ARM64 مورد نیاز است و برای استفاده نیز اتصال اینترنت لازم است. Shellهای Bash، Zsh، PowerShell و CMD نیز پشتیبانی می‌شوند.

حداقل موارد مورد نیاز

در جدول زیر می توانید سیستم هایی که توانایی اجرای Claude Code را دارند را مشاهده کنید:

Claude Code معمولاً وابستگی‌هایی مانند ripgrep را نیز خودش مدیریت می‌کند و در نصب معمول Native لازم نیست از ابتدا برای نصب آن‌ها اقدام کنید.

آیا برای نصب Claude Code به Node.js نیاز داریم؟

یکی از سؤالات رایج کاربران همین است.

برای Native Installer معمولاً نیازی به نصب Node.js ندارید. این موضوع یکی از تفاوت‌های مهم روش جدید Native با روش‌های قدیمی‌تر است.

البته Anthropic هنوز امکان نصب Claude Code از طریق npm را نیز ارائه می‌کند و در حال حاضر پکیج npm به Node.js 22 یا بالاتر نیاز دارد. بنابراین این دو روش را نباید با یکدیگر اشتباه گرفت.

برای بیشتر کاربران جدید، توصیه منطقی این است که ابتدا سراغ Native Installer بروید و فقط زمانی از npm استفاده کنید که دلیل مشخصی برای آن داشته باشید.

نصب Claude Code در ویندوز

کاربران Windows دو مسیر اصلی دارند:

Windows Native

یا

WSL 2

این دو روش هر دو قابل استفاده‌اند، اما فلسفه استفاده از آن‌ها یکسان نیست.

در حالت Native، Claude Code مستقیماً روی Windows نصب می‌شود و می‌توانید آن را از PowerShell یا CMD اجرا کنید. نصب Git for Windows نیز اختیاری است، اما داشتن آن باعث می‌شود Claude Code به Git Bash و Bash Tool دسترسی داشته باشد. بدون Git for Windows، Claude Code از PowerShell برای اجرای دستورات Shell استفاده می‌کند.

در WSL، Claude Code داخل محیط Linux شما نصب می‌شود و باید همان‌جا اجرا شود؛ یعنی اگر Claude Code را در WSL نصب کرده‌اید، اجرای آن را از داخل WSL انجام دهید، نه PowerShell یا CMD ویندوز.

نصب Claude Code با PowerShell

برای بسیاری از کاربران Windows، PowerShell ساده‌ترین مسیر برای نصب Claude Code است.

ابتدا PowerShell را باز کنید. لازم نیست آن را با Administrator اجرا کنید؛ مستندات رسمی Anthropic می‌گوید نصب Native ویندوز از PowerShell یا CMD بدون نیاز به اجرای Administrator انجام می‌شود.

سپس دستور زیر را اجرا کنید:

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

این دستور اسکریپت نصب Claude Code را دریافت و اجرا می‌کند.

پس از پایان نصب، برای اطمینان یک PowerShell جدید باز کنید و نسخه را بررسی کنید:

claude --version

اگر نسخه Claude Code نمایش داده شد، ابزار توسط سیستم شناسایی شده است. برای بررسی دقیق‌تر وضعیت نصب و تنظیمات نیز می‌توانید از:

claude doctor

استفاده کنید. دستور claude doctor وضعیت نصب و تنظیمات را به شکل تشخیصی بررسی می‌کند و در صورت وجود بعضی مشکلات، هشدار یا راهنمای اصلاح ارائه می‌دهد.

از کجا بفهمیم PowerShell باز کرده‌ایم یا CMD؟

اگر ابتدای خط چیزی شبیه این ببینید:

PS C:\Users\YourName>

در PowerShell هستید.

اما در CMD معمولاً چیزی شبیه این نمایش داده می‌شود:

C:\Users\YourName>

این دو محیط شبیه هم هستند اما دستورهایشان الزاماً یکسان نیست. یکی از خطاهای رایج نصب Claude Code دقیقاً از همین اشتباه ناشی می‌شود.

نصب Claude Code با CMD

اگر می‌خواهید از Command Prompt یا همان CMD ویندوز استفاده کنید، نباید دستور مخصوص PowerShell را در آن اجرا کنید.

در CMD این دستور را اجرا کنید:

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

این روش نیز مستقیماً توسط مستندات رسمی Anthropic ارائه شده است.

بعد از پایان نصب، اجرای زیر را امتحان کنید:

claude --version

یک اشتباه بسیار رایج

اگر در CMD دستور PowerShell را وارد کنید:

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

احتمالاً با خطایی مواجه می‌شوید که نشان می‌دهد irm شناخته نشده است.

برعکس، اگر دستور دارای && مخصوص CMD را در PowerShell اجرا کنید، PowerShell ممکن است خطایی درباره معتبر نبودن && نشان دهد.

پس قبل از هر چیز مطمئن شوید در Shell صحیح قرار دارید. خود مستندات Claude Code نیز همین تفاوت را به عنوان یکی از خطاهای رایج نصب مطرح می‌کند.

نصب Claude Code با WinGet

اگر از Windows و ابزار مدیریت بسته‌های WinGet استفاده می‌کنید، نصب Claude Code حتی ساده‌تر می‌شود.

در PowerShell یا CMD دستور زیر را اجرا کنید:

winget install Anthropic.ClaudeCode

بعد از پایان نصب، نسخه را بررسی کنید:

claude --version

یکی از مزیت‌های WinGet برای بعضی کاربران این است که نصب نرم‌افزار از طریق Package Manager انجام می‌شود و مدیریت آن در محیط Windows آشناتر است.

اما یک تفاوت مهم را فراموش نکنید: نصب‌های WinGet برخلاف Native Installer به‌صورت پیش‌فرض خودکار به‌روزرسانی نمی‌شوند. برای ارتقای نسخه باید دستور مخصوص WinGet را اجرا کنید.

نصب Claude Code در WSL

اگر بیشتر با ابزارها و محیط Linux کار می‌کنید، WSL 2 می‌تواند انتخاب بسیار مناسبی باشد.

WSL مخفف Windows Subsystem for Linux است و به شما اجازه می‌دهد یک محیط Linux را درون Windows اجرا کنید.

Anthropic در راهنمای رسمی خود می‌گوید Windows Native، WSL 2 و WSL 1 هرکدام سناریوهای متفاوتی دارند:

• Windows Native برای پروژه‌ها و ابزارهای Windows-native
• WSL 2 برای Linux toolchain و سناریوهایی که Sandbox کردن اجرای دستورات اهمیت دارد
• WSL 1 در شرایطی که WSL 2 در دسترس نیست

از میان این گزینه‌ها، WSL 2 برای کاربرانی که Workflow آن‌ها بر پایه ابزارهای Linux است، انتخاب طبیعی‌تری است.

نصب Claude Code داخل WSL

بعد از ورود به محیط WSL، دستور Linux را اجرا کنید:

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

سپس:

claude --version

را اجرا کنید.

نکته مهم این است که اگر Claude Code را داخل WSL نصب کرده‌اید، آن را هم داخل همان محیط WSL اجرا کنید:

claude

و نصب WSL را با نسخه Windows مخلوط نکنید. مستندات رسمی Anthropic نیز تأکید می‌کند که Claude Code نصب‌شده در WSL باید در ترمینال WSL اجرا شود.

نصب Claude Code در لینوکس

در Linux نیز ساده‌ترین مسیر برای بیشتر کاربران، Native Installer است.

برای نصب:

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

بعد از اتمام کار:

claude --version

را اجرا کنید.

اگر شماره نسخه را دریافت کردید، Claude Code نصب شده است.

نصب در Ubuntu و Debian

کاربران Ubuntu و Debian می‌توانند از Native Installer استفاده کنند. علاوه بر آن، Anthropic برای توزیع‌های Debian/Ubuntu یک مخزن apt رسمی نیز ارائه کرده است. این مسیر برای محیط‌هایی که مدیریت نرم‌افزار از طریق Package Manager را ترجیح می‌دهند، کاربردی است.

برای کاربران معمولی، پیشنهاد بهتر این است که ابتدا Native Installer را امتحان کنند، مگر اینکه نیاز مشخصی به مدیریت Claude Code از طریق apt داشته باشند.

نصب در Fedora و RHEL

برای Fedora و RHEL نیز مخزن رسمی dnf وجود دارد و می‌توان Claude Code را از طریق Package Manager سیستم نصب و بعداً ارتقا داد.

نکته درباره Alpine Linux

Alpine بر پایه musl است و شرایط آن با توزیع‌های مبتنی بر glibc متفاوت است. مستندات رسمی Anthropic برای Alpine، نصب Bash و Curl و کتابخانه‌هایی مانند libgcc و libstdc++ و همچنین ripgrep را ذکر می‌کند.

بنابراین اگر روی Alpine هستید، از دستورهای عمومی Ubuntu یا Debian بدون توجه به تفاوت محیط استفاده نکنید.

چگونه نصب Claude Code را بررسی کنیم؟

نصب نرم‌افزار فقط زمانی تمام نشده که دستور نصب بدون خطا اجرا شده باشد. بهتر است سه بررسی انجام دهید.

بررسی نسخه

اول:

claude --version

اگر نسخه Claude Code نمایش داده شد، سیستم دستور claude را پیدا کرده است.

بررسی وضعیت نصب و تنظیمات

دوم:

claude doctor

این دستور برای تشخیص وضعیت نصب و تنظیمات طراحی شده و در حالت عادی Session جدید را اجرا نمی‌کند.

بررسی مسیر اجرای Claude

اگر می‌خواهید بفهمید سیستم دقیقاً از چه فایل اجرایی استفاده می‌کند، باید مسیر claude را نیز بررسی کنید.

در Linux/macOS معمولاً:

which claude

و در Windows PowerShell:

Get-Command claude | Select-Object Source

مستندات رسمی برای شناسایی نصب‌های متعدد نیز دستورهایی برای بررسی مسیرهای مختلف Claude Code پیشنهاد می‌کند.

این بررسی زمانی اهمیت زیادی پیدا می‌کند که قبلاً Claude Code را با روش دیگری نصب کرده باشید.

چگونه Claude Code را اجرا کنیم؟

بعد از نصب موفقیت‌آمیز، اجرای Claude Code ساده است:

claude

Claude Code یک Session تعاملی باز می‌کند و از طریق آن می‌توانید تعامل خود را آغاز کنید.

برای اولین اجرا، ممکن است از شما خواسته شود وارد حساب شوید. Anthropic اعلام کرده که Claude Code به یکی از حساب‌ها یا روش‌های دسترسی پشتیبانی‌شده نیاز دارد؛ از جمله Pro، Max، Team، Enterprise یا Console. پلن رایگان Claude.ai در حال حاضر شامل دسترسی Claude Code نیست. همچنین امکان استفاده از بعضی ارائه‌دهندگان ابری مانند Amazon Bedrock، Google Cloud و Microsoft Foundry نیز وجود دارد.

پس از نصب، اگر نیاز دارید وارد حساب شوید، ساده‌ترین مسیر این است که:

claude

را اجرا کنید و مراحل ورود نمایش‌داده‌شده را ادامه دهید.

بعد از ورود، می‌توانید کار با خود Claude Code را شروع کنید.

برای جزئیات مربوط به کار با Terminal، ورود به پوشه پروژه و Workflow استفاده از Claude Code، مقاله آموزش اتصال Claude Code به ترمینال را نیز مطالعه کنید.

مشکل command not found در Claude Code

یکی از رایج‌ترین مشکلات بعد از نصب Claude Code این است که نصب با موفقیت انجام شده اما وقتی دستور زیر را اجرا می‌کنید:

claude

سیستم می‌گوید:

command not found: claude

یا در Windows:

'claude' is not recognized...

این خطا معمولاً به معنی خراب بودن خود Claude Code نیست؛ بلکه اغلب Shell شما مسیر نصب را در PATH پیدا نمی‌کند. مستندات رسمی Anthropic نیز این مورد را یکی از مشکلات اصلی بعد از نصب می‌داند.

اولین راه‌حل: ترمینال جدید باز کنید

گاهی ترمینالی که قبل از نصب باز بوده، تغییرات PATH را هنوز دریافت نکرده است.

بنابراین:

1. ترمینال را ببندید.
2. یک PowerShell، CMD یا Terminal جدید باز کنید.
3. دوباره اجرا کنید:

claude --version

بررسی PATH در Linux

در نصب Native، مسیر رایج فایل اجرایی Claude در Linux و macOS عبارت است از:

~/.local/bin/claude

اگر ~/.local/bin داخل PATH نباشد، Shell نمی‌تواند دستور claude را پیدا کند.

بررسی PATH در Windows

در Windows نیز نصب Native از مسیر کاربر استفاده می‌کند و فایل اجرایی Claude در مسیر محلی کاربر قرار می‌گیرد. مستندات رسمی مسیر %USERPROFILE%\.local\bin\claude.exe را برای Native Installer ذکر می‌کند.

اگر مسیر وجود داشته باشد اما claude پیدا نشود، مسئله باید در PATH یا درگیری چند نصب بررسی شود.

اگر چند نسخه Claude Code نصب شده باشد چه می‌شود؟

این مشکل به‌خصوص برای کاربرانی پیش می‌آید که قبلاً Claude Code را با npm نصب کرده‌اند و بعد نسخه Native را نیز نصب کرده‌اند.

در این حالت ممکن است چند claude روی سیستم شما وجود داشته باشد و نسخه‌ای که اجرا می‌شود با نسخه‌ای که فکر می‌کنید نصب کرده‌اید متفاوت باشد.

Anthropic توصیه می‌کند وجود نصب‌های متعدد را بررسی کنید و ترجیحاً یک مسیر نصب را نگه دارید. برای Windows می‌توانید:

where.exe claude

و در Linux:

which -a claude

را بررسی کنید.

این کار به شما نشان می‌دهد دقیقاً چند نسخه از فرمان claude در مسیرهای سیستم پیدا می‌شود.

خطاهای رایج هنگام نصب Claude Code

خطاهای رایج هنگام نصب Claude Code را جدی بگیرید:

خطای irm is not recognized

این معمولاً به این معنی است که دستور مخصوص PowerShell را داخل CMD اجرا کرده‌اید.

در PowerShell:

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

و در CMD:

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

استفاده کنید.

خطای && is not a valid statement separator

این خطا معمولاً وقتی رخ می‌دهد که دستور CMD را داخل PowerShell اجرا کرده باشید.

محیط Shell را بررسی کنید و دستور مناسب همان محیط را اجرا کنید.

خطای syntax error near unexpected token '<'

اگر در Linux هنگام اجرای Install Script خطایی شبیه این مشاهده کردید:

syntax error near unexpected token '<'

ممکن است به جای اسکریپت نصب، یک صفحه HTML از سرور دریافت کرده باشید.

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

خطای TLS یا SSL

اگر خطاهایی مربوط به:

TLS
SSL
secure channel

دریافت می‌کنید، مشکل لزوماً از Claude Code نیست.

در این شرایط باید اتصال شبکه، Proxy، گواهی‌های CA و دسترسی سیستم به سرورهای دانلود Claude Code بررسی شود. صفحه رسمی Troubleshooting نیز مشکلات TLS و Proxy را جزو دسته‌های مشخص عیب‌یابی نصب قرار داده است.

خطای Permission در Linux

اگر کاربر Linux هنگام نصب با خطاهای دسترسی مواجه شود، بررسی دسترسی نوشتن به مسیرهایی مانند:

~/.local/bin/
~/.claude/

مهم است.

مستندات رسمی توصیه می‌کند این مسیرها توسط کاربر قابل نوشتن باشند و در نصب‌های Native از اجرای دستورات اضافی با sudo خودداری شود، مگر اینکه مستندات همان روش صراحتاً نیاز به دسترسی بالاتر را مطرح کرده باشند.

اگر Claude Code بعد از نصب اجرا نمی‌شود چه کنیم؟

این مسیر عیب‌یابی را به‌ترتیب انجام دهید:

claude --version

سپس:

claude doctor

بعد مسیر اجرایی Claude را بررسی کنید.

در Linux:

which -a claude

در Windows:

where.exe claude

اگر بیش از یک نسخه پیدا شد، نصب‌های قدیمی یا متضاد را بررسی کنید. این ترتیب معمولاً بسیار بهتر از حذف تصادفی فایل‌ها یا نصب دوباره پشت‌سرهم است.

Claude Code را چگونه آپدیت کنیم؟

روش به‌روزرسانی Claude Code به شیوه نصب آن بستگی دارد.

Native Installer

نصب Native به‌صورت پیش‌فرض می‌تواند در پس‌زمینه به‌روزرسانی شود و Claude Code بررسی آپدیت را هنگام اجرا و به شکل دوره‌ای انجام می‌دهد.

همچنین می‌توانید آپدیت را دستی انجام دهید:

claude update

این دستور برای اعمال فوری به‌روزرسانی استفاده می‌شود.

WinGet

اگر Claude Code را با WinGet نصب کرده‌اید، آپدیت خودکار Native را ندارید و باید از:

winget upgrade Anthropic.ClaudeCode

استفاده کنید.

npm

اگر Claude Code را با npm نصب کرده‌اید:

npm install -g @anthropic-ai/claude-code@latest

به‌عنوان روش رسمی ارتقا ارائه شده است.

طبق مستندات فعلی، بهتر است برای این کار از npm update -g استفاده نکنید؛ همچنین اجرای sudo npm install -g نیز توصیه نمی‌شود و ممکن است باعث مشکلات Permission و امنیتی شود.

آیا باید Claude Code را همیشه به آخرین نسخه آپدیت کنیم؟

لزومی ندارد هر کاربر دقیقاً یک نسخه مشخص را دنبال کند. Claude Code دو کانال اصلی برای انتشار به‌روزرسانی دارد:

latest

برای دریافت نسخه‌های جدیدتر و قابلیت‌های تازه سریع‌تر.

stable

برای کاربرانی که ترجیح می‌دهند نسخه‌ای با فاصله بیشتر از انتشار اولیه و با عبور از بعضی Regressionهای مهم دریافت کنند.

در مستندات رسمی، کانال latest به‌عنوان حالت پیش‌فرض معرفی شده و stable معمولاً حدود یک هفته عقب‌تر است.

برای استفاده روزمره، انتخاب بین این دو بیشتر به اولویت شما میان «دریافت سریع قابلیت‌ها» و «ثبات بیشتر» بستگی دارد.

چگونه Claude Code را حذف کنیم؟

حذف Claude Code نیز به روش نصب بستگی دارد.

حذف Native در Linux یا WSL

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

حذف Native در Windows

در PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

حذف از طریق WinGet

winget uninstall Anthropic.ClaudeCode

حذف نسخه npm

npm uninstall -g @anthropic-ai/claude-code

آیا حذف برنامه یعنی همه تنظیمات هم حذف می‌شوند؟

نه لزوماً.

Anthropic تنظیمات، State، MCP Configuration و Session History را نیز در مسیرهای جداگانه نگه می‌دارد. حذف این فایل‌ها یک مرحله جداگانه است و باید با دقت انجام شود، چون ممکن است تنظیمات و تاریخچه جلسات شما نیز حذف شوند.

بنابراین قبل از پاک‌سازی کامل، مطمئن شوید که واقعاً قصد حذف تنظیمات و داده‌های مربوط به Claude Code را دارید.

Windows Native یا WSL؛ کدام را انتخاب کنیم؟

این شاید مهم‌ترین تصمیم کاربران Windows قبل از نصب Claude Code باشد.

Windows Native را انتخاب کنید اگر:

پروژه‌های شما عمدتاً در محیط Windows هستند.

از ابزارهای Windows-native استفاده می‌کنید.

می‌خواهید ساده‌ترین مسیر نصب را داشته باشید.

می‌خواهید بدون راه‌اندازی محیط Linux کار کنید.

Anthropic، Windows Native را برای پروژه‌ها و ابزارهای Windows-native پیشنهاد می‌کند.

WSL 2 را انتخاب کنید اگر:

پروژه‌های شما بیشتر Linux-based هستند.

Workflow شما بر پایه ابزارهای Linux است.

به محیط Linux برای توسعه وابسته‌اید.

Sandboxing برای اجرای دستورات برایتان مهم است.

مستندات رسمی، WSL 2 را برای Linux toolchain و سناریوهای دارای Sandbox مناسب معرفی می‌کند.

جدول تصمیم سریع

تصمیم گیری سریع با جدول زیر ممکن می شود:

برای بسیاری از کاربران تازه‌کار، Windows Native ساده‌ترین نقطه شروع است. اگر بعداً مشخص شد Workflow شما به Linux وابستگی زیادی دارد، می‌توانید سراغ WSL بروید.

آیا Git for Windows برای Claude Code لازم است؟

خیر؛ در نصب Native فعلی، Git for Windows اجباری نیست.

اما نصب آن می‌تواند مفید باشد، زیرا Git for Windows، Git Bash را در اختیار Claude Code قرار می‌دهد و به این ترتیب Bash Tool قابل استفاده خواهد بود.

اگر Git for Windows نصب نباشد، Claude Code می‌تواند از PowerShell برای اجرای دستورات Shell استفاده کند.

پس:

Git for Windows = اختیاری

اما برای بعضی Workflowهای توسعه:

Git for Windows = مفید

بعد از نصب Claude Code چه کنیم؟

بعد از اینکه claude --version نسخه نصب‌شده را نمایش داد، نصب دیگر دغدغه اصلی شما نیست.

حالا باید وارد مرحله استفاده شوید.

اول Claude Code را اجرا کنید:

claude

سپس می‌توانید وارد محیط تعاملی آن شوید.

از اینجا به بعد، مباحثی مانند:

• نحوه کار با پروژه
• اجرای Claude در پوشه پروژه
• نوشتن Prompt مناسب
• استفاده از Git
• بررسی فایل‌ها
• دیباگ
• تست
• CLAUDE.md
• Skills
• MCP
• Subagents

وارد مرحله استفاده حرفه‌ای می‌شوند و دیگر بخشی از «نصب» محسوب نمی‌شوند.

برای همین بهتر است این صفحه را صفحه مرجع نصب Claude Code نگه دارید و آموزش‌های بعدی را به صفحات مستقل تقسیم کنید. این ساختار از نظر معماری محتوای سایت هم منطقی‌تر است.

مثلاً کاربر می‌تواند مسیر زیر را طی کند:

نصب Claude Code ← اجرای اولیه ← اتصال و کار با Terminal ← آموزش Claude Code ← ترفندهای حرفه‌ای Claude Code

به این ترتیب هر مقاله یک Search Intent مشخص دارد و صفحات مختلف سایت شما کمتر وارد رقابت با یکدیگر می‌شوند.

یک نکته مهم برای کاربران ایران

در فرایند نصب، ممکن است بعضی کاربران با مسئله دسترسی شبکه یا احراز هویت مواجه شوند. این مشکلات را نباید با «مشکل نصب نرم‌افزار» یکی دانست.

اگر Install Script به‌درستی دریافت نشود، اگر سرور دانلود از شبکه شما قابل دسترسی نباشد یا اگر فرایند OAuth کامل نشود، باید خطا را بر اساس مرحله‌ای که در آن رخ داده بررسی کرد.

مستندات رسمی Claude Code نیز مشکلات Network، TLS، Proxy، Region Availability و OAuth را به‌صورت جداگانه در بخش Troubleshooting پوشش می‌دهد.

بنابراین اگر نصب انجام نمی‌شود، اول مشخص کنید مشکل در کدام بخش است:

دانلود نصب‌کننده؟

اجرای Installer؟

PATH؟

اجرای claude؟

احراز هویت؟

اتصال شبکه؟

این تفکیک سرعت عیب‌یابی را بسیار بیشتر می‌کند.

آیا نصب Claude Code سخت است؟

اگر روش درست را انتخاب کنید، معمولاً نه.

در Windows Native می‌توانید با PowerShell، CMD یا WinGet نصب کنید. در Linux و WSL نیز Native Installer مسیر ساده‌ای ارائه می‌دهد. چیزی که نصب Claude Code را برای بعضی کاربران دشوار می‌کند، خود دستور نصب نیست؛ بلکه اشتباه در انتخاب Shell، PATH، چند نصب همزمان، محدودیت شبکه یا احراز هویت است.

به همین دلیل بهترین روش این است که نصب را مرحله‌ای انجام دهید و بعد از هر مرحله نتیجه را بررسی کنید.

چک‌لیست نهایی نصب Claude Code

قبل از اینکه بگویید Claude Code نصب شده است، این موارد را بررسی کنید:

☑ سیستم‌عامل و سخت‌افزار با نیازمندی‌ها سازگار است
☑ روش مناسب نصب انتخاب شده است
☑ Claude Code نصب شده است
☑ دستور claude –version کار می‌کند
☑ در صورت نیاز claude doctor بررسی شده است
☑ PATH درست است
☑ چند نسخه متضاد از Claude Code نصب نیست
☑ احراز هویت انجام شده است
☑ دستور claude اجرا می‌شود

اگر تمام این موارد درست باشد، سیستم شما برای شروع کار آماده است.

سوالات متداول نصب Claude Code

قبل از پرسش، پاسخ آن را دریافت کنید:

جمع‌بندی

نصب Claude Code در نسخه‌های فعلی، نسبت به گذشته ساده‌تر شده است و برای بیشتر کاربران بهترین مسیر، استفاده از Native Installer است. در Windows می‌توانید از PowerShell، CMD یا WinGet استفاده کنید؛ در WSL و Linux نیز Native Installer یک مسیر مستقیم ارائه می‌دهد.

اما نصب موفق فقط اجرای Installer نیست. بعد از نصب باید نسخه را با claude --version بررسی کنید، در صورت نیاز claude doctor را اجرا کنید، PATH را در صورت بروز خطا بررسی کنید، روش احراز هویت مناسب را انتخاب کنید و مطمئن شوید چند نسخه متضاد Claude Code روی سیستم شما وجود ندارد.

برای کاربران Windows نیز انتخاب بین Native و WSL بهتر است بر اساس محل پروژه‌ها و ابزارهای مورد استفاده انجام شود: Windows Native برای پروژه‌های Windows-native و WSL 2 برای Workflowهای مبتنی بر Linux و سناریوهای خاص مانند sandboxing مناسب‌تر است.

بعد از اینکه نصب Claude Code با موفقیت انجام شد، مرحله بعدی یادگیری کار با خود ابزار است. در این مرحله می‌توانید سراغ آموزش اتصال Claude Code به ترمینال بروید و نحوه اجرای آن در محیط پروژه و کار با Terminal را یاد بگیرید.

• 
  ابزار ant چیست؟ کار با Claude API در ترمینال و تفاوتش با دستور claude
  توسط علی صفی زاده
  ابزار ant چیست و چه کاربردی دارد؟ اگر می‌خواهید بدون باز کردن محیط وب، از طریق ترمینال مستقیماً با Claude API کار کنید، درخواست‌های هوش مصنوعی را اجرا کنید یا منابعی مانند Agentها، فایل‌ها و Sessionها را مدیریت کنید، ابزار ant یکی از ابزارهای رسمی Anthropic است که باید بشناسید. این ابزار به شما اجازه
• 
  مدل‌های Claude؛ مقایسه Opus، Sonnet و Haiku؛ کدام مدل بهتر است؟
  توسط علی صفی زاده
  انتخاب بین مدل‌های Claude فقط به این معنی نیست که قوی‌ترین گزینه را پیدا کنیم و همیشه همان را انتخاب کنیم. هر مدل برای نوع خاصی از کار، سطحی از پیچیدگی، سرعت پاسخ‌گویی و بودجه طراحی شده است. به همین دلیل ممکن است مدلی که برای یک پروژه بهترین انتخاب است، برای یک کار دیگر
• 
  برندینگ برای استارتاپ‌ها؛ ۷ مزیت میکرو برندینگ که کسی به شما نمی گوید
  توسط علی صفی زاده
  در این مطلب قرار نیست دوباره فقط توضیح دهیم «میکرو برندینگ چیست». قرار است بدانیم برندینگ برای استارتاپ‌ها چگونه انجام می شود. تمرکز ما روی این است که چرا میکرو برندینگ برای یک استارتاپ می‌تواند مفید باشد، چگونه باید آن را اجرا کرد، چه اشتباهاتی باید کنار گذاشته شود و چطور بفهمیم برندسازی ما واقعاً