Blog

Claude Agent SDK Nutzung mit Ihrem Claude Plan

Ashley Innocent

Ashley Innocent

14 May 2026

Claude Agent SDK Nutzung mit Ihrem Claude Plan

Apidog für Unternehmen

On-Premises-Bereitstellung

SSO & RBAC

SOC 2 konform

Apidog Enterprise entdecken

Anthropic ermöglicht Ihnen die Nutzung des Claude Agent SDK mit Ihrem bestehenden Claude-Abonnement ab dem 15. Juni 2026. Zuvor erforderte die Entwicklung mit dem Agent SDK einen separaten API-Schlüssel mit nutzungsbasierter Abrechnung zusätzlich zu dem, was Sie bereits für Claude Pro oder Max bezahlen. Ab dem 15. Juni enthält Ihr monatlicher Claude-Plan ein Guthaben speziell für die Nutzung des Agent SDK. Kein API-Schlüssel erforderlich.

Wenn Sie schon immer einen benutzerdefinierten Agenten (einen Bereitstellungs-Bot, einen Forschungsassistenten, ein Triage-Tool) erstellen wollten, aber keine separate Abrechnungskarte bei Anthropic hinterlegen wollten, nur um einen Prototyp zu erstellen, ist dies die entscheidende Änderung. Ihr Pro-Abonnement enthält jetzt ein Guthaben von 20 $/Monat für die Nutzung des Agent SDK. Max 20x enthält 200 $. Team Premium-Plätze enthalten 100 $.

button

Was sich am 15. Juni 2026 geändert hat

Kurz gesagt: Die Nutzung des Agent SDK wird jetzt von einem monatlichen Guthaben abgezogen, das an Ihren Claude-Plan gebunden ist. Zuvor erfolgte die Abrechnung über die Anthropic API mit einem separaten Konsolen-Guthaben.

Hier ist das Guthaben pro Plan, direkt aus der Ankündigung von Anthropic:

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

Einige wichtige Regeln:

Was das Guthaben abdeckt und was nicht

Anthropic hat dies sorgfältig aufgeteilt. Lesen Sie genau; die Grenze zwischen „abgedeckt“ und „nicht abgedeckt“ bestimmt, ob sich Ihre Rechnung tatsächlich ändert.

Vom Agent SDK-Guthaben abgedeckt:

Nicht abgedeckt (diese werden weiterhin von Ihrem regulären Claude-Plan abgerechnet oder bleiben separat):

Mit anderen Worten, das Agent SDK-Guthaben ist speziell für programmatische, automatisierte oder nicht-interaktive Workloads vorgesehen. Ihre normale Claude Code-Arbeit unterliegt den bestehenden Nutzungslimits des Plans, die Anthropic kürzlich bis zum 13. Juli um 50 % erhöht hat. Zwei getrennte Budgets, zwei getrennte Zwecke.

Dies ist eine sinnvolle Designentscheidung. Sie bedeutet, dass Sie mit einem benutzerdefinierten Agenten, der auf dem SDK basiert, experimentieren können, ohne das Budget zu beeinträchtigen, das Sie für die tägliche Codierung über Claude Code verwenden.

Wenn Ihr Guthaben aufgebraucht ist

Das Guthaben deckt einen festen Dollarbetrag pro Monat ab. Was passiert, wenn Sie diesen überschreiten, hängt von einer Einstellung ab:

Für Prototyping-Arbeiten lassen Sie die zusätzliche Nutzung deaktiviert. Sie erhalten ein klares Stoppsignal und vermeiden unerwartete Rechnungen. Für Automatisierungen in Produktionsqualität, die weiterlaufen müssen, aktivieren Sie sie.

Das Guthaben wird immer zuerst verwendet. Sie zahlen erst Überziehungsgebühren, wenn Ihr monatliches Kontingent aufgebraucht ist.

So melden Sie sich an

Das Guthaben ist nicht standardmäßig aktiviert. Die Anmeldung ist einmalig und bleibt über Abrechnungszyklen hinweg bestehen, aber Sie müssen sie einmal durchführen.

  1. Melden Sie sich bei dem Claude-Konto an, dem das Abonnement gehört (dem Benutzerkonto bei Pro/Max oder dem Platz-Konto bei Team/Enterprise).
  2. Besuchen Sie die Claude Agent SDK Planeinstellungen (verlinkt im offiziellen Support-Artikel von Anthropic).
  3. Fordern Sie das Guthaben an. Danach wird das Guthaben jeden Monat automatisch erneuert.

Wenn Sie mehrere Plätze in einem Team-Plan haben, muss jeder Benutzer das Guthaben unabhängig voneinander beanspruchen. Administratoren können nicht im Namen von Platzinhabern beanspruchen.

Einrichten des SDK in Python oder TypeScript

Das Agent SDK wird sowohl in Python als auch in TypeScript ausgeliefert. Beide authentifizieren sich auf die gleiche Weise über Ihren Plan: über die Claude Code CLI und nicht über einen reinen API-Schlüssel.

Python

Installieren:

pip install claude-agent-sdk

Authentifizieren Sie sich zuerst durch Anmeldung bei Claude Code:

claude login

Dies speichert planbezogene Anmeldeinformationen lokal. Das Python SDK übernimmt diese automatisch; Sie müssen ANTHROPIC_API_KEY für die planbasierte Nutzung nicht festlegen.

Ein minimaler Agent sieht so aus:

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)

Der gleiche Aufruf hätte zuvor ANTHROPIC_API_KEY und nutzungsbasierte API-Abrechnung erfordert. Jetzt wird er stattdessen von Ihrem Plan-Guthaben abgezogen.

TypeScript

Installieren:

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

Authentifizieren Sie sich über dieselbe Claude Code-Anmeldung:

claude login

Ein minimaler Agent in TypeScript:

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);

Für Umgebungen, in denen das SDK die Claude Code-Anmeldeinformationen nicht automatisch finden kann (CI-Runner, Docker-Container, entfernte Entwicklungsrechner), können Sie diese als Umgebungsvariablen festlegen. Anthropic veröffentlicht die genauen Variablennamen in der Agent SDK-Dokumentation.

Wenn Ihre Claude Code-Anmeldung Konfigurationsfehler auslöst, bevor Sie überhaupt zur SDK-Einrichtung kommen, behandelt der Fix für ungültige custom3p-Unternehmenskonfiguration die häufigste Ursache.

Der claude -p-Workflow

Es gibt eine zweite Möglichkeit, das Agent SDK-Guthaben zu nutzen, die kein Schreiben von Code erfordert: den Befehl claude -p in Claude Code.

-p versetzt Claude Code in den nicht-interaktiven Modus. Sie übergeben ihm eine Anweisung, es wird gegen Ihr Repository ausgeführt und beendet sich. Keine Hin- und Her-Sitzung. So skripten Sie Claude Code in CI-Pipelines, Cron-Jobs und Git-Hooks.

Ein einfaches Beispiel: ein Pre-Commit-Hook, der Claude auffordert, riskante Änderungen zu kennzeichnen.

#!/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 Aufruf von claude -p nach dem 15. Juni wird von Ihrem Agent SDK-Guthaben abgezogen, nicht von Ihrem interaktiven Claude Code-Budget. Das bedeutet, dass Sie es in automatisierte Workflows einbinden können, ohne sich Sorgen machen zu müssen, die Limits zu verbrauchen, die Sie für die tägliche Codierung benötigen.

Dies passt gut zum Befehl /goal für autonome Schleifen und zu AGENTS.md-Kontextdateien, um den Agenten zuverlässig über mehrere Läufe hinweg zu steuern.

GitHub Actions-Integration

Die Claude Code GitHub Actions-Integration ist die dritte Workload, die vom SDK-Guthaben abgedeckt wird. Wenn Sie Claude in PR-Reviews, Issue-Triage oder die Generierung von Release Notes integriert haben, werden diese Workflow-Läufe jetzt dem Agent SDK-Guthaben des Benutzers angerechnet, der die GitHub App installiert hat.

Dies ist nützlich für Projekte wie Clawsweeper, den auf Claude Code basierenden GitHub Triage-Bot, bei denen die Automatisierung ständig läuft und die Rechnung früher auf den API-Schlüssel fiel, der mit der App verbunden war.

Echte Agenten bauen: das SDK mit Apidog koppeln

Der wahre Wert des Agent SDK liegt in Agenten, die mehr tun als auf Text zu antworten; Agenten, die echte APIs ansprechen, Datenbanken abfragen, Code bereitstellen. Damit dies zuverlässig funktioniert, benötigt der Agent einen definierten Vertrag für jede externe API, die er berührt. Ohne einen solchen errät der Agent Anforderungsformen und Sie verbringen Ihre Debugging-Zeit damit, halluzinierte Payloads zu korrigieren.

Hier passt Apidog in den Workflow:

  1. Definieren Sie den API-Vertrag zuerst in Apidog. Spezifizieren Sie Endpunkte, Anforderungs-/Antwortschemata und Beispiel-Paylads. Dies wird zur Quelle der Wahrheit.
  2. Exportieren Sie OpenAPI und übergeben Sie es Ihrem Agenten als Kontext.
  3. Verwenden Sie das SDK, um den Agenten mit den echten Endpunkten zu verbinden. Der Agent ruft Ihre API unter Verwendung der Schemata auf, von denen er weiß, dass sie korrekt sind.
  4. Validieren Sie mit dem Apidog CLI. Jeder Agentenlauf kann überprüfen, ob die API immer noch das zurückgibt, was der Vertrag verspricht.

Für Agenten, die andere Tools über MCP-Server orchestrieren, ist der MCP-Server-Test-Workflow mit Apidog die passende Anleitung. Sie erhalten eine End-to-End-Testabdeckung für die Tools, die Ihr Agent aufruft.

Das Gesamtbild finden Sie im Design-First-API-Workflow-Leitfaden: Wenn der Agent einen Vertrag zur Validierung hat, verlagert sich Ihre Zeit als Entwickler auf das Schreiben besserer Verträge und Einschränkungen, anstatt JSON-Schema-Fehler in der Agenten-Ausgabe zu jagen.

Laden Sie Apidog kostenlos herunter, wenn Sie die Vertragsschicht für Ihre Agent SDK-Projekte nutzen möchten.

Wenn Sie trotzdem einen separaten API-Schlüssel wünschen

Das planbasierte Guthaben ist die richtige Standardeinstellung für die meisten Entwickler. Es gibt jedoch immer noch Fälle, in denen ein eigenständiger API-Schlüssel sinnvoll ist:

Der Leitfaden für kostenlosen Claude API-Zugriff behandelt Wege zur Claude-Nutzung, die weder einen Pro-Plan noch einen kostenpflichtigen API-Schlüssel erfordern.

Eine übersichtliche Checkliste vor dem Start

FAQ

Muss ich meinen alten ANTHROPIC_API_KEY entfernen, damit das Planguthaben funktioniert? Das SDK verwendet die lokalen Anmeldeinformationen von Claude Code, sofern vorhanden, was bedeutet, dass claude login ausreicht, um das SDK auf die planbasierte Abrechnung umzustellen. Wenn Sie ANTHROPIC_API_KEY in Ihrer Umgebung für andere Tools eingerichtet haben, lassen Sie es; das SDK bevorzugt die Plan-Authentifizierung, wenn diese vorhanden ist.

Was zählt als eine „Anfrage“ gegen das Guthaben? Das Guthaben wird in Dollar und nicht in Anfragen ausgedrückt. Jeder SDK-Aufruf wird zu den gleichen Tarifen abgerechnet, die Anthropic für die API-Nutzung veröffentlicht; Ihr Guthaben sinkt um die Kosten jedes Modellaufrufs, einschließlich Tool-Nutzung und Kontext-Tokens. Es gibt keine zusätzliche Gebühr pro Anfrage.

Kann ich mein Guthaben mit einem Teamkollegen teilen? Nein. Guthaben ist pro Benutzer und nicht übertragbar. Jeder Team- oder Enterprise-Platz hat seinen eigenen Guthabenpool.

Was passiert mit meinem alten Anthropic API-Konsolen-Guthaben? Es bleibt, wo es ist. Das Planguthaben ist ein separater Abrechnungsmechanismus. Wenn Sie ein vorausbezahltes Guthaben auf Ihrer API-Konsole hatten, funktioniert dieses immer noch für alle API-Schlüssel-Workloads.

Ist das Agent SDK dasselbe wie Claude Code? Nein. Claude Code ist die offizielle CLI und die IDE-Erweiterungen, die Anthropic bereitstellt. Das Agent SDK ist eine Programmierbibliothek (Python oder TypeScript) zum Erstellen benutzerdefinierter Agenten. Das Guthaben deckt das SDK sowie den nicht-interaktiven Befehl claude -p in Claude Code ab; interaktives Claude Code bleibt bei Ihrer regulären Plannutzung.

Wird sich meine GitHub Actions-Rechnung ändern? Wenn Ihre Aktion die offizielle Claude Code GitHub Actions-Integration verwendet und das Guthaben auf dem Konto des installierenden Benutzers beansprucht wird, werden diese Läufe nun dem SDK-Guthaben anstelle einer API-Schlüssel-Abrechnung belastet.

Funktioniert das Guthaben außerhalb des Agent SDK und claude -p? Nicht für die vier abgedeckten Oberflächen (SDK in Python/TS, claude -p, GitHub Actions, Drittanbieter-Agent SDK-Apps). Jede andere Claude-Nutzung fällt auf die normalen Limits Ihres Plans oder Ihren API-Schlüssel zurück, je nachdem, woher die Anfrage stammt.

button

Praktizieren Sie API Design-First in Apidog

Entdecken Sie eine einfachere Möglichkeit, APIs zu erstellen und zu nutzen

Kostenlos registrierenDownload