Claude Agent SDK Nutzung mit Ihrem Claude Plan

Anthropic ermöglicht Ihnen ab dem 15. Juni 2026, das Claude Agent SDK mit Ihrem bestehenden Claude-Abonnement zu nutzen. Vorher brauchten Sie für die Entwicklung mit dem Agent SDK einen separaten API-Schlüssel mit nutzungsbasierter Abrechnung. Ab dem 15. Juni enthält Ihr monatlicher Claude-Plan ein separates Guthaben für Agent-SDK-Workloads. Ein API-Schlüssel ist dafür nicht erforderlich.

Teste Apidog noch heute

Wenn Sie einen eigenen Agenten bauen möchten — etwa einen Deployment-Bot, Forschungsassistenten oder Triage-Workflow — entfällt damit eine Einstiegshürde: Sie müssen nicht zuerst eine separate Abrechnung über die Anthropic API einrichten. Ihr Claude-Pro-Abonnement enthält jetzt 20 $/Monat Agent-SDK-Guthaben. Max 20x enthält 200 $. Team-Premium-Plätze enthalten 100 $.

Was sich am 15. Juni 2026 geändert hat

Kurzfassung: Agent-SDK-Nutzung wird jetzt zuerst von einem monatlichen Guthaben abgezogen, das an Ihren Claude-Plan gebunden ist. Vorher lief dieselbe Nutzung über die Anthropic API und ein separates Konsolen-Guthaben.

Plan	Monatliches Agent-SDK-Guthaben
Pro	$20
Max 5x	$100
Max 20x	$200
Team Standard pro Platz	$20
Team Premium pro Platz	$100
Enterprise nutzungsbasiert	$20
Enterprise Premium-Platz	$200

Wichtige Regeln:

• Enterprise-Standard-Plätze erhalten kein Guthaben. Verwenden Sie einen API-Schlüssel oder wechseln Sie auf einen Premium-Platz.
• Guthaben ist pro Benutzer und nicht übertragbar. Sie können es nicht mit Teammitgliedern zusammenlegen.
• Nicht genutztes Guthaben verfällt am Ende des Abrechnungszyklus.
• Eine einmalige Aktivierung ist erforderlich. Danach erneuert sich das Guthaben monatlich automatisch.
• API-Schlüssel-Workloads nutzen dieses Guthaben nicht. Wenn Sie über ANTHROPIC_API_KEY authentifizieren, verwenden Sie weiterhin das API-Abrechnungsmodell.

Was das Guthaben abdeckt

Das Guthaben gilt nur für bestimmte programmatische oder nicht-interaktive Workloads.

Abgedeckt:

• Claude-Agent-SDK-Aufrufe aus Python- oder TypeScript-Projekten
• claude -p in Claude Code
• Claude Code GitHub Actions-Integration
• Drittanbieteranwendungen, die sich über das Agent SDK authentifizieren

Nicht abgedeckt:

• Interaktive Claude-Code-Sitzungen
• Claude-Web-App und mobile App
• Claude-Cowork-Sitzungen

Das Agent-SDK-Guthaben ist also für automatisierte Workloads gedacht. Ihre normale Claude-Code-Nutzung läuft weiterhin über die regulären Planlimits, die Anthropic kürzlich bis zum 13. Juli um 50 % erhöht hat.

Praktisch bedeutet das: Sie können SDK-Agenten testen, ohne das Budget zu verbrauchen, das Sie für tägliche interaktive Claude-Code-Arbeit benötigen.

Wenn Ihr Guthaben aufgebraucht ist

Nach Verbrauch des monatlichen Guthabens hängt das Verhalten von Ihrer Einstellung für zusätzliche Nutzung ab:

• Zusätzliche Nutzung aktiviert: Überschreitungen werden nutzungsbasiert zu Standard-API-Tarifen abgerechnet.
• Zusätzliche Nutzung deaktiviert: Anfragen stoppen, bis der Abrechnungszyklus zurückgesetzt wird.

Empfehlung:

• Für Prototypen: zusätzliche Nutzung deaktivieren.
• Für produktive Automatisierungen: zusätzliche Nutzung aktivieren, wenn Workflows nicht unterbrochen werden dürfen.

Das Guthaben wird immer zuerst verwendet. Kosten entstehen erst, wenn Ihr monatliches Kontingent aufgebraucht ist.

Guthaben aktivieren

Das Guthaben ist nicht automatisch aktiv. Sie müssen es einmal beanspruchen.

1. Melden Sie sich bei dem Claude-Konto an, dem das Abonnement gehört.
2. Öffnen Sie die Claude-Agent-SDK-Planeinstellungen, die im offiziellen Support-Artikel von Anthropic verlinkt sind.
3. Fordern Sie das Guthaben an.

Bei Team- oder Enterprise-Plänen muss jeder Benutzer das Guthaben selbst aktivieren. Administratoren können es nicht stellvertretend für andere Plätze beanspruchen.

SDK in Python einrichten

Installieren Sie das SDK:

pip install claude-agent-sdk

Melden Sie sich über Claude Code an:

claude login

Dadurch werden lokale planbasierte Anmeldeinformationen gespeichert. Für diese Nutzung müssen Sie ANTHROPIC_API_KEY nicht setzen.

Minimaler Agent:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run("Review the diff in /tmp/patch.diff and flag concerns.")
print(response.text)

Dieser Aufruf wird über Ihr Plan-Guthaben abgerechnet, sofern die planbasierte Authentifizierung aktiv ist.

SDK in TypeScript einrichten

Installieren Sie das Paket:

npm install @anthropic-ai/claude-agent-sdk

Authentifizieren Sie sich erneut über Claude Code:

claude login

Minimaler Agent:

import { Agent } from "@anthropic-ai/claude-agent-sdk";

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

In CI-Runnern, Docker-Containern oder Remote-Umgebungen kann es nötig sein, die Claude-Code-Anmeldeinformationen explizit als Umgebungsvariablen bereitzustellen. Die genauen Variablennamen finden Sie in der Agent-SDK-Dokumentation.

Wenn claude login bereits vor der SDK-Einrichtung fehlschlägt, beschreibt der Artikel zum Fix für ungültige custom3p-Unternehmenskonfiguration eine häufige Ursache.

claude -p für nicht-interaktive Workflows nutzen

Sie müssen nicht zwingend SDK-Code schreiben. Das Agent-SDK-Guthaben gilt auch für:

claude -p

-p startet Claude Code im nicht-interaktiven Modus. Sie übergeben eine Aufgabe, Claude arbeitet sie aus und beendet sich danach. Das ist nützlich für:

• CI-Pipelines
• Cron-Jobs
• Git-Hooks
• Repository-Prüfungen
• automatisierte Reviews

Beispiel: Pre-Commit-Hook für riskante Änderungen.

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:\n\n$DIFF"

Jeder claude -p-Aufruf wird nach dem 15. Juni vom Agent-SDK-Guthaben abgezogen, nicht vom interaktiven Claude-Code-Budget.

Für länger laufende autonome Workflows passt das gut zum /goal-Befehl und zu AGENTS.md-Kontextdateien, um Agenten über mehrere Läufe hinweg konsistent zu steuern.

GitHub Actions integrieren

Auch die Claude Code GitHub Actions-Integration fällt unter das SDK-Guthaben.

Typische Einsatzfälle:

• Pull-Request-Reviews
• Issue-Triage
• Release-Notes-Generierung
• automatisierte Repository-Checks

Die Workflow-Läufe werden dem Agent-SDK-Guthaben des Benutzers zugerechnet, der die GitHub App installiert hat.

Das ist relevant für Projekte wie Clawsweeper, den auf Claude Code basierenden GitHub-Triage-Bot, bei denen Automatisierung dauerhaft läuft und früher über einen verbundenen API-Schlüssel abgerechnet wurde.

Agenten mit API-Verträgen bauen

Der größte Nutzen des Agent SDK entsteht, wenn Agenten nicht nur Text generieren, sondern echte Systeme bedienen:

• APIs aufrufen
• Daten auswerten
• Deployments vorbereiten
• Tickets triagieren
• interne Tools orchestrieren

Damit das stabil funktioniert, braucht der Agent einen klaren Vertrag für jede API, die er verwendet. Ohne Vertrag errät der Agent Payload-Strukturen, Parameter oder Response-Formate — und Sie debuggen halluzinierte JSON-Strukturen.

Hier passt Apidog in den Workflow:

1. API-Vertrag in Apidog definieren.
   
   Legen Sie Endpunkte, Request-Schemas, Response-Schemas und Beispiel-Payloads fest.

2. OpenAPI exportieren.
   
   Geben Sie die Spezifikation dem Agenten als Kontext.

3. Agent über das SDK mit echten Endpunkten verbinden.
   
   Der Agent verwendet die dokumentierten Schemas statt zu raten.

4. Mit der Apidog CLI validieren.
   
   Jeder Agentenlauf kann prüfen, ob die API weiterhin das liefert, was der Vertrag verspricht.

Für Agenten, die externe Tools über MCP-Server orchestrieren, ist der MCP-Server-Test-Workflow mit Apidog der passende nächste Schritt.

Den größeren Kontext beschreibt der Design-First-API-Workflow-Leitfaden: Wenn der Agent einen validierbaren Vertrag hat, investieren Sie weniger Zeit in JSON-Debugging und mehr Zeit in bessere Schnittstellen.

Sie können Apidog kostenlos herunterladen, wenn Sie eine Vertragsschicht für Ihre Agent-SDK-Projekte nutzen möchten.

Wann ein separater API-Schlüssel weiterhin sinnvoll ist

Das planbasierte Guthaben ist für viele Entwickler der einfachste Einstieg. Ein separater API-Schlüssel bleibt trotzdem sinnvoll, wenn Sie andere Anforderungen haben.

Beispiele:

• Produktionsagenten mit klarer Budgettrennung
  
  Planguthaben sind begrenzt. Für skalierende Produktionssysteme kann eine separate API-Abrechnung sauberer sein.

• Gemeinsame Abrechnung über mehrere Benutzer oder Organisationen
  
  API-Schlüssel sind nicht an ein einzelnes Claude-Benutzerkonto gebunden.

• Enterprise-Standard-Plätze
  
  Diese erhalten kein Agent-SDK-Guthaben. Für SDK-Zugriff benötigen Sie dann einen API-Schlüssel oder ein Upgrade.

Der Leitfaden für kostenlosen Claude-API-Zugriff beschreibt zusätzliche Wege zur Claude-Nutzung ohne Pro-Plan oder kostenpflichtigen API-Schlüssel.

Checkliste vor dem ersten Agentenlauf

• [ ] Prüfen, ob Ihr Plan berechtigt ist: Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise nutzungsbasiert oder Enterprise Premium-Platz
• [ ] Agent-SDK-Guthaben einmalig aktivieren
• [ ] Entscheiden, ob zusätzliche Nutzung aktiviert werden soll
• [ ] claude login ausführen
• [ ] Python- oder TypeScript-SDK installieren
• [ ] Minimalen Agenten erstellen
• [ ] Testen, ob der Agent ohne gesetzten ANTHROPIC_API_KEY läuft
• [ ] Nach den ersten Läufen das Guthaben in den Kontoeinstellungen prüfen

FAQ

Muss ich ANTHROPIC_API_KEY entfernen, damit das Planguthaben funktioniert?

Nein. Das SDK verwendet die lokalen Claude-Code-Anmeldeinformationen, sofern sie vorhanden sind. claude login reicht für planbasierte Abrechnung aus. Wenn ANTHROPIC_API_KEY für andere Tools gesetzt ist, können Sie ihn dort belassen.

Was zählt als Anfrage gegen das Guthaben?

Das Guthaben wird in Dollar abgerechnet, nicht in festen Anfragekontingenten. Jeder SDK-Aufruf reduziert das Guthaben entsprechend den API-Tarifen, inklusive Modellaufrufen, Tool-Nutzung und Kontext-Tokens.

Kann ich mein Guthaben mit Teammitgliedern teilen?

Nein. Das Guthaben ist pro Benutzer und nicht übertragbar.

Was passiert mit meinem alten Anthropic-API-Konsolen-Guthaben?

Es bleibt separat bestehen. API-Schlüssel-Workloads verwenden weiterhin das API-Konsolen-Guthaben oder die API-Abrechnung.

Ist das Agent SDK dasselbe wie Claude Code?

Nein. Claude Code ist CLI und IDE-Integration. Das Agent SDK ist eine Python- oder TypeScript-Bibliothek zum Erstellen eigener Agenten. Das Guthaben deckt das SDK, claude -p, GitHub Actions und Drittanbieter-Agent-SDK-Apps ab.

Ändert sich meine GitHub-Actions-Abrechnung?

Wenn Ihre Action die offizielle Claude Code GitHub Actions-Integration nutzt und das Guthaben für das installierende Konto aktiviert wurde, laufen diese Workflows über das SDK-Guthaben.

Funktioniert das Guthaben außerhalb des Agent SDK und claude -p?

Nur für die abgedeckten Oberflächen: Python/TypeScript SDK, claude -p, GitHub Actions und Drittanbieter-Agent-SDK-Apps. Andere Claude-Nutzung läuft weiterhin über die normalen Planlimits oder über API-Schlüssel-Abrechnung.