SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

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

راهنمای اجرای بومی Claude روی Linux شامل نصب نسخه بتا از مخزن apt و ابزار Claude Code CLI. بررسی محدودیت‌های نسخه دسکتاپ در مقایسه با macOS و جزئیات اشتراک‌های لازم.

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

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

سه ویژگی که در macOS و Windows وجود دارند، در نسخه بتای دسکتاپ Linux یا وجود ندارند و یا محدود هستند: قابلیت Computer Use که در آن Claude برنامه‌های روی صفحه شما را کنترل می‌کند، دیکته صوتی و کلید میانبر سراسری Quick Entry. شرکت Anthropic در مستندات خود ذکر کرده است که قابلیت Computer Use و دیکته صوتی در Linux در دسترس نیستند. کلید میانبر Quick Entry در نشست X11 کار می‌کند، اما در نشست بومی Wayland به پورتال GlobalShortcuts محیط دسکتاپ شما نیاز دارد؛ بنابراین بدون آن پورتال، این کلید میانبر در دسترس نخواهد بود. دستور echo $XDG_SESSION_TYPE خروجی x11 یا wayland را چاپ می‌کند و به شما می‌گوید در کدام وضعیت قرار دارید. ابزار CLI دیکته صوتی مخصوص به خود را دارد، بنابراین خلأ دیکته صوتی مربوط به اپلیکیشن دسکتاپ است و نه خود Claude.

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

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

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

نصب را از طریق مخزن apt انجام دهید و نه از طریق فایل .deb دانلودشده. اپلیکیشن لینوکس به‌روزرسان داخلی ندارد، بنابراین نسخه‌های جدید فقط از طریق مدیر بسته به دست شما می‌رسند و ثبت مخزن همان چیزی است که به 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 (ورود یکپارچه) سازمان خود، اگر شرکت شما آن را تنظیم کرده است، وارد شوید. این‌ها دو روش ورودی هستند که در صفحه نصب لینوکس Anthropic ذکر شده‌اند و کاربران API Key را به سمت CLI هدایت می‌کند. Anthropic حالت استقرار دومی را برای همین اپلیکیشن به‌صورت جداگانه مستند کرده است: در صورتی که با یک ارائه‌دهنده استنتاج (Amazon Bedrock، Google Cloud's Agent Platform، Microsoft Foundry، یک درگاه LLM یا مستقیماً Anthropic API) پیکربندی شود، صفحه ورود امکان رد کردن احراز هویت Anthropic را می‌دهد و ارائه‌دهنده، استنتاج و صورت‌حساب مربوط به Chat، Cowork و Code را مدیریت می‌کند. آن مستندات یک مسیر لینوکسی برای پیکربندی مدیریت‌شده یعنی /etc/claude-desktop/managed-settings.json را نام می‌برند و صفحه نصب لینوکس اکنون به مستندات استقرار شخص ثالث لینک می‌دهد. در دستگاه‌هایی که پیکربندی Claude Desktop ندارند، Claude Desktop 3.1623.1 یا جدیدتر در صفحه ورود استاندارد گزینه Use your Claude API account را نیز ارائه می‌دهد که می‌توانید با آن از طریق Claude Console وارد شوید یا بدون پیکربندی قبلی، یک API key وارد کنید. در Claude Desktop 4.23118.0 یا جدیدتر، این لینک در ورود به سیستم کامپیوتری که سازمان در آن حساب‌های دیگر را مسدود کرده است، حتی بدون مدیریت دستگاه، مخفی می‌شود.

وظایف Cowork که روی ماشین شما اجرا می‌شوند از یک ماشین مجازی استفاده می‌کنند، بنابراین نیاز دارند که مجازی‌سازی سخت‌افزاری فعال باشد و کاربر شما در گروه kvm عضو باشد (sudo usermod -aG kvm $USER، سپس خارج شوید و دوباره وارد شوید). همه وظایف Cowork به‌صورت محلی اجرا نمی‌شوند. از 6 اکتبر 2026، وظایف جدید Cowork در طرح‌های Pro، Max و Ultra در فضای ابری Anthropic اجرا می‌شوند و هیچ تنظیمی برای نگه داشتن آن‌ها روی کامپیوتر شما وجود ندارد؛ همچنین سازمان‌های Team و Enterprise که تجربه یکپارچه Chat و Cowork را فعال کرده‌اند نیز وظایف را در فضای ابری اجرا می‌کنند. در این طرح‌ها، ماشین مجازی فقط برای وظایفی اهمیت دارد که قبلاً روی کامپیوتر شما شروع شده‌اند و Anthropic کارهای جدیدی که باید محلی باقی بمانند را به Claude Code در اپلیکیشن دسکتاپ ارجاع می‌دهد.

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 است، یا اگر نشست‌ها به آنجا هدایت شوند، می‌تواند محیط self-hosted متعلق به سازمان خودتان باشد. این سرویس همیشه از اعتبارنامه‌های اشتراک شما استفاده می‌کند.

درک محدودیت‌های مرورگر نکته‌ای کلیدی است. یک مرورگر به‌تنهایی نمی‌تواند فایل‌های موجود روی سرور شما را بخواند یا دستوری روی آن اجرا کند. هر چیزی که با ماشین شما در تعامل باشد، نیازمند نرم‌افزاری روی همان ماشین است؛ یعنی CLI، اپلیکیشن دسکتاپ یا یک runner پیکربندی‌شدهٔ self-hosted. نشست‌های ابری Cowork می‌توانند از طریق اپلیکیشن دسکتاپ، در حالی که باز است، به پوشه‌های محلی متصل دسترسی پیدا کنند.

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

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

  • این ابزار فایل‌های موجود در دایرکتوری کاری شما را می‌خواند و ویرایش می‌کند؛ در حالت Manual، پیش از اعمال هر تغییری از شما اجازه می‌گیرد. حالت Auto، ویرایش‌ها را با بررسی‌های ایمنی در پس‌زمینه اعمال می‌کند و در نشست‌های تعاملی فعلی، تنظیم پیش‌فرض داخلی است، مگر آنکه تنظیمات یا سیاست‌های امنیتی آن را تغییر دهند. برای بررسی دستی اقدامات، با claude --permission-mode default شروع کنید.
  • این ابزار دستورات shell را با سطح دسترسی همان نشست اجرا می‌کند؛ بنابراین می‌تواند یک پروژه را build کند، مجموعه تست‌ها را اجرا کند، یک لاگ را بخواند یا وضعیت یک سرویس را روی همان سرور بررسی کند.
  • این ابزار بدون نیاز به نشست تعاملی اجرا می‌شود: claude -p "read the nginx error log and summarise it" یک پاسخ ارائه می‌دهد و خارج می‌شود؛ این همان چیزی است که در cron job یا pipeline به آن نیاز دارید. در نسخه 2.1.302 یا جدیدتر Claude Code، این اجراها در حالت Manual شروع می‌شوند (اگر سطح دسترسی تعیین نشده باشد) و اقداماتی که نیاز به تأیید دارند، رد می‌شوند مگر اینکه مکانیزم تأییدی ارائه دهید؛ برای اینکه classifier آن‌ها را بررسی کند، --permission-mode auto را ارسال کنید. نحوه نگارش این پاسخ به انتخاب شماست، زیرا یک سبک خروجی، system prompt پشت هر پاسخ را ویرایش می‌کند و می‌تواند خروجی یک اجرای اسکریپتی را مختصر نگه دارد، در حالی که نشست تعاملی توضیحات کامل ارائه می‌دهد.
  • این ابزار سرورهای MCP (پروتکل زمینه مدل) را با claude mcp add متصل می‌کند که ابزارهایی فراتر از سیستم فایل در اختیار مدل قرار می‌دهد.
  • این ابزار در محیط‌هایی که هیچ دسکتاپ گرافیکی ندارند نیز اجرا می‌شود؛ یعنی همان VPS (سرور خصوصی مجازی) که اجاره می‌کنید.

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

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

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

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

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

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

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

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

در npm نسخه 12، مرحله postinstall به‌صورت پیش‌فرض نادیده گرفته می‌شود که باعث می‌شود claude قادر به اجرا نباشد. اگر npm --version با 12 شروع می‌شود، از نصب‌کننده بومی که در بالا ذکر شد استفاده کنید یا پیش از نصب مجدد، Claude Code را به allow-scripts در پیکربندی npm کاربر خود اضافه کنید.

آن را با sudo اجرا نکنید. مستندات نسبت به sudo npm install -g هشدار می‌دهند، زیرا این کار باعث باقی ماندن فایل‌هایی با مالکیت root در پیشوند (prefix) جهانی npm شما می‌شود و در نتیجه، نصب یا به‌روزرسانی بعدی توسط کاربر بدون دسترسی ویژه (unprivileged) به دلیل مشکلات مجوز (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 احراز هویت جداگانه‌ای که بالای اعلان جای‌گذاری (paste) ترمینال نمایش داده می‌شود را کپی کنید. آن URL را در مرورگر کامپیوتر شخصی خود باز کنید. پس از ورود از طریق آن URL، مرورگر به‌جای بازگشت به localhost، یک کد ورود نمایش می‌دهد. آن کد را در ترمینال در اعلان 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 فایل را فقط برای این بوت فعال می‌کند. اگر می‌خواهید پس از راه‌اندازی مجدد نیز فعال باشد، یک خط برای /swapfile به /etc/fstab اضافه کنید. موارد دیگری که باید پیش از اجازه دادن به یک عامل برای اجرای دستورات روی یک سرور زنده محدود کنید، موضوع اجرای ایمن Claude Code روی یک VPS است.

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

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

دو نکته از این موضوع نتیجه می‌شود. نسخه پشتیبان از /home حاوی یک نشست فعال است، بنابراین کپی کردن آن نسخه پشتیبان روی یک ماشین اشتراکی، دسترسی به حساب شما را به هر کسی که بتواند آن را بخواند، می‌دهد. همچنین، ایمیج ماشینی که از سیستمی ساخته شده که در آن لاگین کرده‌اید، آن نشست را به تمام نمونه‌های کپی‌شده از آن منتقل می‌کند. پیش از گرفتن هرگونه 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 تمام موارد را پوشش می‌دهد؟

یک طرح اشتراک پولی، با همان ورود به سیستم، تمام سطوح دسترسی را پوشش می‌دهد؛ البته در برخی طرح‌های Enterprise استثنائاتی وجود دارد. یک حساب Pro، Max، Ultra یا Team شما را در مرورگر به claude.ai، در اپلیکیشن دسکتاپ، در CLI و در افزونه VS Code وارد می‌کند و در هر بار استفاده، همان اشتراک واحد لحاظ می‌شود. این موضوع در مورد حساب‌های Enterprise در طرح‌های جدید یا سلف‌سرویس (خارج از سازمان‌های آماده برای HIPAA) نیز صادق است، که در آن یک لایسنس Enterprise شامل Claude Code می‌شود. طرح‌های قدیمی‌تر Enterprise از انواع لایسنس‌های مجزا استفاده می‌کنند: در آنجا سطوح دسترسی Claude Code نیازمند لایسنس Chat + Claude Code یا لایسنس Premium در طرح‌های قدیمی مبتنی بر لایسنس هستند و لایسنس‌های Chat-only یا Standard شامل آن‌ها نمی‌شوند. سازمان‌های Enterprise آماده برای HIPAA نیز از انواع لایسنس‌های مجزای Chat و Chat + Claude Code استفاده می‌کنند. در یک طرح Enterprise آماده برای HIPAA، استفاده از Claude Code نیازمند لایسنس Chat + Claude Code است و پوشش BAA برای ترمینال و تب Code در Claude Desktop، نیازمند پیکربندی HIPAA یا پوشش مربوط به عدم نگهداری داده (zero data retention) است. افزونه‌های VS Code و JetBrains و نشست‌های ابری (cloud sessions) توسط پیکربندی HIPAA پوشش داده نمی‌شوند. در طرح‌های Pro، Max، Ultra، Team و طرح‌های Enterprise مبتنی بر لایسنس، یک سقف استفاده واحد برای همه آن‌ها وجود دارد؛ بنابراین یک اجرای طولانی CLI روی سرور شما از سهمیه باقی‌مانده اپلیکیشن دسکتاپ کم می‌کند و تشخیص اینکه به کدام محدودیت رسیده‌اید و چه کاری باید انجام دهید، نکته‌ای است که هنگام امتناع هر یک از سطوح دسترسی از انجام کار، باید بررسی شود. یک طرح Enterprise مبتنی بر میزان استفاده، سهمیه مشخصی ندارد که تمام شود: هر سطح دسترسی از همان توکن اول با نرخ API محاسبه می‌شود. طرح رایگان claude.ai شامل دسترسی به Claude Code نمی‌شود. بدون طرح پولی، CLI می‌تواند با یک حساب Claude Console وارد شود یا اگر سازمان شما از Amazon Bedrock، پلتفرم Agent گوگل‌کلاد یا Microsoft Foundry استفاده می‌کند، بدون نیاز به ورود از طریق مرورگر، از طریق آن ارائه‌دهنده احراز هویت شود. با اشتراک claude.ai یا ورود از طریق SSO، بخش‌های Claude Code در اپلیکیشن دسکتاپ نیازمند طرح پولی هستند. حالت شخص ثالث که در بالا توضیح داده شد و در صورت ارائه، گزینه حساب Claude API در دستگاه‌های مدیریت‌نشده، به اپلیکیشن دسکتاپ اجازه می‌دهد تا به‌جای آن از صورت‌حساب Console یا ارائه‌دهنده استفاده کند.

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

قیمت‌ها و محدودیت‌های طرح‌ها بسیار سریع تغییر می‌کنند و نمی‌توان آن‌ها را در اینجا بازگو کرد. دو صفحه اعداد فعلی را دنبال می‌کنند: هزینه واقعی 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)، یا شما روی یک سیستم musl هستید که کتابخانه‌های runtime لازم را ندارد. انتخاب نسخه اشتباه زمانی رخ می‌دهد که بسته‌های 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 باعث می‌شود که یک باگِ رفع‌شده، همچنان حل‌نشده به نظر برسد.

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

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

FAQ

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

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

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

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

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

دستور claude را اجرا کنید و URL احراز هویت جداگانه‌ای که بالای اعلان جای‌گذاری (paste) ترمینال نمایش داده می‌شود را کپی کنید. آن URL را در مرورگر کامپیوتر شخصی خود باز کنید، نه روی سرور. پس از ورود از طریق آن URL، مرورگر به جای بازگشت به localhost، یک کد ورود نمایش می‌دهد. آن کد را در اعلان Paste code here if prompted وارد کنید. برای نشست‌هایی که بدون حضور کاربر شروع می‌شوند، دستور claude setup-token را اجرا کرده و توکن چاپ‌شده را به عنوان CLAUDE_CODE_OAUTH_TOKEN در هر جایی که نیاز است تنظیم کنید.

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

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

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

بله. طرح‌های Pro، Max، Ultra یا Team به شما امکان می‌دهند با یک حساب کاربری به claude.ai، نسخه دسکتاپ، CLI و افزونه VS Code وارد شوید. این موضوع در مورد Enterprise نیز صادق است، با این تفاوت که طرح‌های قدیمی‌تر و طرح‌های سازگار با HIPAA تنها در صورتی شامل Claude Code هستند که صندلی‌های (seats) مربوطه، مانند Chat + Claude Code، را داشته باشند. سازمان‌های سازگار با HIPAA از انواع صندلی‌های جداگانه Chat و Chat + Claude Code استفاده می‌کنند و فقط صندلی‌های Chat + Claude Code شامل Claude Code هستند. طرح رایگان claude.ai شامل Claude Code نمی‌شود، بنابراین CLI ترمینال به یک طرح پولی، یک حساب Claude Console یا یک ارائه‌دهنده ابری که سازمان شما استفاده می‌کند (مانند Amazon Bedrock، پلتفرم Agent گوگل کلاود یا Microsoft Foundry) نیاز دارد. نسخه دسکتاپ از ورود با اشتراک یا SSO و استنتاج (inference) شخص ثالث پیکربندی‌شده پشتیبانی می‌کند؛ در دستگاه‌هایی که پیکربندی Claude Desktop ندارند، نسخه 3.1623.1 یا جدیدتر، گزینه حساب Claude API را نیز ارائه می‌دهد که ورود به Console یا کلید API را بدون پیکربندی قبلی می‌پذیرد. در نسخه 4.23118.0 یا جدیدتر، این لینک در ورود به کامپیوتر که سازمان در آن حساب‌های دیگر را مسدود کرده است، حتی بدون مدیریت دستگاه، مخفی می‌شود. هزینه API به صورت جداگانه بر اساس هر توکن از حساب Console محاسبه می‌شود که محصولی متفاوت از اشتراک است.

آیا این مقاله مفید بود؟