پیش‌نویس — این مقاله هنوز منتشر نشده و فقط برای پیش‌نمایشه.

معمولی

نصب Claude Code از ترمینال و وصلش به بنفش

چطور خود ابزار Claude Code رو رو سیستمت نصب کنی و از ترمینال به بنفش وصلش کنی — جدا از افزونهٔ VS Code.

اگه می‌خوای Claude Code رو از ترمینال اجرا کنی (نه از پنل افزونهٔ VS Code)، این مقاله برای توئه. فرض می‌کنیم یه کلید طرح داری. تا آخرش Claude Code رو رو سیستمت نصب می‌کنی و با کلیدت بهش وصل می‌شی.

اگه به‌جاش دنبال افزونهٔ VS Code می‌گردی، اون یه مسیر جداست: مقالهٔ «وصل کردن VS Code به بنفش» رو ببین.

۱. نصبش کن

یکی از این دو راه رو برو — هر دو همون ابزار رو نصب می‌کنن:

  • با npm (از ایران هم کار می‌کنه؛ اگه از قبل Node.js داری):

    css
    npm install -g @anthropic-ai/claude-code
    
  • اسکریپت رسمی نصب (مک، لینوکس، یا WSL رو ویندوز) — از ایران کار نمی‌کنه:

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

اگه با --omit=optional نصب بشه باینری نمیاد؛ دوباره نصب کن. به‌روزرسانی هم از راه npm i -g @anthropic-ai/claude-code@latest.

رو ویندوز، باید از WSL اجرا بشه — نسخهٔ بومی ویندوز (بدون WSL) پشتیبانی نمی‌شه.

بعد از نصب، claude --version رو بزن تا مطمئن بشی درست نشسته.

اگه گفت claude پیدا نشد (command not found)، یعنی پوشهٔ نصبش هنوز تو PATH نیست. اسکریپت نصب آخر کارش یه خط پیشنهادی برای همین نشون می‌ده؛ همون خط رو اجرا کن، ترمینال رو یه بار ببند و دوباره باز کن و بعد دوباره claude --version رو بزن.

۲. وصلش کن به بنفش

Claude Code با چند متغیر محیطی به سرویس بنفش وصل می‌شه، نه با لاگین حساب رسمی ابزار. این متغیرها رو هیچ‌وقت این‌جا تایپ نمی‌کنیم — با کلید و طرحت فرق می‌کنن و همیشه به‌روز نیستن؛ از کارت خودشون کپی کن:

  1. تو «کلیدهای API» کارت Claude Code رو باز کن (همون بلاک ترمینالی، نه سوییچ VS Code).
  2. کل بلاک رو کپی کن و تو ترمینالت پیست کن و اجرا کن — چندتا خط export پشت هم‌ان؛ خط آخرِ بلاک رو هم بزن.
  3. همون پنجرهٔ ترمینال رو نگه دار (یا این خطوط رو تو .bashrc/.zshrc یا پروفایل شلت ذخیره کن تا هر بار نخوای دوباره پیست کنی).

۳. تستش کن

تو همون ترمینال بزن:

کد
claude

بار اول چندتا صفحهٔ خوشامد می‌بینی: انتخاب رنگ‌بندی (هر کدوم خوشت اومد)، چند نکتهٔ امنیتی (اینتر بزن)، و یه سؤال که «به این پوشه اعتماد داری؟». اگه پوشهٔ خودته، گزینهٔ Yes, I trust this folder رو انتخاب کن (جای گزینه‌ها تو نسخه‌های مختلف فرق می‌کنه؛ «No, exit» برنامه رو می‌بنده).

بعد یه پیام بفرست. اگه جواب اومد، وصلی. اگه می‌خوای مطمئن بشی داری از بنفش استفاده می‌کنی نه از حساب شخصیت، دستور /status رو بزن — باید یه خط «Anthropic base URL» با آدرس سرویسی که از کارت کپی کردی ببینی.

اگه درخواست ورود با حساب (login) اومد یا پایین صفحه نوشت «Not logged in»

یعنی متغیرهای محیطی تو همون شل فعلی نیستن — مرحلهٔ ۲ رو تو همین پنجرهٔ ترمینال دوباره اجرا کن (یه ترمینال جدید باز کردن یعنی دوباره باید exportهاشون کنی، مگه این‌که تو پروفایل شلت ذخیره کرده باشی).

چی چک شده و چی نه

خود دستورهای نصب (curl/npm) طبق مستندات رسمی Anthropic‌ان، نه چیزی که بنفش جداگانه تأیید کرده باشه. بخش وصل‌شدن به بنفش (همون متغیرهای محیطی) با یه کلید واقعی، تو ترمینال، تست شده (روی یه لینوکس تازه، با Claude Code 2.1.318) — همون چیزی که کارت Claude Code تو «کلیدهای API» نشونش می‌ده.