Schnellstart

Verwenden Sie das Agent SDK, um einen KI-Agenten zu erstellen, der Ihren Code liest, Fehler findet und behebt – alles ohne manuelle Eingriffe. Das werden Sie tun:

Ein Projekt mit dem Agent SDK einrichten
Eine Datei mit fehlerhaftem Code erstellen
Einen Agenten ausführen, der Fehler automatisch findet und behebt

Voraussetzungen

Node.js 18+ oder Python 3.10+
Ein Anthropic-Konto (hier registrieren)

Einrichtung

Erstellen Sie einen Projektordner

Erstellen Sie ein neues Verzeichnis für diesen Schnellstart:

mkdir my-agent
cd my-agent

Für Ihre eigenen Projekte können Sie das SDK aus jedem Ordner ausführen; es hat standardmäßig Zugriff auf Dateien in diesem Verzeichnis und seinen Unterverzeichnissen.

Installieren Sie das SDK

Installieren Sie das Agent SDK-Paket für Ihre Sprache:

TypeScript (neues Projekt)
TypeScript (bestehendes Projekt)
Python (uv)
Python (pip)

npm init -y
npm pkg set type=module
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

Das Setzen von "type": "module" in package.json ermöglicht Ihrem Agent-Skript die Verwendung von Top-Level-await, und tsx führt TypeScript-Dateien direkt aus.

npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

tsx führt TypeScript-Dateien direkt aus. Wenn Ihr Projekt CommonJS verwendet, benennen Sie Ihr Agent-Skript agent.mts statt agent.ts. Die .mts-Erweiterung veranlasst tsx, die Datei als ES-Modul zu behandeln, sodass Top-Level-await funktioniert, ohne Ihr gesamtes Projekt in ES-Module zu konvertieren. Verwenden Sie agent.mts anstelle von agent.ts in den Erstellungs- und Ausführungsschritten später in diesem Schnellstart.

uv ist ein schneller Python-Paketmanager, der virtuelle Umgebungen automatisch verwaltet:

uv init
uv add claude-agent-sdk

Erstellen und aktivieren Sie eine virtuelle Umgebung und installieren Sie dann das Paket.Auf macOS oder Linux:

python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk

Unter Windows:

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install claude-agent-sdk

Wenn PowerShell Activate.ps1 mit einem Ausführungsrichtlinienfehler blockiert, führen Sie zuerst Set-ExecutionPolicy -Scope Process RemoteSigned aus.

Das TypeScript SDK bündelt eine native Claude Code-Binärdatei für Ihre Plattform als optionale Abhängigkeit, sodass Sie Claude Code nicht separat installieren müssen.

Legen Sie Ihren API-Schlüssel fest

Rufen Sie einen API-Schlüssel von der Claude-Konsole ab und legen Sie ihn dann als Umgebungsvariable in der Shell fest, in der Sie Ihren Agenten ausführen:

macOS / Linux
Windows (PowerShell)

export ANTHROPIC_API_KEY=your-api-key

$env:ANTHROPIC_API_KEY = "your-api-key"

Das SDK liest den Schlüssel aus der Umgebung des Prozesses, der Ihren Agenten ausführt; es lädt .env-Dateien nicht automatisch. Wenn Sie den Schlüssel in einer .env-Datei speichern, laden Sie ihn selbst, beispielsweise mit de

Agent SDK

Kernkonzepte

Eingabe und Ausgabe

Mit Tools erweitern

Verhalten anpassen

Kontrolle und Beobachtbarkeit

Bereitstellung

SDK-Referenzen

Voraussetzungen

Einrichtung

​Voraussetzungen

​Einrichtung

Voraussetzungen

Einrichtung