SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor · Imeboreshwa 2026-08-31

Claude kwenye Linux: Desktop App na CLI

Jua kinachofanya kazi asili kwenye Linux: desktop app ya beta kupitia apt, Claude Code CLI, programu-jalizi za wahariri, na mpango unaolipia kila moja.

Ni sehemu zipi za Claude zinafanya kazi moja kwa moja kwenye Linux leo

Claude kwenye Linux inaendesha kupitia sehemu nne tofauti. Kufikia August 2026, zote zinafanya kazi kwenye mashine ya kawaida ya Ubuntu au Debian. Programu ya desktop husakinishwa kutoka kwenye apt repository ya Anthropic na iko kwenye beta. Claude Code CLI (command line interface) ni binary iliyokusanywa, na inaendesha kwenye distributions nyingi zaidi kuliko programu ya desktop. Web app kwenye claude.ai inahitaji browser pekee. API ni HTTPS endpoint unayoiita kutoka kwenye code yako mwenyewe.

Vipengele viwili vinavyopatikana kwenye macOS na Windows havipo kwenye desktop beta ya Linux: Computer Use, ambapo Claude inadhibiti apps kwenye screen yako, na voice dictation. Anthropic inaeleza kuwa vipengele vyote viwili bado havipatikani kwenye Linux. CLI ina voice dictation yake. Kwa hiyo, pengo liko kwenye programu ya desktop, si kwenye Claude yenyewe.

Upatikanaji hubadilika. Kwa hiyo, chukulia ukurasa huu kuwa maelezo ya sehemu hizi, kisha hakikisha hali ya sasa kabla ya kupanga matumizi yako kulingana nayo. Sehemu ya mwisho inaorodhesha kurasa za kuangalia.

Sakinisha programu ya Claude ya desktop kwenye Ubuntu au Debian

Mahitaji yaliyoandikwa ni Ubuntu 22.04 au ya baadaye, au Debian 12 au ya baadaye, kwenye x86_64 (ambayo dpkg huiita amd64) au arm64. Distributions nyingine zinazotokana na Debian zinaweza kufanya kazi, lakini hazijajaribiwa. Fedora na RHEL bado hazina package, kwa hiyo kwenye hizo unatumia CLI au browser.

Sakinisha kutoka kwenye apt repository badala ya kutumia faili ya .deb iliyopakuliwa. Programu ya Linux haina updater yake, kwa hiyo matoleo mapya yanakufikia kupitia package manager pekee. Kusajili repository ndiko kunakowezesha apt upgrade kuyaona.

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 inapaswa kuchapisha fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Linganisha fingerprint hiyo kabla ya kusajili repository, kwa sababu signing key ambayo hujaikagua ni cryptographic key unayoamini bila uthibitisho. Ikiwa gpg itaripoti kuwa faili haina data halali ya OpenPGP, upakuaji umeshindikana. Kisha apt update itashindwa baadaye kwa NO_PUBKEY BAA929FF1A7ECACE.

Kusajili repository ni mstari mmoja wa deb unaoandikwa kwenye /etc/apt/sources.list.d/claude-desktop.list. Nakili mstari huo kutoka ukurasa wa Anthropic wa usakinishaji wa Linux, code.claude.com/docs/en/desktop-linux, bila kuubadilisha. Anwani ya repository ndiyo sehemu ya utaratibu huu inayoweza kubadilika zaidi. Mstari ulioandikwa kwa kukumbuka ndiyo sababu unaweza kubaki ukiangalia E: Unable to locate package claude-desktop baadaye. Soma mstari huo kabla ya kuubandika: arch=amd64,arm64 ndiyo sababu apt kwenye architecture nyingine yoyote haipati chochote, na signed-by= inaelekeza kwenye keyring file uliyoikagua. Hilo linaifanya key hiyo itumike kwa repository hii pekee badala ya kuaminiwa kwa kila kitu kingine ambacho apt husoma.

sudo apt update && sudo apt install claude-desktop

Ianzishe kupitia application launcher yako, au endesha claude-desktop kwenye terminal. Ingia kwa account yako ya claude.ai, au kupitia SSO (single sign-on) ya shirika lako ikiwa kampuni yako imeiweka. Programu ya desktop haikubali Claude Console API key. Authentication inayotumia key ni kipengele cha CLI.

E: Unable to locate package claude-desktop inamaanisha apt haijasoma repository. cat /etc/apt/sources.list.d/claude-desktop.list inapaswa kuonyesha mstari wa deb ulioandika, na dpkg --print-architecture inapaswa kuchapisha amd64 au arm64, kwa sababu hakuna packages zilizochapishwa kwa architectures nyingine. Updates zitafika pamoja na mfumo wako mwingine, kutoka sudo apt update && sudo apt upgrade.

Kile kinachopatikana kwenye browser pekee

claude.ai hufanya kazi kwenye browser yoyote ya sasa na distribution yoyote, hivyo ni chaguo kwa Fedora, RHEL, Arch, openSUSE na mfumo mwingine wowote usio na package. Browser pia hupata Claude Code kwenye web, ambapo session huendeshwa kwenye cloud ya Anthropic badala ya kwenye mashine yako, na hutumia credentials za subscription yako kila wakati.

Kikomo cha browser ndicho muhimu kuelewa. Cloud session haiwezi kusoma files zilizo kwenye server yako mwenyewe au kuendesha command humo. Kitu chochote kinachohitaji kufikia mashine yako kinahitaji software kwenye mashine hiyo, yaani CLI au desktop app.

CLI inakupa nini ambacho programu ya wavuti haitoi

Anzisha claude ndani ya directory, nayo itafanya kazi kwenye directory hiyo. Hiyo ndiyo tofauti, na mambo mengine yanafuata kutokana nayo.

  • Husoma na kuhariri files zilizo kwenye working directory yako, kisha hukuonyesha kila uhariri kabla ya kuutekeleza.
  • Huendesha shell commands unazoidhinisha, hivyo inaweza kuunda project, kuendesha test suite, kusoma log, au kukagua service kwenye server yenyewe.
  • Hufanya kazi bila interactive session: claude -p "read the nginx error log and summarise it" huchapisha jibu moja kisha hutoka. Hivyo ndivyo unavyoitumia kutoka kwenye cron job au pipeline. Unaweza kuweka muundo wa jibu hilo kwa jinsi unavyotaka, kwa sababu output style hubadilisha system prompt iliyo nyuma ya kila jibu na inaweza kufanya run ya scripted iwe fupi huku interactive session ikijieleza.
  • Huunganisha servers za MCP (model context protocol) kwa kutumia claude mcp add, jambo linaloipa model tools zinazozidi filesystem.
  • Hufanya kazi mahali ambapo hakuna graphical desktop kabisa. Hii ndiyo hali ya kila VPS (virtual private server) utakayowahi kukodisha.

Hoja hiyo ya mwisho ndiyo inayofanya mwongozo wa server uzingatie CLI. Server ya kukodi ina SSH (secure shell) pekee na hakuna kingine, kwa hiyo terminal ndiyo interface pekee inayoweza kuwepo pamoja nawe. Kuiendesha kwa njia hiyo kuna kanuni zake, ambazo kuendesha Claude Code kwenye VPS ndani ya tmux kunazieleza kikamilifu, na kutumia Claude kwa kazi za kila siku za sysadmin kunashughulikia kazi zinazofaa kuikabidhi.

Integrations za editor ziko kati ya njia hizo mbili. VS Code extension inahitaji VS Code 1.94.0 au ya baadaye na hukupa panel ya graphical ndani ya editor, yenye diffs na mapitio ya mpango. Huweka nakala binafsi ya CLI kwa ajili ya panel hiyo na haiweki claude kwenye PATH yako, kwa hiyo kuandika claude kwenye integrated terminal bado kunahitaji standalone install. Editors zilizojengwa juu ya VS Code husakinisha extension hiyo hiyo kutoka kwenye Open VSX registry, na pia kuna JetBrains plugin.

Je, unahitaji Node.js ili kuendesha Claude Code kwenye Linux?

Si kwa usakinishaji unaopendekezwa. Kisakinishaji asili hupakua binary iliyokusanywa, na binary hiyo haiendeshi kwenye Node.js.

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

claude --version inapaswa kuchapisha nambari ya toleo kama 2.1.211 (Claude Code). Ikiwa kuna jambo lisilo sahihi, endesha claude doctor. Amri hii huchapisha uchunguzi wa kusoma tu kuhusu usakinishaji na faili zako za mipangilio bila kuanzisha session.

Node.js ni muhimu tu kwa njia ya npm. Kuanzia package version 2.1.198, package ya npm inahitaji Node.js 22 au ya baadaye. Kwenye Node.js ya zamani, npm huchapisha onyo la EBADENGINE badala ya kushindwa. Hii ni kwa sababu package huleta binary ileile asili kama dependency ya kila platform, kisha huiunganisha mahali pake.

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

Usiendeshe hiyo kwa sudo. Documentation inaonya dhidi ya sudo npm install -g kwa sababu huacha faili zinazomilikiwa na root kwenye npm prefix yako ya kimataifa. Kwa hiyo, usakinishaji au update inayofuata bila ruhusa za juu hushindwa kwa sababu ya permissions. Directory ya kimataifa ya npm isipoandikika, auto-update ya chinichini huacha kufanya kazi. claude doctor inaorodhesha marekebisho.

Anthropic pia huchapisha package repositories zilizotiwa saini kwa Debian, Fedora, RHEL na Alpine. Kwa hiyo, sudo apt install claude-code hufanya kazi kwa njia inayofanana na package ya desktop, ikiwa na signing key yake kwenye https://downloads.claude.ai/keys/claude-code.asc.

Usakinishe kwa kila mtumiaji au kwa mfumo mzima?

Kisakinishi asilia huweka programu kwa kila mtumiaji. Huweka launcher kwenye ~/.local/bin/claude kama symlink inayoelekea ~/.local/share/claude/versions/, hakihitaji root, na hujisasisha chinichini. Kila mtumiaji kwenye mashine hupata nakala yake yenye toleo lake.

Usakinishaji kupitia package manager ni wa mfumo mzima. Binary moja hutumiwa na kila mtumiaji, huhitaji root, na haisasishwi kiotomatiki kupitia Claude Code. Huiboresha kwa sudo apt update && sudo apt upgrade claude-code, amri ileile unayoendesha kwa kila kitu kingine kwenye mashine.

Chagua usakinishaji wa kila mtumiaji kwenye mashine unayoingia kama wewe mwenyewe; hii ndiyo hali ya kawaida kwa kazi nyingi za VPS. Chagua usakinishaji wa package kwenye seva inayotumiwa na watu wengi au kwenye machine image, ikiwa unataka kila mtu atumie toleo moja na unataka kulisasisha kwa ratiba yako. Kwenye usakinishaji asilia, mipangilio miwili kwenye ~/.claude/settings.json huamua jinsi masasisho yanavyofanyika:

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

Channel ya stable hufuata release ambayo ina takriban wiki moja tangu itolewe na huruka releases zenye regressions kubwa. DISABLE_AUTOUPDATER husimamisha ukaguzi wa chinichini pekee, kwa hiyo claude update bado hufanya kazi na unabaki na udhibiti wa wakati toleo jipya linapowekwa. Hili ni muhimu kwenye seva ambayo kazi ndefu inaendelea bila uangalizi na ungependa binary isibadilike wakati kazi hiyo inaendelea.

Ingia kupitia SSH na udumishe session ikiwa hai

Matatizo mawili mahususi ya Linux hujitokeza unapoendesha CLI kwa mara ya kwanza kwenye seva iliyokodishwa. Mchakato wa kuingia unahitaji browser, lakini seva haina browser. SSH connection ikikatika, kazi unayoendesha hukatika nayo.

tmux hutatua tatizo la pili. tmux session ni ya tmux server iliyo kwenye mashine ya mbali, si ya connection yako. Kwa hiyo, link ikikatika, process huendelea kufanya kazi.

tmux new -s claude
claude

Jitenganishe kwa Ctrl-b kisha d, na urudi baadaye kwa tmux attach -t claude.

Kuingia ndilo tatizo la kwanza. Endesha claude na itaonyesha URL ya authorisation. Fungua URL hiyo kwenye browser ya kompyuta yako. Baada ya kuingia, browser itaonyesha login code badala ya kurudi moja kwa moja, kwa sababu browser iliyo kwenye laptop yako haiwezi kufikia callback server ambayo Claude Code ilianzisha kwenye loopback address ya mashine ya mbali. Bandika code hiyo kwenye terminal kwenye prompt ya Paste code here if prompted, na terminal itaripoti Login successful.

Kwa session inayopaswa kuanza bila mtu kuifuatilia, claude setup-token hufungua authorisation hiyo hiyo ya browser na kuchapisha OAuth token ya mwaka mmoja kwenye terminal. Haihifadhi token hiyo popote, kwa hiyo inakili kisha uiweke mahali unapohitaji.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Token hiyo inahitaji paid plan na inaweza tu kutuma model requests. Ichukulie kama password yenye muda wa matumizi wa mwaka mmoja. Mahali pa kuihifadhi, na jinsi ya kumzuia agent asiisome tena, limeelezwa katika kuweka secrets mbali na mawakala wa AI.

Seva ndogo hukumbana na kikwazo kingine. Usakinishaji unahitaji takriban 512 MB za memory ya bure, na hardware requirement iliyoandikwa ya kuiendesha ni 4 GB za RAM au zaidi. Kwa hiyo, kwenye instance ya 1 GB, kernel out-of-memory killer husitisha usakinishaji:

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

Ongeza swap, kisha endesha installer tena. Swap ni nafasi ya disk ambayo kernel hutumia kama memory ya ziada. Ni polepole zaidi kuliko RAM, lakini inatosha kukamilisha usakinishaji.

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

swapon huwezesha file hiyo kwa boot hii pekee. Ongeza line ya /swapfile kwenye /etc/fstab ikiwa unataka irudi baada ya reboot. Mambo mengine ya kuzuia kabla ya kumruhusu agent kuendesha commands kwenye live server yameelezwa katika kuendesha Claude Code kwa usalama kwenye VPS.

Mahali ambapo vitambulisho vyako vya Claude huhifadhiwa kwenye Linux

Kwenye Linux, /login huandika credential kwenye ~/.claude/.credentials.json ikiwa na file mode 0600. macOS huweka credential hiyo hiyo kwenye Keychain iliyosimbwa, hivyo mazoea uliyounda kwenye Mac hayatumiki moja kwa moja: kwenye Linux token ni file ya kawaida kwenye home directory yako, na kila process inayoendeshwa kama user wako inaweza kuisoma. Kuweka CLAUDE_CONFIG_DIR huhamisha file chini ya directory hiyo badala yake.

Mambo mawili yanafuata kutokana na hilo. Backup ya /home ina login inayotumika, hivyo kunakili backup hiyo kwenye mashine inayoshirikiwa kunampa account yako mtu yeyote mwingine anayeweza kuisoma. Pia machine image iliyoundwa kutoka kwenye box ambayo uliingiza login husafirisha login hiyo kwenye kila instance inayoundwa kwa kuiclone. Endesha /logout kabla ya kutengeneza snapshot yoyote.

Precedence ya credentials huwachanganya watu walio na subscription na API key kwa wakati mmoja. ANTHROPIC_API_KEY inapowekwa kwenye shell yako, Claude Code huitumia baada ya kuidhinisha, hivyo subscription yako hubaki bila kutumiwa huku key ikitoza kwa kila token. /status huonyesha credential inayotumika, na unset ANTHROPIC_API_KEY hukurejesha kwenye login ya subscription.

Logins huisha muda wake. Ndani ya siku tatu kabla ya kuisha, mstari wa kuanza huonyesha Your login expires in 3 days, na onyo hilo halizuii request. Baada ya kuisha, kila request hushindwa kwa Login expired · Please run /login. Jua hili kabla ya kuacha session isiyosimamiwa ikiendelea mwishoni mwa wiki, kwa sababu session kama hiyo huacha kufanya progress na haiwezi kujirekebisha yenyewe.

Je, usajili mmoja wa Claude unatosha kwa kila kitu?

Mpango mmoja wa kulipia unashughulikia njia zote kwa kutumia login ileile. Akaunti ya Pro, Max, Team au Enterprise inakuingiza kwenye claude.ai kupitia browser, kwenye desktop app, kwenye CLI na kwenye VS Code extension. Kila mara unatumia usajili uleule. Pia kuna kikomo kimoja cha matumizi kwa njia zote. Kwa hiyo, CLI run ndefu kwenye seva yako itapunguza kiasi ambacho desktop app inaweza kutumia. Unapokutana na njia yoyote inayokataa kufanya kazi, jambo la kwanza la kubaini ni umevuka dirisha gani la kikomo na ufanye nini kuhusu hilo. Mpango wa bure wa claude.ai haujumuishi ufikiaji wa Claude Code. Kwa hiyo, CLI na sehemu za Claude Code kwenye desktop app zinahitaji mpango wa kulipia au akaunti ya Claude Console.

API ni bidhaa tofauti yenye mfumo tofauti wa billing. Akaunti ya Console hutoza kwa kila token kulingana na unachotuma. Hii inafaa kwa service unayoijenga, badala ya kuandika amri kwenye terminal. Kuweka ANTHROPIC_API_KEY huihamishia CLI kwenye njia hiyo ya billing. Huo ni uamuzi unaoufanya, si fallback.

Bei na limits za mipango hubadilika mara nyingi sana kiasi kwamba hazifai kuandikwa tena hapa. Kurasa mbili zinafuatilia nambari za sasa: gharama halisi ya Claude Code na mpango wa Claude unaouhitaji. Ikiwa unalinganisha billing ya kila token na mpango wa kila mwezi, API ikilinganishwa na usajili inaeleza mahali break-even inapatikana.

Makosa ya usakinishaji utakayoyaona

bash: claude: command not found mara tu baada ya usakinishaji kufanikiwa. Binary iko kwenye ~/.local/bin/claude, na directory hiyo haipo kwenye search path ya shell yako. Thibitisha hilo kwa echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", ambayo haitoi chochote entry hiyo inapokosekana. Rekebisha hali hiyo kwa bash kwa kutumia echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc, kisha endesha source ~/.bashrc. Kusakinisha extension ya VS Code pekee hakutengenezi faili hiyo kamwe, kwa sababu extension huhifadhi nakala yake ya CLI ndani ya directory ya extension.

Error loading shared library libstdc++.so.6. Installer ilichagua build ya musl kwa mfumo wa glibc. Hii hutokea wakati packages za cross-compilation za musl zipo na utambuzi unasoma hali hiyo kimakosa. Endesha ldd --version 2>&1 | head -1: jina la output GNU libc au GLIBC linamaanisha kuwa unatumia glibc na ulipokea binary isiyofaa, kwa hiyo ondoa usakinishaji huo kisha endesha installer tena. Kwenye Alpine na mifumo mingine ya musl, suluhisho ni kinyume chake, apk add libgcc libstdc++ ripgrep.

Nakala mbili za claude kwenye seva moja. which -a claude huorodhesha kila inayolingana ndani ya PATH yako. Usakinishaji wa native ni symlink kutoka ~/.local/bin/claude kwenda ~/.local/share/claude/versions/, usakinishaji wa zamani wa npm wa ndani huhifadhiwa chini ya ~/.claude/local/, na npm -g ls @anthropic-ai/claude-code huonyesha usakinishaji wa npm wa kimataifa. Ondoa zile usizotaka, kwa sababu nakala iliyobaki iliyo mapema kwenye PATH yako ndiyo hufanya bug iliyorekebishwa ionekane kana kwamba bado haijarekebishwa.

Mahali pa kuangalia hali ya sasa

Kila nambari ya toleo na tarehe katika mwongozo huu ni hali ilivyokuwa Agosti 2026. Muundo wa jumla ndio unaobaki kuwa sahihi: njia nne za matumizi, login moja kwenye njia zinazolipiwa, na uamuzi mmoja kuhusu kama CLI itakuwa ya user wako au ya mashine nzima.

FAQ

Je, kuna programu ya Claude ya kompyuta za mezani kwa Linux?

Ndiyo. Kufikia Agosti 2026 iko katika awamu ya beta, na inatumia Ubuntu 22.04 au toleo jipya zaidi pamoja na Debian 12 au toleo jipya zaidi kwenye amd64 au arm64. Isakinishe kwa sudo apt install claude-desktop baada ya kuongeza hazina ya apt ya Anthropic na cryptographic signing key yake, ili matoleo mapya yawasili pamoja na upgrades zako za kawaida za mfumo. Toleo la Linux lina tabs zilezile kama programu ya macOS, ikiwemo tab ya Claude Code. Computer Use na voice dictation bado hazipo katika toleo la Linux, na Fedora pamoja na RHEL hazina package, kwa hiyo kwenye distributions hizo tumia CLI au claude.ai kwenye browser.

Je, ninahitaji Node.js ili kuendesha Claude Code kwenye Linux?

Si kwa usakinishaji unaopendekezwa. curl -fsSL https://claude.ai/install.sh | bash hupakua binary iliyocompile ambayo haitumii Node.js wakati wa kuendesha programu. Node.js inahitajika tu ukisakinisha npm package, ambayo kufikia version 2.1.198 inahitaji Node.js 22 au toleo jipya zaidi. Kwenye Node.js ya zamani, npm huonyesha warning ya EBADENGINE na usakinishaji hukamilika bado, kwa sababu binary ileile ya native hupakuliwa kama dependency ya kila platform. Usiisakinishe kwa sudo npm install -g, kwa sababu huacha files zinazomilikiwa na root kwenye npm prefix yako na kuvuruga updates zinazofuata.

Ninawezaje kuingia kwenye Claude Code kupitia SSH?

Endesha claude; itaonyesha authorisation URL. Fungua URL hiyo kwenye browser ya kompyuta yako mwenyewe, si kwenye server. Baada ya kuingia, browser huonyesha login code badala ya kufanya redirect, kwa sababu haiwezi kufikia callback listener iliyoanzishwa na Claude Code kwenye loopback address ya mashine ya mbali. Bandika code hiyo kwenye prompt ya Paste code here if prompted. Kwa sessions zinazoanza bila mtu kuwepo, endesha claude setup-token na uweke token iliyoonyeshwa kama CLAUDE_CODE_OAUTH_TOKEN kila inapohitajika.

Claude Code huhifadhi wapi taarifa yangu ya kuingia kwenye Linux?

Kwenye ~/.claude/.credentials.json ikiwa na file mode 0600, au chini ya CLAUDE_CONFIG_DIR unapoweka variable hiyo. Linux haitumii keychain, tofauti na macOS, kwa hiyo process yoyote inayoendeshwa kama user wako inaweza kusoma file hiyo. Kwa hiyo, backup ya /home au machine image hubeba login inayofanya kazi: endesha /logout kabla ya kutengeneza snapshot au kunakili mfumo. Ikiwa ANTHROPIC_API_KEY pia imewekwa katika environment yako, huwa na kipaumbele kuliko subscription login iliyohifadhiwa baada ya kuidhinisha, na /status huonyesha ni ipi iliyo active.

Je, subscription yangu ya Claude Pro inahusisha CLI pamoja na programu ya wavuti?

Ndiyo. Mpango wa Pro, Max, Team au Enterprise hukuingiza kwenye claude.ai, programu ya kompyuta ya mezani, CLI na VS Code extension kwa kutumia account moja. Mpango wa bure wa claude.ai haujumuishi Claude Code, kwa hiyo terminal CLI inahitaji mpango unaolipiwa au account ya Claude Console. API hutozwa kivyake kwa kila token kutoka kwenye account ya Console, ambayo ni bidhaa tofauti na subscription.