نصب Claude Code در ویندوز؛ راهنمای Native و WSL 2 با تنظیمات امن

اگر می‌خواهید Claude Code را در ویندوز نصب کنید، دیگر مجبور نیستید فقط به یک مسیر قدیمی یا راه‌حل غیررسمی تکیه کنید. مستندات فعلی Anthropic اجرای مستقیم روی Windows 10 نسخه 1809 به بعد و Windows Server 2019 به بعد را پشتیبانی می‌کند؛ در عین حال WSL 2 هنوز برای پروژه‌هایی که ابزارهای لینوکسی یا جداسازی بهتر می‌خواهند انتخاب مهمی است. تفاوت این دو مسیر فقط در دستور نصب نیست: محل فایل‌های پروژه، نوع Shell، شیوه دسترسی ابزار به فرمان‌ها و امکان Sandboxing نیز تغییر می‌کند.

در این راهنما ابتدا انتخاب بین Native Windows و WSL 2 را روشن می‌کنیم، سپس نصب رسمی، بررسی سلامت، ورود، شروع اولین پروژه و تنظیم مجوزهای محتاطانه را مرحله‌به‌مرحله پیش می‌بریم. هدف این نیست که دستیار کدنویسی را با بیشترین دسترسی ممکن اجرا کنیم؛ هدف آن است که از یک پوشه پروژه مشخص شروع کنیم، هر تغییر را در Git ببینیم و فقط همان فرمان‌هایی را اجازه دهیم که واقعاً برای کار لازم‌اند.

چرا نصب Claude Code در ویندوز به موضوعی روبه‌رشد تبدیل شده است؟

بررسی Google Trends برای ایران در تاریخ ۸ سپتامبر ۲۰۲۶ نشان داد Claude Code در مقایسه با Gemini CLI و GitHub Copilot سیگنال بسیار قوی‌تری دارد. میانگین علاقه در ۹۰ روز برای این سه عبارت به‌ترتیب ۴۶، ۱ و ۱ بود. در بازه ۱۲ماهه نیز Claude Code از سطح تک‌رقمی ابتدای دوره به محدوده‌های بالاتر در ماه‌های اخیر رسیده است. مهم‌تر اینکه عبارت claude code install windows در Related Queries بازه ۹۰روزه وضعیت Breakout داشت. پیشنهادهای Google Search نیز صورت‌های «نصب claude code در windows» و «ننصب claude code در windows download» را نمایش داد.

این داده‌ها حجم مطلق بازار یا تضمین محبوبیت دائمی نیستند، اما برای انتخاب زاویه مقاله کافی‌اند: کاربران فارسی‌زبان یک راهنمای به‌روز برای نصب ویندوزی می‌خواهند و بسیاری از آموزش‌های قدیمی هنوز Native Windows را پشتیبانی‌نشده معرفی می‌کنند. زاویه این مقاله، مقایسه مسیر رسمی Native با WSL 2 و شروع امن در یک مخزن واقعی است.

پیش‌نیازهای رسمی و تصمیم قبل از نصب

طبق مستندات رسمی، حداقل ۴ گیگابایت RAM، پردازنده x64 یا ARM64 و اتصال اینترنت برای احراز هویت و پردازش لازم است. Claude Code روی PowerShell، CMD، Bash و Zsh کار می‌کند. Git for Windows در نصب Native اجباری نیست، اما اگر می‌خواهید ابزار Bash در اختیار عامل باشد، نصب آن مفید است. برای استفاده از WSL بهتر است WSL 2 را انتخاب کنید، زیرا مستندات Anthropic پشتیبانی Sandboxing را برای WSL 2 ذکر می‌کند؛ اجرای Native و WSL 1 این قابلیت را ندارند.

یک قاعده ساده کمک می‌کند: اگر پروژه و ابزارهای شما روی Windows زندگی می‌کنند، Native کم‌اصطکاک‌تر است. اگر پروژه با Linux CI، Bash، Docker و پکیج‌های لینوکسی هماهنگ است، WSL 2 معمولاً تجربه منسجم‌تری می‌دهد. پروژه را بین دو فایل‌سیستم پراکنده نکنید؛ کار مداوم روی فایل‌های Windows از داخل WSL می‌تواند کندتر و گیج‌کننده‌تر باشد.

روش اول: نصب Native روی Windows با WinGet

WinGet مسیر قابل‌ردیابی و ساده‌ای برای نصب Native است. PowerShell یا Windows Terminal معمولی را باز کنید؛ مستندات تأکید می‌کند نصب Native به اجرای ترمینال با Administrator نیاز ندارد. قبل از اجرا مطمئن شوید Package ID دقیقاً متعلق به Anthropic است. بلوک زیر نصب، مشاهده نسخه و اجرای بررسی تشخیصی فقط‌خواندنی را نشان می‌دهد.

winget install Anthropic.ClaudeCodeclaude --versionclaude doctor

نصب‌های WinGet به‌طور پیش‌فرض با به‌روزرسانی خودکار داخلی Claude Code مدیریت نمی‌شوند. برای ارتقا باید دوره‌ای دستور winget upgrade Anthropic.ClaudeCode را اجرا کنید. اگر فرمان claude پس از نصب شناخته نشد، ترمینال را ببندید و دوباره باز کنید تا PATH تازه بارگذاری شود؛ سپس claude doctor را اجرا کنید و به‌جای حدس‌زدن، پیام تشخیصی آن را بخوانید.

نصب Native با اسکریپت رسمی

مستندات Anthropic برای PowerShell یک اسکریپت نصب رسمی نیز ارائه می‌کند. چون اجرای مستقیم محتوای دریافت‌شده از اینترنت یک تصمیم امنیتی است، ابتدا دامنه را با مستندات رسمی تطبیق دهید و فقط از claude.ai استفاده کنید. در محیط سازمانی ممکن است سیاست IT استفاده از WinGet یا بسته امضاشده داخلی را ترجیح دهد؛ همان سیاست بر دستور عمومی اولویت دارد.

نقش Git for Windows چیست؟

بدون Git for Windows، Claude Code در حالت Native فرمان‌های Shell را با ابزار PowerShell اجرا می‌کند. با نصب Git for Windows، ابزار Bash نیز در دسترس قرار می‌گیرد. اگر Git Bash در مسیر غیرمعمول یا نسخه Portable قرار دارد، مسیر آن را در تنظیمات پروژه یا کاربر مشخص کنید. هیچ مسیر نمونه‌ای را بدون بررسی محل واقعی bash.exe کپی نکنید.

روش دوم: نصب Claude Code داخل WSL 2

در این روش ابتدا یک توزیع Linux آماده دارید و نصب را داخل همان ترمینال انجام می‌دهید، نه در PowerShell یا CMD. پروژه‌های لینوکسی را در پوشه Home توزیع نگه دارید. سپس نصب‌کننده رسمی Linux را اجرا کنید، نسخه را بررسی کنید و از همان محیط وارد پوشه پروژه شوید. از اجرای نصب با sudo صرفاً برای رفع خطای مجوز خودداری کنید؛ بالا بردن دسترسی، علت تنظیم نادرست مسیر یا مالکیت را پنهان می‌کند.

curl -fsSL https://claude.ai/install.sh | bashclaude --versionclaude doctorcd ~/projects/sample-appclaude

پس از نصب، دستور claude یک نشست تعاملی را باز و فرایند ورود را آغاز می‌کند. برای استفاده معمولی به حساب Pro، Max، Team، Enterprise یا Console نیاز دارید و برنامه رایگان Claude.ai شامل Claude Code نیست. این نکته را پیش از عیب‌یابی بی‌پایان خطای ورود بررسی کنید. در تیم سازمانی نیز ممکن است دسترسی از طریق Amazon Bedrock، Google Cloud یا Microsoft Foundry تنظیم شده باشد.

اولین اجرای امن در یک پروژه واقعی

Claude Code را از ریشه یک مخزن مشخص اجرا کنید، نه از Home یا ریشه درایو. پیش از شروع، وضعیت Git را بررسی و تغییرات موجود را Commit یا دست‌کم ثبت کنید تا بتوانید خروجی عامل را از کار قبلی خود جدا ببینید. نخستین درخواست بهتر است خواندنی باشد: «ساختار پروژه را توضیح بده و هیچ فایلی را تغییر نده». سپس از آن بخواهید برنامه تغییر را ارائه کند و فقط بعد از بازبینی، ویرایش محدود را مجاز کنید.

مجوزها را چگونه مدیریت کنیم؟

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

• کار را از یک مخزن Git تمیز شروع کنید.
• فایل‌های حاوی Secret را در دسترس غیرضروری قرار ندهید.
• خروجی git diff را پس از هر مرحله بررسی کنید.
• فرمان‌های حذف، مهاجرت داده و انتشار را خودکار تأیید نکنید.
• برای کد ناشناس یا مخزن غیرقابل اعتماد از WSL 2 و محیط ایزوله‌تر استفاده کنید.
• گزینه --dangerously-skip-permissions را برای کار روزمره به کار نبرید.

مراقبت از Prompt Injection در مخزن

README، Issue، فایل داده و خروجی ابزارها می‌توانند حاوی متن مخرب باشند. وجود یک دستور در فایل پروژه به معنی اجازه شما نیست. اگر عامل پیشنهادی برای ارسال داده، اجرای فایل دانلودشده یا دورزدن مجوزها مطرح کرد، آن را متوقف و منبع دستور را بررسی کنید. Secretها را در فایل نمونه، لاگ یا Prompt قرار ندهید و دسترسی ابزار را به کمترین محدوده موردنیاز محدود کنید.

عیب‌یابی خطاهای رایج نصب

فرمان claude پیدا نمی‌شود

ابتدا ترمینال تازه‌ای باز کنید و claude --version را بزنید. اگر WinGet نصب را موفق گزارش کرده اما فرمان شناخته نمی‌شود، وضعیت PATH و محل بسته را بررسی کنید. در WSL مطمئن شوید نصب را داخل همان توزیع انجام داده‌اید و تصادفاً نسخه Windows برنامه را از مسیر مشترک فراخوانی نمی‌کنید. خروجی claude doctor برای تشخیص نوع نصب و خطای تنظیمات طراحی شده است.

ابزار Bash در Native Windows در دسترس نیست

این وضعیت بدون Git for Windows طبیعی است و Claude Code می‌تواند از PowerShell استفاده کند. اگر پروژه شما واقعاً به Bash نیاز دارد، Git for Windows را از منبع رسمی نصب یا مسیر Git Bash موجود را در تنظیمات معرفی کنید. برای یک پروژه کاملاً لینوکسی، انتقال کار به WSL 2 ممکن است تمیزتر از ترکیب چند Shell باشد.

ورود یا اتصال شبکه شکست می‌خورد

اتصال اینترنت برای احراز هویت و پردازش لازم است. وضعیت سرویس، محدودیت کشور پشتیبانی‌شده، Proxy سازمانی و نوع حساب را بررسی کنید. کلید API، Token یا Cookie را در پیام خطا، Issue عمومی یا گفتگو با عامل کپی نکنید. اگر شبکه سازمانی فقط دامنه‌های مجاز را باز می‌کند، از تیم IT بخواهید فهرست رسمی نیازهای شبکه Anthropic را ارزیابی کند.

Native یا WSL 2؛ انتخاب نهایی

برای توسعه‌دهنده C# یا PowerShell که Solution روی NTFS دارد و با ابزارهای Windows کار می‌کند، Native معمولاً انتخاب مستقیم‌تری است. برای پروژه Node، Python، Go یا زیرساختی که CI آن Linux است و از Docker و Bash استفاده می‌کند، WSL 2 هماهنگی محیطی بیشتری فراهم می‌کند. اگر امنیت اجرای فرمان ناشناس نگرانی اصلی است، پشتیبانی Sandboxing در WSL 2 مزیت مهمی است، اما جای بازبینی تغییرات و اصل حداقل دسترسی را نمی‌گیرد.

برای شروع، یک پروژه کم‌ریسک انتخاب کنید و از عامل بخواهید فقط تست‌ها و ساختار را تحلیل کند. سپس یک تغییر کوچک با معیار پذیرش روشن تعریف کنید. همان الگوی مهاجرت مرحله‌ای که در راهنمای مهاجرت امن Passkey در ASP.NET Core مطرح شده، اینجا هم مفید است: محدوده کوچک، خروجی قابل‌آزمایش و امکان بازگشت.

جمع‌بندی

نصب Claude Code در ویندوز اکنون دو مسیر رسمی و کاربردی دارد. Native Windows برای پروژه‌ها و ابزارهای بومی ساده‌تر است؛ WSL 2 برای زنجیره ابزار Linux و نیاز به Sandboxing مناسب‌تر خواهد بود. در هر دو روش، نسخه را با claude --version و سلامت نصب را با claude doctor بررسی کنید، برنامه را از ریشه مخزن مشخص اجرا کنید و مجوزها را محدود نگه دارید.

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