Claude Code im Terminal - Logicc Docs

Claude Code im Terminal

Claude Code über den Anthropic-kompatiblen Logicc-Endpunkt einrichten, Claude-Modelle auswählen, Verbrauch prüfen und typische Fehler beheben.

Stand: 27. August 2026

Claude Code kann über den Anthropic-kompatiblen Endpunkt mit der Logicc API verbunden werden. Die Oberfläche läuft im Terminal. Für diese Integration werden ausschließlich freigeschaltete Claude-Modelle empfohlen.

Beta: Claude Code wird regelmäßig aktualisiert. Neue Clientfunktionen können zusätzliche Anforderungen an das Gateway stellen. Prüfen Sie die verwendete Version und den vorgesehenen Workflow vor dem produktiven Einsatz.

Schnellstart

Claude Code installieren.
Logicc API-Key und Base URL als Umgebungsvariablen setzen.
Claude Code mit einem freigeschalteten Claude-Modell starten.
Verbindung mit /status und Modell mit /model prüfen.
Quota nach der ersten Testanfrage kontrollieren.

Voraussetzungen

Aktiver Logicc API-Key
Freigeschaltetes Claude-Modell
Aktuelle Claude-Code-Version
Terminal unter macOS, Linux, Windows oder WSL

1. Claude Code installieren

macOS, Linux oder WSL:

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

Alternativ unter macOS:

brew install --cask claude-code

Installation prüfen:

claude --version

2. Logicc API konfigurieren

macOS, Linux oder WSL

export LOGICC_API_KEY="DEIN_LOGICC_API_SCHLUESSEL"
export ANTHROPIC_AUTH_TOKEN="$LOGICC_API_KEY"
export ANTHROPIC_BASE_URL="https://api.logicc.cloud/anthropic"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

Windows PowerShell

$env:LOGICC_API_KEY = "DEIN_LOGICC_API_SCHLUESSEL"
$env:ANTHROPIC_AUTH_TOKEN = $env:LOGICC_API_KEY
$env:ANTHROPIC_BASE_URL = "https://api.logicc.cloud/anthropic"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"

ANTHROPIC_AUTH_TOKEN wird als Bearer-Token an das Logicc Gateway gesendet. Die Base URL ersetzt den direkten Anthropic-Endpunkt für diese Sitzung.

3. Modelle und Quota prüfen

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Verwenden Sie ausschließlich Modell-IDs aus dieser Antwort.

4. Claude Code starten

cd /pfad/zum/projekt
claude --model claude-sonnet-5

Windows PowerShell:

Set-Location "C:\Pfad\zum\Projekt"
claude --model claude-sonnet-5

Verbindung und Modell prüfen:

/status
/model

Bei aktivierter Gateway-Erkennung erscheinen zusätzliche Gateway-Modelle unter /model mit dem Hinweis From gateway.

5. Dauerhafte Einstellungen

Nicht geheime Einstellungen können in ~/.claude/settings.json gespeichert werden:

{
  "model": "claude-sonnet-5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.logicc.cloud/anthropic",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Unter Windows lautet der Pfad %USERPROFILE%\.claude\settings.json.

Speichern Sie den API-Key nicht in einer projektbezogenen .claude/settings.json, in Git oder in gemeinsam genutzten Skripten. Verwenden Sie für den dauerhaften Einsatz einen Secret Manager oder Credential Helper.

Modellwahl

Empfohlene Modelle

Modell	Modell-ID	Empfehlung	Kostenprofil
Claude Sonnet 5	`claude-sonnet-5`	Standard für die meisten Coding-Aufgaben	Mittel
Claude Haiku 4.5	`claude-haiku-4-5`	Schnelle Routineaufgaben	Niedriger
Claude Opus 5	`claude-opus-5`	Komplexe Planung und anspruchsvolle Aufgaben	Hoch

Weitere dokumentierte IDs

claude-opus-4-8, claude-opus-4-6, claude-sonnet-4@20250514, claude-3-7-sonnet@20250219, claude-3-5-sonnet-v2@20241022 und claude-haiku-4-5@20251001.

Neuere Modelle können eine aktuelle Claude-Code-Version voraussetzen. Führen Sie bei fehlenden Einträgen claude update aus.

Kompatibilität

Modelltyp	Status	Hinweis
Freigeschaltete Claude-Modelle	Empfohlen	Native Anthropic-Messages-Kompatibilität
Nicht-Claude-Modelle	Nicht offiziell unterstützt	Tool Calling, Reasoning, Prompt Caching und Modellwechsel können fehlschlagen

Für GPT-Modelle verwenden Sie Codex oder OpenCode.

Kosten und Quota

Agentische Coding-Sitzungen können automatisch viele Modell- und Tool-Schritte ausführen. Prüfen Sie das Restbudget regelmäßig:

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Budget, Verbrauch und Restbudget werden in Euro geführt.

Datenschutz

Claude Code arbeitet lokal mit freigegebenen Projektdateien und Terminal-Werkzeugen. Die Modellverarbeitung findet nicht lokal statt. Prompts und ausgewählte Datei- oder Codeausschnitte werden über die Logicc API an den eingerichteten Modellprovider übertragen. Websuche, MCP-Server und Plugins können weitere Datenflüsse erzeugen.

Fehlerbehebung

Fehler	Nächster Schritt
`401`	`ANTHROPIC_AUTH_TOKEN` prüfen
`403`	Modellfreigabe und API-Key-Status prüfen
`404`	`ANTHROPIC_BASE_URL` exakt auf `https://api.logicc.cloud/anthropic` setzen
`429`	Quota und Rate Limit prüfen
Modell fehlt	`/v1/models` prüfen, `claude update` ausführen und Sitzung neu starten
Direkter Anthropic-Zugang aktiv	Claude Code aus demselben Terminal wie die gesetzten Variablen starten und `/status` prüfen
GPT-Tools schlagen fehl	Zu einem Claude-Modell wechseln oder Codex beziehungsweise OpenCode verwenden

Support

Bei Fragen schreiben Sie an [email protected] mit dem Betreff API. Teilen Sie Claude-Code-Version, Betriebssystem, Modell-ID, HTTP-Status, Zeitpunkt und Fehlertext ohne API-Key mit.

Weiterführende Dokumentation:

Logicc Help Center: https://help.logicc.com/docs
Gateway-Verbindung: https://code.claude.com/docs/en/llm-gateway-connect
Modellkonfiguration: https://code.claude.com/docs/en/model-config

Was this helpful?

⌘J