Zo gebruikt u Claude Code op de desktop— een professionele gids

Anthropic heeft deze maand een desktop-voorvertoning van Claude Code uitgebracht — een native desktop-app die de agentgestuurde codeworkflows van Anthropic uit de terminal naar een grafische omgeving brengt, met ingebouwde ondersteuning om meerdere, geïsoleerde codingsessies parallel uit te voeren. De desktop-preview is ontworpen om naast de web- en mobiele versies van Claude Code te bestaan en richt zich op twee praktische ontwikkelaarsproblemen: meerdere AI-agents op dezelfde repository draaien zonder elkaar in de weg te zitten, en het makkelijker maken om lokale of cloudsessies vanuit één GUI te starten.

Wat is Claude Code op Desktop?

Claude Code op Desktop is de native (preview) desktopapplicatie waarmee ontwikkelaars Claude Code-sessies lokaal of op Anthropic’s veilige cloudinfrastructuur kunnen draaien via een GUI in plaats van uitsluitend de CLI. Het combineert de kerncapaciteiten voor agentische coding van Claude Code met desktopgemakken: sessiebeheer, integratie met de lokale omgeving en het met één klik starten van websessiessies. De app is expliciet gepositioneerd als aanvulling op de CLI- en webaanbiedingen van Claude Code; hij bundelt een stabiele Claude Code-runtime en beheert versies voor je om een consistente en stabiele ervaring te behouden.

Waarom is dit belangrijk? Historisch gezien liepen AI-codetools ofwel puur in de terminal (ontwikkelaars die zich prettig voelen bij CLI-workflows) of puur in de cloud (browser-UI’s). De desktop-app overbrugt die kloof door lokale runs met lage latentie mogelijk te maken en door je naadloos te laten overschakelen naar door Anthropic gehoste (web)sessies wanneer je geïsoleerde cloudcompute of enterprise-controles nodig hebt. De desktop-preview is vooral opmerkelijk vanwege de ondersteuning voor multi‑sessie‑parallelisme — je kunt meerdere onafhankelijke Claude Code-agents tegelijkertijd op dezelfde repository draaien, elk in zijn eigen Git-worktree (geïsoleerde branch-werkruimte) zodat de agents elkaar niet in de weg zitten. Dat is de belangrijkste feature waar veel teams direct baat bij hebben.

Hoe verhoudt de desktopeditie zich tot de web- en CLI-versies?

Claude Code begon als een command-line tool en breidde later uit naar web- en mobiele interfaces; de desktop-preview bouwt voort op die fundamenten. De desktop-app spiegelt veel van de mogelijkheden die op het web beschikbaar zijn (sessies starten, repository-koppelingen, voortgang bekijken), maar focust op de ergonomie van lokale workflows — desktop-UX, native installatie en nauwere integraties met lokale Git-repositories via worktrees — zodat sessies gelijktijdig kunnen draaien zonder elkaars bestandsstatus te beïnvloeden.

Zie ook Claude Code Web: What it is and how to use it

7 uitstekende features van Claude Code op Desktop

1) Multi-sessie-parallelisme

Claude Code voor Desktop ondersteunt het gelijktijdig draaien van meerdere, onafhankelijke Claude-sessies. Dat betekent dat je één sessie op een bugfix kunt richten, een andere tests kunt laten schrijven en een derde documentatie kunt laten genereren — allemaal tegelijk, in plaats van in de wachtrij in één sessie. Dit parallelisme versnelt workflows en stelt je in staat verschillende taken gelijktijdig te delegeren.

Bijvoorbeeld:

Stel je hebt een project genaamd my-app, en je wilt:

• Claude in één venster de homepage laten wijzigen;
• Claude in een ander venster de databaselogica laten optimaliseren.

Claude Desktop maakt automatisch voor je aan:

~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/

Twee onafhankelijke kopieën (zonder conflicten). Dit is alsof je twee branches van ontwikkeling gelijktijdig draait, waarbij Claude elk voor je afhandelt.

2. .worktreeinclude: Maak Claude bewust van genegeerde bestanden

Soms heeft je project bestanden zoals .env of .local, die meestal door .gitignore worden genegeerd en niet naar de werkmap van Claude worden gekopieerd. Bestanden die in .gitignore staan, worden niet automatisch gekopieerd naar nieuwe worktrees. Claude biedt een nieuw mechanisme: je kunt in de hoofdmap van het project een .worktreeinclude-bestand aanmaken om aan te geven welke bestanden moeten worden gekopieerd — een .gitignore-achtige lijst die specificeert welke genegeerde bestanden moeten worden gekopieerd naar nieuw aangemaakte worktrees (bijvoorbeeld lokale .env-bestanden of ontwikkelaarsspecifieke instellingen). Alleen bestanden die zowel in .worktreeinclude als .gitignore voorkomen, worden gekopieerd, wat voorkomt dat per ongeluk gevolgde bestanden worden gedupliceerd. Dit is cruciaal om sessiespecifieke geheimen of omgevingsbestanden te behouden zonder ze in Git op te nemen.

Bijvoorbeeld:

.env
.env.local

.env.production

**/.claude/settings.local.json

Dit betekent: wanneer Claude de werkmap aanmaakt, worden deze bestanden ook gekopieerd.

Opmerking:

• Alleen bestanden die in zowel .gitignore als .worktreeinclude bestaan, worden gekopieerd;
• Voorkom het per ongeluk kopiëren van belangrijke gevolgde bestanden.

3) Sessies starten en synchroniseren met web-/cloudsessies

De desktop-app kan fungeren als launcher voor web-/cloudsessies — dat wil zeggen, je kunt cloudgebaseerde Claude Code-sessies vanuit de desktop-UI starten en ze lokaal volgen of bijsturen. Deze hybride modus is handig als je het gemak van lokale bediening wilt combineren met het schaal- of toestemmingsmodel van cloudgehoste runs.

Opmerking:

• Bij draaien in de cloud worden Claude’s taken uitgevoerd op de beveiligde server van Anthropic.
• Het schakelen tussen lokale en cloudomgevingen is naadloos.
• Om een sessie te maken, selecteer je eenvoudig "remote environment".

4) Sessies starten en synchroniseren met web-/cloudsessies

De desktop-app kan fungeren als launcher voor web-/cloudsessies — dat wil zeggen, je kunt cloudgebaseerde Claude Code-sessies vanuit de desktop-UI starten en ze lokaal volgen of bijsturen. Deze hybride modus is handig als je het gemak van lokale bediening wilt met het schaal- of toestemmingsmodel van cloudgehoste runs (lokaal voor snelle taken, cloud voor risicovolle of resource-intensieve taken).

5) Gebundelde versie en enterprise-configuratie

Desktop bevat een gebundelde, stabiele Claude Code-runtime die bij de eerste start wordt gedownload en automatisch wordt beheerd. Enterprise-beheerders kunnen lokaal gebruik van Claude Code indien nodig uitschakelen (enterprisebeleid isClaudeCodeForDesktopEnabled). Desktop-installers ondersteunen gangbare enterprise-uitrolformaten (MSIX voor Windows, PKG voor macOS), en beheerders kunnen updates en extensietoegang beheren. Deze controles zijn ontworpen om adoptie voor grote teams te vereenvoudigen.

Opmerking:

• De applicatie wordt automatisch gedownload bij de eerste opening;
• De desktopapplicatie beheert versie-updates automatisch;
• Oude versies worden automatisch opgeschoond om het systeem schoon te houden;
• Zelfs als je de CLI-versie op je computer hebt geïnstalleerd, gebruikt de desktopapp alsnog zijn eigen versie (voor meer stabiliteit).
• De desktopversie geeft prioriteit aan stabiliteit en compatibiliteit; de CLI (command-line-versie) kan sneller updaten, maar nieuwe features worden mogelijk niet onmiddellijk met de desktopversie gesynchroniseerd.

6) Aangepaste omgevingsvariabelen

Claude Desktop laat je variabelen instellen net als .env-bestanden.

Deze variabelen zijn alleen van kracht binnen de Claude-sessie, waardoor ze ideaal zijn voor projectconfiguratie.

Bijvoorbeeld:

API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"

7) Integreren met lokale tools en omgevingen

Bij lokale sessies extraheert de desktop-app je shell-$PATH, zodat processe n binnen de sessie dezelfde node-, npm-, yarn-, Python- of andere CLI-tools kunnen gebruiken waarop je vertrouwt. Er is ook een UI om aangepaste omgevingsvariabelen toe te voegen (in .env-indeling), met gemaskeerde waarden voor veiligheid. Dit maakt het draaien van tests of builds binnen een agentische sessie soepeler, omdat de agent dezelfde toolchain kan aanroepen als je terminal.

Hoe installeer ik Claude Code op Desktop?

In dit gedeelte doorlopen we het installatieproces met minimale frictie. De onderstaande instructies zijn actueel voor de desktop-preview en verwijzen je naar de canonieke installers.

Vereisten en accountinstelling

1. Anthropic-account en -werkruimte: Claude Code is gekoppeld aan de Anthropic Console. Je moet een OAuth-flow in de Claude Console voltooien en actieve billing of research preview-toegang hebben zoals vereist door het werkruimtemodel van Anthropic. Claude Code gebruikt een interne werkruimte in de console om gebruik bij te houden; je kunt geen API-sleutels voor die werkruimte aanmaken — deze wordt beheerd voor het gebruik van Claude Code.
2. Git en repo-gereedheid: Zorg dat Git is geïnstalleerd en dat het project waarop je wilt werken een Git-repository is (of initialiseer Git). De desktop-app verwacht geldige repo’s voor functies zoals worktrees; als je een map zonder geïnitialiseerde Git opent, wordt er geen worktree aangemaakt.
3. OS-specificaties: macOS- en Linux-installaties zijn doorgaans native binaries; Windows-gebruikers wordt aanbevolen WSL te gebruiken voor volledige command-compatibiliteit in veel workflows. Sommige communitygidsen behandelen geavanceerde Windows/WSL-setups als je PATH- of distributieproblemen tegenkomt.

Stapsgewijze installatie (kort)

1. Open de Claude Download-pagina en kies de juiste installer voor jouw platform.
2. Voer de installer uit (PKG op macOS, MSIX of EXE op Windows). Voor enterprise-fl eets: gebruik de MSIX/PKG-pakketten voor gecentraliseerde uitrol.
3. Start de Claude Desktop-app en log in met je Anthropic/Claude-account. Je gesprekken en voorkeuren worden gesynchroniseerd tussen desktop, web en mobiel.
4. Bij de eerste start downloadt de app een gebundelde Claude Code-runtime. Laat die download voltooien; dit is vereist en zorgt voor een stabiele, beheerde versie.

Controles na installatie

• Open Settings > Environments en bevestig dat de desktop-app je shell-$PATH heeft geëxtraheerd.
• Kies of je lokale sessies wilt inschakelen (als je machine en beleid dat toelaten) of dat je workflow in plaats daarvan websessiessies aanmaakt.

Optionele installatiemethode die ik moet kiezen

• Native installer (aanbevolen): Gebruik de native OS-installer voor de eenvoudigste, meest geïntegreerde ervaring.
• Homebrew (macOS): Handig voor macOS-gebruikers die apps met Homebrew beheren.
• NPM- of scriptgebaseerde installers: Nuttig voor meer geautomatiseerde of gescripte setups (CI of provisioning), of voor Linux-distributies waar een eenvoudig installerscript de voorkeur heeft.

Installatie: macOS, Linux, WSL (aanbevolen flow)

1. Download de desktop-preview-installer van de Claude Code-downloadpagina (de in-productdocumentatie bevat de installerlink).
2. Voer de installer uit en open de Claude desktopapp.
3. Voltooi de OAuth-aanmelding via de in‑app Claude Console-flow.
4. Configureer de standaardlocatie voor worktrees en je voorkeuren voor lokale/remote uitvoering in de desktopinstellingen.
5. Open een projectmap of kloon een repo vanuit de UI om te beginnen.

Open een terminal en voer, als je de bron vertrouwt, het installatiescript uit dat door Anthropic is verstrekt (dit is doorgaans de aanbevolen gemaksoptie). Voorbeeld (vrij weergegeven):

# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash

Als je liever Homebrew op macOS gebruikt:

brew install --cask claude-code

Installatie: Windows

WSL：

1. Installeer WSL (Ubuntu is gangbaar) en zet een schone WSL-omgeving op. Los PATH- en interoperabiliteitsproblemen op zodat de WSL-integratie van de desktop-app toegang heeft tot de distributie.
2. Installeer Git en eventuele taalruntimes in WSL die Claude nodig kan hebben voor lokale runs (node, python, enz.).
3. Installeer of voer de desktop-app uit op Windows, wijs hem naar je WSL-projectdirectory (of start de desktop-app binnen WSL indien ondersteund), en volg dezelfde OAuth-flow.

PowerShell-voorbeeld (vrij weergegeven):

# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex

CMD-voorbeeld (vrij weergegeven):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Hoe gebruik ik Claude Code op Desktop in de dagelijkse praktijk?

Wat zijn de aanbevolen patronen voor het aanmaken van sessies?

Korte, onafhankelijke taken vs. langlopende refactors

• Voor korte, afgebakende taken (bugfix, wijziging in één bestand, kleine refactor): maak een sessie per taak en laat Claude een gerichte commit produceren. Review en merge snel.
• Voor langlopende inspanningen (grote refactors, feature-ontwikkeling): overweeg een sessie aan te maken die vaak checkpoint, en gebruik de voortgangsbediening van de desktop-UI om het werk te sturen of te pauzeren. Houd sessies op feature-branches om per ongeluk mergen te voorkomen.

Onderhoud een CLAUDE.md of een prompttemplate in je repo om te standaardiseren hoe sessies moeten worden geprompt (context, uit te voeren tests, stijlafspraken). Deze praktijk vermindert variatie en helpt Claude consistente resultaten te produceren over sessies heen. Veel teams slaan standaardprompts of guardrails op in repometadata om voorspelbaar agentgedrag te borgen.

Een sessie starten en een naam geven

1. Open de desktop-app en selecteer of kloon een repository.
2. Klik op “New Session” (of equivalent) en geef de sessie een beschrijvende naam (bijv. bugfix/cs-142 of add-tests-login). Namen helpen om gelijktijdige sessies in de UI te onderscheiden.
3. Kies de modus voor uitvoering — lokaal of remote — selecteer een doelbranch (of laat de agent een branch aanmaken in een nieuwe worktree), en start de sessie. De app maakt automatisch een dedicated Git-worktree voor de sessie aan.

De agent aansturen: prompts en taken

• Gebruik duidelijke, afgebakende prompts. Voorbeeld: “Vind de falende unittest voor AuthService en maak een fix die de bestaande publieke API behoudt; voer tests uit en rapporteer de resultaten.”
• Vraag voor incrementele taken eerst aan Claude om een plan te genereren (een korte checklist), vraag vervolgens stap voor stap om de specifieke codewijzigingen. Incrementele voortgang vermindert de kans op hallucinaties en maakt diffs eenvoudiger te reviewen. Anthropic raadt deze aanpak aan als best practice.

Voortgang bekijken en interacteren

De desktop-UI toont actielogs en diffs terwijl de agent werkt. Je kunt een sessie pauzeren, instructies wijzigen of een draaiende job annuleren. Wanneer de agent edits voorstelt, toont de UI bestandsdiffs en een uitleg van wat er is gewijzigd. Keur de voorgestelde diffs goed, bewerk of wijs ze af vóór de commit.

Commit-, branch- en PR-flows

Zodra je wijzigingen goedkeurt, kan de desktop-app committen in de branch van de worktree van de sessie. Van daaruit kun je naar origin pushen en een pull request openen via de UI (als je GitHub-toegang hebt geautoriseerd). De branch van elke sessie blijft geïsoleerd totdat je merge’t, wat menselijke review eenvoudig houdt.

Hoe werken Git-isolatie en multi-sessie-parallelisme in de praktijk?

Git-worktrees: het isolatiemechanisme

De desktopoplossing van Anthropic gebruikt Git-worktrees om per-sessie kopieën van de working tree van een repository te creëren, gekoppeld aan afzonderlijke branches. Worktrees zijn lichter dan volledige clones — ze delen waar passend dezelfde .git-metadata maar bieden onafhankelijke werkmappen, zodat gelijktijdige edits niet conflicteren of tussen sessies lekken. De desktop plaatst deze automatisch aangemaakte worktrees in een configureerbare map (standaard ~/.claude-worktrees). Dit ontwerp maakt veilige gelijktijdigheid mogelijk voor agentische operaties.

Waarom worktrees in plaats van clones

Worktrees zijn sneller aan te maken en makkelijker te correleren met dezelfde onderliggende Git-geschiedenis, terwijl ze nog steeds de vereiste bestandssysteemseparatie bieden om kruisbesmetting tussen sessies te voorkomen. Voor de meeste workflows verdient dit de voorkeur boven meerdere volledige clones; als je echter volledige, geïsoleerde runtime-omgevingen met verschillende afhankelijkheden nodig hebt, kan een aparte clone of container nog steeds wenselijk zijn.

Coördinatie en conflictafhandeling

Omdat elke sessie in een geïsoleerde branch/worktree werkt, worden conflicten geminimaliseerd. Als twee sessies onafhankelijk dezelfde logische code wijzigen en beide later in dezelfde doelbranch worden gemerged, is normale Git-mergeconflictafhandeling van toepassing — wat het juiste moment is voor menselijke review en oplossing. Het model van Anthropic brengt commits bewust als reviewbare PR’s naar voren, zodat mensen in de merge-lus blijven.

Veelvoorkomende probleemoplossing en beperkingen

Als een sessie niet start of blijft hangen

• Bevestig dat repository-toegangstokens geldig zijn en niet rate-limited.
• Controleer lokale schijfruimte en machtigingen voor de worktrees-map (bijv. ~/.claude-worktrees).
• Bekijk logboeken van de desktop-app op foutmeldingen; de app biedt meestal een diagnosetabblad of logbestand.

Als sessies elkaar besmetten

• Bevestig dat de desktop-app afzonderlijke worktrees aanmaakt (inspecteer de map ~/.claude-worktrees of de worktree-l ocatie die is ingesteld in de app-voorkeuren).
• Als je gedeelde state ziet, zorg dat je de nieuwste desktop-preview gebruikt of raadpleeg de documentatie van Anthropic — deze release pakt sessie-isolatie specifiek aan.

Als genegeerde bestanden niet beschikbaar zijn voor sessies

Voeg de bestandsnamen toe aan je .worktreeinclude-configuratie (of het equivalente in de desktop-UI) zodat de app vereiste genegeerde bestanden (bijv. .env) veilig kopieert naar elke worktree. Vermijd het opslaan of blootstellen van geheimen in worktrees zonder juiste secretsmanagement.

Conclusie

De desktop-preview van Claude Code vertegenwoordigt een betekenisvolle evolutie in hoe agentische codetools passen in ontwikkelaarsworkflows: het behoudt de snelheid en expressiviteit van AI-agents terwijl het verschillende praktische coördinatieproblemen oplost waar ontwikkelaars mee te maken hebben wanneer meerdere agents op dezelfde codebase moeten opereren. Of je het nu inzet voor productiviteit van één ontwikkelaar of om meerdere agenttaken over een team te coördineren: inzicht in Git-worktrees, .worktreeinclude en het onderscheid tussen lokale vs. websessiessies maakt je eerste week met de desktop-preview een stuk productiever.

Klaar om Claude Code cli te gebruiken? raadpleeg de API guide voor gedetailleerde instructies.

Ontwikkelaars kunnen via CometAPI toegang krijgen tot Claude Opus 4.5 API enz., de laatste modelversie wordt altijd bijgewerkt met de officiële website. Om te beginnen, verken de mogelijkheden van het model in de Playground en raadpleeg de API guide voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en een API-sleutel hebt verkregen voordat je toegang krijgt. CometAPI biedt een prijs die veel lager is dan de officiële prijs om je te helpen integreren.

Klaar om te gaan?→ Free trial of Claude opus 4.5 !

Als je meer tips, handleidingen en nieuws over AI wilt weten, volg ons op VK, X en Discord!