Claude Code kostenlos über NVIDIA laufen lassen

NVIDIA verschenkt Entwicklern API-Zugang zu einer großen Auswahl an Modellen. Kein Guthaben nötig, keine Kreditkarte. Du brauchst nur ein Konto. Mit dem kostenlosen Werkzeug OmniRoute hängst du Claude Code an diesen Zugang und arbeitest im gewohnten Terminal weiter, ohne dein Claude-Kontingent anzufassen.

Die zwei Links, die du brauchst

OmniRoute (Gateway, läuft lokal bei dir): github.com/diegosouzapw/OmniRoute

NVIDIA Modellkatalog (hier holst du den API-Schlüssel): build.nvidia.com/models

Mehr ist es nicht. Den Rest erledigst du in etwa einer Viertelstunde.

Schritt 1: NVIDIA-Schlüssel holen

Geh auf build.nvidia.com/models und klick ein Modell an, das dich interessiert. Auf der Modellseite gibt es den Knopf „Get API Key”. Beim ersten Mal legst du dabei ein Konto an.

Kopier den Schlüssel und leg ihn sicher ab. Wie das sauber geht, steht in API-Schlüssel sicher verwalten.

Welches Modell du nimmst, ist Geschmackssache. Die OmniRoute-Doku listet für NVIDIA unter anderem Kimi K2.5, GLM 4.7 und DeepSeek V3.2. Was gerade wirklich verfügbar ist, siehst du im Katalog.

Die Basis-URL von NVIDIA lautet https://integrate.api.nvidia.com/v1. Merk sie dir für den Fall, dass du sie irgendwo von Hand eintragen musst. OmniRoute kennt sie bereits.

Schritt 2: OmniRoute installieren

Der faule Weg: Kopier den OmniRoute-Link in deine Claude-Code-Sitzung und schreib dazu, dass Claude das Ding installieren und einrichten soll. Claude liest das Repo, installiert das Paket und startet den Server. Das ist der Weg, den ich im Reel zeige.

Der Weg von Hand:

npm install -g omniroute
omniroute

Danach läuft das Dashboard auf http://localhost:20128, die Schnittstelle für andere Werkzeuge liegt auf http://localhost:20128/v1. Peer-Dependency-Warnungen beim Installieren sind laut Doku harmlos.

Schritt 3: NVIDIA in OmniRoute eintragen

Öffne das Dashboard unter http://localhost:20128 und geh auf Providers. Such dort den Anbieter NVIDIA NIM, setz deinen NVIDIA-Schlüssel ein, aktivier den Anbieter und lass ihn testen.

Ab jetzt kennt OmniRoute die NVIDIA-Modelle. Sie tragen das Präfix nvidia/. Welche IDs es genau sind, fragst du direkt ab:

curl http://localhost:20128/v1/models -H "Authorization: Bearer DEIN-OMNIROUTE-SCHLÜSSEL"

Schritt 4: Den OmniRoute-Schlüssel abholen

Im Dashboard unter Endpoints liegt dein OmniRoute-API-Schlüssel. Den schickt Claude Code gleich mit jeder Anfrage an deinen lokalen Server. Der NVIDIA-Schlüssel bleibt in OmniRoute liegen und verlässt deinen Rechner nur in Richtung NVIDIA.

Schritt 5: Claude Code umstellen

Jetzt bekommt Claude Code eine neue Adresse. Öffne ~/.claude/settings.json und trag einen env-Block ein:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "DEIN-OMNIROUTE-SCHLÜSSEL",
    "ANTHROPIC_MODEL": "nvidia/DEINE-MODELL-ID",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Drei Dinge sind hier wichtig.

An die Basis-URL gehört kein /v1. Claude Code hängt den Pfad /v1/messages selbst an. Mit /v1 in der Zeile läuft die Anfrage ins Leere.

ANTHROPIC_MODEL musst du setzen. Die eingebaute Modellauswahl von Claude Code zeigt über einen Gateway nur IDs, die mit claude oder anthropic beginnen. Ein nvidia/... erscheint dort nie, obwohl es sauber geroutet wird. Deshalb trägst du es fest ein.

Die Variablen werden beim Start gelesen. Nach jeder Änderung an dieser Datei musst du Claude Code neu starten.

Das gilt für das Terminal und für die Desktop-App gleichermaßen. Beide lesen dieselbe settings.json.

Abkürzung: Wenn du dir die Datei sparen willst, startet OmniRoute Claude Code auch selbst mit den passenden Variablen:

omniroute run claude --model nvidia/DEINE-MODELL-ID

Schritt 6: In Claude Code ausloggen

Das ist der Schritt, den die meisten Anleitungen weglassen, und ohne ihn sparst du gar nichts.

Laut Anthropic-Dokumentation bleibt ein gespeichertes claude.ai-Login das aktive Zugangsdaten-Set, selbst wenn du eine andere Basis-URL gesetzt hast. Deine Anfragen laufen dann weiter über dein Abo. Starte Claude Code also einmal und tipp:

/logout

Schritt 7: Testlauf

Claude Code neu starten und irgendwas fragen, das eine klare Antwort gibt. Ich frage gern nach dem Modell selbst, das verrät sofort, wer am anderen Ende sitzt.

Wenn keine Antwort kommt, prüf in dieser Reihenfolge: läuft omniroute noch im Terminal, steht in der Basis-URL wirklich kein /v1, und hast du Claude Code nach der Änderung neu gestartet.

Was du wissen musst

Die beiden reden verschiedene Sprachen. Claude Code spricht die Anthropic Messages API. NVIDIA bietet nur eine OpenAI-kompatible Schnittstelle an, einen Pfad /v1/messages gibt es dort nicht. Genau diese Lücke schließt OmniRoute als Übersetzer zwischen beiden Formaten.

Es antwortet nicht mehr Claude. Die Oberfläche bleibt Claude Code, mit allen Werkzeugen und Befehlen, die du kennst. Denken tut ab jetzt das NVIDIA-Modell. Bei Qualität und Ton merkst du den Unterschied.

Das Limit. Die OmniRoute-Provider-Referenz nennt für den freien NVIDIA-Zugang rund 40 Anfragen pro Minute. Beim normalen Arbeiten fällt das nicht auf. Wenn du mehrere Agenten parallel laufen lässt, schon.

Anthropic unterstützt das nicht. In der offiziellen Doku zu fremden Gateways steht wörtlich, dass Anthropic es nicht unterstützt, Claude Code über ein Gateway auf Nicht-Claude-Modelle zu routen. Verboten ist es nicht, aber es kann nach einem Update klemmen, und Support gibt es dafür keinen.

Zu Daten. Gratis-Zugänge sind gut für eigene Projekte und zum Rumprobieren. Kundendaten, Verträge und alles Vertrauliche gehören da nicht rein.

Zurück auf Claude

Den env-Block aus ~/.claude/settings.json löschen, Claude Code neu starten, wieder anmelden. Fertig.

Wenn du dasselbe lieber über OpenRouter bauen willst, gibt es das hier: Claude Code auf ein Gratis-Modell umstellen.