Claude Code mit Ollama: lokal verbinden und die Grenzen prüfen

Claude Code ist der Client, Ollama liefert das Modell

Claude Code organisiert Projektkontext, Dateiaktionen und Befehle. Ollama stellt einen Modell-Endpunkt bereit. Die Inferenz übernimmt das gewählte lokale oder gehostete Modell. Die kompatible Schnittstelle verbindet diese Rollen, ersetzt aber weder das Modell noch dessen Fähigkeiten.

Der Grundlagenartikel „Die Rolle von Ollama verstehen“ erklärt den Unterschied zwischen Laufzeit und Modell. Ein Modellalias, der wie ein Claude-Name aussieht, ändert ebenfalls keine Gewichte in ein proprietäres Claude-Modell.

Lokal bedeutet hier eine bewusst gewählte lokale Modellverarbeitung. Ein Ollama-Server auf localhost kann auch angemeldete Cloudmodelle weiterleiten. Externe Werkzeuge haben zusätzlich eigene Datenwege. Verlasse dich deshalb nicht allein auf die Adresse des Clients.

Installation, Modell und Kontext vorbereiten

Installiere Ollama und Claude Code aus ihren offiziellen Quellen passend zu deinem Betriebssystem. Die aktuelle Claude-Code-Übersicht enthält getrennte Wege für macOS, Linux und Windows. Prüfe nach der Installation in einem neuen Terminal die Versionsausgaben, statt Befehle für eine andere Shell zu mischen.

ollama --version
claude --version
ollama ls
ollama ps

Wähle ein lokales Modell mit geeigneter Werkzeugunterstützung und genügend Kontext. Ein kleines Chatmodell ist nicht automatisch ein zuverlässiger Coding-Agent. Ollama empfiehlt für größere Coding-Aufgaben Kontext ab etwa 64k; der Rechner und das Modell müssen den zusätzlichen Speicherbedarf tragen können.

Der Guide „Das zugewiesene Kontextfenster prüfen“ erklärt den Unterschied zwischen Katalogmaximum, Einstellung und aktivem Wert. Beginne bei knapper Hardware mit einer kleineren Aufgabe, statt pauschal den größten Kontext einzutragen.

Mit Ollama Launch verbinden

Die offizielle Ollama-Integration bietet einen interaktiven Start. Öffne zuvor einen separaten Übungsordner ohne private Daten und produktive Schlüssel. Lege darin die kleine Notizdatei aus dem nächsten Abschnitt ab.

ollama launch claude

Prüfe in der Auswahl den konkreten Modellnamen und wähle ausdrücklich einen lokalen Weg, wenn du lokale Inferenz möchtest. Achte darauf, ob ein Download nötig ist und wie groß er ist. Eine Cloud-Kennzeichnung darf dabei nicht als austauschbares Namensdetail übersehen werden.

Behalte die üblichen Rückfragen zu Datei- und Befehlsaktionen bei. Automatisches Bestätigen oder pauschales Abschalten der Rechteprüfung gehört nicht zu dieser Einsteigerprobe. Eine erfolgreiche Startmeldung belegt zunächst nur den gestarteten Client, noch keine passende Modellantwort.

Die Verbindung für eine Sitzung selbst setzen

Alternativ kannst du die dokumentierten Verbindungsvariablen bewusst für einen eigenen Terminalstart setzen. Ersetze im folgenden Beispiel DEIN_LOKALES_MODELL durch einen tatsächlich installierten lokalen Modellnamen. Die Vorlage wählt keinen passenden Namen für dich aus.

ANTHROPIC_AUTH_TOKEN=ollama \
ANTHROPIC_API_KEY="" \
ANTHROPIC_BASE_URL=http://localhost:11434 \
claude --model DEIN_LOKALES_MODELL

ollama ist hier ein dokumentierter Platzhalter für den lokalen Endpunkt, kein persönlicher Zugangsschlüssel. Der lokale Ollama-Server prüft diesen Schlüssel nicht als Schutz. Veröffentliche ihn deshalb nicht ungeschützt im Netz.

Die Syntax oben gilt für Bash und Zsh. Für PowerShell verwendest du dessen Umgebungsvariablensyntax oder den interaktiven Launch-Weg; kopiere die Zeilen nicht unverändert in CMD. Hinterlege keine echten Anthropic- oder Ollama-Cloudschlüssel in dieser Lernvorlage.

Öffne im gestarteten Claude Code /status und prüfe Provider, Basis-URL sowie gegebenenfalls Proxy. Claude-Einstellungen können die Shell-Konfiguration beeinflussen. Kontrolliere den wirksamen Zustand, wenn die Sitzung trotz gesetzter Variablen einen anderen Weg nutzt.

Mit einer lesenden Aufgabe anfangen

Lade die fiktiven Lumen-Projektnotizen herunter und lege sie als notizen.txt im eigenen Übungsordner ab. Die Datei enthält nur zwei bekannte Fakten und eine ausdrücklich offene Angabe.

Lies ausschließlich notizen.txt in diesem Übungsordner.
1. Welcher Port ist für die lokale Vorschau notiert?
2. Wie heißt die Beispielkonfiguration?
3. Welches Veröffentlichungsdatum steht fest?
Belege jede Antwort mit dem passenden Satz.
Falls eine Angabe fehlt, schreibe „nicht festgelegt“.
Ändere keine Datei, installiere nichts und nutze keinen externen Dienst.

Die erwarteten Fakten lauten 4317 und lumen.example.json. Ein Veröffentlichungsdatum ist nicht festgelegt. Das sind Inhalte der eigenen fiktiven Datei, keine hier gemessenen Modellantworten.

Prüfe Antwort und tatsächliche Aktionen. Ein Prompt allein begrenzt die technischen Rechte nicht. Die Lektion „Einen Agenten zuerst kontrolliert ausprobieren“ hilft dir, Umgebung und erlaubte Effekte passend einzugrenzen.

Kontext, Tools und Cloudwege gezielt diagnostizieren

Die Anthropic-kompatible API ist eine Teilmenge. Die gelesene Ollama-Referenz nennt unter anderem Einschränkungen bei gezielter Tool-Choice-Kontrolle sowie fehlende Anthropic-Prompt-Caching-, PDF-Dokumentblock- und Tokenzähl-Endpunkte. Ein erfolgreicher einfacher Prompt beweist deshalb nicht, dass jede Claude-Code-Funktion gleich arbeitet.

Lokaler Betrieb benötigt Hardware und Energie; Cloudmodelle und externe APIs haben eigene Bedingungen. Versprich weder pauschal kostenlose Nutzung noch vollständige Offline-Verarbeitung, solange die gesamte Kette nicht geprüft ist.

Für diesen Artikel wurden keine Programme installiert, keine Modelle heruntergeladen und keine Coding-Agenten ausgeführt. Notizdatei, Auftrag und Diagramm sind eigene Lernhilfen. Prüfe die aktuelle Dokumentation erneut, wenn sich Client, Modell oder Ollama-Version ändern.