Bevor Sie starten
Sie brauchen:- aktiven Premium- oder berechtigten Team-Zugang zu Capriole AI;
- einen Capriole-AI-API-Schlüssel von der API-Seite;
- mindestens einen installierten Coding-Agenten;
- ein Terminal, in dem Sie eine Umgebungsvariable setzen können.
Diese Anleitung verwendet einen Schlüssel erneut, um Kompatibilität zu belegen. Für ein langlebiges Setup oder ein Team erstellen Sie für jeden Agenten oder Nutzer einen eigenen benannten Schlüssel. Getrennte Schlüssel begrenzen den Schaden, falls ein Schlüssel geleakt wird, und Sie können auf der API-Seite die Nutzung pro Schlüssel filtern und den Zugang einzeln widerrufen.
Den Agenten seinem Protokoll zuordnen
Jeder Client behält das Wire-Protokoll, für das er gebaut wurde, auch wenn der Kontoschlüssel geteilt wird.
Responses- und Chat-Completions-Pfade enthalten
/v1 in der Base URL. Anthropic-Messages-Pfade verwenden die API-Wurzel, außer wenn eine Integrationsseite einen client-spezifischen Adapterwert dokumentiert. Kopieren Sie den genauen Wert von der passenden Integrationsseite.
Den gemeinsamen Schlüssel einrichten
1
Den Capriole-API-Schlüssel exportieren
Setzen Sie eine Shell-Variable, bevor Sie einen Agenten öffnen:Prüfen Sie, dass die Variable existiert, ohne das Secret auszugeben:Das erwartete Ergebnis ist
Capriole API key is set.2
Den Client-Pfad wählen
Öffnen Sie die Integrationsseite aus der Tabelle und kopieren Sie ihre gepflegte Konfiguration. Verwenden Sie denselben Wert aus
CAPRIOLE_AI_API_KEY überall dort, wo dieser Client ein Token verlangt.- Codex liest den Schlüssel über
env_keyausCAPRIOLE_AI_API_KEY. - Claude Code verwendet
ANTHROPIC_AUTH_TOKEN. Setzen Sie ihn vor dem Start aus der gemeinsamen Variable. - Kilo Code referenziert
{env:CAPRIOLE_AI_API_KEY}inapiKeyund in einemAuthorization-Header. Sein einziger Capriole-Anbieter sendet jede Modellfamilie an Responses, Messages oder Chat Completions. - GitHub Copilot CLI verwendet
COPILOT_PROVIDER_API_KEYauf OpenAI-kompatiblen Pfaden undCOPILOT_PROVIDER_BEARER_TOKENauf Anthropic Messages. - OpenCode referenziert
{env:CAPRIOLE_AI_API_KEY}inapiKeyund in einemAuthorization-Header. Sein einziger Capriole-Anbieter sendet jede Modellfamilie an Responses, Messages oder Chat Completions. - OpenClaw-Anbietereinträge referenzieren
${CAPRIOLE_AI_API_KEY}direkt. Exportieren Sie die gemeinsame Variable im Terminal, das das Gateway startet. - Cline speichert den Schlüssel einmalig mit
cline auth -k "$CAPRIOLE_AI_API_KEY". - Qwen Code nennt die Variable in
envKeyund kann sie aus~/.qwen/.envlesen. - Crush liest
$CAPRIOLE_AI_API_KEYim Anbietereintrag seinercrushrc. - Pi liest
$CAPRIOLE_AI_API_KEYinmodels.json.
3
Das Modell auf einer kompatiblen Route halten
Beginnen Sie mit einem gepflegten Alias, sofern Sie keine genaue Modellversion brauchen:
- verwenden Sie
openai-latestauf OpenAI-Responses-Pfaden oder in Codex das nativegpt-6.2-astra; - verwenden Sie
claude-latestauf Anthropic-Messages-Pfaden oder in Claude Codeclaude-fable-5-1; - verwenden Sie ein in der Integrationsseite gelistetes Modell auf Chat-Completions-kompatiblen Pfaden.
4
Den Agenten starten und prüfen
Starten Sie den konfigurierten Client aus einem Testprojekt und fragen Sie:Achten Sie auf eine nicht leere Antwort, idealerweise den angeforderten Marker
CAPRIOLE_OK. Modelle folgen nicht immer Prompts mit exakter Ausgabe, der Wortlaut kann daher abweichen.Öffnen Sie dann die API-Seite und bestätigen Sie, dass die Anfrage in der Nutzungsansicht unter dem erwarteten Schlüssel und Modell erscheint. Der Nutzungseintrag ist die entscheidende Prüfung, dass der Client Capriole verwendet hat. Eine Antwort allein reicht nicht, wenn der Client einen anderen Anbieter oder Fallback konfiguriert hat. Die Anleitung zu API-Schlüsseln und Nutzung zeigt die genauen Filter und den Schlüssellebenszyklus.Wie Erfolg aussieht
Coding-Agent-Anfragen nutzen das berechtigte persönliche oder Team-API-Guthaben. Lesen Sie Capriole AI abgerechnete Tokens, bevor Sie eine große automatisierte Arbeitslast ausführen.

