Paano gamitin ang Claude sa Linux: Desktop App at CLI

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

Ang Claude sa Linux ay tumatakbo sa apat na magkakahiwalay na surface, at simula noong Agosto 2026, gumagana ang lahat ng apat sa isang ordinaryong Ubuntu o Debian machine. Ang desktop app ay ini-install mula sa apt repository ng Anthropic at nasa beta stage pa ito. Ang Claude Code CLI (command line interface) ay isang compiled binary, at tumatakbo ito sa mas maraming distribution kumpara sa desktop app. Ang web app sa claude.ai ay nangangailangan lamang ng browser, at ang API ay isang HTTPS endpoint na tinatawagan mo mula sa sarili mong code.

May dalawang feature na available sa macOS at Windows ang wala sa Linux desktop beta: ang Computer Use, kung saan kinokontrol ni Claude ang mga app sa iyong screen, at ang voice dictation. Dokumentado ng Anthropic na hindi pa available ang mga ito sa Linux. Ang CLI ay may sarili nitong voice dictation, kaya ang kakulangan ay nasa desktop app at hindi sa mismong Claude.

Nagbabago ang availability, kaya basahin ang page na ito bilang paglalarawan sa mga surface at i-check ang kasalukuyang status bago ka magplano base rito. Ang huling section ay naglilista ng mga page na dapat i-check.

I-install ang Claude desktop app sa Ubuntu o Debian

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

Mag-install mula sa apt repository sa halip na mula sa na-download na .deb file. Ang Linux app ay walang sariling updater, kaya ang mga bagong version ay makakarating lang sa iyo sa pamamagitan ng iyong package manager, at ang pag-register ng repository ang nagpapahintulot sa apt upgrade na makita 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. I-compare ito bago mo i-register ang repository, dahil ang signing key na hindi mo chineck ay key na pinagkakatiwalaan mo nang bulag. Kung mag-report ang gpg na ang file ay walang valid OpenPGP data, nabigo ang download, at ang apt update ay magkakaroon ng error mamaya gamit ang NO_PUBKEY BAA929FF1A7ECACE.

Ang pag-register ng repository ay isang deb line na isinusulat sa /etc/apt/sources.list.d/claude-desktop.list. I-copy ang linyang iyon mula sa Linux install page ng Anthropic, code.claude.com/docs/en/desktop-linux, nang eksakto kung paano ito nakasulat doon. Ang repository address ang bahagi ng procedure na ito na pinakamadalas magbago, at ang linyang tinype mula sa memorya ang dahilan kung bakit ka mapapatitig sa E: Unable to locate package claude-desktop pagkatapos. Basahin ang linya bago mo ito i-paste: ang arch=amd64,arm64 ang dahilan kung bakit walang mahanap ang apt sa ibang architecture, at ang signed-by= ay nakaturo sa keyring file na chineck mo lang, na naglilimita sa key na iyon sa repository na ito sa halip na pagkatiwalaan ito para sa lahat ng iba pang binabasa ng apt.

sudo apt update && sudo apt install claude-desktop

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

Ang E: Unable to locate package claude-desktop ay nangangahulugang hindi nabasa ng apt ang repository. Dapat ipakita ng cat /etc/apt/sources.list.d/claude-desktop.list ang deb line na isinulat mo, at dapat i-print ng dpkg --print-architecture ang amd64 o arm64, dahil walang mga package na naka-publish para sa ibang architecture. Ang mga update ay darating kasabay ng iba pang bahagi ng iyong system, mula sa sudo apt update && sudo apt upgrade.

Ang mga bagay na sa browser lang umiiral

Ang claude.ai ay gumagana sa anumang kasalukuyang browser sa kahit anong distribution, kaya ito ang sagot para sa Fedora, RHEL, Arch, openSUSE, at iba pa na walang package. Nakukuha rin ng browser ang Claude Code sa web, kung saan ang session ay tumatakbo sa cloud ng Anthropic sa halip na sa iyong machine, at palagi nitong ginagamit ang iyong subscription credentials.

Ang limitasyon ng browser ang mahalagang maintindihan. Ang isang cloud session ay hindi makakabasa ng mga file sa sarili mong server o makakapagpatakbo ng command dito. Ang anumang bagay na may kinalaman sa iyong machine ay nangangailangan ng software sa machine na iyon, na nangangahulugang kailangan ang CLI o ang desktop app.

Ang mga naibibigay ng CLI na wala sa web app

Simulan ang claude sa isang directory at gagana ito sa directory na iyon. Iyan ang pagkakaiba, at ang lahat ng iba pa ay sumusunod mula rito.

• Binabasa at ine-edit nito ang mga file sa iyong working directory, at ipinapakita sa iyo ang bawat edit bago ito ilapat.
• Nagpapatakbo ito ng mga shell command na ia-approve mo, kaya kaya nitong mag-build ng project, magpatakbo ng test suite, magbasa ng log, o mag-inspect ng service sa mismong box.
• Tumatakbo ito nang walang interactive session: ang claude -p "read the nginx error log and summarise it" ay nagpi-print ng isang sagot at mag-e-exit, na siyang ginagamit mo mula sa isang cron job o pipeline.
• Ikinokonekta nito ang mga MCP (model context protocol) server gamit ang claude mcp add, na nagbibigay sa model ng mga tool na higit pa sa filesystem.
• Tumatakbo ito kung saan walang graphical desktop, na siyang sitwasyon ng bawat VPS (virtual private server) na uupahan mo.

Ang huling punto na iyon ang dahilan kung bakit mahalaga ang CLI sa isang server guide. Ang isang inuupahang server ay may SSH (secure shell) lamang at wala nang iba, kaya ang terminal ang tanging interface na makakasama mo. Ang pagpapatakbo nito sa ganoong paraan ay may sariling mga panuntunan, na sakop nang buo ng pagpapatakbo ng Claude Code sa isang VPS sa loob ng tmux, at ang paggamit ng Claude para sa pang-araw-araw na sysadmin work ay sumasaklaw sa mga gawaing sulit na ipasa rito.

Ang mga editor integration ay nasa pagitan ng dalawa. Ang VS Code extension ay nangangailangan ng VS Code 1.94.0 o mas bago at nagbibigay sa iyo ng graphical panel sa loob ng editor, na may mga diff at plan review. Naglalaman ito ng sariling private copy ng CLI para sa panel na iyon at hindi nito inilalagay ang claude sa iyong PATH, kaya ang pag-type ng claude sa integrated terminal ay nangangailangan pa rin ng standalone install. Ang mga editor na binuo sa VS Code ay nag-i-install ng 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 ang inirerekomendang paraan ng pag-install ang gagamitin. Ang native installer ay nagda-download ng compiled binary, at ang binary na iyon ay hindi tumatakbo 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, na naglalabas ng read-only diagnostics tungkol sa install at sa iyong mga settings file nang hindi nagsisimula ng session.

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

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

Huwag itong patakbuhin gamit ang sudo. Nagbabala ang dokumentasyon laban sa sudo npm install -g dahil nag-iiwan ito ng mga file na pagmamay-ari ng root sa iyong global npm prefix, kaya magkakaroon ng permission error sa susunod na unprivileged install o update. Kapag hindi writable ang npm global directory, titigil ang background auto-update at ililista ng claude doctor ang mga solusyon.

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 katulad ng desktop package, na may sariling signing key sa https://downloads.claude.ai/keys/claude-code.asc.

Dapat bang per-user o system-wide ang installation?

Ang native installer ay isang per-user install. Naglalagay ito ng launcher sa ~/.local/bin/claude bilang isang symlink sa ~/.local/share/claude/versions/, hindi nangangailangan ng root, at kusa itong nag-a-update sa background. Ang bawat user sa machine ay makakakuha ng hiwalay na kopya sa magkaibang bersyon.

Ang installation sa pamamagitan ng package manager ay system-wide. Isang binary lang ang nagsisilbi sa lahat ng user, nangangailangan ito ng root, at hindi ito kusa nag-a-update sa pamamagitan ng Claude Code. Ina-upgrade mo ito gamit ang sudo apt update && sudo apt upgrade claude-code, ang parehong command na ginagamit mo para sa lahat ng iba pang software sa box.

Piliin ang per-user install sa machine kung saan ikaw lang ang naka-log in, na sumasaklaw sa karamihan ng trabaho sa VPS. Piliin ang package install sa isang shared server o sa isang machine image, kung saan gusto mo ng iisang bersyon para sa lahat at gusto mong kontrolado mo ang schedule ng pag-update. Sa isang native install, dalawang settings sa ~/.claude/settings.json ang nagtatakda kung paano gumagana ang mga update:

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

Ang stable channel ay sumusunod sa isang release na halos isang linggo na ang tanda at nilalakpasan ang mga release na may malalaking regression. Ang DISABLE_AUTOUPDATER ay humihinto lamang sa background check, kaya gumagana pa rin ang claude update at hawak mo ang kontrol kung kailan darating ang bagong bersyon. Mahalaga ito sa isang server kung saan may tumatakbong mahabang job nang walang nagbabantay at mas gusto mong hindi magbago ang binary habang tumatakbo ito.

Mag-log in via SSH at panatilihing buhay ang session

Dalawang problema na partikular sa Linux ang lumilitaw sa unang beses mong patakbuhin ang CLI sa isang rented server. Ang login flow ay nangangailangan ng browser, ngunit wala nito ang server. Ang koneksyong SSH na napuputol ay nagreresulta sa pagkawala ng iyong kasalukuyang trabaho.

Nilulutas ng tmux ang pangalawang problema. Ang isang tmux session ay pagmamay-ari ng tmux server sa remote machine, hindi ng iyong koneksyon, kaya kahit maputol ang link, mananatiling tumatakbo ang proseso.

tmux new -s claude
claude

Mag-detach gamit ang Ctrl-b at pagkatapos ay d, at bumalik mamaya gamit ang tmux attach -t claude.

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

Para sa isang session na kailangang magsimula nang walang nakabantay, binubuksan ng claude setup-token ang parehong browser authorisation at nagpi-print ng isang taong OAuth token sa terminal. Hindi nito sine-save ang token kahit saan, kaya kopyahin ito at ilagay kung saan mo ito kailangan.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Ang token na iyon ay nangangailangan ng paid plan at maaari lamang gumawa ng mga model request. Ituring ito bilang isang password na may habang-buhay na isang taon. Kung saan ito itatago, at kung paano pipigilan ang isang agent na basahin ito, ay ang paksa ng pagtatago ng mga sikreto mula sa mga AI agent.

Ang maliliit na server ay nakakaranas ng isa pang hadlang. Ang pag-install ay nangangailangan ng humigit-kumulang 512 MB ng libreng memory, at ang dokumentadong 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 pag-install:

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, pagkatapos ay patakbuhin muli ang installer. Ang swap ay disk space na ginagamit ng kernel bilang overflow memory. Ito ay mas mabagal kaysa sa RAM, at sapat na ito para tapusin ang isang install.

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

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

Kung saan nakatira 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 ang nakasanayan mo sa Mac ay hindi maililipat: sa Linux, ang token ay isang plain file sa iyong home directory, at mababasa ito ng bawat process na tumatakbo bilang iyong user. Ang pag-set ng CLAUDE_CONFIG_DIR ay naglilipat sa file sa ilalim ng directory na iyon.

Dalawang bagay ang resulta nito. Ang backup ng /home ay naglalaman ng live login, kaya ang pag-copy ng backup na iyon sa isang shared machine ay nagbibigay ng access sa iyong account sa sinumang makakabasa nito. At ang machine image na binuo mula sa isang box kung saan ka naka-log in ay magdadala ng login na iyon sa bawat instance na i-clone mula rito. Patakbuhin ang /logout bago ka mag-snapshot ng kahit ano.

Ang credential precedence ay nakakalito sa mga taong may subscription at API key nang sabay. Kapag ang ANTHROPIC_API_KEY ay naka-set sa iyong shell, gagamitin ito ng Claude Code kapag inaprubahan mo, kaya hindi magagamit ang iyong subscription habang ang key ay nagbi-bill per token. Ipinapakita ng /status kung aling credential ang active, 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 ang babalang iyon ay hindi humaharang sa request. Pagkatapos ng expiry, mabibigo ang bawat request na may Login expired · Please run /login. Alamin ito bago ka mag-iwan ng unattended session na tumatakbo sa katapusan ng linggo, dahil ang ganitong session ay hihinto sa pag-usad at hindi makaka-recover nang kusa.

Sapat na ba ang isang Claude subscription para sa lahat?

Ang isang paid plan ay sumasaklaw sa lahat ng interface gamit ang iisang login. Ang Pro, Max, Team, o Enterprise account ay nagbibigay-daan sa iyo na mag-sign in sa claude.ai sa browser, sa desktop app, sa CLI, at sa VS Code extension, at iisang subscription lang ito para sa lahat. Iisang usage allowance lang din ang ibinabahagi ng mga ito, kaya ang mahabang CLI run sa iyong server ay mababawasan ang natitirang limit ng desktop app, at ang kung anong limit window ang naabot mo at ano ang dapat gawin ang kailangang suriin kapag nagsimula nang tumanggi ang alinman sa mga interface. Ang libreng claude.ai plan ay hindi kasama ang access sa Claude Code, kaya ang CLI at ang mga bahagi ng Claude Code sa desktop app ay nangangailangan ng paid plan o Claude Console account.

Ang API ay ibang produkto na may ibang billing. Ang Console account ay naniningil kada token batay sa aktwal na ipinapadala mo, na angkop para sa serbisyong dine-develop mo sa halip na ikaw ang nagta-type sa terminal. Ang pag-set ng ANTHROPIC_API_KEY ay naglilipat sa CLI sa billing path na iyon, at ito ay desisyong gagawin mo, hindi isang fallback.

Ang mga presyo at limitasyon ng plan ay madalas magbago kaya hindi na ito ilalagay dito. Dalawang pahina ang nagbabantay sa kasalukuyang mga numero: kung magkano talaga ang Claude Code at kung anong Claude plan ang kailangan mo. Kung pinagtitimbang mo ang per-token billing laban sa monthly plan, ang paghahambing ng API sa subscription ay nagpapaliwanag kung saan ang break-even point.

Ang mga install error na madalas mong makita

bash: claude: command not found pagkatapos mismo ng matagumpay na install. Ang binary ay nasa ~/.local/bin/claude at ang directory na iyon ay wala sa search path ng iyong shell. Kumpirmahin ito gamit ang echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", na walang ipi-print kung wala ang entry. Ayusin ito para sa bash gamit ang echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, pagkatapos ay patakbuhin ang source ~/.bashrc. Ang pag-install ng VS Code extension nang mag-isa ay hindi gumagawa ng file na iyon, dahil ang extension ay nagtatago ng sarili nitong kopya ng CLI sa loob ng extension directory.

Error loading shared library libstdc++.so.6. Pinili ng installer ang musl build para sa isang glibc system. Nangyayari ito kapag may mga musl cross-compilation package at maling nabasa ang mga ito ng detection. Patakbuhin ang ldd --version 2>&1 | head -1: ang output na may GNU libc o GLIBC ay nangangahulugang ikaw ay nasa glibc at maling binary ang nakuha mo, kaya alisin ang install at patakbuhin muli ang installer. Sa Alpine at iba pang musl system, ang solusyon ay ang kabaligtaran, apk add libgcc libstdc++ ripgrep.

Dalawang kopya ng claude sa iisang box. Inililista ng which -a claude ang bawat match sa iyong PATH. Ang native install ay isang symlink mula sa ~/.local/bin/claude patungo sa ~/.local/share/claude/versions/, ang legacy local npm install ay nasa ilalim ng ~/.claude/local/, at ang npm -g ls @anthropic-ai/claude-code ang nagpapakita ng global npm install. Alisin ang mga hindi mo kailangan, dahil ang lumang kopya na nauna sa iyong PATH ang dahilan kung bakit mukhang hindi naayos ang isang bug kahit na-fix na ito.

Saan titingnan ang kasalukuyang estado

• Status ng Linux desktop, mga requirement, at command para sa pag-install: code.claude.com/docs/en/desktop-linux
• Mga suportadong distribution at bawat paraan ng pag-install para sa CLI: code.claude.com/docs/en/setup
• Aling mga platform ang may app na maaaring i-download: claude.com/download
• Aling plan ang may kasamang ano, at kung magkano ang halaga nito: claude.com/pricing

Ang bawat version number at petsa sa gabay na ito ay snapshot noong Agosto 2026. Ang estruktura ang nananatiling totoo: apat na surface, isang login para sa lahat ng paid na account, at isang desisyon kung ang CLI ay pagmamay-ari ng iyong user o ng buong machine.

FAQ

Mayroon bang Claude desktop app para sa Linux?

Oo. Simula noong Agosto 2026, ito ay nasa beta stage at sumusuporta sa 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 ng Anthropic at ang signing key nito, para ang mga bagong bersyon ay dumating kasabay ng iyong normal na system upgrades. Ang Linux build ay may parehong tabs gaya ng macOS app, kabilang ang Claude Code tab. Ang Computer Use at voice dictation ay wala pa sa Linux build, at ang Fedora at RHEL ay walang package, kaya sa mga distribution na iyon, gamitin ang CLI o ang claude.ai sa browser.

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

Hindi para sa inirerekomendang paraan ng pag-install. Ang curl -fsSL https://claude.ai/install.sh | bash ay nagda-download ng compiled binary na hindi gumagamit ng Node.js sa runtime. Mahalaga lang ang Node.js kung i-install mo ang npm package, na nangangailangan ng Node.js 22 o mas bago simula sa bersyong 2.1.198. Sa mas lumang Node.js, ang npm ay naglalabas ng EBADENGINE na babala at matatapos pa rin ang pag-install, dahil ang parehong native binary ay kinukuha bilang per-platform dependency. Huwag na 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 ito ng mga susunod na update.

Paano ako mag-log in sa Claude Code via SSH?

Patakbuhin ang claude at maglalabas ito ng authorisation URL. Buksan ang URL na iyon sa browser sa iyong sariling computer, hindi sa server. Matapos kang mag-sign in, magpapakita ang browser ng login code sa halip na mag-redirect, dahil hindi nito maabot ang callback listener na sinimulan ng Claude Code sa loopback address ng remote machine. I-paste ang code na iyon sa Paste code here if prompted prompt. Para sa mga session na nagsisimula nang walang tao sa harap ng computer, patakbuhin ang claude setup-token at i-set ang na-print na token bilang CLAUDE_CODE_OAUTH_TOKEN kung saan man ito kailangan.

Saan iniimbak ng Claude Code ang aking login sa Linux?

Sa ~/.claude/.credentials.json na may file mode na 0600, o sa ilalim ng CLAUDE_CONFIG_DIR kapag na-set mo ang variable na iyon. Walang keychain na ginagamit sa Linux, hindi gaya ng macOS, kaya anumang proseso na tumatakbo bilang iyong user ay kayang basahin ang file. Ang isang /home backup o machine image ay nagdadala ng gumaganang login: patakbuhin ang /logout bago ka mag-snapshot o mag-copy ng system. Kung ang ANTHROPIC_API_KEY ay naka-set din sa iyong environment, ito ang mas mangingibabaw kaysa sa nakaimbak na subscription login kapag na-approve mo na ito, at ang /status ang magpapakita kung alin ang aktibo.

Sinasaklaw ba ng aking Claude Pro subscription ang CLI pati na ang web app?

Oo. Ang isang Pro, Max, Team, o Enterprise plan ay nagpapahintulot sa iyong mag-sign in sa claude.ai, desktop app, CLI, at VS Code extension gamit ang iisang account. Ang libreng claude.ai plan ay hindi kasama ang Claude Code, kaya ang terminal CLI ay nangangailangan ng paid plan o isang Claude Console account. Ang API ay hiwalay na binabayaran kada token mula sa isang Console account, na isang magkaibang produkto kumpara sa subscription.