رفتن به محتوا
Claude Code Docs غیر رسمی

نصب پیشرفته

این صفحه نیازمندی‌های سیستم، جزئیات نصب مخصوص هر پلتفرم، به‌روزرسانی‌ها و حذف نصب را پوشش می‌دهد. برای راهنمای گام‌به‌گامِ نخستین نشستت، به شروعِ سریع سر بزن. اگر تا حالا با ترمینال کار نکرده‌ای، راهنمای ترمینال را ببین.

نیازمندی‌های سیستم

Section titled “نیازمندی‌های سیستم”

Claude Code روی پلتفرم‌ها و پیکربندی‌های زیر اجرا می‌شود:

  • سیستم‌عامل:
    • macOS 13.0+
    • Windows 10 1809+ یا Windows Server 2019+
    • Ubuntu 20.04+
    • Debian 10+
    • Alpine Linux 3.19+
  • سخت‌افزار: حداقل ۴ گیگابایت RAM، پردازنده‌ی x64 یا ARM64
  • شبکه: اتصال اینترنت لازم است. پیکربندی شبکه را ببین.
  • پوسته (Shell): Bash، Zsh، PowerShell یا CMD.
  • موقعیت مکانی: کشورهای پشتیبانی‌شده‌ی Anthropic

وابستگی‌های اضافی

Section titled “وابستگی‌های اضافی”

نصب Claude Code

Section titled “نصب Claude Code”

برای نصب Claude Code، از یکی از روش‌های زیر استفاده کن:

macOS، Linux، WSL:

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

Windows PowerShell:

Terminal window
irm https://claude.ai/install.ps1 | iex

Windows CMD:

Terminal window
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

اگر پیام The token '&&' is not a valid statement separator را دیدی، یعنی در PowerShell هستی، نه CMD. اگر پیام 'irm' is not recognized as an internal or external command را دیدی، یعنی در CMD هستی، نه PowerShell. وقتی در PowerShell باشی، پرامپتت PS C:\ را نشان می‌دهد و در CMD همان C:\ بدون PS را.

روی Windows بومی، نصب Git for Windows توصیه می‌شود تا Claude Code بتواند از ابزار Bash استفاده کند. اگر Git for Windows نصب نباشد، Claude Code به‌جای آن از PowerShell به‌عنوان ابزار پوسته استفاده می‌کند. راه‌اندازی‌های WSL نیازی به Git for Windows ندارند.

همچنین می‌توانی روی Debian، Fedora، RHEL و Alpine با apt، dnf یا apk نصب کنی.

پس از کامل‌شدن نصب، در پروژه‌ای که می‌خواهی رویش کار کنی یک ترمینال باز کن و Claude Code را اجرا کن:

Terminal window
claude

اگر هنگام نصب به مشکلی برخوردی، عیب‌یابیِ نصب و ورود را ببین.

راه‌اندازی روی Windows

Section titled “راه‌اندازی روی Windows”

می‌توانی Claude Code را به‌صورت بومی روی Windows یا داخل WSL اجرا کنی. بر اساس اینکه پروژه‌هایت کجا قرار دارند و به کدام قابلیت‌ها نیاز داری انتخاب کن:

گزینهنیازمندی‌هاSandboxingچه زمانی استفاده شود
Windows بومیهیچ؛ Git for Windows اختیاری استپشتیبانی نمی‌شودپروژه‌ها و ابزارهای بومیِ Windows
WSL 2فعال‌بودن WSL 2پشتیبانی می‌شودزنجیره‌ابزارهای Linux یا اجرای دستورِ سندباکس‌شده
WSL 1فعال‌بودن WSL 1پشتیبانی نمی‌شوداگر WSL 2 در دسترس نباشد

گزینه ۱: Windows بومی

دستور نصب را از PowerShell یا CMD اجرا کن. نیازی نیست به‌عنوان Administrator اجرایش کنی. نصب Git for Windows اختیاری است. این کار با فراهم‌کردن Git Bash، ابزار Bash را فعال می‌کند.

اینکه از PowerShell نصب کنی یا از CMD فقط روی این تأثیر می‌گذارد که کدام دستور نصب را اجرا می‌کنی. پرامپتت در PowerShell به‌شکل PS C:\Users\YourName> و در CMD به‌شکل C:\Users\YourName> بدون PS است. اگر تازه‌کار در ترمینال هستی، راهنمای ترمینال هر گام را قدم‌به‌قدم توضیح می‌دهد.

پس از نصب، claude را از هر ترمینالی اجرا کن.

  • بدون Git for Windows، Claude Code دستورهای پوسته را از طریق ابزار PowerShell اجرا می‌کند.

  • با Git for Windows، Claude Code برای ابزار Bash از Git Bash استفاده می‌کند. اگر Claude Code نتوانست Git Bash را پیدا کند، مسیر آن را در فایل settings.json تنظیم کن:

    {
      "env": {
        "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
      }
    }

وقتی Git for Windows نصب باشد، ابزار PowerShell به‌صورت تدریجی به‌عنوان یک گزینه‌ی اضافی در کنار Bash عرضه می‌شود. برای انتخابِ ورود CLAUDE_CODE_USE_POWERSHELL_TOOL=1 و برای انصراف 0 را تنظیم کن. برای راه‌اندازی و محدودیت‌ها، ابزار PowerShell را ببین.

گزینه ۲: WSL

توزیع WSL خود را باز کن و نصب‌کننده‌ی Linux را از دستورالعمل‌های نصب بالا اجرا کن. claude را داخل ترمینال WSL نصب و اجرا می‌کنی، نه از PowerShell یا CMD.

Alpine Linux و توزیع‌های مبتنی بر musl

Section titled “Alpine Linux و توزیع‌های مبتنی بر musl”

نصب‌کننده‌ی بومی روی Alpine و دیگر توزیع‌های مبتنی بر musl/uClibc به libgcc، libstdc++ و ripgrep نیاز دارد. این‌ها را با مدیر بسته‌ی توزیعت نصب کن، سپس USE_BUILTIN_RIPGREP=0 را تنظیم کن.

این نمونه بسته‌های لازم را روی Alpine نصب می‌کند:

Terminal window
apk add libgcc libstdc++ ripgrep

سپس در فایل settings.json خود USE_BUILTIN_RIPGREP را روی 0 تنظیم کن:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

تأیید نصب

Section titled “تأیید نصب”

پس از نصب، مطمئن شو که Claude Code کار می‌کند:

Terminal window
claude --version

اگر این دستور با command not found یا خطای دیگری شکست خورد، عیب‌یابیِ نصب و ورود را ببین.

برای بررسی دقیق‌ترِ نصب و پیکربندی‌ات، claude doctor را اجرا کن:

Terminal window
claude doctor

احراز هویت

Section titled “احراز هویت”

Claude Code به یک حساب Pro، Max، Team، Enterprise یا Console نیاز دارد. پلنِ رایگانِ Claude.ai دسترسی به Claude Code را شامل نمی‌شود. همچنین می‌توانی Claude Code را با یک ارائه‌دهنده‌ی API شخص‌ثالث مانند Amazon Bedrock، Google Vertex AI یا Microsoft Foundry استفاده کنی.

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

به‌روزرسانی Claude Code

Section titled “به‌روزرسانی Claude Code”

نصب‌های بومی به‌طور خودکار در پس‌زمینه به‌روزرسانی می‌شوند. می‌توانی کانال انتشار را پیکربندی کنی تا کنترل کنی به‌روزرسانی‌ها را بلافاصله بگیری یا با زمان‌بندیِ پایدارِ تأخیری، یا اینکه به‌روزرسانی خودکار را به‌کلی غیرفعال کنی. نصب‌های Homebrew، WinGet و مدیر بسته‌ی Linux به‌طور پیش‌فرض نیازمند به‌روزرسانی دستی هستند.

به‌روزرسانی‌های خودکار

Section titled “به‌روزرسانی‌های خودکار”

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

برای دیدن نتیجه‌ی آخرین تلاش برای به‌روزرسانی، claude doctor را اجرا کن.

اگر نصب سراسریِ npm نتواند به‌صورت خودکار به‌روزرسانی شود چون دایرکتوریِ سراسریِ npm قابل‌نوشتن نیست، Claude Code هنگام راه‌اندازی یک اعلان یک‌باره نشان می‌دهد و claude doctor راه‌حل‌های موجود را فهرست می‌کند. برای جزئیات، خطاهای دسترسی هنگام نصب را ببین.

پیکربندی کانال انتشار

Section titled “پیکربندی کانال انتشار”

با تنظیم autoUpdatesChannel کنترل کن که Claude Code برای به‌روزرسانی‌های خودکار و claude update کدام کانال انتشار را دنبال کند:

  • "latest"، پیش‌فرض: قابلیت‌های جدید را به‌محض انتشار دریافت می‌کنی
  • "stable": نسخه‌ای که معمولاً حدود یک هفته قدیمی‌تر است را استفاده می‌کنی و نسخه‌هایی با افت‌های جدی رد می‌شوند

این را از طریق /config ← Auto-update channel پیکربندی کن، یا به فایل settings.json خود اضافه‌اش کن:

{
  "autoUpdatesChannel": "stable"
}

برای استقرارهای سازمانی، می‌توانی با تنظیمات مدیریت‌شده (managed settings) یک کانال انتشار یکدست را در سراسر سازمانت اعمال کنی.

نصب‌های Homebrew به‌جای این تنظیم، کانال را بر اساس نام cask انتخاب می‌کنند: claude-code کانال stable و claude-code@latest کانال latest را دنبال می‌کند.

تثبیت حداقل نسخه

Section titled “تثبیت حداقل نسخه”

تنظیم minimumVersion یک کف تعیین می‌کند. به‌روزرسانی‌های خودکارِ پس‌زمینه و claude update از نصب هر نسخه‌ای پایین‌تر از این مقدار خودداری می‌کنند، بنابراین رفتن به کانال "stable" اگر همین حالا روی یک بیلدِ جدیدترِ "latest" باشی، تو را به نسخه‌ی پایین‌تر نمی‌برد.

سوئیچ از "latest" به "stable" از طریق /config به تو پیشنهاد می‌دهد که یا روی نسخه‌ی فعلی بمانی یا اجازه‌ی رفتن به نسخه‌ی پایین‌تر را بدهی. انتخابِ ماندن، minimumVersion را روی آن نسخه تنظیم می‌کند. سوئیچ دوباره به "latest" آن را پاک می‌کند.

برای تثبیت صریحِ یک کف، آن را به فایل settings.json خود اضافه کن:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}

در تنظیمات مدیریت‌شده، این یک حداقلِ سازمان‌گستر را اعمال می‌کند که تنظیمات کاربر و پروژه نمی‌توانند آن را بازنویسی کنند.

تثبیت minimumVersion فقط به‌روزرسانی‌ها را محدود می‌کند. برای اینکه Claude Code از راه‌اندازی خارج از یک محدوده‌ی نسخه‌ای خودداری کند، به‌جای آن از تنظیمات مدیریت‌شده‌ی requiredMinimumVersion و requiredMaximumVersion استفاده کن. به‌روزرسانی‌ها هم سقفِ requiredMaximumVersion را رعایت می‌کنند. تنظیمات موجود را ببین.

غیرفعال‌کردن به‌روزرسانی‌های خودکار

Section titled “غیرفعال‌کردن به‌روزرسانی‌های خودکار”

DISABLE_AUTOUPDATER را در کلید env فایل settings.json خود روی "1" تنظیم کن:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

DISABLE_AUTOUPDATER فقط بررسیِ پس‌زمینه را متوقف می‌کند؛ claude update و claude install همچنان کار می‌کنند. برای مسدودکردن همه‌ی مسیرهای به‌روزرسانی، از جمله به‌روزرسانی‌های دستی، به‌جای آن DISABLE_UPDATES را تنظیم کن. از این زمانی استفاده کن که Claude Code را از طریق کانال‌های خودت توزیع می‌کنی و نیاز داری کاربران روی نسخه‌ای که تو ارائه می‌دهی بمانند.

به‌روزرسانی دستی

Section titled “به‌روزرسانی دستی”

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

Terminal window
claude update

گزینه‌های نصب پیشرفته

Section titled “گزینه‌های نصب پیشرفته”

این گزینه‌ها برای تثبیت نسخه، مدیرهای بسته‌ی Linux، npm و تأیید یکپارچگیِ باینری هستند.

نصب یک نسخه‌ی مشخص

Section titled “نصب یک نسخه‌ی مشخص”

نصب‌کننده‌ی بومی یا یک شماره‌نسخه‌ی مشخص یا یک کانال انتشار (latest یا stable) را می‌پذیرد. کانالی که هنگام نصب انتخاب می‌کنی، پیش‌فرض تو برای به‌روزرسانی‌های خودکار می‌شود. برای اطلاعات بیشتر، پیکربندی کانال انتشار را ببین.

برای نصب آخرین نسخه (پیش‌فرض):

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

برای نصب نسخه‌ی پایدار (stable):

Terminal window
curl -fsSL https://claude.ai/install.sh | bash -s stable

برای نصب یک شماره‌نسخه‌ی مشخص:

Terminal window
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

نصب با مدیرهای بسته‌ی Linux

Section titled “نصب با مدیرهای بسته‌ی Linux”

Claude Code مخزن‌های امضاشده‌ی apt، dnf و apk منتشر می‌کند. هر مخزن دو کانال ارائه می‌دهد: stable نسخه‌ای را که معمولاً حدود یک هفته قدیمی‌تر است سرو می‌کند و نسخه‌هایی با افت‌های جدی را رد می‌کند، و latest هر نسخه را به‌محض انتشار سرو می‌کند. دستورهای زیر کانال stable را پیکربندی می‌کنند که برای بیشتر کاربران مناسب است؛ هر تب آدرس مخزنِ latest را هم نشان می‌دهد. نصب‌های مدیر بسته از طریق Claude Code به‌صورت خودکار به‌روزرسانی نمی‌شوند؛ به‌روزرسانی‌ها از طریق ورک‌فلوِ عادیِ ارتقای سیستمت می‌رسند.

همه‌ی مخزن‌ها با کلید امضای انتشار Claude Code امضا شده‌اند. پیش از اعتماد به کلید، آن را همان‌طور که در هر تب توضیح داده شده تأیید کن.

برای Debian و Ubuntu. دستورهای زیر کانال stable را پیکربندی می‌کنند:

Terminal window
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

برای استفاده از کانال latest به‌جای آن، هم مسیر URL و هم نام suite تغییر می‌کند. از این خط deb استفاده کن:

Terminal window
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list

پیش از اعتماد به کلید GPG، اثرانگشت (fingerprint) آن را تأیید کن: gpg --show-keys /etc/apt/keyrings/claude-code.asc باید 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE را گزارش دهد.

برای ارتقا در آینده، sudo apt update && sudo apt upgrade claude-code را اجرا کن.

نصب با npm

Section titled “نصب با npm”

همچنین می‌توانی Claude Code را به‌عنوان یک بسته‌ی سراسریِ npm نصب کنی. این بسته به Node.js نسخه‌ی ۱۸ یا بالاتر نیاز دارد.

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

بسته‌ی npm همان باینریِ بومیِ نصب‌کننده‌ی مستقل را نصب می‌کند. npm باینری را از طریق یک وابستگیِ اختیاریِ مخصوص هر پلتفرم مانند @anthropic-ai/claude-code-darwin-arm64 می‌آورد و یک مرحله‌ی postinstall آن را سرِ جایش پیوند می‌دهد. باینریِ نصب‌شده‌ی claude خودش Node را فراخوانی نمی‌کند.

پلتفرم‌های پشتیبانی‌شده برای نصب با npm عبارت‌اند از darwin-arm64، darwin-x64، linux-x64، linux-arm64، linux-x64-musl، linux-arm64-musl، win32-x64 و win32-arm64. مدیر بسته‌ات باید وابستگی‌های اختیاری را مجاز کند. اگر پس از نصب باینری پیدا نشد، عیب‌یابی را ببین.

برای ارتقای یک نصبِ npm، npm install -g @anthropic-ai/claude-code@latest را اجرا کن. از npm update -g پرهیز کن، چون محدوده‌ی semver را از نصب اولیه رعایت می‌کند و ممکن است تو را به جدیدترین نسخه منتقل نکند.

یکپارچگیِ باینری و امضای کد

Section titled “یکپارچگیِ باینری و امضای کد”

هر انتشار یک manifest.json منتشر می‌کند که شامل چک‌سام‌های SHA256 برای باینریِ هر پلتفرم است. این manifest با یک کلید GPG متعلق به Anthropic امضا شده است، بنابراین تأیید امضای manifest به‌صورت گذرا (transitively) هر باینریِ فهرست‌شده در آن را تأیید می‌کند.

تأیید امضای manifest

Section titled “تأیید امضای manifest”

گام‌های ۱ تا ۳ به یک پوسته‌ی POSIX با gpg و curl نیاز دارند. روی Windows، آن‌ها را در Git Bash یا WSL اجرا کن. گام ۴ شامل یک گزینه‌ی PowerShell است.

کلید عمومی را دانلود و وارد (import) کن

کلید امضای انتشار در یک URL ثابت منتشر شده است.

Terminal window
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

اثرانگشت کلیدِ واردشده را نمایش بده.

Terminal window
gpg --fingerprint security@anthropic.com

تأیید کن که خروجی شامل این اثرانگشت است:

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

manifest و امضا را دانلود کن

VERSION را روی انتشاری که می‌خواهی تأیید کنی تنظیم کن.

Terminal window
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"

امضا را تأیید کن

امضای مجزا (detached) را در برابر manifest تأیید کن.

Terminal window
gpg --verify manifest.json.sig manifest.json

یک نتیجه‌ی معتبر، Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>" را گزارش می‌دهد.

gpg همچنین برای هر کلیدِ تازه‌واردشده، WARNING: This key is not certified with a trusted signature! را چاپ می‌کند. این طبیعی است. خط Good signature تأیید می‌کند که بررسیِ رمزنگاری موفق بوده است. مقایسه‌ی اثرانگشت در گام ۱ تأیید می‌کند که خودِ کلید معتبر است.

باینری را در برابر manifest بررسی کن

چک‌سام SHA256 باینریِ دانلودشده‌ات را با مقدارِ فهرست‌شده زیر platforms.<platform>.checksum در manifest.json مقایسه کن.

Terminal window
sha256sum claude

امضاهای کدِ مخصوص پلتفرم

Section titled “امضاهای کدِ مخصوص پلتفرم”

علاوه بر manifestِ امضاشده، باینری‌های جداگانه در جایی که پشتیبانی شود، امضاهای کدِ بومیِ پلتفرم را حمل می‌کنند.

  • macOS: امضاشده توسط «Anthropic PBC» و نوتاریزه‌شده توسط Apple. با codesign --verify --verbose ./claude تأیید کن.
  • Windows: امضاشده توسط «Anthropic, PBC». با Get-AuthenticodeSignature .\claude.exe تأیید کن.
  • Linux: باینری‌ها به‌صورت جداگانه امضای کد ندارند. اگر مستقیماً از باکتِ claude-code-releases دانلود می‌کنی یا از نصب‌کننده‌ی بومی استفاده می‌کنی، یکپارچگی را با امضای manifestِ بالا تأیید کن. اگر با apt، dnf یا apk نصب می‌کنی، مدیر بسته‌ات امضاها را به‌صورت خودکار با کلید امضای مخزن تأیید می‌کند.

حذف نصب Claude Code

Section titled “حذف نصب Claude Code”

برای حذف Claude Code، دستورالعمل‌های روش نصبت را دنبال کن. اگر claude پس از آن همچنان اجرا می‌شود، احتمالاً یک نصب دوم یا یک aliasِ پوسته‌ی باقی‌مانده از یک نصب‌کننده‌ی قدیمی‌تر داری. برای یافتن و حذف آن، بررسی نصب‌های متعارض را ببین.

نصب بومی

Section titled “نصب بومی”

باینری Claude Code و فایل‌های نسخه را حذف کن:

Terminal window
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

نصب Homebrew

Section titled “نصب Homebrew”

cask نصب‌شده‌ی Homebrew را حذف کن. اگر cask پایدار (stable) را نصب کرده‌ای:

Terminal window
brew uninstall --cask claude-code

اگر cask آخرین (latest) را نصب کرده‌ای:

Terminal window
brew uninstall --cask claude-code@latest

نصب WinGet

Section titled “نصب WinGet”

بسته‌ی WinGet را حذف کن:

Terminal window
winget uninstall Anthropic.ClaudeCode

apt / dnf / apk

Section titled “apt / dnf / apk”

بسته و پیکربندیِ مخزن را حذف کن:

Terminal window
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

npm

Section titled “npm”

بسته‌ی سراسریِ npm را حذف کن:

Terminal window
npm uninstall -g @anthropic-ai/claude-code

حذف فایل‌های پیکربندی

Section titled “حذف فایل‌های پیکربندی”

افزونه‌ی VS Code، پلاگین JetBrains و اپلیکیشن Desktop هم در ~/.claude/ می‌نویسند. اگر هرکدام هنوز نصب باشد، دایرکتوری دفعه‌ی بعدی که اجرا شود دوباره ساخته می‌شود. برای حذف کاملِ Claude Code، پیش از پاک‌کردن این فایل‌ها، افزونه‌ی VS Code، پلاگین JetBrains و اپلیکیشن Desktop را حذف نصب کن.

برای حذف تنظیمات و داده‌های کش‌شده‌ی Claude Code:

Terminal window
# Remove user settings and state
rm -rf ~/.claude
rm ~/.claude.json


# Remove project-specific settings (run from your project directory)
rm -rf .claude
rm -f .mcp.json