Einrichtung — Schritt für Schritt

Kirat einrichten

Claude lässt sich auf drei Arten nutzen, und für jede wird Kirat anders installiert. Finden Sie zuerst Ihre heraus und folgen Sie dann nur diesen Schritten. Die meisten brauchen eine.

Video-Anleitung mit Kapiteln, etwa 7 Minuten. Untertitel unter CC.

Wo schreiben Sie mit Claude?

Öffnen Sie die Claude-App. Oben sehen Sie die Reiter Chat, Cowork und Code. Unter Code steht im Schalter unter dem Eingabefeld Local oder Cloud.

A · etwa 2 Minuten Claude-App, Reiter Chat Das normale Chatfenster auf Mac oder Windows. Desktop-Erweiterung → B · etwa 10 Minuten Reiter Code mit „Local“, oder Claude Code im Terminal oder in VS Code Claude arbeitet mit Dateien auf Ihrem Computer. Claude-Code-Plugin → C · etwa 10 Minuten Reiter Code mit „Cloud“, claude.ai/code im Browser oder Code in der Mobil-App Claude arbeitet auf Servern von Anthropic. Cloud-Umgebung →

Sie nutzen mehrere davon? Richten Sie jede ein. Die Erweiterung erreicht keine Code-Sitzungen, und nichts auf Ihrem Computer erreicht eine Cloud-Sitzung.

Nicht unterstützt: der Chat auf claude.ai im Browser, der Chat in den Claude-Mobil-Apps und Cowork-Aufgaben, die in der Cloud laufen.

Vorher: zwei API-Keys

Kirat nutzt Ihre eigenen Keys. OpenAI und Google rechnen direkt mit Ihnen ab, was Sie verbrauchen; wir sehen Ihre Keys nie. Das Besorgen ist der langsame Teil, wegen der Registrierungs- und Abrechnungsformulare der Anbieter.

OpenAI: Öffnen Sie auf platform.openai.com den Bereich API keys und erstellen Sie einen Key. Aktivieren Sie die Abrechnung und setzen Sie ein Monatslimit; ein eigenes Projekt für Kirat ist sinnvoll.
Google Gemini: Klicken Sie auf aistudio.google.com auf Get API key. Aktivieren Sie die Abrechnung für das Projekt dahinter und setzen Sie ein Budget.
Halten Sie beide Keys bereit (zum Beispiel im Passwort-Manager). Sie geben sie im nächsten Schritt ein.

Optional, minimale Rechte: Bei OpenAI genügt ein eingeschränkter Key (Restricted) mit „List models“ auf Read und „Model capabilities“ auf Request, alles andere auf None. Ein Gemini-Key aus Google AI Studio ist bereits auf die Gemini API beschränkt.

Claude-App, Reiter Chat

Entpacken Sie den Download (Windows: Rechtsklick → Alle extrahieren…; Mac: Doppelklick). Sie erhalten einen Ordner kirat.
Öffnen Sie in der Claude-App Settings → Extensions → Advanced settings und klicken Sie auf Install Extension…. Wählen Sie die .mcpb-Datei aus dem Ordner kirat. Oder ziehen Sie die Datei auf die Seite Extensions.
Geben Sie beide API-Keys ein und klicken Sie auf Install. Die App warnt, dass die Erweiterung nicht von Anthropic geprüft ist. Das ist bei jeder Erweiterung aus einer Datei so.
Starten Sie einen neuen Chat und schreiben Sie: Use the Kirat extension and call kirat_status. Beide Mitglieder sollten verfügbar sein, und die Key-Prüfung sollte für beide Keys ok melden.

Fertige Vorlagen (decide, review, critique, brainstorm) finden Sie unter dem +-Knopf im Eingabefeld.

Reiter Code mit „Local“, oder Claude Code im Terminal oder in VS Code

Dieser Weg braucht einen Befehl im Terminal. Die lokalen Sitzungen im Reiter Code und Claude Code teilen ihre Einstellungen, Sie installieren also einmal für beides.

Entpacken Sie den Download und verschieben Sie den Ordner kirat in Ihren Benutzerordner (Mac: /Users/<Name>, Windows: C:\Users\<Name>). Lassen Sie ihn dort: Claude Code startet Kirat aus diesem Ordner. Enthält Ihr Windows-Benutzername ein Leerzeichen, nehmen Sie stattdessen C:\kirat und schreiben im Befehl unten C:/kirat/claude-code.
Öffnen Sie ein Terminal (Mac: die App Terminal; Windows: PowerShell) und tippen Sie node --version. Steht dort v20 oder höher, geht es weiter. Sonst installieren Sie die LTS-Version von nodejs.org und öffnen danach ein neues Terminal.
Führen Sie diesen Befehl im Terminal aus:
claude plugin install kirat --marketplace ~/kirat/claude-code
Ist claude unbekannt, installieren Sie zuerst Claude Code (siehe code.claude.com, Quickstart). Ist der Befehl zu alt, führen Sie vorher claude update aus.
Geben Sie beide Keys ein, wenn danach gefragt wird. Fragt nichts, tippen Sie /plugin configure kirat@kirat in einer Claude-Code-Sitzung im Terminal.
Starten Sie eine neue lokale Sitzung (oder Claude Code neu) und schreiben Sie: Use the Kirat extension and call kirat_status.

Vorlagen in Claude Code: /kirat:decide, /kirat:review, /kirat:critique, /kirat:brainstorm.

Cloud-Sitzungen: Reiter Code mit „Cloud“, claude.ai/code, Mobil-App

Alles passiert in den Einstellungen Ihrer Cloud-Umgebung, im Browser oder in der Claude-App. Kein Terminal. Sie machen das einmal je Umgebung; danach hat jede neue Sitzung darin Kirat.

Einstellungen der Umgebung öffnen. In der Claude-App: Code → der Umgebungs-Schalter unter dem Eingabefeld → Cloud → mit der Maus auf Ihre Umgebung → Zahnrad. Auf claude.ai/code ist es derselbe Schalter unter dem Eingabefeld: mit der Maus auf die Umgebung, dann auf das Einstellungssymbol.

Keys als Network Secrets hinterlegen. Klicken Sie unter Network secrets zweimal auf Add secret und lassen Sie den Typ auf Bearer:

Name	Allowed websites	Header-Name	Prefix	Value
OpenAI	`api.openai.com`	`Authorization`	`Bearer`	Ihr OpenAI-Key
Gemini	`generativelanguage.googleapis.com`	`x-goog-api-key`	leer (löschen)	Ihr Gemini-Key

Niemand in einer Sitzung kann diese Keys lesen, auch Claude nicht. Bei Team- und Enterprise-Tarifen fehlt der Bereich womöglich oder bietet nur ein kurzes Formular; dann fragen Sie Ihren Admin, oder tragen Sie die Keys stattdessen unter Environment variables ein, je eine Zeile: KIRAT_OPENAI_API_KEY=… und KIRAT_GEMINI_API_KEY=… (diese kann jeder lesen, der die Umgebung nutzt).

Netzwerkzugriff. Steht dort Full, ist nichts zu tun. Sonst wählen Sie Custom, setzen den Haken bei Also include default list of common package managers und tragen kirat.ai bei den erlaubten Domains ein. Mit Umgebungsvariablen statt Network Secrets zusätzlich api.openai.com.
Setup-Skript. Öffnen Sie in Ihrem Download START-HERE.html (Doppelklick, es öffnet sich im Browser) und klicken Sie auf Copy setup block. Fügen Sie den Block ganz oben in das Feld Setup script ein, über allem, was dort schon steht.

Die Download-Adresse im Block gehört zu Ihrem Kauf: Veröffentlichen Sie sie nicht.
Speichern und eine neue Sitzung in dieser Umgebung starten. Diese erste Sitzung führt das Setup aus und zeigt Kirat meist noch nicht, weil sie vor dem Ende des Setups gestartet ist. Starten Sie eine zweite neue Sitzung und schreiben Sie: Call kirat_status. Beide Mitglieder sollten verfügbar sein, und die Key-Prüfung sollte ok melden. Ab dann hat jede neue Sitzung Kirat.

Hat es nicht geklappt? kirat_status nennt den Key oder Host, den Sie prüfen müssen. Fehlt Kirat auch in der zweiten Sitzung, steht im Setup-Log „Kirat setup failed“ und der Grund. Ändern Sie nach der Korrektur das Setup-Skript (eine Leerzeile genügt), sonst behalten neue Sitzungen den alten Stand.

Lesen Sie vorher die Grenzen in der Cloud: Unter anderem zählt das Tagesbudget je Sitzung, setzen Sie also Ausgabenlimits bei OpenAI und Google.

Kommen Sie nicht weiter?

Claude kennt Kirat nicht: Prüfen Sie, welchen Weg Sie nutzen (Abschnitt 01). Eine Erweiterung im Reiter Chat erscheint nicht in Code-Sitzungen.
Ein Mitglied ist nicht verfügbar: Sein API-Key fehlt oder ist falsch. kirat_status sagt, welcher.
Aufrufe werden blockiert: Das Tagesbudget ist aufgebraucht. Erhöhen Sie es in den Kirat-Einstellungen oder warten Sie bis zum nächsten Tag (UTC).

Die README.md in Ihrem Download behandelt Einstellungen, Kosten, Updates und weitere Probleme (auf Englisch). Kirat wird ohne Support angeboten. Läuft es in einer unterstützten Umgebung nicht, können Sie innerhalb von 14 Tagen eine Erstattung verlangen: Schreiben Sie an support@kirat.ai, mit Ihrer Bestellnummer und der Ausgabe von kirat_status (sie enthält nie Ihre Keys).