Claude Code mit apmix einrichten: in zwei Minuten startklar

Claude Code ist Anthropics Coding-Agent fürs Terminal: Er liest dein Repository, bearbeitet Dateien, führt Befehle aus und schreibt Tests. Er spricht die Anthropic-API, und genau diese API stellt apmix bereit. Du kannst Claude Code also mit deinem apmix-Schlüssel betreiben, mit den Claude-Modellen deines Tarifs und einem Monatskontingent statt einer separaten Anthropic-Rechnung.

Diese Anleitung dauert etwa zwei Minuten. Du brauchst ein apmix-Konto mit API-Schlüssel (im Dashboard erstellen) und Node.js 18 oder neuer.

1. Claude Code installieren#

Überspring diesen Schritt, wenn claude auf deinem Rechner schon läuft.

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

2. Auf apmix ausrichten#

Claude Code liest drei Umgebungsvariablen. Weil es das Anthropic-Protokoll spricht, lautet die Base URL https://api.apmix.ai ohne /v1; den Pfad hängt Claude Code selbst an.

Unter macOS oder Linux:

export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

Unter Windows, in PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.apmix.ai"
$env:ANTHROPIC_AUTH_TOKEN = "apx_live_YOUR_KEY"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"

Diese Werte gelten nur für das aktuelle Terminal. Für einen ersten Test ist das perfekt; der nächste Schritt macht sie dauerhaft.

3. Dauerhaft speichern#

Claude Code liest seine Einstellungen auch aus ~/.claude/settings.json. Trag dieselben Werte in den env-Block ein, dann ist jedes neue Terminal sofort bereit:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

In der Dokumentation findest du Einzeiler für PowerShell und bash, die diese Datei für dich schreiben und die alte vorher sichern.

4. Starten#

Öffne dein Projekt und starte Claude Code:

cd your-project
claude

Fertig: Jede Anfrage läuft jetzt über apmix und wird vom Kontingent deines Tarifs abgezogen.

Modelle wechseln mit /model#

Tippe in Claude Code /model, um das Modell für die Sitzung zu wechseln. Du kannst jede Claude-ID aus dem Katalog verwenden:

Jedes Modell hat seinen eigenen Multiplikator für gewichtete Tokens, aufgelistet auf der Preisseite. Mit einem leichteren Modell für Routinearbeit hält dasselbe Kontingent deutlich länger; mehr dazu in gewichtete Tokens, erklärt.

Prüfen, ob der Schlüssel funktioniert#

Wenn etwas nicht stimmt, lass dir die Modelle anzeigen, die dein Schlüssel erreicht. Kommt eine JSON-Liste zurück, sind Schlüssel und URL richtig:

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Die häufigsten Antworten und was zu tun ist:

• 401 invalid_api_key: Der Schlüssel ist falsch oder wurde gelöscht. Kopier ihn erneut unter Dashboard → API-Schlüssel.
• 403 model_not_in_plan: Das Modell liegt über deinem Tarif. GET /v1/models listet nur, was dein Tarif aufrufen kann; wähle eines davon oder mach ein Upgrade.
• 429 rate_limit_exceeded: Mehr als 60 Anfragen pro Minute auf einem Schlüssel (120 bei Max). Warte die Sekunden aus retry-after ab.

Jeder Fehler ist in der Fehlerreferenz erklärt, und jede Antwort enthält einen x-apmix-request-id-Header, den du beim Support angeben kannst.

Die Nutzung im Blick behalten#

Agents sind hungrig: Eine lange Claude-Code-Sitzung kann Millionen von Tokens verschicken. Drei Dinge helfen:

1. Schau in Dashboard → Logs, dort siehst du jede Anfrage live mit Modell, Tokens und Kosten.
2. Leg in den Einstellungen optionale Tages- oder Wochenlimits fest, damit eine aus dem Ruder gelaufene Sitzung nicht den ganzen Monat aufbraucht.
3. Aktiviere E-Mail-Hinweise bei 50, 70, 80 oder 90 % deines Kontingents.

So eingerichtet fühlt sich Claude Code auf apmix genau wie Claude Code an, mit einem Schlüssel und einer Rechnung für alles andere, was du nutzt.