Claude Code einrichten: Anthropic vs. OpenRouter

1 Voraussetzungen & Grundbegriffe

Bevor wir loslegen, kläre kurz zwei Dinge: Was du brauchst und was du nicht brauchst.

Du brauchst NICHT:

• Ein Claude-Abo bei Anthropic (kostet ca. 18–90 € / Monat)
• Programmierkenntnisse
• Einen teuren Computer (außer beim Ollama-Weg)

Du brauchst:

• Einen Windows-, Mac- oder Linux-Computer
• Eine stabile Internetverbindung
• Ca. 20–30 Minuten Zeit

2 Installation: Node.js & Claude Code

Schritt 2.1 — Node.js installieren

Claude Code ist in JavaScript geschrieben und benötigt Node.js als Laufzeitumgebung. Das ist kostenlos und offiziell.

1. 1
   Gehe auf nodejs.org und lade die Version mit der Aufschrift "LTS" (Long Term Support) herunter. LTS bedeutet: stabil und empfohlen. Nicht die neueste Version nehmen.
2. 2
   Öffne die heruntergeladene Datei und folge dem Installations-Assistenten. Klicke einfach immer auf "Weiter / Next". Keine Anpassungen nötig.
3. 3
   Starte deinen Computer neu (oder zumindest das Terminal). Das ist wichtig, damit Windows/Mac den neuen Befehl npm kennt.
4. 4
   Öffne das Terminal und tippe diesen Befehl, um die Installation zu prüfen:

   node --version

   Du solltest etwas wie v22.14.0 sehen. Erscheint eine Zahl → alles gut. Erscheint ein Fehler → Node.js neu installieren.

Schritt 2.2 — Claude Code installieren

Jetzt installierst du Claude Code selbst. Tippe diesen Befehl in dein Terminal:

terminalnpm install -g @anthropic-ai/claude-code

Das -g bedeutet "global" — Claude Code wird systemweit installiert, nicht nur für ein einzelnes Projekt. Die Installation dauert ca. 1–2 Minuten.

Prüfe danach die Installation:

terminalclaude --version

Du solltest eine Versionsnummer sehen (z. B. 1.2.3 (Claude Code)). Falls ein Fehler erscheint, lies den Troubleshooting-Abschnitt am Ende.

3 Die 2 Modi im Vergleich

Claude Code kann auf zwei grundsätzlich verschiedene Arten betrieben werden. Verstehe den Unterschied, bevor du weitermachst — er bestimmt, welche settings.json du brauchst.

4 Modus 1: Anthropic direkt

Bei diesem Modus kommuniziert Claude Code direkt mit Anthropics Servern. Du bekommst die originalen Claude-Modelle in voller Qualität.

Variante A — Claude-Abo (claude.ai Pro / Max)

Du hast ein Abo auf claude.ai? Dann ist die Einrichtung am einfachsten:

1. 1
   Stelle sicher, dass deine settings.json keine Zeile mit ANTHROPIC_BASE_URL enthält — oder dass die Datei noch gar nicht existiert. Das ist der Standardzustand.
2. 2
   Starte Claude Code im Terminal:

   terminalclaude

3. 3
   Beim ersten Start erscheint ein Login-Dialog. Wähle Option 1: "Claude account with subscription". Es öffnet sich ein Browserfenster — melde dich mit deinem claude.ai-Account an.

Die settings.json beim Abo-Modus: Sie kann leer bleiben oder komplett fehlen. Falls sie existiert, darf sie keine URL-Umleitung enthalten:

~/.claude/settings.json (Abo-Modus){
  "theme": "dark"
}

Oder gar keine Datei — Claude Code meldet sich dann einfach über den Browser an.

Variante B — Anthropic API-Key (Console / pay-per-use)

Du hast einen API-Key von console.anthropic.com? Damit zahlst du pro Token, brauchst kein Abo.

1. 1
   Gehe auf console.anthropic.com → API Keys und erstelle einen neuen Key. Er beginnt mit sk-ant-....
2. 2
   Erstelle oder bearbeite die globale settings.json (~/.claude/settings.json) mit diesem Inhalt:

   ~/.claude/settings.json (API-Key-Modus){
     "env": {
       "ANTHROPIC_API_KEY": "sk-ant-DEIN_ANTHROPIC_KEY_HIER"
     }
   }

3. 3
   Starte Claude Code:

   terminalclaude

   Claude Code erkennt den API-Key automatisch und verbindet sich mit Anthropics Servern — kein Browser-Login nötig.

Startbefehl für Anthropic-Modus

terminal — Anthropic direkt# Einfach starten (nutzt eingeloggten Account oder API-Key aus settings.json)
claude

# Bestimmtes Modell erzwingen
claude --model claude-sonnet-4-5-20250929

# Oder das leistungsstärkste Modell
claude --model claude-opus-4-5

5 Modus 2: OpenRouter

OpenRouter ist ein Dienst, der dir Zugang zu über 300 KI-Modellen über eine einzige Schnittstelle gibt. Viele Modelle sind kostenlos nutzbar.

Schritt 5.1 — OpenRouter-Account & Key erstellen

1. 1
   Gehe auf openrouter.ai und erstelle einen kostenlosen Account.
2. 2
   (Optional, aber empfohlen) Lade einmalig 5–10 USD Guthaben auf ("Credits" im Dashboard). Mit einem kleinen Guthaben werden tägliche Gratis-Kontingente für viele Modelle freigeschaltet. Das Guthaben wird dabei nicht verbraucht, solange du kostenlose Modelle nutzt.
3. 3
   Navigiere im Dashboard zu "API Keys" → "Create Key". Kopiere den generierten Key — er beginnt mit sk-or-v1-....

Schritt 5.2 — settings.json für OpenRouter

Speicherort der globalen settings.json:

• Windows: C:\Users\DEINNAME\.claude\settings.json
• macOS / Linux: ~/.claude/settings.json

Erstelle den Ordner falls nötig:

powershellNew-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

terminalmkdir -p ~/.claude
nano ~/.claude/settings.json

Kopiere diesen Inhalt in die Datei:

~/.claude/settings.json (OpenRouter-Modus){
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-DEIN_OPENROUTER_KEY_HIER",
    "ANTHROPIC_API_KEY": """",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "meta-llama/llama-3.3-70b-instruct:free"
  }
}

Schritt 5.3 — Alten Login entfernen

Falls du vorher im Anthropic-Modus eingeloggt warst, musst du dich zuerst abmelden:

terminal# Starte Claude Code kurz
claude

# Dann im Claude-Code-Prompt eingeben:
/logout

Danach Claude Code mit /exit beenden und neu starten.

Startbefehl für OpenRouter-Modus

terminal — OpenRouter# Normaler Start (nutzt Modell aus settings.json)
claude

# Bestimmtes Modell für diese Sitzung erzwingen
claude --model meta-llama/llama-3.3-70b-instruct:free

# Claude über OpenRouter nutzen (kostenpflichtig, aber günstiger als direkt)
claude --model anthropic/claude-sonnet-4

# Günstigstes leistungsfähiges Modell
claude --model deepseek/deepseek-chat-v3

Du kannst das Modell auch innerhalb einer laufenden Sitzung wechseln:

innerhalb claude code/model meta-llama/llama-3.3-70b-instruct:free

Verbindung prüfen

Starte Claude Code und tippe:

innerhalb claude code/status

Du siehst dann, mit welchem Backend und Modell du gerade verbunden bist. Prüfe auch dein OpenRouter-Dashboard unter "Activity" — dort erscheinen deine Anfragen in Echtzeit.

6 Zwischen den Modi wechseln

Das Wechseln ist einfacher als du denkst. Es gibt zwei Methoden:

Methode 1: Zwei settings-Dateien vorbereiten (empfohlen)

Erstelle einmalig zwei Dateien im .claude-Ordner — eine für jeden Modus. Zum Wechseln kopierst du einfach die gewünschte Datei.

powershell — einmalig# Anthropic-Vorlage erstellen
notepad "$env:USERPROFILE\.claude\settings-anthropic.json"
# Inhalt: {"env": {"ANTHROPIC_API_KEY": "sk-ant-DEINKEY"}}

# OpenRouter-Vorlage erstellen
notepad "$env:USERPROFILE\.claude\settings-openrouter.json"
# Inhalt: siehe Abschnitt 5

powershellCopy-Item "$env:USERPROFILE\.claude\settings-anthropic.json" `
          "$env:USERPROFILE\.claude\settings.json" -Force

powershellCopy-Item "$env:USERPROFILE\.claude\settings-openrouter.json" `
          "$env:USERPROFILE\.claude\settings.json" -Force

terminal — einmalig# Anthropic-Vorlage anlegen
nano ~/.claude/settings-anthropic.json
# Inhalt: {"env": {"ANTHROPIC_API_KEY": "sk-ant-DEINKEY"}}

# OpenRouter-Vorlage anlegen
nano ~/.claude/settings-openrouter.json
# Inhalt: siehe Abschnitt 5

terminalcp ~/.claude/settings-anthropic.json ~/.claude/settings.json

terminalcp ~/.claude/settings-openrouter.json ~/.claude/settings.json

alias cc-anthropic='cp ~/.claude/settings-anthropic.json ~/.claude/settings.json && echo "✅ Anthropic-Modus aktiv"'
alias cc-openrouter='cp ~/.claude/settings-openrouter.json ~/.claude/settings.json && echo "✅ OpenRouter-Modus aktiv"'

Methode 2: Direkt beim Starten per Umgebungsvariable

Du kannst Einstellungen auch direkt beim Start überschreiben, ohne die settings.json zu ändern. Diese Methode ist gut für einmalige Sitzungen:

powershell$env:ANTHROPIC_BASE_URL="https://openrouter.ai/api"
$env:ANTHROPIC_AUTH_TOKEN="sk-or-v1-DEINKEY"
$env:ANTHROPIC_API_KEY=""
claude

powershellRemove-Item Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
$env:ANTHROPIC_API_KEY="sk-ant-DEINKEY"
claude

terminalANTHROPIC_BASE_URL="https://openrouter.ai/api" \
ANTHROPIC_AUTH_TOKEN="sk-or-v1-DEINKEY" \
ANTHROPIC_API_KEY="" \
claude

terminalunset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
ANTHROPIC_API_KEY="sk-ant-DEINKEY" claude

Schnell-Übersicht: Welche settings.json für welchen Modus?

7 Was muss ich konkret tun? — Die explizite Checkliste

Dieser Abschnitt ist eine direkte Antwort auf die Frage: "Was genau mache ich, wenn ich Anthropic nutzen will — und was, wenn ich OpenRouter nutzen will?" Kein Erklärtext, nur Schritte.

~/.claude/settings.json → Anthropic-Modus (leere Datei){}

terminalclaude

~/.claude/settings.json → Anthropic API-Key{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-DEIN_KEY_HIER"
  }
}

terminalclaude

im Claude Code Prompt/status

~/.claude/settings.json → OpenRouter-Modus{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-DEIN_OPENROUTER_KEY_HIER",
    "ANTHROPIC_API_KEY": """",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "meta-llama/llama-3.3-70b-instruct:free"
  }
}

im Claude Code Prompt/logout

terminalclaude

8 Weg C: Ollama (vollständig lokal)

Bei Ollama läuft die KI komplett auf deinem Computer. Kein Internet nötig, keine Kosten, volle Privatsphäre. Dafür braucht dein PC etwas mehr Leistung.

Schritt 5.1 — Ollama installieren

1. 1
   Gehe auf ollama.com und lade das Programm für dein Betriebssystem herunter. Installation ist wie ein normales Programm.
2. 2
   Starte Ollama. Es läuft im Hintergrund (du siehst es evtl. im System-Tray / in der Menüleiste).
3. 3
   Lade ein Sprachmodell herunter. Für Programmieraufgaben empfohlen:

   ollama pull qwen2.5-coder:7b

   Das Modell ist ca. 4,7 GB groß. Einmaliger Download.

Schritt 5.2 — settings.json für Ollama

Bearbeite deine ~/.claude/settings.json und ersetze den gesamten Inhalt durch:

settings.json{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:11434/api",
    "ANTHROPIC_AUTH_TOKEN": "ollama",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen2.5-coder:7b"
  }
}

9 Claude Code starten & erste Befehle

Jetzt kommt der spannende Teil. Öffne das Terminal, navigiere zu einem Projektordner und starte Claude Code:

terminalclaude

Beim allerersten Start erscheint möglicherweise eine Abfrage zu Nutzungsbedingungen. Bestätige mit Enter.

Wichtige Befehle in Claude Code

Dein erstes Gespräch

Sobald Claude Code gestartet ist, kannst du direkt in normaler Sprache schreiben:

beispielErstelle eine einfache Python-Datei, die "Hallo Welt" ausgibt.

10 Modelle bei OpenRouter: Auto-Router, Gratis-Modelle & Modell-Namen finden

Option A — Der automatische Gratis-Router (einfachste Lösung)

OpenRouter bietet einen speziellen Modell-Namen, der automatisch ein verfügbares kostenloses Modell auswählt: openrouter/free

~/.claude/settings.json → Auto-Router{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-DEIN_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "openrouter/free"
  }
}

Option B — Einen bestimmten Modell-Namen selbst finden

Du möchtest ein bestimmtes Modell nutzen? So findest du den exakten Namen, den du in die settings.json eintragen kannst:

1. 1
   Gehe auf openrouter.ai/models — das ist die offizielle Modellliste.
2. 2
   Nur Gratis-Modelle anzeigen: Klicke links auf den Filter "Free" oder füge ?pricing=free an die URL an. Du siehst jetzt nur Modelle, die $0 kosten.

   https://openrouter.ai/models?pricing=free
3. 3
   Klicke auf ein Modell, das dich interessiert. Es öffnet sich die Detailseite.
4. 4
   Den Modell-Namen kopieren: Auf der Detailseite siehst du oben in der URL oder direkt auf der Seite den Identifier im Format anbieter/modellname:free. Klicke auf das Kopier-Symbol neben dem Namen.

   Beispiele für Modell-IDs:
   meta-llama/llama-3.3-70b-instruct:free
google/gemma-3-27b-it:free
qwen/qwen3-coder-480b-a35b-instruct:free
deepseek/deepseek-r1:free

   Das Muster ist immer: anbieter/modellname:free — das :free am Ende bedeutet "kostenlose Variante".
5. 5
   Trage den kopierten Namen in deine settings.json ein:

   settings.json"ANTHROPIC_DEFAULT_SONNET_MODEL": "HIER_DEN_KOPIERTEN_NAMEN_EINFÜGEN"

   Starte Claude Code neu — fertig.

Aktuelle Empfehlungen (Stand April 2026)

Gratis-Modelle auf OpenRouter wechseln gelegentlich. Die folgende Tabelle zeigt bewährte Optionen — prüfe die Verfügbarkeit immer aktuell auf openrouter.ai/models?pricing=free.

Modell während einer laufenden Sitzung wechseln

Du musst Claude Code nicht neu starten um das Modell zu wechseln. Tippe im Prompt:

im Claude Code Prompt/model meta-llama/llama-3.3-70b-instruct:free

Das gilt nur für die aktuelle Sitzung. Beim nächsten Start greift wieder die settings.json.

11 Glossar: Fachbegriffe erklärt

12 Troubleshooting

❌ "claude: command not found" (Befehl nicht gefunden)

Ursache: Node.js / npm ist nicht im Systempfad (PATH). Lösung:

1. Terminal komplett schließen und neu öffnen.
2. Prüfen ob npm funktioniert: npm --version
3. Falls npm auch fehlt: Node.js deinstallieren und neu installieren. Auf Windows darauf achten, dass die Option "Add to PATH" aktiviert ist.
4. Nach der Neu-Installation: npm install -g @anthropic-ai/claude-code erneut ausführen.

❌ Fehlercode 401 "Unauthorized"

Ursache: Falscher oder abgelaufener API-Key. Lösung:

1. Gehe auf openrouter.ai → "API Keys" → prüfe ob dein Key noch aktiv ist.
2. Kopiere den Key neu (ohne führende/nachfolgende Leerzeichen).
3. Stelle sicher, dass ANTHROPIC_API_KEY auf einen leeren String "" gesetzt ist (nicht gelöscht, sondern leer!).
4. Starte Claude Code mit einem frischen Terminal neu.

❌ Fehlercode 429 "Rate Limit" / "Too Many Requests"

Ursache: Das Gratis-Tageslimit des Modells ist erschöpft. Lösung:

1. Warte 10–30 Minuten und versuche es erneut.
2. Wechsle das Modell in der settings.json zu einem anderen Gratis-Modell (z. B. von Llama zu Gemma).
3. Starte Claude Code danach mit einem frischen Terminal neu.

❌ "JSON parse error" oder Claude startet nicht

Ursache: Syntaxfehler in der settings.json. Lösung:

1. Öffne die Datei und prüfe: Alle Zeichenketten in "doppelten Anführungszeichen"?
2. Nach jedem Eintrag ein Komma — außer beim letzten in einem Block.
3. Nutze jsonlint.com um die Datei zu validieren.
4. Im Zweifel: Datei löschen und von vorne beginnen mit dem Code-Beispiel aus Abschnitt 4.

❌ "Die KI antwortet sehr langsam"

Beim OpenRouter-Weg: Gratis-Modelle sind oft langsamer als bezahlte. Wechsle zu einem kleineren, schnelleren Modell (z. B. qwen/qwen3-8b:free).

Beim Ollama-Weg: Dein PC hat möglicherweise nicht genug RAM/GPU. Wechsle zu einem kleineren Modell: ollama pull qwen2.5-coder:1.5b

❌ Claude Code fragt nach Anmeldung / Abo

Ursache: Claude Code versucht, sich mit dem Original-Anthropic-Account zu verbinden. Lösung:

1. Im Claude Code Interface tippe: /logout
2. Prüfe die settings.json: ANTHROPIC_API_KEY muss auf "" (leer) gesetzt sein.
3. Terminal schließen und neu öffnen.