Einstieg

Schnellstart in 5 Minuten

Drei Schritte, ein Prüfbefehl. Danach sehen Sie jeden Aufruf Ihrer Agenten im Cockpit, mit Kosten je Agent, Lauf und Endkunde.

Bevor Sie anfangen

  • Ein Konto bei Tokenwacht (kostenlos registrieren, keine Kreditkarte). Der Erststart im Cockpit führt Sie durch dieselben Schritte wie diese Seite.
  • Ihren Anbieterschlüssel (Anthropic, OpenAI, Google oder Bedrock). Er bleibt bei Ihnen; Tokenwacht reicht ihn nur durch und speichert ihn nie.
  • Zugriff auf die Stelle, an der Ihr Agent den Anbieter aufruft: eine Konfigurationsdatei, eine Umgebungsvariable oder eine Zeile Code.

Schritt 1 · Tokenwacht-Schlüssel erzeugen

  1. Im Cockpit auf Anbindung gehen (oder Konto → API-Schlüssel).
  2. Neuen Schlüssel erzeugen. Geltungsbereich: für den Proxy „Proxy“, für eigene Zahlen „Ingest“, für Auswertungen „Lesen“. Ohne Auswahl gilt alles.
  3. Den Schlüssel tw_live_… kopieren. Er wird nur einmal angezeigt. Legen Sie ihn als Umgebungsvariable ab, z. B. TOKENWACHT_KEY.
Zwei Schlüssel, zwei Rollen. Der Anbieterschlüssel (z. B. ANTHROPIC_API_KEY) bezahlt die Aufrufe und bleibt, wo er ist. Der Tokenwacht-Schlüssel (X-TW-Key) ordnet die Aufrufe Ihrem Mandanten zu. Ohne ihn reicht der Proxy nichts weiter.

Schritt 2 · Basis-URL tauschen

Ersetzen Sie die Adresse des Anbieters durch die von Tokenwacht und setzen Sie zwei Kopfzeilen. Alles andere bleibt: Modelle, Parameter, Streaming, Werkzeuge.

import os
from anthropic import Anthropic

client = Anthropic(
    base_url="https://tokenwacht.de/anthropic",
    api_key=os.environ["ANTHROPIC_API_KEY"],
    default_headers={
        "X-TW-Key": os.environ["TOKENWACHT_KEY"],
        "X-TW-Agent": "nils-icp-research",      # Name des Agenten, frei wählbar, stabil
    },
)
antwort = client.messages.create(model="claude-sonnet-5", max_tokens=200,
                                 messages=[{"role": "user", "content": "Sag Hallo."}])
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://tokenwacht.de/openai/v1",
    api_key=os.environ["OPENAI_API_KEY"],
    default_headers={"X-TW-Key": os.environ["TOKENWACHT_KEY"], "X-TW-Agent": "erik-closer"},
)
antwort = client.chat.completions.create(model="gpt-5", messages=[{"role": "user", "content": "Sag Hallo."}])
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://tokenwacht.de/anthropic",
  apiKey: process.env.ANTHROPIC_API_KEY,
  defaultHeaders: { "X-TW-Key": process.env.TOKENWACHT_KEY, "X-TW-Agent": "liv-connector" },
});
const antwort = await client.messages.create({ model: "claude-sonnet-5", max_tokens: 200,
  messages: [{ role: "user", content: "Sag Hallo." }] });
# Viele SDKs und Werkzeuge lesen die Basis-URL aus der Umgebung. Die Kopfzeile X-TW-Key
# muss trotzdem gesetzt werden — wo das nicht geht, nutzen Sie SDK, n8n-Baustein oder Hook.
export ANTHROPIC_BASE_URL=https://tokenwacht.de/anthropic
export OPENAI_BASE_URL=https://tokenwacht.de/openai/v1
export TOKENWACHT_KEY=tw_live_…

Werkzeuge, die keine eigenen Kopfzeilen erlauben, binden Sie über den Claude-Code-Hook, den n8n-Baustein oder das SDK an.

curl https://tokenwacht.de/anthropic/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" \
  -H "X-TW-Key: $TOKENWACHT_KEY" -H "X-TW-Agent: probe" \
  -d '{"model":"claude-sonnet-5","max_tokens":50,"messages":[{"role":"user","content":"Sag Hallo."}]}'

Alle Kopfzeilen, die Lauf-Bildung und die Antwort bei einem Stopp stehen unter Proxy. Gemini und Bedrock: ebenfalls dort.

Schritt 3 · Anbindung prüfen

Bevor Sie Ihren Agenten starten, prüfen Sie den Schlüssel und sehen, ob schon Ereignisse angekommen sind:

curl https://tokenwacht.de/v1/anbindung/pruefen -H "Authorization: Bearer $TOKENWACHT_KEY"
{"ok": true, "mandant": "Muster GmbH", "projekt": "standard", "schluessel": "erststart", "bereiche": "alle",
 "ereignisse_10min": 1, "letztes_ereignis": {"zeitpunkt": "2026-09-06T10:41:07Z", "agent": "probe", "anbieter": "anthropic",
 "modell": "claude-sonnet-5", "kosten_eur": "0.0007"},
 "hinweis": "Anbindung steht. Nächster Schritt: Regeln im Schattenbetrieb anlegen."}
So sieht Erfolg aus: ok: true und ein letztes_ereignis, das Ihrem Aufruf entspricht. Im Cockpit unter Anbindung erscheint derselbe Aufruf live, ohne Neuladen. Bleibt letztes_ereignis leer, obwohl Ihr Agent lief, hilft die Fehlersuche: in neun von zehn Fällen fehlt die Kopfzeile oder die Basis-URL zeigt noch auf den Anbieter.

Und dann

  • Agenten benennen. X-TW-Agent ist die dauerhafte Einheit, an der Kosten, Trend und Befunde hängen. Ein Name je Agent, nicht je Aufruf.
  • Läufe klammern. X-TW-Run fasst die Aufrufe eines Auftrags zusammen. Fehlt er, bildet Tokenwacht Läufe automatisch (15 Minuten Pause = neuer Lauf).
  • Endkunden zuordnen. X-TW-Kunde macht aus Aufrufen Weiterbelastung: CSV, DATEV, PDF je Kunde.
  • Regeln im Schatten anlegen. Lauf-Budget, Tagesbudget, Ratenbegrenzung. Erst messen, dann scharf schalten. Regeln, Befunde, Alarme.
Welcher Weg passt? →