Claude sa Linux: Desktop App at CLI Setup

Aling mga bahagi ng Claude ang native na tumatakbo sa Linux ngayon

Tumatakbo ang Claude sa Linux sa apat na magkakahiwalay na surface, at hanggang August 2026 ay gumagana ang lahat ng ito sa karaniwang Ubuntu o Debian machine. Ini-install ang desktop app mula sa apt repository ng Anthropic at nasa beta ito. Ang Claude Code CLI (command line interface) ay isang compiled binary, at tumatakbo ito sa mas maraming distribution kaysa sa desktop app. Browser lang ang kailangan ng web app sa claude.ai, at ang API ay isang HTTPS endpoint na tinatawagan mula sa sarili mong code.

Wala sa Linux desktop beta ang dalawang feature na mayroon sa macOS at Windows: ang Computer Use, kung saan kinokontrol ni Claude ang mga app sa screen mo, at voice dictation. Itinuturing ng dokumentasyon ng Anthropic na hindi pa available sa Linux ang dalawang ito. May sarili nitong voice dictation ang CLI, kaya nasa desktop app ang limitasyon at hindi sa Claude mismo.

Nagbabago ang availability, kaya basahin ang page na ito bilang paglalarawan ng mga surface at tingnan ang kasalukuyang status bago ka magplano batay rito. Nakalista sa huling seksyon ang mga page na dapat tingnan.

I-install ang Claude desktop app sa Ubuntu o Debian

Ang mga dokumentadong requirement ay Ubuntu 22.04 o mas bago, o Debian 12 o mas bago, sa x86_64 (na tinatawag na dpkg na amd64) o arm64. Maaaring gumana ang ibang Debian-based distribution, pero hindi nasubukan. Wala pang package para sa Fedora at RHEL, kaya CLI o browser ang gamitin sa mga iyon.

Mag-install mula sa apt repository sa halip na mula sa na-download na .deb file. Walang sariling updater ang Linux app, kaya sa pamamagitan lamang ng package manager makukuha ang mga bagong version. Ang pag-register ng repository ang nagbibigay-daan para makita ng apt upgrade ang mga ito.

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

Dapat i-print ng gpg --show-keys ang fingerprint na 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Ihambing ito bago i-register ang repository, dahil ang signing key na hindi mo sinuri ay pinagkakatiwalaan mo nang hindi ito nabe-verify. Kung iulat ng gpg na walang valid OpenPGP data ang file, nabigo ang download, at mabibigo rin ang apt update kalaunan na may NO_PUBKEY BAA929FF1A7ECACE.

Ang pag-register ng repository ay isang deb line na isinusulat sa /etc/apt/sources.list.d/claude-desktop.list. Kopyahin ang line na iyon mula sa Linux install page ng Anthropic, code.claude.com/docs/en/desktop-linux, nang eksaktong tulad ng pagkaka-print doon. Ang repository address ang bahaging pinakamalamang magbago sa procedure na ito, at ang line na tina-type mula sa memorya ang dahilan kung bakit haharap ka sa E: Unable to locate package claude-desktop pagkatapos. Basahin ang line bago ito i-paste: ipinapaliwanag ng arch=amd64,arm64 kung bakit walang makita ang apt sa ibang architecture, at tumutukoy ang signed-by= sa keyring file na sinuri mo, kaya nalilimitahan ang key na iyon sa repository na ito sa halip na pagkatiwalaan ito para sa lahat ng binabasa ng apt.

sudo apt update && sudo apt install claude-desktop

Simulan ito mula sa application launcher, o patakbuhin ang claude-desktop sa terminal. Mag-sign in gamit ang iyong claude.ai account, o sa pamamagitan ng SSO (single sign-on) ng organisasyon kung na-configure ito ng inyong kumpanya. Hindi tumatanggap ang desktop app ng Claude Console API key. Feature ng CLI ang key-based authentication.

Ibig sabihin ng E: Unable to locate package claude-desktop ay hindi nabasa ng apt ang repository. Dapat ipakita ng cat /etc/apt/sources.list.d/claude-desktop.list ang isinulat mong deb line, at dapat i-print ng dpkg --print-architecture ang amd64 o arm64, dahil walang package na inilalathala para sa ibang architecture. Darating ang mga update kasama ng iba pang system update, mula sa sudo apt update && sudo apt upgrade.

Mga bagay na sa browser lang makikita

Gumagana ang claude.ai sa anumang kasalukuyang browser at sa anumang distribution. Kaya ito ang sagot para sa Fedora, RHEL, Arch, openSUSE, at iba pang walang package. Nakukuha rin sa browser ang Claude Code on the web. Tumatakbo ang session nito sa cloud ng Anthropic sa halip na sa iyong machine, at palagi nitong ginagamit ang credentials ng iyong subscription.

Mahalagang maunawaan ang limitasyon ng browser. Hindi mababasa ng cloud session ang mga file sa sarili mong server at hindi ito makakapagpatakbo ng command doon. Kailangang may software sa mismong machine para sa anumang kumokonekta rito. Ibig sabihin, kailangan mong gamitin ang CLI o desktop app.

Ang ibinibigay ng CLI na wala sa web app

Patakbuhin ang claude sa isang directory at gagana ito sa directory na iyon. Iyan ang pagkakaiba, at dito nagmumula ang iba pa.

• Binabasa at ine-edit nito ang mga file sa working directory mo, at ipinapakita sa iyo ang bawat edit bago ito ilapat.
• Pinapatakbo nito ang mga shell command na inaprubahan mo, kaya maaari itong mag-build ng project, magpatakbo ng test suite, magbasa ng log, o magsuri ng service mismo sa server.
• Gumagana ito nang walang interactive session: nagpi-print ang claude -p "read the nginx error log and summarise it" ng isang sagot at nag-e-exit, na siyang ginagamit mula sa cron job o pipeline. Ikaw ang nagtatakda kung paano magiging hitsura ang sagot, dahil ang output style ay nag-e-edit sa system prompt sa likod ng bawat reply at maaaring panatilihing maikli ang scripted run habang ipinapaliwanag ng interactive session ang sarili nito.
• Kumokonekta ito sa mga MCP (model context protocol) server gamit ang claude mcp add, kaya nagkakaroon ang model ng mga tool na higit pa sa filesystem.
• Gumagana ito kahit walang graphical desktop, gaya sa bawat VPS (virtual private server) na iyong uupahan.

Iyan ang dahilan kung bakit mahalaga ang CLI sa isang server guide. May SSH (secure shell) at wala nang iba ang isang rented server, kaya ang terminal lamang ang surface na maaaring gamitin doon. May sarili itong mga patakaran kapag sa ganitong paraan ito pinapatakbo. Saklaw ito nang buo ng pagpapatakbo ng Claude Code sa VPS sa loob ng tmux, habang tinatalakay naman ng paggamit ng Claude para sa pang-araw-araw na sysadmin work ang mga trabahong nararapat ipagawa rito.

Nasa pagitan ng dalawang ito ang mga editor integration. Nangangailangan ang VS Code extension ng VS Code 1.94.0 o mas bago at nagbibigay ito ng graphical panel sa loob ng editor, kasama ang diffs at plan review. May kasama itong pribadong kopya ng CLI para sa panel na iyon at hindi nito inilalagay ang claude sa iyong PATH, kaya kailangan pa rin ang standalone install kapag itina-type ang claude sa integrated terminal. Ini-install ng mga editor na nakabatay sa VS Code ang parehong extension mula sa Open VSX registry, at mayroon ding JetBrains plugin.

Kailangan ba ng Node.js para patakbuhin ang Claude Code sa Linux?

Hindi kung gagamitin ang inirerekomendang installation. Nagda-download ang native installer ng compiled binary, at hindi tumatakbo ang binary na iyon sa Node.js.

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

Dapat mag-print ang claude --version ng version number gaya ng 2.1.211 (Claude Code). Kung may mukhang mali, patakbuhin ang claude doctor. Nagpi-print ito ng read-only diagnostics tungkol sa installation at mga settings file mo nang hindi nagsisimula ng session.

Mahalaga lamang ang Node.js sa npm route. Simula sa package version 2.1.198, nangangailangan ang npm package ng Node.js 22 o mas bago. Sa mas lumang Node.js, nagpi-print ang npm ng EBADENGINE warning sa halip na mag-fail. Ito ay dahil kinukuha ng package ang parehong native binary bilang per-platform dependency at inililink ito sa tamang lokasyon.

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

Huwag itong patakbuhin gamit ang sudo. Nagbababala ang documentation laban sa sudo npm install -g dahil nag-iiwan ito ng mga file na pagmamay-ari ng root sa global npm prefix. Dahil dito, nagfa-fail ang susunod na unprivileged install o update dahil sa permissions. Kapag hindi writable ang global npm directory, hindi na gumagana ang background auto-update, at inililista ng claude doctor ang mga paraan para ayusin ito.

Naglalathala rin ang Anthropic ng mga signed package repository para sa Debian, Fedora, RHEL, at Alpine. Kaya gumagana ang sudo apt install claude-code nang halos katulad ng desktop package, at mayroon itong sariling signing key sa https://downloads.claude.ai/keys/claude-code.asc.

Mag-install per user o system wide?

Ang native installer ay nag-i-install per user. Naglalagay ito ng launcher sa ~/.local/bin/claude bilang symlink papunta sa ~/.local/share/claude/versions/, hindi nangangailangan ng root, at awtomatikong nag-a-update sa background. May hiwalay na kopya at hiwalay na version ang bawat user sa machine.

Ang pag-install gamit ang package manager ay system wide. Isang binary ang ginagamit ng lahat ng user, nangangailangan ito ng root, at hindi ito awtomatikong nag-a-update sa pamamagitan ng Claude Code. I-upgrade ito gamit ang sudo apt update && sudo apt upgrade claude-code, ang command na ginagamit mo na para sa iba pang software sa server.

Piliin ang per-user install sa machine na ginagamit mo bilang sarili mong user. Saklaw nito ang karamihan ng VPS work. Piliin ang package install sa shared server o machine image kung gusto mo ng iisang version para sa lahat at gusto mong ikaw ang magtakda kung kailan ito mag-a-update. Sa native install, dalawang setting sa ~/.claude/settings.json ang tumutukoy sa paraan ng mga update:

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

Ang stable channel ay sumusunod sa release na humigit-kumulang isang linggo na ang edad at lumalaktaw sa mga release na may malalaking regression. Pinahihinto lamang ng DISABLE_AUTOUPDATER ang background check, kaya gumagana pa rin ang claude update at ikaw pa rin ang nagkokontrol kung kailan mai-install ang bagong version. Mahalaga ito sa server kung saan may matagal na job na tumatakbo nang unattended at ayaw mong magbago ang binary habang ginagamit ito.

Mag-log in sa pamamagitan ng SSH, at panatilihing buhay ang session

Dalawang problemang partikular sa Linux ang lumalabas sa unang paggamit mo ng CLI sa isang inuupahang server. Nangangailangan ng browser ang proseso ng pag-login, pero walang browser ang server. Kapag naputol ang SSH connection, kasama nitong natitigil ang kasalukuyang gawain.

Nilulutas ng tmux ang pangalawang problema. Nakaugnay ang tmux session sa tmux server sa remote machine, hindi sa connection mo. Kaya patuloy na tumatakbo ang proseso kahit maputol ang link.

tmux new -s claude
claude

Mag-detach gamit ang Ctrl-b at pagkatapos ay d. Bumalik paglaon gamit ang tmux attach -t claude.

Ang pag-login ang unang problema. Patakbuhin ang claude upang mag-print ito ng authorisation URL. Buksan ang URL na iyon sa browser sa sarili mong computer. Pagkatapos mong mag-sign in, magpapakita ang browser ng login code sa halip na mag-redirect pabalik. Nangyayari ito dahil hindi maabot ng browser sa laptop mo ang callback server na sinimulan ng Claude Code sa loopback address ng remote machine. I-paste ang code sa terminal sa prompt na Paste code here if prompted. Pagkatapos, iuulat ng terminal ang Login successful.

Para sa session na kailangang magsimula nang walang nagbabantay, binubuksan ng claude setup-token ang parehong browser authorisation at ipinapakita sa terminal ang isang OAuth token na valid nang isang taon. Hindi nito sine-save ang token kahit saan, kaya kopyahin ito at itakda kung saan mo ito kailangan.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Kailangan ng token na ito ng paid plan, at maaari lamang itong gumawa ng model requests. Ituring ito na parang password na may bisa nang isang taon. Ang tamang pag-iimbakan nito at ang paraan upang mapigilan ang agent na basahin ito pabalik ay tinatalakay sa pag-iingat sa mga secret upang hindi maabot ng AI agents.

May isa pang limitasyon ang maliliit na server. Nangangailangan ang installation ng humigit-kumulang 512 MB na libreng memory, at ang nakadokumentong hardware requirement para patakbuhin ito ay 4 GB ng RAM o higit pa. Kaya sa isang 1 GB instance, tinatapos ng kernel out-of-memory killer ang installation:

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

Magdagdag ng swap, at patakbuhin muli ang installer. Ang swap ay disk space na ginagamit ng kernel bilang overflow memory. Mas mabagal ito kaysa RAM, pero sapat ito upang matapos ang installation.

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

Ino-on ng swapon ang file para sa boot na ito lamang. Magdagdag ng linya para sa /swapfile sa /etc/fstab kung gusto mong bumalik ito pagkatapos ng reboot. Ang iba pang dapat i-lock down bago mo payagang magpatakbo ang agent ng mga command sa live server ay tinatalakay sa ligtas na pagpapatakbo ng Claude Code sa VPS.

Saan nakaimbak ang iyong Claude credentials sa Linux

Sa Linux, isinusulat ng /login ang credential sa ~/.claude/.credentials.json gamit ang file mode na 0600. Inilalagay ng macOS ang parehong credential sa encrypted Keychain, kaya hindi mailalapat dito ang nakasanayan mo sa Mac: sa Linux, plain file ang token sa iyong home directory, at mababasa ito ng bawat process na tumatakbo bilang iyong user. Ang pagtatakda ng CLAUDE_CONFIG_DIR ang naglilipat sa file sa directory na iyon.

Dalawang bagay ang resulta nito. Naglalaman ng aktibong login ang backup ng /home, kaya kapag kinopya mo ang backup sa shared machine, naibibigay mo ang account mo sa sinumang makakabasa nito. At ang machine image na ginawa mula sa isang machine kung saan nag-login ka ay nagdadala ng login na iyon sa bawat instance na magmumula sa clone nito. Patakbuhin ang /logout bago ka gumawa ng snapshot.

Nagiging sanhi ng problema sa credential precedence ang sabay na pagkakaroon ng subscription at API key. Kapag nakatakda ang ANTHROPIC_API_KEY sa shell mo, gagamitin ito ng Claude Code kapag inaprubahan mo ito, kaya hindi magagamit ang subscription mo habang sinisingil ang key bawat token. Ipinapakita ng /status kung aling credential ang aktibo, at ibinabalik ka ng unset ANTHROPIC_API_KEY sa subscription login.

Nag-e-expire ang mga login. Sa loob ng tatlong araw bago ang expiry, mababasa sa startup line ang Your login expires in 3 days, at hindi kailanman hinaharang ng warning na iyon ang isang request. Pagkatapos ng expiry, mabibigo ang bawat request gamit ang Login expired · Please run /login. Alamin ito bago ka mag-iwan ng unattended session na tumatakbo sa buong weekend, dahil titigil ang ganitong session sa pag-usad at hindi ito makakabawi nang mag-isa.

Sapat ba ang isang Claude subscription para sa lahat?

Saklaw ng isang bayad na plan ang lahat ng interface gamit ang iisang login. Sa Pro, Max, Team, o Enterprise account, makakapag-sign in ka sa claude.ai gamit ang browser, sa desktop app, sa CLI, at sa VS Code extension. Iisa ang subscription sa bawat isa. Iisa rin ang usage allowance para sa lahat ng ito. Kaya kapag mahaba ang CLI run sa server mo, mababawasan ang natitirang allowance ng desktop app. Kapag may interface na tumangging magpatuloy, kailangan mong alamin kung aling limit window ang naabot mo at kung ano ang dapat gawin. Hindi kasama sa libreng claude.ai plan ang access sa Claude Code. Dahil dito, kailangan ng bayad na plan o Claude Console account para sa CLI at sa mga bahagi ng desktop app na gumagamit ng Claude Code.

Ibang produkto ang API at iba rin ang billing nito. Sa Console account, bawat token na aktuwal mong ipinapadala ang sinisingil. Mas angkop ito sa serbisyong binubuo mo kaysa sa direktang pag-type sa terminal. Kapag itinakda mo ang ANTHROPIC_API_KEY, ililipat ang CLI sa ganitong billing path. Pinipili mo ito; hindi ito fallback.

Madalas magbago ang mga presyo at limit ng plan, kaya hindi na namin uulitin dito ang kasalukuyang halaga. Sinusubaybayan ng dalawang page ang pinakabagong numero: kung magkano talaga ang Claude Code at kung aling Claude plan ang kailangan mo. Kung pinag-iisipan mo ang per-token billing kumpara sa buwanang plan, ipinapaliwanag ng API kumpara sa subscription kung saan nagkakaroon ng break-even.

Ang mga error sa pag-install na aktuwal mong makikita

bash: claude: command not found agad matapos ang matagumpay na pag-install. Nasa ~/.local/bin/claude ang binary, ngunit wala ang directory na iyon sa search path ng shell mo. Kumpirmahin ito gamit ang echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"; walang inilalabas ang command kapag nawawala ang entry. Ayusin ito para sa bash gamit ang echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, pagkatapos ay patakbuhin ang source ~/.bashrc. Hindi kailanman ginagawa ng hiwalay na pag-install ng VS Code extension ang file na iyon, dahil nasa loob ng extension directory ang kopya ng CLI na ginagamit nito.

Error loading shared library libstdc++.so.6. Pinili ng installer ang musl build para sa glibc system. Nangyayari ito kapag may naka-install na musl cross-compilation package at mali ang nababasang resulta ng detection. Patakbuhin ang ldd --version 2>&1 | head -1: ang output na may pangalan na GNU libc o GLIBC ay nangangahulugang glibc ang system mo at maling binary ang natanggap mo. Alisin ang installation at patakbuhin muli ang installer. Sa Alpine at iba pang musl system, kabaligtaran ang dapat gawin, apk add libgcc libstdc++ ripgrep.

Dalawang kopya ng claude sa iisang server. Inililista ng which -a claude ang bawat tugma sa PATH mo. Ang native install ay symlink mula ~/.local/bin/claude papunta sa ~/.local/share/claude/versions/, ang legacy local npm install ay nasa ilalim ng ~/.claude/local/, at ipinapakita ng npm -g ls @anthropic-ai/claude-code ang global npm install. Alisin ang mga kopyang hindi mo kailangan, dahil ang lumang kopya na mas nauuna sa PATH mo ang nagiging dahilan kung bakit mukhang hindi naayos ang isang bug.

Saan susuriin ang kasalukuyang estado

• Status, requirements, at mga command sa pag-install para sa Linux desktop: code.claude.com/docs/en/desktop-linux
• Mga supported distribution at lahat ng paraan ng pag-install para sa CLI: code.claude.com/docs/en/setup
• Mga platform na may app na maaaring i-download: claude.com/download
• Kung ano ang kasama sa bawat plan at kung magkano ang bayad: claude.com/pricing

Snapshot ng Agosto 2026 ang bawat version number at petsa sa gabay na ito. Ang nananatiling pareho ay ang istruktura: apat na surface, isang login para sa mga may bayad na surface, at isang desisyon kung para sa iyong user lang ang CLI o para sa buong machine.

FAQ

May Claude desktop app ba para sa Linux?

Oo. Noong August 2026, nasa beta ito at sinusuportahan nito ang Ubuntu 22.04 o mas bago at Debian 12 o mas bago sa amd64 o arm64. I-install ito gamit ang sudo apt install claude-desktop matapos idagdag ang apt repository at signing key ng Anthropic, upang matanggap ang mga bagong bersyon kasama ng karaniwang system upgrades. Pareho ang mga tab ng Linux build at macOS app, kabilang ang Claude Code tab. Hindi pa available sa Linux build ang Computer Use at voice dictation. Wala ring package para sa Fedora at RHEL, kaya gamitin ang CLI o ang claude.ai sa browser sa mga distribution na iyon.

Kailangan ba ang Node.js para patakbuhin ang Claude Code sa Linux?

Hindi para sa inirerekomendang installation. Nagda-download ang curl -fsSL https://claude.ai/install.sh | bash ng compiled binary na hindi gumagamit ng Node.js habang tumatakbo. Kailangan lamang ang Node.js kapag ini-install mo ang npm package. Sa version 2.1.198, nangangailangan ito ng Node.js 22 o mas bago. Sa mas lumang Node.js, nagpi-print ang npm ng EBADENGINE warning, ngunit natatapos pa rin ang installation dahil kinukuha ang parehong native binary bilang per-platform dependency. Huwag itong i-install gamit ang sudo npm install -g dahil nag-iiwan ito ng mga file na pagmamay-ari ng root sa iyong npm prefix at nakakasira sa mga susunod na update.

Paano ako magla-log in sa Claude Code gamit ang SSH?

Patakbuhin ang claude at magpi-print ito ng authorisation URL. Buksan ang URL na iyon sa browser sa sarili mong computer, hindi sa server. Pagkatapos mong mag-sign in, magpapakita ang browser ng login code sa halip na mag-redirect. Hindi nito maabot ang callback listener na sinimulan ng Claude Code sa loopback address ng remote machine. I-paste ang code sa Paste code here if prompted prompt. Para sa mga session na nagsisimula nang walang user na naroroon, patakbuhin ang claude setup-token at itakda ang naka-print na token bilang CLAUDE_CODE_OAUTH_TOKEN saanman ito kinakailangan.

Saan iniimbak ng Claude Code ang login ko sa Linux?

Sa ~/.claude/.credentials.json na may file mode na 0600, o sa ilalim ng CLAUDE_CONFIG_DIR kapag itinakda mo ang variable na iyon. Walang keychain na ginagamit sa Linux, hindi tulad sa macOS. Dahil dito, mababasa ng anumang process na tumatakbo bilang iyong user ang file. Kaya ang /home backup o machine image ay maaaring maglaman ng gumaganang login. Patakbuhin ang /logout bago ka gumawa ng snapshot o kumopya ng system. Kung nakatakda rin ang ANTHROPIC_API_KEY sa iyong environment, ito ang mauunang gamitin kaysa sa nakaimbak na subscription login kapag inaprubahan mo ito. Ipinapakita ng /status kung alin ang aktibo.

Saklaw ba ng Claude Pro subscription ko ang CLI pati ang web app?

Oo. Ang Pro, Max, Team, o Enterprise plan ay nagla-log in sa iyo sa claude.ai, desktop app, CLI, at VS Code extension gamit ang iisang account. Hindi kasama sa libreng claude.ai plan ang Claude Code, kaya nangangailangan ang terminal CLI ng paid plan o Claude Console account. Hiwalay ang singil sa API kada token mula sa Console account. Ibang produkto ang Console account kumpara sa subscription.