Table of Contents

De agentfuncties van Claude werken nu met modellen op je eigen hardware, zonder API-sleutel, abonnement of gegevens die je machine verlaten. Ollama biedt een Anthropic-compatibele API, waarop Claude Code en Claude Desktop met enkele opdrachten aansluiten.

Veel handleidingen missen één belangrijk detail. Ze beschrijven Claude Cowork en geven daarna stappen die de opdrachtregeltool instellen. Dat zijn twee verschillende integraties, en slechts één ervan biedt Cowork.

Deze gids behandelt beide routes afzonderlijk, de omgevingsvariabele die populaire handleidingen overslaan, geschikte modellen voor elke route in september 2026 en functies die cloudgebonden blijven, ongeacht je configuratie.

Na deze gids: bepaal je welke integratie je nodig hebt, verbind je die via de gedocumenteerde Ollama-route en controleer je het endpoint met één test voor toolaanroepen. Lokale inferentie houdt modelverzoeken alleen lokaal als je een lokaal model kiest en cloudfuncties vermijdt.

Kort antwoord

Ollama verbindt Claude op twee verschillende manieren. De verkeerde kiezen is de meest voorkomende reden waarom iemand een werkende terminal heeft, maar geen Cowork.

IntegratieWat je krijgtInstallatieroutePlatform
Claude DesktopCowork, subagenten, zoeken op internet, automatische modusOllama-app, daarna Apps en Connect ClaudeAlleen macOS
Claude CodeDe CLI-codeeragent met toolaanroepen en bestandsbewerkingenollama launch claude of omgevingsvariabelenmacOS, Linux, Windows

Wil je Cowork, gebruik dan de integratie met Claude Desktop. Dit is een grafische workflow in de Ollama-app. Die is alleen beschikbaar voor macOS; Windows-ondersteuning staat nog als toekomstig vermeld.

Wil je een agent in je terminal, gebruik dan Claude Code. Eén opdracht volstaat.

Beide zijn gratis. Je betaalt alleen voor hardware en elektriciteit.

Twee integraties, niet één

De verwarring begint bij de namen. Claude Cowork is een functie van Claude Desktop, geen aparte applicatie en geen andere naam voor Claude Code.

De documentatie van Ollama heeft aparte pagina’s voor beide producten. Claude Desktop staat onder Assistants, naast OpenClaw en Hermes. Claude Code staat onder Coding, naast OpenCode, Cline en Codex CLI.

Het verschil is belangrijk omdat de configuratie volledig uiteenloopt:

  • Claude Desktop stel je in via de Ollama-app. Je hoeft geen shellprofiel aan te passen.
  • Claude Code stel je in met omgevingsvariabelen of één startopdracht.

Een gids die je ANTHROPIC_BASE_URL laat instellen en daarna claude laat uitvoeren, configureert de opdrachtregeltool. Verwachtte je na die stappen de desktopervaring van Cowork, dan is er niets kapot. Je hebt een ander product ingesteld.

Claude Desktop en Cowork instellen

Deze route loopt via de Ollama-app, niet via de terminal.

Vereisten

  • Ollama geïnstalleerd op macOS. Windows-ondersteuning staat als toekomstig vermeld.
  • Eerst een model downloaden als je lokaal wilt werken. Voor een cloudmodel meld je je aan bij Ollama en schakel je cloudmodellen in. Voor sommige cloudmodellen is een betaald abonnement nodig.
  • Claude geïnstalleerd. Ontbreekt het programma, dan biedt Ollama aan het tijdens de installatie te downloaden.

Stappen

  1. Open Ollama en kies Apps.
  2. Kies Connect Claude.
  3. Volg de installatievragen. Installeer Claude als daarom wordt gevraagd en start het programma opnieuw wanneer daarom wordt gevraagd.

Dat is de hele procedure. Wil je later een ander model kiezen, open dan Ollama Settings, ga naar Apps, kies de modellen en selecteer Restart Claude.

Wat beschikbaar is

De documentatie van Ollama vermeldt vier functies als ondersteund via deze integratie:

  • Cowork, voor moeilijke taken
  • Subagents, om grotere taken over agents te verdelen
  • Web search, standaard geleverd via Ollama
  • Auto mode, waarbij de agent zelf bepaalt wanneer toestemming voor wijzigingen nodig is

Cowork staat in deze lijst. Via deze integratie werkt het dus wel, maar via de opdrachtregelroute niet.

Verbinding verbreken

Na het verbreken van de verbinding wordt de vorige Claude-configuratie hersteld. De wijziging is dus omkeerbaar.

  • Open in de interface Apps, verbreek de verbinding met Claude en start Claude opnieuw wanneer daarom wordt gevraagd.
  • Voer in een terminal ollama launch claude-desktop --restore uit.
  • Als je Ollama afsluit terwijl Claude verbonden is, worden de gebruikelijke instellingen van Claude eveneens hersteld. Laat Ollama actief als je de lokale configuratie wilt behouden.
Diagram van de Ollama-app die via het Apps-paneel verbinding maakt met Claude Desktop, met modelkeuze in Ollama-instellingen en een herstelroute naar de oorspronkelijke configuratie

Claude Code instellen via de CLI

Bijna elke gids behandelt deze route. Voor werk in de terminal is dit de juiste keuze.

Methode met één opdracht

ollama launch claude

De opdracht stelt de vereiste omgevingsvariabelen in, verwijst Claude Code naar je lokale Ollama-instantie en start het programma. Kies een model en druk op Enter. Voeg de vlag toe om vooraf een model te kiezen:

ollama launch claude --model qwen3.5

De wrapper verzorgt de omgeving. Lees de volgende sectie toch, want inzicht in die instellingen helpt bij het oplossen van problemen.

Omgevingsvariabelen handmatig instellen

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

claude --model qwen3.5

De tweede regel ontbreekt in veel populaire handleidingen. Door ANTHROPIC_API_KEY op een lege tekenreeks te zetten, voorkom je dat een bestaande echte sleutel in je omgeving de lokale verbinding verstoort. Als een gepubliceerde handleiding deze regel weglaat, krijgen lezers met een al geëxporteerde sleutel een verwarrende fout.

Gebruik deze opdrachten inline om je shellprofiel ongemoeid te laten:

ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_BASE_URL=http://localhost:11434 ANTHROPIC_API_KEY="" claude --model kimi-k2.7-code:cloud

Twee details uit de officiële documentatie:

  • ANTHROPIC_AUTH_TOKEN bevat de bearer-authenticatie. Daarom staat in lokale modus de letterlijke tekst ollama in deze variabele.
  • De eigen instellingenbestanden van Claude gaan boven shellvariabelen. Als een verbinding vreemd reageert nadat je nieuwe waarden hebt geëxporteerd, controleer je die instellingen en voer je daarna /status uit in Claude Code om het gebruikte endpoint te zien.

Rechtstreeks verbinding maken met Ollama Cloud

Voor deze route hoef je Ollama niet te installeren. Stel een API-sleutel in en verwijs Claude Code naar het gehoste endpoint van Ollama:

ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash

Er geldt één beperking. Volgens de documentatie van Ollama werken gehost zoeken op internet en geavanceerde bediening van tools via deze route niet volledig. Basischat, bestandsbewerkingen en toolaanroepen werken met compatibele modellen.

Modellen kiezen voor september 2026

Het modellenaanbod is in 2026 sterk veranderd. Advies uit het voorjaar moet je daarom opnieuw controleren.

ModelTypeContextWaarom kiezen
Qwen3.8 27BLokaal, 18 GB256KDe beste lokale allrounder van dit moment, met vision, toolaanroepen en instelbare denkmodus
Qwen3 Coder NextLokaal, MoE 80B totaal / 3B actief256KGemaakt voor altijd actieve codeeragenten, met een snelle modus zonder denkstappen
Qwen3.6 35B A3BLokaal, MoE 35B / 3B actief262KApache 2.0 en efficiënt bij beperkt geheugen
kimi-k2.7-code:cloudCloudGrootCloudmodel voor programmeerwerk zonder lokale hardware
glm-5.3-flashCloudGrootHet model dat de eigen documentatie van Ollama als eerste noemt

Begin met Qwen3.8 27B als je genoeg geheugen hebt. Het draait lokaal met een contextvenster van 256K, native vision, toolaanroepen en denkstappen die je per verzoek in- of uitschakelt. Op een kaart met ten minste 24 GB is het geschikt voor dagelijks gebruik.

Begin met een cloudmodel als je dat geheugen niet hebt. Claude Code verbinden met een gehost model kost niets om te proberen en maakt de hardwarevraag overbodig. Je code verlaat dan wel je machine.

Waarschuwing voor ternaire modellen

In onze gids voor lokale AI lees je dat het ternaire Bonsai 2 27B-model met 5,53 GiB een volledig 27B-model draait. Dat lijkt hier een aantrekkelijke keuze.

Deze workflow ondersteunt het niet. De ternaire kernels zitten in de llama.cpp-fork van Prism ML, en standaard Ollama kan deze bestanden niet laden. Een opdracht als ollama launch claude --model Ternary-Bonsai-2-27B stopt voordat inferentie begint. Gebruik voor Claude Code het standaard Qwen3.8 27B-pakket en bewaar de ternaire pakketten voor een runtime die ze ondersteunt.

Gemak en maximale efficiëntie lopen hier uiteen. De geïntegreerde tools verwachten een standaard-GGUF.

Stel een context van 64K in voordat je het model de schuld geeft

De documentatie van Ollama geeft één rechtstreeks advies voor werk in repositories: kies een model en stel een contextvenster van minstens 64K in. Verhoog dit verder voor grotere repositories.

Claude Code laadt bestandsinhoud, verschillen en opdrachtuitvoer in het contextvenster. Bij een kleine standaardwaarde raakt het model halverwege de taak vol. De fout lijkt dan op een redeneerprobleem in plaats van een configuratieprobleem.

ContextGeschikt voor
Minder dan 32KBewerkingen in één bestand en korte vragen
64KWerk met meerdere bestanden in een bescheiden repository
128KGrotere repositories en lange opdrachtuitvoer
256KHet volledige venster van Qwen3.8 27B

Raakt Claude Code halverwege een taak de draad kwijt, controleer dan de contextinstelling voordat je van model wisselt.

Toolaanroepen met één opdracht controleren

Toolaanroepen maken van een agent iets anders dan een tekstgenerator. Controleer dus of ze werken.

Vraag Claude Code nadat het is gestart:

Read the current directory and list all files

Toont het echte bestanden, dan werken toolaanroepen. Antwoordt het dat het de map zou lezen en beschrijft het wat daar vermoedelijk staat, dan is de functie niet gekoppeld. Je praat dan met een chatmodel waarop een programmeerprompt is toegepast. Geen enkele extra prompt lost dit op.

Voer deze controles in deze volgorde uit:

  1. Kies een model met bevestigde ondersteuning voor toolaanroepen. Niet elk model ondersteunt dit. Je kunt het verschil niet afleiden uit het aantal parameters.
  2. Controleer of de omgeving naar Ollama verwijst. Voer ollama --version uit en controleer of ANTHROPIC_BASE_URL naar je lokale endpoint verwijst.
  3. Voer /status uit in Claude Code. Een basis-URL of inloggegeven in de eigen instellingen van Claude gaat boven de shellvariabelen die je net hebt geëxporteerd.

Wat alleen in de cloud beschikbaar blijft

Ken deze grens voordat je een workflow rond lokale inferentie bouwt.

FunctieMet lokale modellenCloud
Chat en bestandsbewerkingenJaJa
ToolaanroepenAfhankelijk van modelJa
SubagentenJaJa
Zoeken op internetVia OllamaJa
CoworkVia de integratie met Claude DesktopJa
Automatische modusVia de integratie met Claude DesktopJa
Geplande promptsVia /loop in Claude CodeJa

Voor lokaal gebruik gelden drie kanttekeningen:

  • Redeneren over meerdere bestanden verslechtert eerder dan de snelheid. Een lokaal model werkt goed met één bestand, redelijk met drie bestanden en slecht met een volledige repository. Stem de omvang van de taak daarop af.
  • Voor sommige cloudmodellen is een betaald Ollama-abonnement nodig. Je moet ook aangemeld zijn en de cloudmodellen hebben ingeschakeld.
  • De rechtstreekse cloudroute heeft beperkingen. Gehost zoeken op internet en geavanceerde bediening van tools worden niet volledig ondersteund als je de lokale installatie overslaat.

Lokale inferentie is sterk in afgebakend werk dat je kunt controleren, en minder geschikt voor grote, onduidelijke taken. Stem je planning af op die grens.

Automatiseren

Twee functies maken deze aanpak geschikt voor meer dan interactieve sessies.

Headless uitvoeren voor scripts en CI

De vlag --yes slaat interactieve selecties over en haalt het model op als dat nodig is. Je hebt --model nodig. Alles na -- gaat rechtstreeks naar Claude Code:

ollama launch claude --model gemma4:cloud --yes -- -p "how does this repository work?"

Let op het machtigingsmodel. Claude Code vraagt voor de meeste acties om bevestiging. Een headless uitvoering vereist daarom ingestelde machtigingsregels of een geïsoleerde omgeving. Richt een onbeheerde agent niet op een repository die je wilt beschermen.

Geplande prompts met /loop

Binnen een Claude Code-sessie voert /loop met een interval een prompt of slashopdracht uit:

/loop 30m Check my open PRs and summarize their status
/loop 1h Research the latest AI news and summarize key developments
/loop 15m Check for new GitHub issues and triage by priority

Dit werkt zolang de sessie open is. Het is geen achtergrondproces en stopt zodra de sessie eindigt.

Problemen oplossen

SymptoomWaarschijnlijke oorzaakOplossing
Verbinding geweigerdOllama draait nietVoer ollama serve uit en controleer met curl http://localhost:11434/api/tags
Het model beschrijft acties in plaats van ze uit te voerenHet gekozen model ondersteunt geen toolaanroepenSchakel over naar een model met bevestigde ondersteuning voor toolaanroepen
Er wordt een echte API-sleutel gebruikt in plaats van het lokale endpointANTHROPIC_API_KEY is nog geëxporteerdStel de variabele in op een lege tekenreeks, zoals hierboven
Cowork ontbreekt na de installatieDe CLI van Claude Code is ingesteld in plaats van Claude DesktopGebruik voor Cowork de Ollama-workflow via Apps
Genereren duurt langDe context is te groot ingesteld of er is een dicht model gekozen terwijl een dun model volstaatVerlaag de context en probeer daarna een mixture-of-experts-model
Geëxporteerde variabelen hebben geen effectDe instellingenbestanden van Claude gaan boven shellvariabelenControleer de instellingenbestanden en voer daarna /status uit
Verzoeken op de achtergrond mislukkenClaude Code kiest voor interne taken een klein modelLaat de kleine-modelinstelling naar hetzelfde lokale model verwijzen

Twee van deze zeven problemen hebben dezelfde oorzaak. De meeste configuratiefouten komen door een verkeerd endpoint of een model zonder toolaanroepen.

Belangrijkste punten

  • Claude Desktop en Claude Code zijn afzonderlijke integraties. Cowork zit in Claude Desktop en wordt op macOS ingesteld via het paneel Apps van Ollama. De CLI-route biedt geen Cowork.
  • Met één opdracht start je de CLI-route: ollama launch claude. Handmatig heb je drie variabelen nodig. Veel handleidingen vergeten ANTHROPIC_API_KEY="".
  • Een lokale installatie is niet vereist. Verwijs Claude Code met een API-sleutel naar https://ollama.com.
  • Stel eerst een context van minstens 64K in. Een klein venster lijkt op een redeneerfout.
  • Controleer toolaanroepen met één verzoek. Beschrijft het model alleen wat het zou doen, dan gebruik je een tekstgenerator in plaats van een agent.
  • Ternaire Bonsai-pakketten werken hier niet. Ze vereisen de llama.cpp-fork van Prism ML. Standaard Ollama kan ze niet laden.
  • Verbinding verbreken is veilig. Als je Ollama afsluit, worden de vorige Claude-instellingen hersteld. In de terminal werkt ook ollama launch claude-desktop --restore.

Volgende stappen

  1. Installeer Ollama en haal een model met bevestigde toolondersteuning op voordat je Claude configureert: Ollama-modellenbibliotheek
  2. Lees de Claude Code-pagina van Ollama voor actuele vlaggen en modellen: Claude Code-integratie
  3. Gebruik de pagina voor Claude Desktop als je Cowork wilt: Claude Desktop-integratie
  4. Bepaal eerst welke hardware je nodig hebt aan de hand van de geheugencategorieën in onze gids voor lokale inferentie: Lokale AI in 2026: een 27B-model verslaat Sonnet 4.6
  5. Bekijk wat kleinere hardware aankan als je een altijd actieve agent op een energiezuinig apparaat wilt: Welke AI-modellen draaien op een Raspberry Pi 4 of 5?

Gerelateerde artikelen

ArtikelInhoud
Lokale AI in 2026: een 27B-model verslaat Sonnet 4.6Benchmark voor lokale inferentie, ternaire kwantisering en hardwarekeuze
Welke AI-modellen draaien op een Raspberry Pi 4 of 5?Lokale inferentie voor een kleine assistent die altijd actief is
Een privacyvriendelijke AI-assistent voor Meshtastic bouwenEen lokaal model voor een radio zonder internetverbinding, met privacy als uitgangspunt
Beste VS Code-extensies voor AI-ontwikkelingEditortools voor gebruik met een lokale codeeragent

Bronnen

  1. Claude Code-integratie - Ollama-documentatie
  2. Claude Desktop-integratie - Ollama-documentatie
  3. Ollama-modellenbibliotheek
  4. Qwen3.8 - Ollama-modellenbibliotheek
  5. Claude Cowork met lokale modellen - PromptSpace
  6. Prism ML llama.cpp-fork - ternaire kernels