Claude op Linux: desktop-app en CLI installeren

Welke onderdelen van Claude draaien momenteel native op Linux

Claude op Linux draait op vier afzonderlijke platformen en sinds augustus 2026 werken alle vier op een standaard Ubuntu- of Debian-machine. De desktop-app wordt geïnstalleerd vanuit de apt-repository van Anthropic en bevindt zich in de bètafase. De Claude Code CLI (command line interface) is een gecompileerd binair bestand en draait op meer distributies dan de desktop-app. De web-app op claude.ai vereist alleen een browser en de API is een HTTPS-endpoint dat u vanuit uw eigen code aanroept.

Twee functies die wel beschikbaar zijn op macOS en Windows ontbreken in de Linux-desktopbèta: Computer Use, waarbij Claude applicaties op uw scherm bestuurt, en spraakdictatie. Anthropic documenteert beide als nog niet beschikbaar op Linux. De CLI beschikt wel over eigen spraakdictatie, dus het verschil zit in de desktop-app en niet in Claude zelf.

Beschikbaarheid verandert, dus lees deze pagina als een beschrijving van de platformen en controleer de huidige status voordat u uw planning hierop baseert. De laatste sectie bevat de pagina's die u kunt raadplegen.

De Claude desktop-app installeren op Ubuntu of Debian

De gedocumenteerde vereisten zijn Ubuntu 22.04 of nieuwer, of Debian 12 of nieuwer, op x86_64 (wat dpkg aanduidt als amd64) of arm64. Andere op Debian gebaseerde distributies werken mogelijk, maar zijn niet getest. Fedora en RHEL hebben nog geen pakket; gebruik daar de CLI of de browser.

Installeer vanuit de apt-repository in plaats van via een gedownload .deb-bestand. De Linux-app heeft geen eigen updater, dus nieuwe versies bereiken u alleen via uw pakketbeheerder. Het registreren van de repository zorgt ervoor dat apt upgrade deze kan zien.

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 hoort de vingerafdruk 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE weer te geven. Vergelijk deze voordat u de repository registreert, want een ondertekeningssleutel die u niet controleert, is een sleutel die u blind vertrouwt. Als gpg meldt dat het bestand geen geldige OpenPGP-gegevens bevat, is de download mislukt en zal apt update later falen met NO_PUBKEY BAA929FF1A7ECACE.

Het registreren van de repository is één deb-regel die naar /etc/apt/sources.list.d/claude-desktop.list wordt geschreven. Kopieer die regel vanaf de Linux-installatiepagina van Anthropic, code.claude.com/docs/en/desktop-linux, exact zoals deze daar staat. Het repository-adres is het onderdeel van deze procedure dat het vaakst wijzigt; een regel die uit het hoofd wordt getypt, zorgt ervoor dat u achteraf naar E: Unable to locate package claude-desktop staart. Lees de regel voordat u deze plakt: arch=amd64,arm64 is de reden waarom apt op een andere architectuur niets vindt, en signed-by= verwijst naar het keyring-bestand dat u zojuist hebt gecontroleerd. Dit beperkt die sleutel tot deze ene repository in plaats van deze te vertrouwen voor alles wat apt verder leest.

sudo apt update && sudo apt install claude-desktop

Start de app vanuit uw applicatiestarter of voer claude-desktop uit in een terminal. Meld u aan met uw claude.ai-account of via de SSO (single sign-on) van uw organisatie als uw bedrijf dit heeft ingesteld. De desktop-app accepteert geen Claude Console API-sleutel: authenticatie op basis van sleutels is een CLI-functie.

E: Unable to locate package claude-desktop betekent dat apt de repository nooit heeft gelezen. cat /etc/apt/sources.list.d/claude-desktop.list hoort de deb-regel te tonen die u hebt geschreven, en dpkg --print-architecture hoort amd64 of arm64 af te drukken, omdat er geen pakketten zijn gepubliceerd voor andere architecturen. Updates komen vervolgens binnen met de rest van uw systeem, via sudo apt update && sudo apt upgrade.

Wat alleen in een browser bestaat

claude.ai werkt in elke actuele browser op elke distributie, wat het de oplossing maakt voor Fedora, RHEL, Arch, openSUSE en elk ander systeem zonder pakket. De browser biedt ook toegang tot Claude Code op het web, waarbij de sessie in de cloud van Anthropic draait in plaats van op uw eigen machine, en waarbij altijd uw abonnementsgegevens worden gebruikt.

Het is nuttig om de beperking van de browser te begrijpen. Een cloud-sessie kan geen bestanden op uw eigen server lezen of daarop commando's uitvoeren. Alles wat interactie vereist met uw machine, heeft software op die machine nodig; dit betekent de CLI of de desktop-app.

Wat de CLI u biedt wat de webapplicatie niet heeft

Start claude in een map en het werkt op die map. Dat is het verschil, en de rest vloeit daaruit voort.

• Het leest en bewerkt de bestanden in uw werkmap en toont u elke wijziging voordat deze wordt toegepast.
• Het voert shell-commando's uit die u goedkeurt, zodat het een project kan bouwen, een testsuite kan draaien, een logbestand kan lezen of een service op de machine zelf kan inspecteren.
• Het draait zonder interactieve sessie: claude -p "read the nginx error log and summarise it" geeft één antwoord en sluit af, wat u gebruikt vanuit een cron job of een pipeline.
• Het verbindt MCP (model context protocol) servers met claude mcp add, wat het model tools geeft buiten het bestandssysteem.
• Het draait waar helemaal geen grafische desktop aanwezig is, wat geldt voor elke VPS (virtual private server) die u ooit zult huren.

Dat laatste punt is waarom een serverhandleiding de CLI belangrijk vindt. Een gehuurde server heeft SSH (secure shell) en niets anders, dus de terminal is het enige oppervlak dat daar met u aanwezig kan zijn. Het op die manier draaien heeft zijn eigen regels, die Claude Code draaien op een VPS binnen tmux volledig behandelt, en Claude gebruiken voor dagelijks systeembeheer behandelt de taken die het waard zijn om eraan uit te besteden.

Editor-integraties bevinden zich tussen beide in. De VS Code extensie vereist VS Code 1.94.0 of later en biedt u een grafisch paneel binnen de editor, met diffs en planbeoordeling. Het bundelt een privé-kopie van de CLI voor dat paneel en plaatst claude niet op uw PATH, dus het typen van claude in de geïntegreerde terminal vereist nog steeds de zelfstandige installatie. Editors gebouwd op VS Code installeren dezelfde extensie vanuit het Open VSX register, en er is ook een JetBrains plugin beschikbaar.

Hebt u Node.js nodig om Claude Code op Linux uit te voeren?

Niet bij de aanbevolen installatiemethode. Het native installatieprogramma downloadt een gecompileerd binair bestand en dat bestand draait niet op Node.js.

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

claude --version hoort een versienummer weer te geven, zoals 2.1.211 (Claude Code). Als er iets niet klopt, voer dan claude doctor uit; dit commando toont alleen-lezen diagnostische gegevens over de installatie en uw configuratiebestanden zonder een sessie te starten.

Node.js is alleen van belang bij de npm-installatieroute. Vanaf pakketversie 2.1.198 vereist het npm-pakket Node.js 22 of hoger. Bij een oudere versie van Node.js geeft npm een EBADENGINE-waarschuwing in plaats van dat het proces faalt, omdat het pakket hetzelfde native binaire bestand als platformafhankelijke afhankelijkheid ophaalt en op de juiste plek koppelt.

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

Voer dit niet uit met sudo. De documentatie waarschuwt tegen sudo npm install -g omdat dit bestanden achterlaat die eigendom zijn van root in uw globale npm-prefix, waardoor de volgende installatie of update door een niet-bevoorrechte gebruiker faalt vanwege rechtenproblemen. Wanneer de globale npm-directory niet beschrijfbaar is, stopt de automatische achtergrondupdate en geeft claude doctor de oplossingen weer.

Anthropic publiceert ook ondertekende pakketrepositories voor Debian, Fedora, RHEL en Alpine, waardoor sudo apt install claude-code op vrijwel dezelfde manier werkt als het desktop-pakket, met een eigen ondertekeningssleutel op https://downloads.claude.ai/keys/claude-code.asc.

Moet u per gebruiker of systeembreed installeren?

De native installer is een installatie per gebruiker. Deze plaatst een launcher op ~/.local/bin/claude als een symlink in ~/.local/share/claude/versions/, vereist geen root-rechten en werkt zichzelf op de achtergrond bij. Elke gebruiker op de machine krijgt een afzonderlijke kopie met een eigen versie.

Een installatie via een pakketbeheerder is systeembreed. Eén binary bedient elke gebruiker, vereist root-rechten en voert geen automatische updates uit via Claude Code. U voert de upgrade uit met sudo apt update && sudo apt upgrade claude-code, hetzelfde commando dat u al voor alle andere software op de machine gebruikt.

Kies voor de installatie per gebruiker op een machine waar u onder uw eigen account inlogt; dit is van toepassing op het meeste VPS-werk. Kies voor de pakketinstallatie op een gedeelde server of op een machine-image, waar u één versie voor iedereen wilt en u zelf wilt bepalen wanneer deze wordt bijgewerkt. Bij een native installatie bepalen twee instellingen in ~/.claude/settings.json hoe updates zich gedragen:

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

Het stable-kanaal volgt een release die ongeveer een week oud is en slaat releases met grote regressies over. DISABLE_AUTOUPDATER stopt alleen de achtergrondcontrole, waardoor claude update nog steeds werkt en u de controle behoudt over wanneer een nieuwe versie wordt geïnstalleerd. Dit is van belang op een server waar een langdurige taak onbeheerd draait en u liever niet wilt dat de binary daaronder verandert.

Log in via SSH en houd de sessie actief

Er treden twee Linux-specifieke problemen op wanneer u de CLI voor het eerst uitvoert op een gehuurde server. De inlogprocedure vereist een browser, maar de server heeft er geen. Een SSH-verbinding die wegvalt, beëindigt uw lopende werkzaamheden.

tmux lost het tweede probleem op. Een tmux-sessie hoort bij de tmux-server op de externe machine, niet bij uw verbinding. Een verbroken verbinding laat het proces daarom gewoon doorlopen.

tmux new -s claude
claude

Koppel los met Ctrl-b en vervolgens d, en keer later terug met tmux attach -t claude.

Het inloggen is het eerste probleem. Voer claude uit; dit geeft een autorisatie-URL weer. Open die URL in de browser op uw eigen computer. Nadat u bent ingelogd, toont de browser een inlogcode in plaats van terug te navigeren, omdat de browser op uw laptop de callback-server die Claude Code op het loopback-adres van de externe machine heeft gestart, niet kan bereiken. Plak die code in de terminal bij de Paste code here if prompted-prompt, waarna de terminal Login successful rapporteert.

Voor een sessie die moet starten zonder dat er iemand meekijkt, opent claude setup-token dezelfde browserautorisatie en print het een OAuth-token met een geldigheid van één jaar naar de terminal. Het token wordt nergens opgeslagen, dus kopieer het en stel het in waar nodig.

export CLAUDE_CODE_OAUTH_TOKEN=your-token

Dit token vereist een betaald abonnement en kan alleen modelverzoeken uitvoeren. Behandel het als een wachtwoord met een levensduur van één jaar. Waar u dit bewaart en hoe u voorkomt dat een agent het uitleest, is het onderwerp van geheimen buiten bereik van AI-agents houden.

Kleine servers lopen tegen nog een obstakel aan. De installatie vereist ongeveer 512 MB vrij geheugen en de gedocumenteerde hardwarevereiste voor het draaien ervan is 4 GB RAM of meer. Op een 1 GB-instance beëindigt de out-of-memory killer van de kernel daarom de installatie:

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

Voeg swap toe en voer de installer opnieuw uit. Swap is schijfruimte die de kernel gebruikt als extra geheugen. Het is aanzienlijk trager dan RAM, maar voldoende om een installatie te voltooien.

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

swapon activeert het bestand alleen voor deze opstartsessie. Voeg een regel voor /swapfile toe aan /etc/fstab als u wilt dat dit na een herstart behouden blijft. Wat u nog meer moet beveiligen voordat u een agent opdrachten laat uitvoeren op een live server, is het onderwerp van veilig Claude Code draaien op een VPS.

Waar uw Claude-inloggegevens op Linux worden opgeslagen

Op Linux schrijft /login de inloggegevens naar ~/.claude/.credentials.json met bestandsmodus 0600. macOS plaatst dezelfde inloggegevens in de versleutelde Keychain, dus een gewoonte die u op een Mac heeft aangeleerd, is hier niet van toepassing: op Linux is het token een tekstbestand in uw thuismap en elk proces dat onder uw gebruiker draait, kan dit lezen. Het instellen van CLAUDE_CONFIG_DIR verplaatst het bestand naar die map.

Hieruit volgen twee belangrijke punten. Een back-up van /home bevat een actieve inlogsessie; het kopiëren van die back-up naar een gedeelde machine geeft iedereen die het bestand kan lezen toegang tot uw account. Bovendien bevat een machine-image die is gebouwd op een systeem waar u was ingelogd, die inloggegevens voor elk exemplaar dat ervan wordt gekloond. Voer /logout uit voordat u een snapshot maakt.

De prioriteit van inloggegevens zorgt vaak voor verwarring bij gebruikers die zowel een abonnement als een API-sleutel hebben. Wanneer ANTHROPIC_API_KEY is ingesteld in uw shell, gebruikt Claude Code deze zodra u dit goedkeurt; uw abonnement blijft dan ongebruikt terwijl de sleutel per token wordt gefactureerd. /status toont welke inloggegevens actief zijn en unset ANTHROPIC_API_KEY brengt u terug naar de inlogprocedure voor het abonnement.

Inloggegevens verlopen. Binnen drie dagen voor het verlopen bevat de opstartregel Your login expires in 3 days, maar deze waarschuwing blokkeert nooit een verzoek. Na het verlopen mislukt elk verzoek met Login expired · Please run /login. Houd hier rekening mee voordat u een onbeheerde sessie over het weekend laat draaien, aangezien een dergelijke sessie stopt met werken en niet uit zichzelf kan herstellen.

Dekt één Claude-abonnement alles?

Eén betaald abonnement dekt elk platform met dezelfde inloggegevens. Met een Pro-, Max-, Team- of Enterprise-account logt u in op claude.ai in een browser, de desktop-app, de CLI en de VS Code-extensie; het is telkens hetzelfde abonnement. Het is ook één gezamenlijk gebruiksquotum voor alle platformen. Een langdurige CLI-sessie op uw server verbruikt dus de resterende capaciteit van de desktop-app. Welke limiet u heeft bereikt en wat u daaraan kunt doen is het punt om te onderzoeken wanneer een van de platformen weigert te werken. Het gratis claude.ai-abonnement bevat geen toegang tot Claude Code, dus voor de CLI en de Claude Code-onderdelen van de desktop-app is een betaald abonnement of een Claude Console-account vereist.

De API is een ander product met een andere facturering. Een Console-account factureert per token op basis van wat u daadwerkelijk verstuurt. Dit is geschikter voor een dienst die u bouwt dan voor interactief gebruik in een terminal. Het instellen van ANTHROPIC_API_KEY verplaatst de CLI naar dat facturatiemodel; dit is een bewuste keuze en geen standaardinstelling.

Prijzen en abonnementslimieten veranderen te vaak om hier te vermelden. Twee pagina's houden de actuele cijfers bij: wat Claude Code daadwerkelijk kost en welk Claude-abonnement u nodig heeft. Als u facturering per token afweegt tegen een maandelijks abonnement, dan zet de API vergeleken met een abonnement uiteen waar het omslagpunt ligt.

De installatiefouten die u daadwerkelijk zult zien

bash: claude: command not found direct na een succesvolle installatie. Het binaire bestand bevindt zich op ~/.local/bin/claude en die map staat niet in het zoekpad van uw shell. Controleer dit met echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin", dat niets weergeeft als het item ontbreekt. Los dit voor bash op met echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc en voer daarna source ~/.bashrc uit. Het installeren van de VS Code-extensie op zichzelf creëert dat bestand nooit, omdat de extensie zijn eigen kopie van de CLI binnen de extensiemap bewaart.

Error loading shared library libstdc++.so.6. Het installatieprogramma heeft de musl-build gekozen voor een glibc-systeem. Dit gebeurt wanneer musl-cross-compilatiepakketten aanwezig zijn en de detectie deze verkeerd interpreteert. Voer ldd --version 2>&1 | head -1 uit: uitvoer met de naam GNU libc of GLIBC betekent dat u op glibc werkt en het verkeerde binaire bestand heeft ontvangen. Verwijder in dat geval de installatie en voer het installatieprogramma opnieuw uit. Op Alpine en andere musl-systemen is de oplossing het tegenovergestelde, apk add libgcc libstdc++ ripgrep.

Twee kopieën van claude op één machine. which -a claude toont elke overeenkomst in uw PATH. Een native installatie is een symbolische koppeling van ~/.local/bin/claude naar ~/.local/share/claude/versions/, een verouderde lokale npm-installatie bevindt zich onder ~/.claude/local/, en npm -g ls @anthropic-ai/claude-code onthult een globale npm-installatie. Verwijder de versies die u niet wilt, want een verouderde kopie die eerder in uw PATH staat, zorgt ervoor dat een opgeloste bug onopgelost lijkt.

Waar u de huidige status kunt controleren

• Status van Linux-desktop, vereisten en installatiecommando's: code.claude.com/docs/en/desktop-linux
• Ondersteunde distributies en elke installatiemethode voor de CLI: code.claude.com/docs/en/setup
• Voor welke platforms er überhaupt een app te downloaden is: claude.com/download
• Welk abonnement wat bevat en wat de kosten zijn: claude.com/pricing

Elk versienummer en elke datum in deze handleiding is een momentopname van augustus 2026. De structuur blijft ongewijzigd: vier oppervlakken, één login voor de betaalde varianten, en één beslissing over de vraag of de CLI bij uw gebruiker hoort of bij de gehele machine.

FAQ

Is er een Claude desktop-app voor Linux?

Ja. Sinds augustus 2026 is deze in bèta en ondersteunt deze Ubuntu 22.04 of hoger en Debian 12 of hoger op amd64 of arm64. Installeer deze met sudo apt install claude-desktop nadat u de apt-repository van Anthropic en de bijbehorende ondertekeningssleutel heeft toegevoegd, zodat nieuwe versies via uw normale systeemupdates binnenkomen. De Linux-build bevat dezelfde tabbladen als de macOS-app, inclusief het Claude Code-tabblad. Computer Use en spraakdictatie zijn nog niet beschikbaar in de Linux-build, en voor Fedora en RHEL is geen pakket beschikbaar; gebruik op die distributies daarom de CLI of claude.ai in een browser.

Heb ik Node.js nodig om Claude Code op Linux uit te voeren?

Niet voor de aanbevolen installatie. curl -fsSL https://claude.ai/install.sh | bash downloadt een gecompileerd binair bestand dat tijdens runtime geen gebruikmaakt van Node.js. Node.js is alleen van belang als u het npm-pakket installeert, waarvoor vanaf versie 2.1.198 Node.js 22 of hoger vereist is. Bij een oudere Node.js-versie geeft npm een EBADENGINE-waarschuwing en wordt de installatie alsnog voltooid, omdat hetzelfde native binaire bestand als platformafhankelijke afhankelijkheid wordt opgehaald. Installeer het nooit met sudo npm install -g, omdat dit bestanden achterlaat die eigendom zijn van root in uw npm-prefix, wat latere updates verstoort.

Hoe log ik in op Claude Code via SSH?

Voer claude uit; dit toont een autorisatie-URL. Open deze URL in de browser op uw eigen computer, niet op de server. Nadat u bent ingelogd, toont de browser een inlogcode in plaats van door te sturen, omdat de browser de callback-listener die Claude Code op het loopback-adres van de externe machine heeft gestart, niet kan bereiken. Plak die code bij de Paste code here if prompted-prompt. Voor sessies die zonder gebruiker aanwezigheid starten, voert u claude setup-token uit en stelt u het getoonde token in als CLAUDE_CODE_OAUTH_TOKEN waar dit nodig is.

Waar slaat Claude Code mijn inloggegevens op Linux op?

In ~/.claude/.credentials.json met bestandsmodus 0600, of onder CLAUDE_CONFIG_DIR wanneer u die variabele instelt. In tegenstelling tot macOS wordt er op Linux geen keychain gebruikt, waardoor elk proces dat onder uw gebruiker draait het bestand kan lezen. Een /home-back-up of een machine-image bevat daarom een werkende inlogsessie: voer /logout uit voordat u een snapshot maakt of een systeem kopieert. Als ANTHROPIC_API_KEY ook in uw omgeving is ingesteld, krijgt dit voorrang op de opgeslagen abonnementslogin zodra u deze goedkeurt, en /status toont welke momenteel actief is.

Dekt mijn Claude Pro-abonnement zowel de CLI als de web-app?

Ja. Een Pro-, Max-, Team- of Enterprise-abonnement logt u in op claude.ai, de desktop-app, de CLI en de VS Code-extensie met één account. Het gratis claude.ai-abonnement bevat geen Claude Code, dus de terminal-CLI vereist een betaald abonnement of een Claude Console-account. De API wordt afzonderlijk per token gefactureerd vanuit een Console-account, wat een ander product is dan een abonnement.