Claude Code سری آموزش‌های ۵: چگونه Claude Code را نصب کنیم؟

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

نصب Claude Code بدون رابط کاربری گرافیکی و «مرحله بعد» انجام می‌شود و همه چیز در خط فرمان انجام می‌شود. اگر با npm کار می‌کنید، کل فرآیند بیش از دو دقیقه طول نمی‌کشد.

پیش‌نیازها

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

• Node.js 18 یا بالاتر
  روش بررسی: در ترمینال node -v را اجرا کنید. اگر نسخه کمتر از ۱۸ است، با استفاده از nvm، fnm یا مستقیماً از nodejs.org ارتقا دهید.
• یک حساب Anthropic
  آدرس ثبت نام: https://console.anthropic.com. حساب کاربری کلید API را فراهم می‌کند که پس از نصب به آن نیاز دارید. ثبت نام رایگان است و هزینه بر اساس مصرف محاسبه می‌شود.
• دسترسی به API Anthropic از طریق شبکه
  دامنه پیش‌فرض api.anthropic.com است. اگر محیط نیاز به تنظیم پروکسی دارد، حتماً HTTP_PROXY یا HTTPS_PROXY را در ترمینال تنظیم کنید.

روش نصب اول: نصب جهانی با npm

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

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

پس از اتمام، claude --version را اجرا کنید. اگر یک شماره نسخه نمایش داده شد، نصب موفق است. پس از نصب جهانی، دستور claude در هر دایرکتوری قابل فراخوانی است.

اگر با خطای مجوز مواجه شدید (معمولاً در دایرکتوری /usr/local/lib در macOS)، دو راه حل وجود دارد:

1. استفاده از sudo برای نصب (آسان اما از نظر امنیتی بحث‌برانگیز).
2. تنظیم npm برای استفاده از دایرکتوری کاربر برای جلوگیری از sudo:
   bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
   سپس ~/.npm-global/bin را به PATH اضافه کنید و ترمینال را دوباره باز کنید.

روش نصب دوم: استفاده موقت با npx

اگر نمی‌خواهید چیزی را جهانی نصب کنید یا فقط می‌خواهید به صورت موقت امتحان کنید، استفاده از npx مستقیم‌تر است.

npx @anthropic-ai/claude-code

npx به صورت موقت آخرین بسته را دانلود می‌کند و پس از اجرا، هیچ دستور جهانی باقی نمی‌گذارد. هر بار که استفاده می‌کنید، به‌روزرسانی‌ها را بررسی می‌کند، بنابراین همیشه آخرین نسخه استفاده می‌شود. نکته منفی این است که کمی کندتر است (هر بار باید دانلود کند) و برای استفاده مکرر در اسکریپت‌های خودکار مناسب نیست.

مناسب برای: اولین تجربه کاربری، استفاده موقت روی دستگاه دیگران یا استفاده گاه به گاه.

بررسی راه‌اندازی صحیح

پس از نصب، ابتدا عجله نکنید. یک دستور ساده اجرا کنید تا ببینید ابزار کار می‌کند:

claude --help

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

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

مشکلات رایج

• نسخه پایین Node
  اگر نسخه کمتر از ۱۸ باشد، خطا مستقیماً نمایش داده می‌شود، نه اخطار. ارتقای Node ساده‌ترین راه حل است.
• وقفه شبکه
  چه برای دانلود بسته npm و چه برای اتصال به API، ممکن است به دلیل پروکسی یا فایروال مسدود شود. ابتدا مطمئن شوید curl https://api.anthropic.com کار می‌کند، سپس مراحل بعدی را انجام دهید.
• استفاده مستقیم از cmd پیش‌فرض در ویندوز
  اگرچه از نظر تئوری ممکن است، اما توصیه می‌شود از Git Bash، WSL2 یا Windows Terminal استفاده کنید تا از مشکلات عجیب تبدیل مسیر جلوگیری شود.