Claude Code kann wesentlich nützlicher werden, wenn es weiß, wie Ihre AI-Routing-Schicht funktioniert. Das SKILL.md-Setup ist der saubere Weg, ihm diesen Workflow beizubringen: wo sich Flatkeys Router befindet, wie man Live-Model-IDs entdeckt, wie man unterstützte Modelle und Tools aufruft und welche Sicherheitsregeln zu befolgen sind, bevor man Guthaben ausgibt oder Produktionssysteme berührt.
Es gibt gleich zu Beginn einen wichtigen Vorbehalt. Claude Codes eigene Reasoning-Schleife läuft weiterhin auf Claude. In der Gateway-Dokumentation von Anthropic heißt es, dass Claude Code sich mit einem LLM-Gateway verbinden kann, aber es unterstützt nicht, Claude Code selbst über ein Gateway auf Nicht-Claude-Modelle zu routen. Verwenden Sie diesen Leitfaden für die praktische Version von Wie man Claude Code mit jedem Modell verwendet: Das SKILL.md-Setup: Behalten Sie Claude Code als Ihren Coding-Agenten bei und geben Sie ihm dann ein Flatkey-Skill, damit es jedes von Flatkey unterstützte Modell oder messpflichtige Tool direkt aus Ihrem Projekt entdecken und aufrufen kann, wenn die Aufgabe es erfordert.
Flatkeys öffentliches SKILL.md ist genau für diesen Zweck gebaut. Es weist Agents an, https://router.flatkey.ai zu verwenden, die OpenAI-kompatible Base-URL https://router.flatkey.ai/v1, den Live-Model-Katalog, den Tools-Marktplatz, kleine erste Aufrufe, Request-IDs und Freigabe-Gates für Writes, Sends, Käufe, Deletes, Publishing oder Berechtigungsänderungen.
Wenn Sie mit dem Router selbst noch nicht vertraut sind, lassen Sie den Flatkey API Schnellstart neben diesem Leitfaden geöffnet. Wenn Sie dies mit einer breiteren Provider-Migration vergleichen, erklären die Leitfäden OpenAI-API-Alternative und einheitlicher AI-API-Workflow das Base-URL-Muster ausführlicher.
Die kurze Antwort
Verwenden Sie dieses Setup, wenn Claude Code Flatkey innerhalb Ihres Repos ausführen soll:
- Erstellen Sie einen Flatkey-API-Schlüssel in der Flatkey Console.
- Installieren Sie das Flatkey-Skill in Claude Code als
~/.claude/skills/flatkey/SKILL.mdoder.claude/skills/flatkey/SKILL.md. - Speichern Sie
FLATKEY_API_KEYin Ihrer Shell oder einem lokalen Secret Manager, nicht in einer committeten Datei. - Bitten Sie Claude Code, das Flatkey-Skill zu verwenden, den Live-Model-Katalog abzurufen und einen kleinen Smoke-Call über
https://router.flatkey.ai/v1auszuführen. - Prüfen Sie die Flatkey Usage Logs auf Modell, Token-Anzahl, Latenz, Status und Kosten.
Wenn Sie möchten, dass der Claude-Familienverkehr von Claude Code über Flatkey läuft, verwenden Sie stattdessen Flatkeys Claude-Code-Leitfaden und nicht die OpenAI-kompatible /v1-Base-URL:
export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="$FLATKEY_API_KEY"
Dieser Pfad ist für das Gateway-Routing von Claude Code gedacht. Der SKILL.md-Pfad dient dazu, Claude Code beizubringen, wie es Flatkey-Modelle und -Tools aus dem Projekt heraus verwendet.
Was SKILL.md in Claude Code verändert
Ein Claude-Code-Skill ist ein Verzeichnis mit einer SKILL.md-Datei. Claude Code lädt die Skill-Metadaten beim Start und liest den Skill-Text erst dann, wenn die Aufgabe dazu passt oder wenn Sie den Skill direkt aufrufen. Dadurch ist ein Skill ein besserer Ort als CLAUDE.md für wiederholbare Abläufe wie „Flatkey-Modelle entdecken, einen unterstützten Pfad auswählen, einen kleinen Aufruf ausführen und Usage Logs verifizieren“.
Mit Flatkey sollte die Skill Claude Code dazu bringen, fünf Dinge konsistent zu tun:
| Schritt | Was Claude Code tun sollte | Warum das wichtig ist |
|---|---|---|
| Einrichtungsregeln lesen | Das Flatkey-SKILL.md laden, bevor der Router aufgerufen wird |
Verhindert erratene Modell-IDs, erratene Tool-Eingaben und geheime Leaks |
| Den Live-Katalog verwenden | /v1/models aufrufen, bevor ein Modell ausgewählt wird |
Die Modellliste ändert sich, daher können statische Beispiele veralten |
| Geheimnisse lokal halten | FLATKEY_API_KEY verwenden, ohne ihn auszugeben oder zu committen |
Verhindert die Offenlegung von Zugangsdaten in Chat, Logs und Git |
| Klein anfangen | Einen kleinen Smoke-Call vor aufwendiger Arbeit ausführen | Bestätigt Auth, Base-URL, Route und Antwortstruktur |
| Das Ledger verifizieren | Nach einem Call die Usage Logs oder die Ausgabe der Anfrage prüfen | Gibt dem Team Belege für Modell, Latenz, Tokens und Gebühr |
Das ist der praktische Kern von Wie man Claude Code mit jedem Modell verwendet: Das SKILL.md-Setup. Claude Code bleibt der Orchestrator. Flatkey wird zur Modell- und Tool-Ebene, mit der es gezielt arbeiten kann.
Schritt 1: Persönliche oder Projekt-Installation wählen
Installieren Sie die Skill global, wenn sie in jedem Repo verfügbar sein soll:
mkdir -p ~/.claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
-o ~/.claude/skills/flatkey/SKILL.md
Installieren Sie sie in einem Repo, wenn das Team denselben Flatkey-Workflow teilen soll:
mkdir -p .claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
-o .claude/skills/flatkey/SKILL.md
Bei einer geteilten Projekt-Skill sollten Sie die Datei vor dem Commit überprüfen:
sed -n '1,200p' .claude/skills/flatkey/SKILL.md
Verwandeln Sie den Installationsbefehl nicht in ein automatisch laufendes Shell-Skript. Eine Skill ist Anweisungsinhalt. Behandeln Sie sie so, als würden Sie Ihrem Repo ein anderes Entwicklungsverfahren hinzufügen: abrufen, prüfen und nur dann committen, wenn das Team zustimmt.
Schritt 2: Den Flatkey-Schlüssel sicher setzen
Verwenden Sie eine Umgebungsvariable:
export FLATKEY_API_KEY="sk-fk-your-key"
Wenn die Variable dauerhaft verfügbar sein soll, legen Sie sie in Ihrem Shell-Profil, Ihrem Secret Manager oder einer lokalen Umgebungsdatei ab, die von git ignoriert wird. Platzieren Sie den Schlüssel nicht in .claude/settings.json, CLAUDE.md, einem committed SKILL.md oder in einem Prompt, den Sie in einen geteilten Thread einfügen.
Die eigene Regel der Flatkey-Skill ist einfach: Verwenden Sie ein vorhandenes FLATKEY_API_KEY, wenn eines bereits konfiguriert ist, und geben, protokollieren, committen oder senden Sie diesen Schlüssel niemals irgendwohin außer an router.flatkey.ai oder die authentifizierte Flatkey Console.
Schritt 3: Bestätigen, dass Claude Code die Skill sieht
Starten Sie Claude Code aus dem Repo oder Terminal, in dem die Skill verfügbar ist:
claude
Prüfen Sie dann die verfügbaren Skills:
/skills
Sie sollten flatkey in der Skill-Liste sehen. Wenn Sie den Skill während einer laufenden Claude-Code-Sitzung installiert haben und er nicht erscheint, starten Sie Claude Code neu. Claude Code kann viele Skill-Änderungen während einer Sitzung erkennen, aber ein Neustart ist die einfachste Möglichkeit, während des Setups Unklarheiten zu vermeiden.
Bitten Sie nun um eine harmlose erste Aufgabe:
Use the flatkey skill. Verify that FLATKEY_API_KEY is available without printing it, fetch the live model catalog from Flatkey, and summarize the first five text-capable model IDs you see. Do not run a generation yet.
Dies testet die Erkennung, ohne Generierungsbudget zu verbrauchen.
Schritt 4: Rufen Sie den Live-Modelkatalog ab
Der Flatkey-Skill weist Claude Code an, vor der Auswahl eines Modells den Live-Modelkatalog abzurufen. Der direkte Befehl lautet:
curl -fsS https://router.flatkey.ai/v1/models \
-H "Authorization: Bearer $FLATKEY_API_KEY"
Für einen echten Workflow bitten Sie Claude Code, nur aus den zurückgegebenen IDs auszuwählen:
Use the flatkey skill. Fetch the live model catalog, choose one low-cost text model returned by the catalog for a one-sentence smoke test, and explain why you chose it before running the request.
Das vermeidet einen häufigen Agentenfehler: die Verwendung eines Modellnamens aus dem Gedächtnis oder aus einem alten Artikel. Der Katalog ist die maßgebliche Quelle dafür, was Ihr Schlüssel in diesem Moment aufrufen kann.
Schritt 5: Führen Sie einen kleinen OpenAI-kompatiblen Smoke-Call aus
Sobald der Katalog zurückkommt, führen Sie eine kleine Anfrage über die OpenAI-kompatible API von Flatkey aus:
curl https://router.flatkey.ai/v1/chat/completions \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "replace-with-a-model-id-from-the-live-catalog",
"messages": [
{
"role": "user",
"content": "Reply with one sentence: Flatkey smoke test passed."
}
],
"max_tokens": 40
}'
Halten Sie den ersten Aufruf langweilig. Sie testen Authentifizierung, Modell-ID, Basis-URL, Antwortstruktur und Ledger-Sichtbarkeit. Heben Sie lange Kontext-Prompts, Tool-Aufrufe, Bilderzeugung und Batch-Jobs auf, bis der grundlegende Pfad funktioniert.
Schritt 6: Lassen Sie Claude Code aus einer Aufgabe heraus jedes unterstützte Modell aufrufen
Nachdem der Smoke-Test bestanden ist, können Sie Claude Code anweisen, Arbeit an ein Modell weiterzuleiten, das zur Aufgabe passt.
Zum Beispiel:
Use the flatkey skill. I need a second-model review of this function. Fetch the live catalog, select a coding-capable model returned by the catalog, run a small review request through Flatkey, and report the model ID, request result, and any request ID or usage fields returned. Do not print secrets.
Oder:
Use the flatkey skill. Compare two Flatkey-supported text models on this prompt. Keep both calls under 200 output tokens. Show the outputs side by side and tell me which one I should use for this low-risk internal summarization task.
Das ist das „any model“-Muster, das mit Claude Code gut funktioniert: Claude Code koordiniert die Aufgabe, liest Dateien, wendet Repo-Kontext an und nutzt Flatkey als kontrollierten externen Modellpfad, wenn ein zweites Modell oder eine andere Modellfamilie sinnvoll ist.
Für die Auswahl des Produktionsmodells kombinieren Sie dies mit dem Leitfaden zum KI-Modellkatalog, damit Claude Code den Endpunkttyp, die Preis-Einheit, die Verfügbarkeit und den Verifizierungsstatus prüft, bevor es einen Pfad empfiehlt.
Schritt 7: Flatkey-Tools nur nach Prüfung verwenden
Flatkeys SKILL.md behandelt auch kostenpflichtige Tools. Die wichtige Regel ist, dass Claude Code ein Tool vor der Ausführung prüfen sollte. Es sollte keine Tool-IDs, erforderlichen Felder, Preise, Anbieternamen oder Abrechnungseinheiten erfinden.
Ein guter erster Prompt ist:
Use the flatkey skill. Open the Flatkey tools marketplace in the browser, inspect the search-related tools available to my account, and summarize the required fields and billing unit for one candidate tool. Do not execute the tool yet.
Dann, wenn Sie bereit sind:
Use the flatkey skill. Run the inspected tool with a small limit and an idempotency key. Before execution, repeat the exact tool, required fields, expected billing unit, and maximum budget for my approval.
So bleibt Claude Code nützlich, ohne dass ein Agent in unkontrollierte kostenpflichtige Aufrufe abdriftet.
Schritt 8: Claude-Verkehr von Claude Code bei Bedarf über Flatkey leiten
Das SKILL.md-Setup ist nicht dasselbe wie das Routing von Claude Code selbst über ein Gateway. Wenn Ihr Ziel ist, die Claude-Familienanfragen von Claude Code über Flatkey auszuführen, konfigurieren Sie Claude Code als Anthropic-kompatienten Gateway-Client:
export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_API_KEY="$FLATKEY_API_KEY"
Verwenden Sie für diesen Pfad kein abschließendes /v1. Claude Code und das Anthropic SDK hängen die erforderliche Route an. Nachdem Sie die Variablen gesetzt haben, starten Sie Claude Code in derselben Shell und führen Sie aus:
/status
Achten Sie auf die Anthropic-Base-URL und die Anmeldedatenquelle. Senden Sie dann einen kurzen Prompt und prüfen Sie die Flatkey-Nutzungsprotokolle. Wenn die Base-URL nicht angezeigt wird, hat Claude Code die Umgebungsvariable nicht erhalten.
Verwenden Sie diesen Pfad, wenn die Claude-Nutzung von Claude Code in Flatkeys Guthaben und Hauptbuch erscheinen soll. Verwenden Sie den Skill-Pfad, wenn Claude Code von Ihrem Repo aus Flatkey-unterstützte Modelle und Tools aufrufen soll.
Für benachbarte Routing-Entscheidungen siehe Claude vs GPT API routing. Wenn Ihr Anwendungsfall ein Agent ist, der externe Tools aufruft, ist die Checkliste Gemini API für KI-Agenten nützlich, selbst wenn sich die Modellfamilie ändert, weil die Kontrollen ähnlich sind: genaue Modell-IDs, begrenzte Wiederholungen, Tool-Validierung und Nutzungsprüfung.
Häufige Fehler
Fehler 1: Annehmen, dass SKILL.md Claude Codes Gehirn verändert
Das tut es nicht. Eine Skill gibt Claude Code wiederverwendbare Anweisungen und Abläufe. Sie verwandelt den eigenen Agenten-Loop von Claude Code nicht in GPT, Gemini, DeepSeek, Qwen oder ein anderes Modell.
Fehler 2: /v1 mit ANTHROPIC_BASE_URL verwenden
Flatkeys OpenAI-kompatible Base URL ist:
https://router.flatkey.ai/v1
Die Routing-Base URL des Claude-Code-Gateways ist:
https://router.flatkey.ai
Diese beiden getrennt halten.
Fehler 3: Anmeldedaten in Claude-Einstellungen einchecken
Das projektweite .claude/settings.json wird normalerweise mit dem Repo geteilt. Legen Sie dort keine Schlüssel ab. Verwenden Sie Shell-Exporte, einen Vault oder .claude/settings.local.json nur dann, wenn Ihr Repo diese Datei ignoriert und Ihr Team diesen lokalen Workflow akzeptiert.
Fehler 4: Den Agenten Modell-IDs erraten lassen
Rufen Sie immer zuerst /v1/models ab. Wenn eine Modell-ID im Live-Katalog-Response für Ihren Schlüssel nicht enthalten ist, verwenden Sie sie nicht.
Fehler 5: Bezahlte Tools ausführen, bevor man sie geprüft hat
Prüfen Sie bei Flatkey Tools zuerst erforderliche Felder, Beispiele, Abrechnungseinheit und den genauen Preis. Verwenden Sie dann einen Idempotency-Key und bitten Sie vor der Ausführung um Freigabe.
Eine kopierbare Einrichtungs-Checkliste
Verwenden Sie diese Checkliste für einen einzelnen Entwickler-Computer:
# 1. Install the Flatkey skill for Claude Code
mkdir -p ~/.claude/skills/flatkey
curl -fsSL https://flatkey.ai/SKILL.md \
-o ~/.claude/skills/flatkey/SKILL.md
# 2. Review it
sed -n '1,200p' ~/.claude/skills/flatkey/SKILL.md
# 3. Export your Flatkey key
export FLATKEY_API_KEY="sk-fk-your-key"
# 4. Start Claude Code
claude
Dann eingeben:
Use the flatkey skill. Confirm the Flatkey skill is loaded, verify that FLATKEY_API_KEY is available without printing it, fetch the live model catalog, and run one tiny chat-completions smoke test through https://router.flatkey.ai/v1 using a model ID returned by the catalog.
Öffnen Sie danach Flatkey Usage Logs und bestätigen Sie, dass die Anfrage mit dem erwarteten Modell, Status, Token-Zahlen, Latenz und Kosten erscheint.
FAQ
Kann Claude Code über SKILL.md jedes Modell verwenden?
Claude Code selbst läuft weiterhin auf Claude. Das SKILL.md-Setup ermöglicht es Claude Code, von Ihrem Projekt aus Flatkey-unterstützte Modelle und Tools zu entdecken und aufzurufen, sodass eine Aufgabe bei Bedarf andere Modelle über die Flatkey-API verwenden kann.
Ist das dasselbe wie ANTHROPIC_BASE_URL zu ändern?
Nein. ANTHROPIC_BASE_URL=https://router.flatkey.ai leitet den Claude-Familien-Traffic von Claude Code über ein Gateway. Die Installation von https://flatkey.ai/SKILL.md bringt Claude Code bei, wie es während einer Aufgabe Flatkey-APIs und -Tools bedient.
Soll ich die Flatkey-Skill global oder im Repo installieren?
Verwende ~/.claude/skills/flatkey/ für die persönliche Nutzung über mehrere Projekte hinweg. Verwende .claude/skills/flatkey/, wenn das Repo einen gemeinsamen Team-Workflow enthalten soll. Committe nur die geprüfte Skill-Datei, niemals ein Credential.
Warum ruft der Leitfaden zuerst /v1/models ab?
Weil sich die Modellverfügbarkeit ändert. Der aktuelle Flatkey-Katalog ist sicherer als ein Modellname, der aus dem Gedächtnis, aus einer Chat-Antwort oder aus einem alten Dokument übernommen wurde.
Was sollte ich nach dem Setup überprüfen?
Überprüfe drei Dinge: Claude Code sieht die Skill, die Anfrage an den Flatkey-Katalog ist erfolgreich, und die Usage Logs zeigen die Smoke-Anfrage mit Modell, Status, Tokens, Latenz und Kosten.
Offizielle Referenzen
- Flatkey SKILL.md: https://flatkey.ai/SKILL.md
- Flatkey Quickstart: https://docs.flatkey.ai/quickstart.md
- Flatkey Claude Code-Leitfaden: https://docs.flatkey.ai/guides/claude-code.md
- Flatkey OpenAI SDK-Leitfaden: https://docs.flatkey.ai/guides/openai-sdk.md
- Anthropic Claude Code Skills: https://code.claude.com/docs/en/skills
- Anthropic Claude Code Gateway-Dokumentation: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.md
- Anthropic Gateway-Verbindungsleitfaden: https://docs.anthropic.com/en/docs/claude-code/llm-gateway-connect.md
- Überblick über Anthropic Agent Skills: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
