Der vollständige Leitfaden zum Erstellen von Agenten mit dem Claude Agent SDK

In der heutigen digitalen Welt sind KI-Agenten eine wertvolle Ressource, die Entwicklern helfen, komplexe Aufgaben effizient zu bewältigen. Der Claude Agent SDK von Anthropic bietet eine leistungsstarke Infrastruktur, um eigene Agenten zu erstellen, die in der Lage sind, Aufgaben wie Codeüberprüfungen durchzuführen. In diesem Leitfaden zeigen wir Ihnen, wie Sie einen Code-Review-Agenten von Grund auf neu erstellen können.

Einführung in den Claude Agent SDK

Der Claude Agent SDK ist eine Bibliothek, die Entwicklern den Zugriff auf die Funktionen von Claude ermöglicht. Mit diesem SDK können Sie Agenten erstellen, die in der Lage sind, Dateien zu lesen, Befehle auszuführen und Probleme zu lösen, ähnlich wie es ein menschlicher Ingenieur tun würde. Der SDK bietet Ihnen alles, was Sie benötigen, um Agenten zu entwickeln, ohne dass Sie die zugrunde liegende Infrastruktur selbst aufbauen müssen.

Was wir bauen werden

Unser Code-Review-Agent wird folgende Funktionen haben:

• Analyse eines Code-Basis auf Bugs und Sicherheitsprobleme
• Autonome Durchsuchung von Dateien und Code
• Bereitstellung von strukturiertem, umsetzbarem Feedback
• Verfolgung des Fortschritts während der Arbeit

Technologischer Stack

• Runtime: Claude Code CLI
• SDK: @anthropic-ai/claude-agent-sdk
• Sprache: TypeScript
• Modell: Claude Opus 4.5

Was der SDK Ihnen bietet

Der Claude Agent SDK vereinfacht den Entwicklungsprozess erheblich. Anstatt die Kommunikationsschleife selbst zu verwalten, übernimmt der SDK diese Aufgabe für Sie. Hier ist ein einfaches Beispiel, wie die Verwendung des SDK den Code vereinfacht:

for await (const message of query({ prompt: "Fix the bug in auth.py" })) {
  console.log(message);
}

Voraussetzungen

1. Node.js 18+ installiert
2. Ein Anthropic API-Schlüssel (hier erhalten: Anthropic API)

Erste Schritte

Schritt 1: Installieren Sie Claude Code CLI

Der Agent SDK verwendet Claude Code als Runtime. Installieren Sie es mit:

npm install -g @anthropic-ai/claude-code

Schritt 2: Erstellen Sie Ihr Projekt

mkdir code-review-agent && cd code-review-agent
npm init -y
npm install @anthropic-ai/claude-agent-sdk
npm install -D typescript @types/node tsx

Schritt 3: Setzen Sie Ihren API-Schlüssel

export ANTHROPIC_API_KEY=your-api-key

Ihr erster Agent

Erstellen Sie die Datei agent.ts und fügen Sie den folgenden Code hinzu:

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

async function main() {
  for await (const message of query({ prompt: "What files are in this directory?" })) {
    console.log(message);
  }
}

main();

Führen Sie den Agenten mit folgendem Befehl aus:

npx tsx agent.ts

Verstehen des Nachrichtenstroms

Die Funktion query() gibt einen asynchronen Generator zurück, der Nachrichten streamt, während Claude arbeitet. Hier sind die wichtigsten Nachrichtentypen:

for await (const message of query({ prompt: "..." })) {
  switch (message.type) {
    case "system":
      // Initialisierungsinformationen
      break;
    case "assistant":
      // Antworten von Claude
      break;
    case "result":
      // Endergebnis
      break;
  }
}

Erstellen eines Code-Review-Agenten

Jetzt erstellen wir einen nützlichen Agenten. Erstellen Sie die Datei review-agent.ts und fügen Sie den folgenden Code hinzu:

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

async function reviewCode(directory: string) {
  for await (const message of query({ prompt: `Review the code in ${directory} for: ...` })) {
    // Analyse von Claude
  }
}

reviewCode(".");

Hinzufügen strukturierter Ausgaben

Für programmatische Anwendungen möchten Sie strukturierte Daten. Der SDK unterstützt JSON-Schema-Ausgaben:

const reviewSchema = { type: "object", properties: { ... } };

Umgang mit Berechtigungen

Standardmäßig fragt der SDK um Genehmigung, bevor er Werkzeuge ausführt. Sie können dies anpassen:

options: { permissionMode: "bypassPermissions" }

Erstellen von Subagenten

Für komplexe Aufgaben können Sie spezialisierte Subagenten erstellen:

async function comprehensiveReview(directory: string) { ... }

Fazit

Der Claude Agent SDK bietet eine umfassende Lösung für die Entwicklung von KI-Agenten, die in der Lage sind, komplexe Aufgaben wie Codeüberprüfungen durchzuführen. Mit den in diesem Leitfaden behandelten Techniken können Sie Ihre eigenen Agenten erstellen, die auf Ihre spezifischen Anforderungen zugeschnitten sind.

Quellenliste:

• Quelle: The Complete Guide to Building Agents with the Claude Agent SDK
• Claude Agent SDK Overview
• Anthropic API