نصب Claude روی لینوکس: اپلیکیشن دسکتاپ و ابزار 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 باید اثر انگشت 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 کند، مجموعه تست‌ها را اجرا کند، یک لاگ را بخواند یا وضعیت یک سرویس را مستقیماً روی همان سیستم بررسی کند.
• بدون نیاز به نشست تعاملی اجرا می‌شود: claude -p "read the nginx error log and summarise it" یک پاسخ چاپ کرده و خارج می‌شود که دقیقاً همان چیزی است که برای cron job یا pipeline به آن نیاز دارید.
• سرورهای MCP (پروتکل زمینه مدل) را با claude mcp add متصل می‌کند که ابزارهایی فراتر از سیستم فایل در اختیار مدل قرار می‌دهد.
• در محیط‌هایی که هیچ دسکتاپ گرافیکی وجود ندارد اجرا می‌شود؛ یعنی همان شرایطی که در هر VPS (سرور مجازی خصوصی) که اجاره می‌کنید با آن مواجه خواهید بود.

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

یکپارچه‌سازی‌های ویرایشگر (Editor integrations) در میانه این دو قرار دارند. افزونه VS Code به نسخه 1.94.0 یا بالاتر نیاز دارد و یک پنل گرافیکی داخل ویرایشگر، همراه با نمایش تفاوت‌ها (diffs) و بررسی طرح (plan review) در اختیار شما می‌گذارد. این افزونه یک نسخه اختصاصی از 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 می‌شود و در نتیجه، نصب یا به‌روزرسانی بعدی توسط کاربر غیرمجاز به دلیل خطای مجوز (permissions) با شکست مواجه خواهد شد. هنگامی که دایرکتوری سراسری 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

برای جدا شدن از نشست از 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

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

سرورهای کوچک با یک مانع دیگر نیز مواجه می‌شوند. نصب برنامه به حدود 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 فایل را فقط برای همین بوت فعال می‌کند. اگر می‌خواهید پس از reboot نیز فعال بماند، یک خط برای /swapfile به فایل /etc/fstab اضافه کنید. موارد دیگری که باید پیش از اجازه دادن به یک عامل برای اجرای دستورات روی سرور زنده ایمن‌سازی شوند، موضوع بخش اجرای امن Claude Code روی یک VPS است.

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

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

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

اولویت اعتبارنامه‌ها برای کسانی که همزمان اشتراک و API key دارند، مشکل‌ساز می‌شود. وقتی ANTHROPIC_API_KEY در shell شما تنظیم شده باشد، 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)، یک کد ورود نمایش می‌دهد، زیرا نمی‌تواند به شنونده callback که 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 کسر می‌شود که محصولی متفاوت از اشتراک است.