خلاصه سریع: نصب Claude Code بر روی ویندوز نیازمند راهاندازی WSL2 (زیرسیستم ویندوز برای لینوکس)، نصب اوبونتو و اجرای یک اسکریپت نصب ساده است. این فرآیند به کاربران ویندوز اجازه میدهد تا از طریق ترمینال خود به دستیار کدنویسی هوش مصنوعی Anthropic دسترسی پیدا کنند. باینریهای بومی ویندوز در دسترس هستند، با این حال WSL2 هنوز بهترین روش برای نصب در ویندوز است.
Claude Code یک دستیار کدنویسی مبتنی بر هوش مصنوعی است که مستقیماً در ترمینال عمل میکند و به توسعهدهندگان در ساخت ویژگیها، رفع اشکالات و خودکارسازی وظایف توسعه کمک میکند. اما برای کاربران ویندوز یک نکته وجود دارد.
Claude Code به عنوان یک فایل اجرایی بومی ویندوز موجود است و بدون WSL2 میتوان آن را از طریق npm یا دانلود مستقیم باینری نصب کرد. با این حال، این برنامه به زیرسیستم ویندوز برای لینوکس (WSL2) نیاز دارد و روش نصب رسمی همچنان به WSL2 متکی است.
در اینجا نحوه راهاندازی آن در ویندوز 11 یا ویندوز 10 آمده است.
پیشنیازهای سیستم
قبل از شروع نصب، بررسی کنید که دستگاه ویندوز شما این پیشنیازها را دارد:
- ویندوز 10 1809+ یا ویندوز سرور 2019+
- ویندوز 11 (هر نسخهای)
- حداقل 4 گیگابایت رم در دسترس
- امتیازات مدیریتی در سیستم
- اتصال اینترنت برای دانلود WSL2 و اوبونتو
نصب به فضای دیسک برای WSL2، اوبونتو و Claude Code نیاز دارد.
مرحله 1: فعال کردن زیرسیستم ویندوز برای لینوکس
WSL2 یک محیط لینوکس را مستقیماً در ویندوز فراهم میکند. این اساس و پایه و اساس عملکرد Claude Code است.
PowerShell را به صورت Administrator باز کنید. روی دکمه Start کلیک راست کرده و در ویندوز 11 گزینه "Windows PowerShell (Admin)" یا "Terminal (Admin)" را انتخاب کنید.
این دستور را اجرا کنید:
wsl –install
این دستور ویژگیهای لازم ویندوز را فعال کرده و اوبونتو را به عنوان توزیع پیشفرض لینوکس نصب میکند. سیستم احتمالاً درخواست ریستارت خواهد داد.
پس از راهاندازی مجدد، WSL2 تنظیمات را به طور خودکار تکمیل میکند. اوبونتو اجرا شده و از شما نام کاربری و رمز عبور میخواهد. این اطلاعات فقط برای محیط لینوکس است — نیازی نیست که با اطلاعات ویندوز شما مطابقت داشته باشند.
مرحله 2: تأیید نصب WSL2
پس از ریستارت سیستم و اتمام تنظیمات اولیه اوبونتو، بررسی کنید که WSL2 به درستی کار میکند.
ترمینال اوبونتو را باز کنید (در منوی Start "Ubuntu" را جستجو کنید) و اجرا کنید:
wsl –version
این دستور اطلاعات نسخه WSL را نمایش میدهد. به دنبال "WSL version: 2.x.x" در خروجی باشید.
اگر دستور WSL1 را نشان داد، با این دستور به WSL2 ارتقا دهید:
wsl –set-default-version 2
مرحله 3: نصب Claude Code
حالا به نصب واقعی Claude Code میرسیم. مستندات رسمی یک اسکریپت نصب یک خطی را ارائه میدهند.
در ترمینال اوبونتو، اجرا کنید:
curl -fsSL claude.ai/install.sh | bash
اسکریپت باینری Claude Code را دانلود کرده، مجوزهای لازم را تنظیم میکند و آن را به PATH سیستم اضافه میکند. مدت زمان نصب بسته به سرعت اینترنت و مشخصات سیستم متفاوت است.
طبق مستندات رسمی Claude Code، نصبکننده به طور خودکار معماری سیستم را تشخیص داده و نسخه باینری مناسب را دانلود میکند.
مشکلات رایج نصب
برخی از کاربران ویندوز گزارش میدهند که پس از نصب با خطای "command not found: claude" مواجه میشوند. این معمولاً به این دلیل اتفاق میافتد که متغیر PATH بهروزرسانی نشده است.
ترمینال اوبونتو را ببندید و دوباره باز کنید، سپس دوباره امتحان کنید. اگر مشکل ادامه داشت، این پیکربندی PATH ممکن است به عنوان یک راهحل غیررسمی کمک کند:
echo ‘export PATH=”$HOME/.claude/bin:$PATH”‘ >> ~/.bashrc
source ~/.bashrc
مرحله 4: احراز هویت Claude Code
Claude Code قبل از استفاده نیاز به احراز هویت با حساب Anthropic دارد.
این دستور را اجرا کنید:
claude
ترمینال یک URL را نمایش داده و درخواست احراز هویت میکند. این فرآیند برای کاربران فردی در مقایسه با حسابهای تیمی کمی متفاوت است:
| نوع حساب | روش احراز هویت | مورد نیاز |
|---|---|---|
| فردی | کلید API شخصی | حساب Anthropic با دسترسی API |
| تیمی/سازمانی | توکن سازمان | توکن احراز هویت ارائه شده توسط مدیر |
URL ارائه شده را در مرورگر باز کنید، وارد حساب Anthropic خود شوید و Claude Code را مجاز کنید. ترمینال احراز هویت موفقیتآمیز را تأیید میکند.
کار با پروژههای ویندوز در WSL2
اینجاست که کار کمی پیچیده میشود. سیستم فایلهای ویندوز و سیستم فایلهای WSL2 از هم جدا هستند.
فایلهای ویندوز از WSL2 در /mnt/c/ (برای درایو C:)، /mnt/d/ (برای درایو D:) و غیره قابل دسترسی هستند. اما این کار هزینه عملکردی دارد. بحثهای جامعه نشان میدهند که تفاوتهای عملکردی بین دایرکتوریهای نصب شده در ویندوز و دایرکتوریهای بومی WSL2 وجود دارد.
برای بهترین عملکرد، فایلهای پروژه را در دایرکتوری خانگی WSL2 کپی کنید:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
معاوضه؟ ادغام IDE پیچیدهتر میشود. Visual Studio Code با افزونه Remote-WSL خود این کار را به خوبی انجام میدهد، اما IDEهای دیگر ممکن است دچار مشکل شوند.
تست نصب
عملکرد صحیح Claude Code را با یک تست ساده تأیید کنید.
به دایرکتوری پروژه خود بروید (یا یک پوشه تست ایجاد کنید):
mkdir ~/claude-test
cd ~/claude-test
claude “یک اسکریپت ساده پایتون hello world ایجاد کن”
Claude Code باید پاسخ دهد، فایل را ایجاد کند و کد را نمایش دهد. این تأیید میکند که نصب موفقیتآمیز بوده است.
بیش از حد پرداخت نکنید، اول اعتبارات هوش مصنوعی موجود را ادعا کنید
نصب Claude Code بر روی ویندوز معمولاً سریع است. هزینه واقعی بعداً ظاهر میشود، زمانی که توسعهدهندگان شروع به آزمایش با پرامپتها، اجرای اسکریپتها و ادغام مدل در برنامهها میکنند. آن مرحله آزمایش میتواند تعداد زیادی فراخوانی API ایجاد کند و بسیاری از تیمها تنها پس از شروع ساخت متوجه هزینه میشوند.
قبل از صرف هزینه برای استفاده، ارزش دارد بررسی کنید که آیا واجد شرایط اعتبارات هوش مصنوعی یا برنامههای همکاری هستید. Get AI Perks این فرصتها را در یک مکان جمعآوری میکند و لیست اعتبارات و تخفیفها را از ارائهدهندگان هوش مصنوعی، پلتفرمهای ابری و ابزارهای توسعهدهنده، به همراه دستورالعملهای ساده برای نحوه ادعای آنها ارائه میدهد.
قبل از اجرای اولین پروژه Claude Code خود، Get AI Perks را بررسی کنید و اعتبارات هوش مصنوعی را که میتوانند هزینههای توسعه شما را پوشش دهند، ادعا کنید.
سوالات متداول
آیا Claude Code میتواند به صورت بومی در ویندوز بدون WSL2 اجرا شود؟
بله، اما WSL2 همچنان بهترین روش نصب برای ویندوز باقی میماند.
آیا Claude Code با Windows Terminal کار میکند؟
بله. Windows Terminal میتواند تبهای اوبونتو را باز کند و به Claude Code بدون نیاز به جابجایی به یک پنجره اوبونتوی جداگانه دسترسی دهد. در Windows Terminal، روی فلش رو به پایین کلیک کرده و Ubuntu را از لیست پروفایلها انتخاب کنید.
آیا ابزارهای توسعه ویندوز فعلی من با Claude Code کار خواهند کرد؟
بستگی به ابزار دارد. Visual Studio Code از طریق افزونه Remote-WSL به خوبی ادغام میشود. IDEهای JetBrains و سایر ابزارها ممکن است نیاز به پیکربندی اضافی داشته باشند. مستندات رسمی VS Code و JetBrains را به عنوان پلتفرمهای پشتیبانی شده ذکر کرده است.
چگونه Claude Code را در ویندوز بهروزرسانی کنم؟
Claude Code به طور پیشفرض به صورت خودکار بهروزرسانی میشود. برای بهروزرسانی دستی، دستور claude update را در ترمینال اوبونتو اجرا کنید. قابلیت بهروزرسانی خودکار در صورت نیاز برای محیطهای سازمانی از طریق فایلهای پیکربندی قابل غیرفعال شدن است.
تفاوت بین Claude Code و Claude API چیست؟
Claude Code یک دستیار کدنویسی مبتنی بر ترمینال است که دستورات را اجرا کرده و فایلها را ویرایش میکند. Claude API دسترسی برنامهنویسی به مدل زبان Claude را برای ساخت برنامههای سفارشی فراهم میکند. آنها اهداف متفاوتی دارند و نیاز به فرآیندهای تنظیمات متفاوتی دارند.
آیا میتوانم از Claude Code با پروژههای .NET در ویندوز استفاده کنم؟
بله، اما با ملاحظاتی. بحثهای جامعه نشان میدهند که پشتیبانی از .NET SDK در WSL2 کار میکند، اما نیاز به نصب نسخه لینوکس .NET SDK در اوبونتو دارد. .NET نصب شده در ویندوز از WSL2 قابل دسترسی نخواهد بود.
هزینه Claude Code چقدر است؟
قیمتگذاری بسته به استفاده و نوع حساب متفاوت است. وبسایت رسمی Anthropic را برای سطوح قیمتگذاری فعلی و طرحهای تیمی بررسی کنید، زیرا هزینهها بر اساس مصرف API و الزامات سازمانی متغیر است.
مراحل بعدی پس از نصب
با نصب Claude Code، شروع به کاوش قابلیتهای آن کنید. مستندات شروع سریع توصیه میکنند که قبل از رفتن به سراغ عملیات پیچیدهتر، با وظایف ساده مانند توضیحات کد شروع کنید.
این دستورات را برای آشنایی امتحان کنید:
- claude “این تابع را توضیح بده” – توضیحات کد دریافت کنید
- claude commit – پیامهای commit گیت را ایجاد کنید
- claude -c – آخرین مکالمه را ادامه دهید
مستندات رسمی راهنماهای مفصلی برای ادغام IDE، نصب افزونه و گزینههای پیکربندی پیشرفته ارائه میدهد. برای تیمها، تنظیمات مدیریت شده توسط سرور و ردیابی تجزیه و تحلیل، کنترل بیشتری بر استقرار Claude Code ارائه میدهند.
راهاندازی WSL2 ممکن است در مقایسه با برنامههای بومی ویندوز اضافی به نظر برسد، اما در حال حاضر تنها راه برای اجرای Claude Code در ویندوز است. خبر خوب؟ پس از پیکربندی، به نرمی اجرا شده و با بیشتر گردش کارهای توسعه ادغام میشود.
