نصب Claude روی Linux: اپلیکیشن دسکتاپ و CLI

کدام بخش‌های Claude امروزه به‌صورت بومی روی Linux اجرا می‌شوند

Claude روی Linux در چهار سطح مجزا اجرا می‌شود و تا اوت 2026، هر چهار مورد روی یک ماشین معمولی با توزیع Ubuntu یا Debian کار می‌کنند. اپلیکیشن دسکتاپ از مخزن apt شرکت Anthropic نصب می‌شود و در وضعیت بتا قرار دارد. ابزار CLI (رابط خط فرمان) Claude Code یک فایل باینری کامپایل‌شده است و روی توزیع‌های بیشتری نسبت به اپلیکیشن دسکتاپ اجرا می‌شود. اپلیکیشن وب در claude.ai تنها به یک مرورگر نیاز دارد و API نیز یک endpoint از نوع HTTPS است که از داخل کد خودتان آن را فراخوانی می‌کنید.

دو قابلیتی که در macOS و Windows وجود دارند، در نسخه بتای دسکتاپ Linux غایب هستند: Computer Use که در آن Claude برنامه‌های روی صفحه نمایش شما را کنترل می‌کند، و قابلیت دیکته صوتی. شرکت Anthropic هر دو مورد را به‌عنوان قابلیت‌هایی که هنوز برای Linux در دسترس نیستند، مستند کرده است. ابزار CLI قابلیت دیکته صوتی مخصوص به خود را دارد، بنابراین این کمبود مربوط به اپلیکیشن دسکتاپ است و نه خود Claude.

وضعیت در دسترس بودن تغییر می‌کند، بنابراین این صفحه را به‌عنوان توصیفی از سطوح مختلف در نظر بگیرید و پیش از برنامه‌ریزی بر اساس آن، وضعیت فعلی را بررسی کنید. بخش آخر، صفحاتی که باید بررسی شوند را فهرست کرده است.

نصب اپلیکیشن دسکتاپ Claude روی Ubuntu یا Debian

نیازمندی‌های مستندشده شامل Ubuntu 22.04 یا نسخه‌های جدیدتر، یا Debian 12 یا نسخه‌های جدیدتر، روی معماری x86_64 (که dpkg آن را amd64 می‌نامد) یا arm64 است. سایر توزیع‌های مبتنی بر Debian ممکن است کار کنند اما تست نشده‌اند. برای Fedora و RHEL هنوز بسته‌ای ارائه نشده است، بنابراین در این سیستم‌عامل‌ها باید از CLI یا مرورگر استفاده کنید.

نصب را از طریق مخزن apt انجام دهید و نه از طریق فایل .deb دانلودشده. اپلیکیشن لینوکس قابلیت به‌روزرسانی داخلی ندارد، بنابراین نسخه‌های جدید فقط از طریق مدیر بسته (package manager) به دست شما می‌رسند و ثبت مخزن همان چیزی است که به apt upgrade اجازه می‌دهد آن‌ها را شناسایی کند.

sudo apt install curl gnupg
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc \
  https://downloads.claude.ai/claude-desktop/key.asc
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc

دستور gpg --show-keys باید اثر انگشت (fingerprint) 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE را چاپ کند. پیش از ثبت مخزن، آن را مقایسه کنید؛ زیرا کلید امضایی که بررسی نکرده‌اید، کلیدی است که کورکورانه به آن اعتماد می‌کنید. اگر gpg گزارش دهد که فایل حاوی داده‌های معتبر OpenPGP نیست، دانلود با شکست مواجه شده است و apt update در مراحل بعدی با خطای NO_PUBKEY BAA929FF1A7ECACE مواجه خواهد شد.

ثبت مخزن شامل یک خط deb است که در /etc/apt/sources.list.d/claude-desktop.list نوشته می‌شود. آن خط را دقیقاً همان‌طور که در صفحه نصب لینوکس Anthropic به آدرس code.claude.com/docs/en/desktop-linux آمده است، کپی کنید. آدرس مخزن بخشی از این دستورالعمل است که احتمال تغییر آن زیاد است و تایپ کردن آن از روی حافظه باعث می‌شود بعداً با خطای E: Unable to locate package claude-desktop مواجه شوید. پیش از Paste کردن، خط را بخوانید: arch=amd64,arm64 دلیلی است که apt در سایر معماری‌ها چیزی پیدا نمی‌کند و signed-by= به فایل keyring که بررسی کردید اشاره دارد؛ این کار باعث می‌شود کلید فقط به همین مخزن محدود شود و برای سایر مخازنی که apt می‌خواند، مورد اعتماد نباشد.

sudo apt update && sudo apt install claude-desktop

برنامه را از طریق لانچر اپلیکیشن‌ها اجرا کنید یا دستور claude-desktop را در ترمینال وارد نمایید. با حساب کاربری claude.ai خود یا از طریق SSO (ورود یکپارچه) سازمان خود، اگر شرکتتان آن را تنظیم کرده است، وارد شوید. اپلیکیشن دسکتاپ کلید API مربوط به Claude Console را نمی‌پذیرد: احراز هویت مبتنی بر کلید، قابلیتی مختص CLI است.

خطای E: Unable to locate package claude-desktop به این معنی است که apt هرگز مخزن را نخوانده است. دستور cat /etc/apt/sources.list.d/claude-desktop.list باید خط deb که نوشته‌اید را نشان دهد و dpkg --print-architecture باید amd64 یا arm64 را چاپ کند، زیرا هیچ بسته‌ای برای سایر معماری‌ها منتشر نشده است. پس از آن، به‌روزرسانی‌ها همراه با سایر بخش‌های سیستم شما از طریق sudo apt update && sudo apt upgrade دریافت می‌شوند.

آنچه فقط در مرورگر وجود دارد

سرویس claude.ai در هر مرورگر به‌روزی و روی هر توزیعی کار می‌کند؛ این ویژگی باعث می‌شود که روی Fedora، RHEL، Arch، openSUSE و هر سیستم‌عامل دیگری که بسته‌ای برای آن وجود ندارد، بهترین گزینه باشد. مرورگر همچنین دسترسی به Claude Code را در وب فراهم می‌کند، جایی که نشست (session) به‌جای ماشین شما، در فضای ابری Anthropic اجرا می‌شود و همیشه از اعتبارنامه اشتراک شما استفاده می‌کند.

محدودیت مرورگر نکته‌ای است که باید درک شود. یک نشست ابری نمی‌تواند فایل‌های موجود روی سرور شخصی شما را بخواند یا دستوری روی آن اجرا کند. هر چیزی که با ماشین شما در تعامل باشد، نیازمند نرم‌افزاری روی همان ماشین است؛ یعنی استفاده از CLI یا اپلیکیشن دسکتاپ.

آنچه رابط خط فرمان (CLI) در اختیار شما می‌گذارد و اپلیکیشن وب از آن بی‌بهره است

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

• این ابزار فایل‌های موجود در دایرکتوری کاری شما را می‌خواند و ویرایش می‌کند و پیش از اعمال هر تغییر، آن را به شما نشان می‌دهد.
• دستورات shell مورد تأیید شما را اجرا می‌کند؛ بنابراین می‌تواند یک پروژه را build کند، مجموعه تست‌ها را اجرا کند، یک لاگ را بخواند یا وضعیت یک سرویس را مستقیماً روی همان سیستم بررسی کند.
• بدون نیاز به نشست تعاملی (interactive session) اجرا می‌شود: claude -p "read the nginx error log and summarise it" یک پاسخ چاپ کرده و خارج می‌شود؛ این همان چیزی است که برای استفاده در cron job یا pipeline به آن نیاز دارید. نحوه نگارش این پاسخ کاملاً در اختیار شماست، زیرا یک سبک خروجی، prompt سیستم را در پشت هر پاسخ تغییر می‌دهد و می‌تواند خروجی یک اجرای اسکریپتی را مختصر نگه دارد، در حالی که در یک نشست تعاملی، توضیحات کامل ارائه شود.
• سرورهای MCP (پروتکل زمینه مدل) را با claude mcp add متصل می‌کند که ابزارهایی فراتر از سیستم فایل در اختیار مدل قرار می‌دهد.
• در محیط‌هایی که هیچ رابط گرافیکی (desktop) وجود ندارد اجرا می‌شود؛ یعنی همان شرایطی که در هر VPS (سرور مجازی) که اجاره می‌کنید با آن مواجه خواهید بود.

نکته آخر دلیل اهمیت CLI برای راهنمای سرور است. یک سرور اجاره‌ای فقط SSH (پوسته امن) دارد و هیچ چیز دیگری در آن نیست؛ بنابراین ترمینال تنها رابطی است که در دسترس شما قرار دارد. اجرای آن به این شیوه قواعد خاص خود را دارد که اجرای Claude Code روی یک VPS داخل tmux به طور کامل به آن می‌پردازد و استفاده از Claude برای کارهای روزمره مدیریت سیستم وظایفی را که ارزش سپردن به آن را دارند، بررسی می‌کند.

یکپارچه‌سازی‌های ویرایشگر (Editor integrations) در میانه این دو قرار دارند. افزونه VS Code به نسخه 1.94.0 یا بالاتر نیاز دارد و یک پنل گرافیکی داخل ویرایشگر با قابلیت نمایش diffها و بررسی طرح‌ها در اختیار شما می‌گذارد. این افزونه یک نسخه اختصاصی از CLI را برای آن پنل بسته‌بندی می‌کند و claude را به PATH شما اضافه نمی‌کند؛ بنابراین برای تایپ claude در ترمینال یکپارچه، همچنان به نصب مستقل نیاز دارید. ویرایشگرهایی که بر پایه VS Code ساخته شده‌اند، همان افزونه را از رجیستری Open VSX نصب می‌کنند و یک پلاگین برای JetBrains نیز موجود است.

آیا برای اجرای Claude Code در لینوکس به Node.js نیاز دارید؟

در روش نصب توصیه‌شده، خیر. نصب‌کننده بومی (native) یک فایل باینری کامپایل‌شده را دانلود می‌کند و آن فایل باینری بر پایه Node.js اجرا نمی‌شود.

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

claude --version باید شماره نسخه‌ای مانند 2.1.211 (Claude Code) را نمایش دهد. اگر مشکلی مشاهده کردید، دستور claude doctor را اجرا کنید؛ این دستور بدون شروع یک نشست، اطلاعات تشخیصی فقط‌خواندنی درباره نصب و فایل‌های تنظیمات شما ارائه می‌دهد.

Node.js تنها در روش نصب از طریق npm اهمیت دارد. از نسخه 2.1.198 بسته، پکیج npm نیازمند Node.js 22 یا بالاتر است. در صورت استفاده از نسخه‌های قدیمی‌تر Node.js، دستور npm به جای متوقف شدن، یک هشدار EBADENGINE نمایش می‌دهد؛ زیرا این بسته همان فایل باینری بومی را به عنوان یک وابستگی (dependency) مختص هر پلتفرم دریافت کرده و آن را در جای مناسب لینک می‌کند.

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

آن را با sudo اجرا نکنید. مستندات نسبت به استفاده از sudo npm install -g هشدار می‌دهند، زیرا این کار باعث ایجاد فایل‌هایی با مالکیت root در پیشوند سراسری npm می‌شود و در نتیجه، نصب یا به‌روزرسانی بعدی توسط کاربر عادی به دلیل محدودیت مجوزها با خطا مواجه خواهد شد. هنگامی که دایرکتوری سراسری npm قابل نوشتن نباشد، به‌روزرسانی خودکار در پس‌زمینه متوقف می‌شود و claude doctor راه‌های رفع این مشکل را فهرست می‌کند.

شرکت Anthropic همچنین مخازن بسته‌های امضاشده را برای Debian، Fedora، RHEL و Alpine منتشر می‌کند، بنابراین sudo apt install claude-code مشابه بسته دسکتاپ عمل کرده و از کلید امضای اختصاصی خود در مسیر https://downloads.claude.ai/keys/claude-code.asc استفاده می‌کند.

آیا باید نصب را برای هر کاربر انجام دهید یا در سطح کل سیستم؟

نصب‌کننده بومی (native installer) به‌صورت پیش‌فرض برای هر کاربر انجام می‌شود. این نصب‌کننده یک لانچر را در ~/.local/bin/claude به‌عنوان یک symlink در ~/.local/share/claude/versions/ قرار می‌دهد، نیازی به دسترسی root ندارد و به‌طور خودکار در پس‌زمینه به‌روزرسانی می‌شود. هر کاربر در سیستم، یک کپی مجزا با نسخهٔ متفاوت دریافت می‌کند.

نصب از طریق مدیریت بسته (package manager) در سطح کل سیستم انجام می‌شود. یک فایل اجرایی به همهٔ کاربران سرویس می‌دهد، به دسترسی root نیاز دارد و از طریق Claude Code به‌طور خودکار به‌روزرسانی نمی‌شود. شما آن را با sudo apt update && sudo apt upgrade claude-code ارتقا می‌دهید؛ همان دستوری که برای سایر بسته‌های موجود در سیستم اجرا می‌کنید.

اگر با حساب کاربری شخصی خود وارد سیستم می‌شوید، نصب برای هر کاربر را انتخاب کنید که اکثر کارهای مربوط به VPS را پوشش می‌دهد. اگر در یک سرور اشتراکی یا یک image سیستم هستید که می‌خواهید یک نسخه برای همه وجود داشته باشد و به‌روزرسانی‌ها طبق زمان‌بندی شما انجام شود، نصب از طریق مدیریت بسته را انتخاب کنید. در نصب بومی، دو تنظیم در ~/.claude/settings.json نحوهٔ عملکرد به‌روزرسانی‌ها را تعیین می‌کنند:

{
  "autoUpdatesChannel": "stable",
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

کانال stable نسخه‌هایی را دنبال می‌کند که تقریباً یک هفته از انتشار آن‌ها گذشته است و نسخه‌های دارای مشکلات اساسی (regression) را نادیده می‌گیرد. DISABLE_AUTOUPDATER فقط بررسی خودکار در پس‌زمینه را متوقف می‌کند، بنابراین claude update همچنان کار می‌کند و شما کنترل زمان نصب نسخهٔ جدید را در دست خواهید داشت. این موضوع در سروری که یک پردازش طولانی‌مدت بدون نظارت در حال اجراست اهمیت دارد، زیرا ترجیح می‌دهید فایل اجرایی در حین اجرای پردازش تغییر نکند.

ورود از طریق SSH و حفظ نشست

هنگام اجرای اولین بار CLI روی یک سرور اجاره‌ای، دو مشکل خاص در لینوکس بروز می‌کند. جریان ورود به سیستم نیازمند مرورگر است، در حالی که سرور فاقد آن است. همچنین، قطع شدن اتصال SSH باعث توقف کارهای در حال اجرا می‌شود.

ابزار tmux مشکل دوم را حل می‌کند. یک نشست tmux متعلق به سرور tmux روی ماشین راه دور است، نه اتصال شما؛ بنابراین با قطع شدن لینک، پردازش همچنان در حال اجرا باقی می‌ماند.

tmux new -s claude
claude

برای جدا شدن (detach) از کلیدهای Ctrl-b و سپس d استفاده کنید و برای بازگشت به نشست از tmux attach -t claude استفاده نمایید.

ورود به سیستم مشکل اول است. دستور claude را اجرا کنید تا یک URL احراز هویت چاپ شود. آن URL را در مرورگر کامپیوتر شخصی خود باز کنید. پس از ورود، مرورگر به‌جای هدایت مجدد، یک کد ورود نمایش می‌دهد؛ زیرا مرورگر لپ‌تاپ شما نمی‌تواند به سرور callback که Claude Code روی آدرس loopback ماشین راه دور راه‌اندازی کرده است، دسترسی پیدا کند. آن کد را در ترمینال و در اعلان Paste code here if prompted وارد کنید تا ترمینال پیام Login successful را نمایش دهد.

برای نشستی که باید بدون نظارت شروع شود، claude setup-token همان احراز هویت مرورگر را باز کرده و یک توکن OAuth با اعتبار یک‌ساله در ترمینال چاپ می‌کند. این توکن جایی ذخیره نمی‌شود، بنابراین آن را کپی کرده و در محل مورد نیاز قرار دهید.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

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

سرورهای کوچک با یک مانع دیگر نیز مواجه می‌شوند. نصب برنامه به حدود 512 مگابایت حافظه آزاد نیاز دارد و حداقل سخت‌افزار توصیه‌شده برای اجرای آن 4 گیگابایت رم یا بیشتر است؛ بنابراین روی یک نمونه 1 گیگابایتی، قابلیت out-of-memory killer در هسته، فرآیند نصب را متوقف می‌کند:

Setting up Claude Code...
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

ابتدا swap اضافه کنید و سپس نصب‌کننده را دوباره اجرا کنید. Swap فضایی از دیسک است که هسته به عنوان حافظه کمکی از آن استفاده می‌کند. این فضا بسیار کندتر از رم است، اما برای تکمیل نصب کافی است.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

دستور swapon فایل را فقط برای همین بوت فعال می‌کند. اگر می‌خواهید پس از راه‌اندازی مجدد نیز فعال بماند، یک خط برای /swapfile به فایل /etc/fstab اضافه کنید. موارد دیگری که باید پیش از اجازه دادن به یک عامل برای اجرای دستورات روی سرور زنده ایمن‌سازی شوند، موضوع بخش اجرای ایمن Claude Code روی VPS است.

محل ذخیره اعتبارنامه‌های Claude در لینوکس

در لینوکس، /login اعتبارنامه را در ~/.claude/.credentials.json با مجوز فایل 0600 می‌نویسد. سیستم‌عامل macOS همین اعتبارنامه را در Keychain رمزنگاری‌شده قرار می‌دهد، بنابراین عادتی که در مک پیدا کرده‌اید در اینجا کاربرد ندارد: در لینوکس، توکن یک فایل متنی ساده در دایرکتوری خانگی شماست و هر پردازشی که با کاربر شما اجرا شود می‌تواند آن را بخواند. تنظیم CLAUDE_CONFIG_DIR باعث می‌شود فایل به آن دایرکتوری منتقل شود.

دو نکته از این موضوع نتیجه می‌شود. نسخه پشتیبان از /home حاوی یک نشست ورود فعال است، بنابراین کپی کردن آن نسخه پشتیبان روی یک ماشین اشتراکی، دسترسی به حساب شما را به هر کسی که بتواند آن را بخواند می‌دهد. همچنین، ایمیج ماشینی که از سیستمی ساخته شده که در آن لاگین کرده‌اید، آن ورود را به تمام نمونه‌های کپی‌شده از آن منتقل می‌کند. پیش از گرفتن هرگونه اسنپ‌شات، /logout را اجرا کنید.

اولویت اعتبارنامه‌ها برای کسانی که همزمان اشتراک و API key دارند، مشکل‌ساز می‌شود. وقتی ANTHROPIC_API_KEY در شل شما تنظیم شده باشد، Claude Code پس از تأیید شما از آن استفاده می‌کند، بنابراین اشتراک شما بدون استفاده می‌ماند در حالی که کلید بر اساس هر توکن هزینه ایجاد می‌کند. /status نشان می‌دهد کدام اعتبارنامه فعال است و unset ANTHROPIC_API_KEY شما را به ورود از طریق اشتراک بازمی‌گرداند.

ورودها منقضی می‌شوند. در فاصله سه روز مانده به انقضا، خط شروع برنامه عبارت Your login expires in 3 days را نمایش می‌دهد و این هشدار هرگز مانع درخواست نمی‌شود. پس از انقضا، تمام درخواست‌ها با خطای Login expired · Please run /login شکست می‌خورند. پیش از رها کردن یک نشست بدون نظارت در طول آخر هفته به این موضوع توجه کنید، زیرا چنین نشستی از پیشرفت باز می‌ماند و نمی‌تواند به‌طور خودکار بازیابی شود.

آیا یک اشتراک Claude تمام موارد را پوشش می‌دهد؟

یک طرح اشتراکی پولی، تمامی محیط‌ها را با همان ورود به سیستم (login) پوشش می‌دهد. یک حساب Pro، Max، Team یا Enterprise شما را در claude.ai در مرورگر، اپلیکیشن دسکتاپ، CLI و افزونه VS Code وارد می‌کند و در هر بار استفاده، همان اشتراک واحد است. همچنین یک سهمیه استفاده واحد برای همه آن‌ها وجود دارد؛ بنابراین یک اجرای طولانی CLI روی سرور شما، از سهمیه باقی‌مانده اپلیکیشن دسکتاپ کم می‌کند و اینکه به چه محدودیت زمانی رسیده‌اید و چه کاری باید انجام دهید، موضوعی است که هنگام امتناع هر یک از محیط‌ها از انجام کار، باید بررسی شود. طرح رایگان claude.ai شامل دسترسی به Claude Code نمی‌شود، بنابراین بخش‌های CLI و Claude Code در اپلیکیشن دسکتاپ به یک طرح پولی یا یک حساب Claude Console نیاز دارند.

API یک محصول متفاوت با صورت‌حساب جداگانه است. حساب Console بر اساس توکن برای آنچه واقعاً ارسال می‌کنید صورت‌حساب صادر می‌کند، که برای سرویسی که در حال ساخت آن هستید مناسب‌تر است تا زمانی که در ترمینال تایپ می‌کنید. تنظیم ANTHROPIC_API_KEY، CLI را به آن مسیر صورت‌حساب منتقل می‌کند و این انتخابی است که شما انجام می‌دهید، نه یک گزینه جایگزین خودکار.

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

خطاهای نصبی که احتمالاً با آن‌ها مواجه می‌شوید

bash: claude: command not found بلافاصله پس از نصب موفق. فایل باینری در مسیر ~/.local/bin/claude قرار دارد و آن دایرکتوری در مسیر جستجوی (search path) شل شما تعریف نشده است. این موضوع را با echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" بررسی کنید؛ اگر خروجی خالی باشد، یعنی ورودی مورد نظر وجود ندارد. برای رفع این مشکل در bash از echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc استفاده کنید و سپس source ~/.bashrc را اجرا نمایید. نصب افزونه VS Code به تنهایی هرگز آن فایل را ایجاد نمی‌کند، زیرا افزونه یک کپی از CLI را درون دایرکتوری خود نگه می‌دارد.

Error loading shared library libstdc++.so.6. نصب‌کننده نسخه musl را برای یک سیستم glibc انتخاب کرده است. این اتفاق زمانی رخ می‌دهد که بسته‌های cross-compilation مربوط به musl نصب باشند و سیستم تشخیص، آن‌ها را به اشتباه تفسیر کند. دستور ldd --version 2>&1 | head -1 را اجرا کنید؛ اگر خروجی شامل GNU libc یا GLIBC باشد، یعنی شما از glibc استفاده می‌کنید و فایل باینری اشتباه دریافت شده است؛ بنابراین نصب را حذف کرده و دوباره نصب‌کننده را اجرا کنید. در Alpine و سایر سیستم‌های مبتنی بر musl، راه حل برعکس است: apk add libgcc libstdc++ ripgrep.

وجود دو نسخه از claude روی یک سیستم. دستور which -a claude تمام موارد منطبق در PATH شما را لیست می‌کند. نصب بومی (native) یک symlink از ~/.local/bin/claude به ~/.local/share/claude/versions/ است، نصب محلی قدیمی npm در مسیر ~/.claude/local/ قرار دارد و npm -g ls @anthropic-ai/claude-code نصب سراسری (global) npm را نشان می‌دهد. نسخه‌هایی که نیاز ندارید را حذف کنید، زیرا وجود یک نسخه قدیمی در ابتدای PATH باعث می‌شود که یک باگِ رفع‌شده، همچنان پابرجا به نظر برسد.

محل بررسی وضعیت فعلی

• وضعیت دسکتاپ لینوکس، پیش‌نیازها و دستورات نصب: code.claude.com/docs/en/desktop-linux
• توزیع‌های پشتیبانی‌شده و تمامی روش‌های نصب برای CLI: code.claude.com/docs/en/setup
• کدام پلتفرم‌ها دارای اپلیکیشن قابل دانلود هستند: claude.com/download
• کدام طرح شامل چه مواردی است و هزینه آن چقدر است: claude.com/pricing

تمامی شماره نسخه‌ها و تاریخ‌های موجود در این راهنما، تصویری از وضعیت در آگوست 2026 هستند. ساختار کلی ثابت است: چهار سطح، یک ورود واحد برای طرح‌های پولی، و یک تصمیم‌گیری درباره اینکه آیا CLI متعلق به کاربر شما باشد یا کل سیستم.

FAQ

آیا نسخه دسکتاپ Claude برای لینوکس وجود دارد؟

بله. از اوت 2026 این نسخه در مرحله بتا قرار دارد و از Ubuntu 22.04 یا جدیدتر و Debian 12 یا جدیدتر روی معماری‌های amd64 یا arm64 پشتیبانی می‌کند. پس از افزودن مخزن apt شرکت Anthropic و کلید امضای آن، برنامه را با sudo apt install claude-desktop نصب کنید تا نسخه‌های جدید همراه با به‌روزرسانی‌های معمول سیستم دریافت شوند. نسخه لینوکس دارای همان زبانه‌های نسخه macOS، از جمله زبانه Claude Code است. قابلیت‌های Computer Use و دیکته صوتی هنوز در نسخه لینوکس موجود نیستند و برای توزیع‌های Fedora و RHEL بسته‌ای ارائه نشده است؛ بنابراین در این توزیع‌ها از CLI یا claude.ai در مرورگر استفاده کنید.

آیا برای اجرای Claude Code در لینوکس به Node.js نیاز دارم؟

برای روش نصب توصیه‌شده، خیر. curl -fsSL https://claude.ai/install.sh | bash یک فایل باینری کامپایل‌شده را دانلود می‌کند که در زمان اجرا از Node.js استفاده نمی‌کند. Node.js تنها در صورتی اهمیت دارد که بسته npm را نصب کنید که از نسخه 2.1.198 به بعد، به Node.js 22 یا جدیدتر نیاز دارد. در نسخه‌های قدیمی‌تر Node.js، دستور npm یک هشدار EBADENGINE نمایش می‌دهد و نصب همچنان به پایان می‌رسد، زیرا همان باینری بومی به عنوان یک وابستگی وابسته به پلتفرم دریافت می‌شود. هرگز آن را با sudo npm install -g نصب نکنید، زیرا فایل‌هایی با مالکیت root در پیشوند npm شما باقی می‌گذارد و به‌روزرسانی‌های بعدی را مختل می‌کند.

چگونه از طریق SSH به Claude Code وارد شوم؟

دستور claude را اجرا کنید تا یک URL احراز هویت چاپ شود. آن URL را در مرورگر رایانه شخصی خود باز کنید، نه روی سرور. پس از ورود به سیستم، مرورگر به جای تغییر مسیر (redirect)، یک کد ورود نمایش می‌دهد، زیرا نمی‌تواند به listener بازگشتی که Claude Code روی آدرس loopback ماشین راه دور راه‌اندازی کرده است، دسترسی پیدا کند. آن کد را در اعلان Paste code here if prompted وارد کنید. برای نشست‌هایی که بدون حضور کاربر شروع می‌شوند، claude setup-token را اجرا کرده و توکن چاپ‌شده را در هر کجا که نیاز است به عنوان CLAUDE_CODE_OAUTH_TOKEN تنظیم کنید.

Claude Code اطلاعات ورود مرا در لینوکس کجا ذخیره می‌کند؟

در ~/.claude/.credentials.json با مجوز فایل 0600، یا در صورتی که آن متغیر را تنظیم کرده باشید، در CLAUDE_CONFIG_DIR. برخلاف macOS، در لینوکس از keychain استفاده نمی‌شود، بنابراین هر فرآیندی که با کاربر شما اجرا شود می‌تواند فایل را بخواند. بنابراین، یک نسخه پشتیبان /home یا یک image از ماشین، حاوی اطلاعات ورود فعال است: پیش از گرفتن snapshot یا کپی از سیستم، /logout را اجرا کنید. اگر ANTHROPIC_API_KEY نیز در محیط شما تنظیم شده باشد، پس از تأیید شما، اولویت آن نسبت به اطلاعات ورود اشتراک ذخیره‌شده بالاتر است و /status نشان می‌دهد کدام یک فعال است.

آیا اشتراک Claude Pro علاوه بر وب‌اپلیکیشن، CLI را نیز پوشش می‌دهد؟

بله. طرح‌های Pro، Max، Team یا Enterprise به شما امکان می‌دهند با یک حساب کاربری به claude.ai، نسخه دسکتاپ، CLI و افزونه VS Code وارد شوید. طرح رایگان claude.ai شامل Claude Code نمی‌شود، بنابراین CLI ترمینال به یک طرح پولی یا یک حساب Claude Console نیاز دارد. هزینه API به صورت جداگانه بر اساس توکن از حساب Console کسر می‌شود که محصولی متفاوت از اشتراک است.