نحوه نصب Claude Code CLI در سال ۲۰۲۶: راهنمای کامل راه‌اندازی

AI Perks

AI Perks دسترسی به تخفیف‌ها، اعتبارات و پیشنهادات ویژه ابزارهای هوش مصنوعی، خدمات ابری و API‌ها را فراهم می‌کند تا به استارتاپ‌ها و توسعه‌دهندگان در صرفه‌جویی کمک کند.

همه AI Perks را ببینید

نحوه نصب Claude Code CLI در سال ۲۰۲۶

برای نصب Claude Code، دستور npm install -g @anthropic-ai/claude-code@latest را در ترمینال خود اجرا کنید. نصب حدود ۳۰ ثانیه طول می‌کشد. با دستور claude --version تأیید کنید، سپس با دستور claude auth login احراز هویت کنید تا استفاده از آن را شروع کنید.

Claude Code به Node.js نسخه ۱۸ یا بالاتر نیاز دارد. پس از نصب، با همان دستورات بر روی macOS، لینوکس و ویندوز اجرا می‌شود. و در حالی که در حال راه‌اندازی آن هستید، AI Perks می‌تواند اعتبارات رایگان Anthropic به ارزش ۱۰۰۰ تا ۲۵۰۰۰ دلار یا بیشتر را برای شما فراهم کند تا Claude Code را بدون هزینه اجرا کنید.

بودجه خود را در اعتبارات AI صرفه‌جویی کنید

جستجوی پیشنهادات برای

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

همهرایگانمشارکت‌ها

جستجوی پیشنهادات برای

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

همهرایگانمشارکت‌ها

Software	اعتبارات تقریبی	شرایط	شاخص تأیید	اقدامات

SaaS خود را تبلیغ کنید

به بیش از ۹۰٬۰۰۰ بنیان‌گذار جهانی که به دنبال ابزاری مانند ابزار شما هستند برسید

اکنون درخواست دهید

الزامات سیستم

نسخه Node.js خود را بررسی کنید:

node --version

اگر کمتر از ۱۸ است، آخرین LTS را از nodejs.org نصب کنید یا از nvm استفاده کنید.

AI Perks

AI Perks دسترسی به تخفیف‌ها، اعتبارات و پیشنهادات ویژه ابزارهای هوش مصنوعی، خدمات ابری و API‌ها را فراهم می‌کند تا به استارتاپ‌ها و توسعه‌دهندگان در صرفه‌جویی کمک کند.

همه AI Perks را ببینید

نصب Claude Code بر روی macOS

مرحله ۱: نصب Node.js (در صورت عدم نصب)

با استفاده از Homebrew:

brew install node

یا از nodejs.org دانلود کنید.

مرحله ۲: نصب Claude Code

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

مرحله ۳: تأیید نصب

claude --version

باید شماره نسخه نمایش داده شده را مشاهده کنید (به عنوان مثال، 1.x.x).

مرحله ۴: احراز هویت

claude auth login

این دستور مرورگر را برای ورود از طریق حساب Anthropic شما باز می‌کند.

نصب Claude Code بر روی لینوکس

مرحله ۱: نصب Node.js (اوبونتو/دبیان)

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

برای توزیع‌های دیگر (Fedora، Arch و غیره)، از مدیر بسته خود استفاده کنید.

مرحله ۲: نصب Claude Code

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

اگر خطاهای مجوز دریافت کردید، از sudo با npm استفاده نکنید. در عوض، پیشوند npm را اصلاح کنید:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

سپس دوباره نصب کنید.

مرحله ۳: تأیید و احراز هویت

claude --version
claude auth login

نصب Claude Code بر روی ویندوز

مرحله ۱: نصب Node.js

نصب کننده ویندوز را از nodejs.org دانلود کرده و اجرا کنید. مطمئن شوید که در طول نصب گزینه "Add to PATH" انتخاب شده باشد.

مرحله ۲: باز کردن PowerShell یا Terminal

PowerShell (یا Windows Terminal) را به عنوان Administrator باز کنید.

مرحله ۳: نصب Claude Code

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

مرحله ۴: تأیید نصب

claude --version

اگر claude شناخته نشد، ترمینال خود را مجدداً راه‌اندازی کنید یا بررسی کنید که پوشه باینری سراسری npm در PATH شما وجود دارد:

npm config get prefix

مسیر حاصل (با اضافه کردن \ در انتها) را به متغیر PATH سیستم خود اضافه کنید.

مرحله ۵: احراز هویت

claude auth login

روش‌های احراز هویت

Claude Code از سه روش احراز هویت پشتیبانی می‌کند:

روش ۱: ورود OAuth (آسان‌ترین)

claude auth login

این دستور مرورگر را برای ورود از طریق حساب Anthropic شما باز می‌کند. بهترین گزینه برای استفاده شخصی با اشتراک Pro/Max.

روش ۲: کلید API (توصیه شده برای اعتبارات رایگان)

کلید API Anthropic خود را به عنوان یک متغیر محیطی تنظیم کنید:

macOS/Linux:

export ANTHROPIC_API_KEY="sk-ant-..."
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc  # یا ~/.bashrc

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-...', 'User')

این بهترین گزینه برای استفاده از اعتبارات رایگان Anthropic از AI Perks به جای اشتراک پولی است.

روش ۳: فایل پیکربندی

فایل ~/.claude/auth/credentials.json را ویرایش کنید:

{
  "api_key": "sk-ant-...",
  "auth_type": "api_key"
}

راه‌اندازی اولیه: تأیید عملکرد همه چیز

پس از نصب و احراز هویت:

تست عملکرد پایه

claude

شما باید REPL Claude Code را ببینید. یک پرامپت را امتحان کنید:

Hello! What model are you running?

Claude باید با یک خوشامدگویی پاسخ دهد و مدل فعال را مشخص کند.

تست عملیات فایل

به پوشه پروژه خود بروید:

cd ~/projects/my-app
claude

از Claude بخواهید README شما را بخواند:

Can you read the README.md and summarize this project?

اگر Claude بخواند و پاسخ دهد، راه‌اندازی شما موفقیت‌آمیز بوده است.

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

خطا: npm ERR! EACCES permission denied

شما مجوز نوشتن در پوشه سراسری npm را ندارید. رفع:

# از sudo استفاده نکنید. در عوض، پیشوند npm را تغییر دهید:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

این دستور export را به ~/.zshrc یا ~/.bashrc خود اضافه کنید تا دائمی شود.

خطا: command not found: claude

پس از نصب، دستور claude پیدا نمی‌شود. دلایل:

۱. ترمینال مجدداً راه‌اندازی نشده است - ترمینال خود را ببندید و دوباره باز کنید. ۲. PATH فاقد پوشه bin npm است - دستور echo $(npm config get prefix)/bin را اجرا کنید و به PATH اضافه کنید. ۳. پیکربندی اشتباه شل - برای zsh، فایل ~/.zshrc را ویرایش کنید؛ برای bash، فایل ~/.bashrc را ویرایش کنید.

خطا: Node.js version too old

Claude Code به Node.js نسخه ۱۸ یا بالاتر نیاز دارد. ارتقا دهید:

# macOS (Homebrew)
brew upgrade node

# Linux (nvm)
nvm install 20
nvm use 20

# Windows
# آخرین LTS را از nodejs.org دانلود کنید

خطا: Authentication failed

• کلید API خود را بررسی کنید که با sk-ant- شروع می‌شود.
• بررسی کنید که در console.anthropic.com باطل نشده باشد.
• اطمینان حاصل کنید که فضای اضافی در متغیر محیطی ANTHROPIC_API_KEY شما وجود ندارد.
• کلید را دوباره تولید کنید.

خطا: Cannot find module '@anthropic-ai/claude-code'

نصب کامل نشده است. امتحان کنید:

npm cache clean --force
npm install -g @anthropic-ai/claude-code@latest --force

اجرای Claude Code با اعتبارات رایگان Anthropic

Claude Code برای اجرا نیاز به اشتراک پولی (۲۰ تا ۲۰۰ دلار در ماه) یا اعتبارات API دارد. اعتبارات رایگان Anthropic از طریق AI Perks هزینه API را به طور کامل پوشش می‌دهد.

کل پتانسیل: ۴۵۰۰ تا ۱۵۶۰۰۰+ دلار اعتبار رایگان Claude

پس از نصب Claude Code، آن را با یک کلید API که با اعتبارات رایگان تأمین می‌شود، پیکربندی کنید و صورتحساب اشتراک را کاملاً نادیده بگیرید.

مرحله به مرحله: نصب + اجرای رایگان Claude Code

مرحله ۱: نصب Claude Code

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

مرحله ۲: دریافت اعتبارات رایگان Anthropic

در AI Perks ثبت نام کرده و برای برنامه‌های اعتباری درخواست دهید. بیشتر تصمیمات در عرض یک هفته اعلام می‌شوند.

مرحله ۳: تولید کلید API

وارد console.anthropic.com شوید و یک کلید API در Settings > API Keys ایجاد کنید.

مرحله ۴: پیکربندی Claude Code

export ANTHROPIC_API_KEY="sk-ant-..."

برای دائمی شدن، آن را به پیکربندی شل خود اضافه کنید.

مرحله ۵: شروع کدنویسی

claude

هر پرامپت اکنون از موجودی اعتبار رایگان شما استفاده می‌کند. نیازی به اشتراک نیست.

سوالات متداول

نصب Claude Code چقدر طول می‌کشد؟

نصب از طریق npm ۳۰ تا ۶۰ ثانیه طول می‌کشد، با فرض اینکه Node.js نسخه ۱۸+ از قبل نصب شده باشد. اگر ابتدا نیاز به نصب Node.js دارید، ۵ تا ۱۰ دقیقه اضافه کنید. موفقیت را با claude --version تأیید کنید.

آیا برای نصب Claude Code به اشتراک پولی نیاز دارم؟

خیر، نصب رایگان است. شما فقط به یک اشتراک Anthropic پولی یا اعتبارات API برای استفاده واقعی از Claude Code نیاز دارید. اعتبارات رایگان به ارزش ۱۰۰۰ تا ۲۵۰۰۰ دلار یا بیشتر از طریق AI Perks هزینه‌ها را کاملاً حذف می‌کند.

آیا می‌توانم Claude Code را روی چندین دستگاه نصب کنم؟

بله، روی هر تعداد دستگاه که می‌خواهید نصب کنید. نصب آن رایگان است. حساب Anthropic، کلیدهای API و اعتبارات شما بین دستگاه‌ها به اشتراک گذاشته می‌شوند - استفاده از هر دستگاه به همان موجودی شمارش می‌شود.

چگونه Claude Code را روی سرور (CI/CD) نصب کنم؟

از همان دستور npm install استفاده کنید، سپس از طریق متغیر محیطی (ANTHROPIC_API_KEY) پیکربندی کنید. برای CI/CD، کلید API را به عنوان یک secret ذخیره کرده و در طول اجرای پایپ لاین تزریق کنید. اعتبارات رایگان از طریق AI Perks استفاده CI/CD را با هزینه ۰ دلار تأمین می‌کنند.

آیا می‌توانم Claude Code را بدون Node.js نصب کنم؟

خیر، Claude Code برای اجرا به Node.js نسخه ۱۸+ نیاز دارد. هیچ باینری مستقل رسمی که توسط Anthropic توزیع شده باشد وجود ندارد. در صورت نیاز از nvm یا مدیر بسته سیستم عامل خود برای نصب Node.js استفاده کنید.

چگونه یک نسخه خاص از Claude Code را نصب کنم؟

با پرچم نسخه نصب کنید: npm install -g @anthropic-ai/claude-code@1.2.0 (نسخه دلخواه را جایگزین کنید). نسخه‌های موجود را در لاگ تغییرات GitHub مشاهده کنید.

بعد از نصب Claude Code چه اتفاقی می‌افتد؟

دستور claude --version را برای تأیید، سپس claude auth login (یا ANTHROPIC_API_KEY را تنظیم کنید). با دستور claude از هر پوشه پروژه اجرا کنید. Claude می‌تواند کد شما را بخواند، تغییرات را پیشنهاد دهد و وظایف را اجرا کند. با اعتبارات رایگان از طریق AI Perks، استفاده نامحدود ۰ دلار هزینه دارد.

نصب Claude Code + دریافت اعتبارات رایگان Anthropic

نصب Claude Code ۳۰ ثانیه طول می‌کشد. تامین هزینه آن به صورت رایگان با اشتراک AI Perks انجام می‌شود:

• ۱۰۰۰ تا ۲۵۰۰۰+ دلار اعتبار رایگان Anthropic
• استراتژی‌های انباشت برای ۵۰۰۰۰+ دلار اعتبار
• ۲۰۰+ مزیت اضافی برای استارتاپ‌ها فراتر از اعتبارات هوش مصنوعی
• راهنماهای به‌روزرسانی شده برای هر نسخه Claude Code

در getaiperks.com ثبت نام کنید →

Claude Code را در ۳۰ ثانیه نصب کنید. هزینه آن را به صورت رایگان در getaiperks.com تأمین کنید.