Beginnen met Claude Code

Claude Code is een terminalgebaseerde coding-agent van Anthropic die bestanden kan lezen, code kan aanpassen en commando’s kan uitvoeren in je werkdirectory. Door Claude Code op een VPS te gebruiken, krijg je een permanente Linux-omgeving voor langdurige coding-sessies, externe repositories en ontwikkelwerk dat onafhankelijk van je laptop kan doorgaan.

In deze handleiding installeer je Claude Code op een Linux-VPS en gebruik je het veilig via SSH. Dit is een praktische setup voor ontwikkel- en automatiseringswerk, omdat het taalmodel zelf via Anthropic of een geconfigureerde cloudprovider draait en niet op je VPS.

Waarom een GPU niet vereist is

Bij een standaardinstallatie van Claude Code voert je VPS zelf geen model-inferentie uit. In de praktijk betekent dit dat een VPS zonder GPU voldoende is, zolang de server genoeg geheugen, internettoegang en een ondersteunde Linux-distributie heeft.

Je VPS levert vooral de shell, bestandstoegang, git-repository en runtime-omgeving waarin Claude Code werkt. Een snellere CPU en meer geheugen verbeteren lokale taken zoals pakketinstallaties, tests, indexering en builds, maar een GPU is geen vereiste voor de Claude Code-client zelf.

Claude Code handmatig installeren

Stap 1

Maak verbinding met je VPS via SSH of de VPS-console.

Stap 2

Update je server en installeer de tools die in deze handleiding worden gebruikt:

sudo apt -y update && sudo apt -y upgrade && sudo apt -y install curl git build-essential tmux

In dit commando downloadt curl de installer, wordt git gebruikt voor repositories, levert build-essential algemene build-tools voor lokale dependencies en zorgt tmux ervoor dat je shellsessie blijft draaien nadat je de SSH-verbinding verbreekt. Bij de meeste installaties zijn deze pakketten al vooraf geïnstalleerd.

Stap 3

Installeer Claude Code met Anthropic's aanbevolen Linux-installer:

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

Wil je een iets conservatiever releasekanaal gebruiken? Installeer dan het stable-kanaal:

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

In het tweede commando selecteert stable Anthropic's vertraagde stable-releasekanaal in plaats van het standaard latest-kanaal.

Stap 4

Herlaad je shell en controleer of Claude Code beschikbaar is:

source ~/.bashrc
claude --version

Als het versienummer wordt weergegeven, is Claude Code correct geïnstalleerd. Let op: De installer voegt ~/.local/bin mogelijk niet toe aan PATH in de shellconfiguratie. Als je in deze stap een foutmelding krijgt, probeer dit dan expliciet voor deze sessie te exporteren.

export PATH="$HOME/.local/bin:$PATH"

Stap 5

Start tot slot Claude Code:

claude

Bij de eerste start leidt Claude Code je door een onboardingproces. In het volgende hoofdstuk lees je welke stappen daarbij horen. 

Claude Code-onboarding

Stap 1

Wanneer je Claude Code voor het eerst uitvoert met het commando claude, of inlogt op een VPS waarop Claude Code vooraf is geïnstalleerd, zie je het volgende scherm. De kleuren kunnen iets afwijken:

Welcome to Claude Code v2.1.132
…………………………………………………………………………………………………………………………………………………………

     *                                       █████▓▓░
                                 *         ███▓░     ░░
            ░░░░░░                        ███▓░
    ░░░   ░░░░░░░░░░                      ███▓░
   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓
                                             ░▓▓███▓▓░
 *                                 ░░░░
                                 ░░░░░░░░
                               ░░░░░░░░░░░░░░░░
       █████████                                        *
      ██▄█████▄██                        *
       █████████      *
…………………█ █   █ █………………………………………………………………………………………………………………

 Let's get started.

 Choose the text style that looks best with your terminal
 To change this later, run /theme

   1. Auto (match terminal)
 ❯ 2. Dark mode ✔
   3. Light mode
   4. Dark mode (colorblind-friendly)
   5. Light mode (colorblind-friendly)
   6. Dark mode (ANSI colors only)
   7. Light mode (ANSI colors only)

 ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
  1  function greet() {
  2 -  console.log("Hello, World!");
  2 +  console.log("Hello, Claude!");
  3  }
 ╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
  Syntax theme: Monokai Extended (ctrl+t to disable)

Gebruik de pijltjestoetsen om je gewenste thema te kiezen en druk op Enter om verder te gaan.

Stap 2

Kies vervolgens je LLM-provider. Heb je gekozen voor Ollama, zie het volgende hoofdstuk? Dan wordt deze stap overgeslagen. 

Claude Code can be used with your Claude subscription or billed based on API usage through your Console account.

 Select login method:

 ❯ 1. Claude account with subscription · Pro, Max, Team, or Enterprise

   2. Anthropic Console account · API usage billing

   3. 3rd-party platform · Amazon Bedrock, Microsoft Foundry, or Vertex AI

Afhankelijk van je keuze krijg je een van de volgende opties te zien:

1. Plak een URL om in te loggen (Claude Code met een abonnement op een VPS), bijvoorbeeld:
   Browser didn't open? Use the url below to sign in (c to copy) 

https://claude.com/cai/oauth/authorize?code=true&client_id=9d1c250a-e61b-44d9-88ed-5944d1962f5e&response_type=code&redirect_ uri=https%3A%2F%2Fplatform.claude.com%2Foauth%2Fcode%2Fcallback&scope=org%3Acreate_api_key+user%3Aprofile+user%3Ainference+u ser%3Asessions%3Aclaude_code+user%3Amcp_servers+user%3Afile_upload&code_challenge=EmFjVdDZa_t9LTV5k9aRG0mYI2WuyYuMoUcQJWJ1fD E&code_challenge_method=S256&state=5K1j3i21eZ0se8vu6qAQg4HosOqkTzo0Kn9fOOFxbp0
    
2. Log in op je Anthropic-account in je browser (wanneer je Claude Code lokaal met een Anthropic-abonnement gebruikt).
    
3. Voer API-gegevens in (Anthropic Console-account).
    
4. Voer gegevens in voor het externe platform.

Stap 3

Je krijgt nu een beveiligingswaarschuwing te zien. Druk op ‘Enter’ om door te gaan naar de volgende waarschuwing. 

 Security notes:

 1. Claude can make mistakes
    You should always review Claude's responses, especially when
    running code.

 2. Due to prompt injection risks, only use it with code you trust
    Learn more: https://code.claude.com/docs/en/security
 
 Press Enter to continue…

Daarna krijg je een laatste waarschuwing te zien. Druk opnieuw op ‘Enter’:

───────────────────────────────────────────────────────────────────────────
 Accessing workspace:

 /home/username

 Quick safety check: Is this a project you created or one you trust? (Like your own code, a well-known open source project,
  or work from your team). If not, take a moment to review what's in this folder first.

 Claude Code'll be able to read, edit, and execute files here.

 Security guide

 ❯ 1. Yes, I trust this folder
   2. No, exit

Tot slot krijg je een herinnering over de optie om met teams te werken:

 On a team?

 Ask a teammate to run /team-onboarding and share the guide.
 Paste it as your first message and I'll get you set up.

 Press Enter to continue…

Druk nog één keer op ‘Enter’ om het onboardingproces af te ronden.

Vanaf dit punt kun je simpelweg met Claude Code chatten om het te gebruiken. Een overzicht van nuttige commando's vind je in ons artikel ‘Handige Claude Code commando's’.

Ollama gebruiken met Claude Code

Als alternatief voor een betaald Anthropic-account kun je ook een LLM gebruiken die wordt gehost op je eigen Ollama-installatie op dezelfde server, of op een externe server. Stel hiervoor de omgevingsvariabelen als volgt in:

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434

Start Claude vanaf dit punt door het gehoste Ollama-model op te geven. Het model moet aanwezig en beschikbaar zijn op je Ollama-server:

claude --model ollama/qwen2.5-coder:14b

Tips om Claude Code veilig op een VPS te gebruiken

Claude Code kan bestanden lezen, code aanpassen en shellcommando’s uitvoeren. Daarom is het verstandig om een paar minuten te nemen om je werkomgeving te scheiden van de rest van de server.

Stap 1

Start een permanente terminalsessie voordat je Claude Code opent:

tmux new -s claude

Als je SSH-verbinding wegvalt, houdt tmux de sessie actief. Maak later opnieuw verbinding met:

tmux attach -t claude

Stap 2

Werk in een dedicated projectdirectory in plaats van in je volledige homedirectory of systeempaden:

mkdir -p ~/projects/example-project
cd ~/projects/example-project
claude

Zo blijft de scope van bestandstoegang voorspelbaar en kun je eenvoudiger controleren waar Claude Code bij kan.

Stap 3

Open het permissieoverzicht van Claude Code vanuit Claude Code met:

/permissions

Claude Code maakt onderscheid tussen leestoegang, shellcommando’s en bestandsbewerkingen. Controleer deze permissies voordat je Claude Code in een belangrijke repository laat werken, en behoud de standaard goedkeuringsflow tenzij je in een bewust geïsoleerde ontwikkelomgeving werkt.

Stap 4

Vermijd het uitvoeren van Claude Code als root, tenzij je echt systeemwijde wijzigingen moet uitvoeren. Als je normaal gesproken als root inlogt, maak dan eerst een aparte gebruiker aan:

adduser claude
usermod -aG sudo claude
su - claude

Een aparte gebruiker verkleint het risico op onbedoelde wijzigingen aan systeembestanden. Gebruik sudo alleen voor commando’s die daadwerkelijk verhoogde rechten nodig hebben.

Stap 5

Gebruik bypassPermissions niet op een VPS die ook productiedata, deploymentsleutels of klantinformatie bevat. Anthropic raadt expliciet aan om die modus alleen in geïsoleerde omgevingen te gebruiken. Op een normale ontwikkel-VPS is de standaard permissiemodus de veiligere keuze.

Veelgestelde vragen

/theme

claude --model ollama/qwen2.5-coder:14b --dangerously-skip-permissions

claude update

Claude Code werkt goed op een VPS zonder GPU, omdat de VPS de ontwikkelomgeving levert terwijl het model op afstand draait via Anthropic of een ondersteunde cloudprovider. Met een kleine voorbereiding, vooral een aparte gebruiker, een dedicated projectdirectory en een tmux-sessie, krijg je een praktische en gecontroleerde remote coding-setup.