Claude Code mit dem Mycelis API-Gateway verwenden

Claude Code ist das offizielle CLI von Anthropic für KI-gestützte Softwareentwicklung. Indem du es auf deinen Mycelis-Workspace-Endpunkt umleitest, erhältst du:

• Eigene Modellauswahl — jedes in deinem Workspace verfügbare Modell nutzen, nicht nur Claude
• Zentrale Nutzungsverfolgung — Token-Verbrauch pro Teammitglied im Mycelis-Dashboard einsehen
• Durchsetzung von Team-Richtlinien — Rate-Limits, Budget-Caps und Routing-Regeln greifen automatisch

Voraussetzungen

• Ein Mycelis-Konto mit einem Workspace
• Mindestens ein kommerzielles Deployment (Anthropic via Managed Keys oder BYOK) im Workspace
• Ein Agent im Workspace (der Agent-Slug wird als Modell-Identifier verwendet)
• Claude Code installiert: npm install -g @anthropic-ai/claude-code

Schritt 1 — PAT erstellen (Personal Access Token)

Im Mycelis-Dashboard zu Workspace-Einstellungen → API-Keys navigieren und einen neuen Personal Access Token erstellen. Kopieren — wird als API-Key verwendet.

Schritt 2 — Agent-Slug ermitteln

Unter Agents in der Workspace-Seitenleiste den gewünschten Agenten anklicken. Den Slug aus der Detailansicht kopieren (z.B. mein-coding-agent).

Schritt 3 — Umgebungsvariablen setzen

Folgende Umgebungsvariablen im Shell-Profil setzen (~/.zshrc, ~/.bashrc o.ä.):

export ANTHROPIC_BASE_URL="https://mycelis.ai/api/proxy/v1"
export ANTHROPIC_API_KEY="dein-mycelis-pat-key"

Shell neu laden:

source ~/.zshrc

Schritt 4 — Claude Code mit deinem Agenten starten

Claude Code nutzt die Umgebungsvariable CLAUDE_MODEL (oder den --model-Flag) zur Modellauswahl. Den Agent-Slug angeben:

CLAUDE_MODEL="mein-coding-agent" claude

Oder dauerhaft im Shell-Profil setzen:

export CLAUDE_MODEL="mein-coding-agent"

Dann einfach ausführen:

claude

Claude Code leitet nun alle Anfragen über Mycelis. Jeder Aufruf wird im Workspace-Dashboard unter Nutzung protokolliert.

Setup prüfen

Einen kurzen Test senden:

claude -p "Sag Hallo und bestätige, welches Modell du bist."

Du solltest eine Antwort vom in deinem Mycelis-Agenten konfigurierten Modell sehen. Im Dashboard prüfen, ob die Anfrage in den Nutzungslogs erscheint.

Tipps

• Modell wechseln ohne Code-Änderung — Modell in der Agenten-Konfiguration aktualisieren, alle Claude-Code-Sessions nutzen es sofort.
• Projektkonfigurationen — .env-Datei mit CLAUDE_MODEL=projekt-agent im Projektordner anlegen und mit direnv automatisch laden.
• Budget-Limits — monatliches Ausgabenlimit im Workspace setzen, um unkontrollierte Nutzung bei langen Coding-Sessions zu verhindern.