نصب Claude Code روی ویندوز؛ قدم به قدم

خلاصهٔ یک‌خطی

Claude Code را با npm install -g @anthropic-ai/claude-code نصب می‌کنید، با دستور claude وارد می‌شوید، و از ایران فقط پشت یک VPN با خروجی ثابت غیرایرانی این کار را انجام می‌دهید. همین. بقیهٔ این مطلب جزئیات همین سه جمله است.

قبل از شروع چه چیزهایی لازم است؟

• یک اشتراک Claude Pro یا Max. Claude Code همراه این اشتراک‌ها عرضه می‌شود و جدا خریده نمی‌شود. اگر هنوز ندارید، از صفحهٔ خدمات ما تهیه کنید.
• Node.js نسخهٔ ۱۸ یا بالاتر. Claude Code یک پکیج npm است و بدون Node اجرا نمی‌شود.
• PowerShell یا WSL. روی ویندوز هر دو مسیر جواب می‌دهد. اگر با لینوکس راحت‌ترید، WSL تجربهٔ روان‌تری می‌دهد؛ اگر نه، PowerShell کافی است.
• یک VPN با خروجی ثابت غیرایرانی. این مورد اختیاری نیست. پایین‌تر مفصل توضیح داده‌ایم.

قدم اول: نصب Node.js

به سایت رسمی nodejs.org بروید و نسخهٔ LTS را دانلود و نصب کنید. بعد از نصب، PowerShell را ببندید و دوباره باز کنید تا مسیرها به‌روز شوند. با این دو دستور مطمئن شوید همه‌چیز سر جایش است:

node -v
npm -v

اگر عدد نسخهٔ Node کمتر از ۱۸ بود، باید Node را به‌روز کنید. نسخهٔ قدیمی Node رایج‌ترین دلیل خطاهای عجیب هنگام نصب است.

اگر از WSL استفاده می‌کنید، Node را داخل همان توزیع لینوکس نصب کنید (مثلاً با nvm)، نه روی ویندوز. Claude Code همان محیطی را می‌بیند که از داخلش اجرا می‌شود.

قدم دوم: روشن کردن VPN (قبل از هر چیز دیگر)

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

• خروجی VPN باید ثابت باشد؛ یعنی هر بار از یک کشور مشخص بیرون بیایید، نه هر روز از یک جای دنیا.
• هرگز با IP ایران وارد حساب Claude نشوید، حتی برای یک لحظه. یک ورود اشتباه می‌تواند به قفل شدن حساب ختم شود و برگرداندنش آسان نیست.
• اگر VPN شما «split tunneling» دارد، مطمئن شوید ترافیک PowerShell یا WSL هم از VPN رد می‌شود، نه فقط مرورگر.

قدم سوم: نصب Claude Code

در PowerShell (یا ترمینال WSL) این دستور را اجرا کنید:

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

نصب سراسری (-g) است تا دستور claude از هر پوشه‌ای در دسترس باشد. اگر خطای دسترسی گرفتید، PowerShell را با «Run as administrator» باز کنید. در WSL معمولاً به sudo نیاز نیست اگر Node را با nvm نصب کرده باشید.

بعد از نصب، یک بار ترمینال را ببندید و باز کنید و بررسی کنید دستور شناخته می‌شود:

claude --version

قدم چهارم: ورود به حساب

به پوشهٔ پروژه‌تان بروید و فقط بنویسید:

claude

اولین بار، Claude Code یک لینک ورود می‌سازد و مرورگر را باز می‌کند. با همان حسابی وارد شوید که اشتراک Pro یا Max روی آن فعال است. بعد از تأیید، به ترمینال برمی‌گردید و آماده‌اید.

چند نکته دربارهٔ این مرحله:

• مرورگر هم باید پشت همان VPN باشد. اگر مرورگر با IP ایران باز شود، همان اتفاقی می‌افتد که گفتیم نباید بیفتد.
• اگر مرورگر خودکار باز نشد، لینکی که در ترمینال چاپ شده را دستی کپی کنید.
• ورود یک‌بار انجام می‌شود و روی همان دستگاه ذخیره می‌ماند. لازم نیست هر بار تکرارش کنید، ولی VPN باید هر بار روشن باشد.

اولین استفاده

داخل پوشهٔ یک پروژه که هستید، claude را اجرا کنید و به زبان خودتان بگویید چه می‌خواهید. مثلاً: «این پروژه چه کار می‌کند؟» یا «یک تست برای تابع login بنویس». Claude Code فایل‌های پروژه را می‌خواند، تغییر پیشنهاد می‌دهد و قبل از اعمال هر تغییر از شما تأیید می‌گیرد.

چند عادت مفید از همان روز اول:

1. پروژه را داخل git نگه دارید تا هر تغییری قابل برگشت باشد.
2. درخواست‌های کوچک و مشخص بدهید؛ نتیجه بهتر است.
3. برای خروج، /exit بزنید یا Ctrl+C.

خطاهای رایج و راه‌حل

• `claude` شناخته نمی‌شود: ترمینال را ببندید و باز کنید. اگر باز هم نشد، مسیر پوشهٔ سراسری npm به PATH ویندوز اضافه نشده؛ خروجی npm config get prefix را به PATH اضافه کنید.
• نصب با خطای EACCES یا EPERM متوقف می‌شود: PowerShell را با دسترسی مدیر باز کنید یا در WSL از nvm استفاده کنید.
• ورود انجام نمی‌شود یا صفحهٔ خطا می‌بینید: اول بررسی کنید IP فعلی‌تان غیرایرانی است. اکثر مشکلات ورود از همین‌جاست.
• بعد از ورود، درخواست‌ها جواب نمی‌گیرند: VPN احتمالاً قطع شده یا فقط مرورگر را پوشش می‌دهد. اتصال ترمینال را هم بررسی کنید.

اگر اشتراک ندارید

Claude Code بدون اشتراک Pro یا Max کار نمی‌کند. برای تهیهٔ اشتراک از ایران، همراه با راهنمای تنظیم VPN مناسب، به صفحهٔ خدمات IRClaude سر بزنید یا با پشتیبانی صحبت کنید.