TypeScript SDK V2 Sitzungs-API (entfernt)

Die V2 Sitzungs-API wird nicht mehr unterstützt. TypeScript Agent SDK 0.3.142 entfernt unstable_v2_createSession, unstable_v2_resumeSession, unstable_v2_prompt und die Typen SDKSession und SDKSessionOptions.Verwenden Sie zur Migration die query() API und die Sitzungsoptionen, die sie akzeptiert. Übergeben Sie ein AsyncIterable<SDKUserMessage> für mehrteilige Gespräche oder options.resume, um eine gespeicherte Sitzung fortzusetzen. Diese Seite wird als Referenz beibehalten, wenn Sie Code auf Agent SDK 0.2.x oder früher verwalten.

V2 war eine experimentelle Sitzungs-API, die die Notwendigkeit für asynchrone Generatoren und Yield-Koordination entfernte. Anstatt den Generator-Status über Turns hinweg zu verwalten, war jeder Turn ein separater send()/stream()-Zyklus. Die API-Oberfläche reduzierte sich auf drei Konzepte:

createSession() / resumeSession(): Ein Gespräch starten oder fortsetzen
session.send(): Eine Nachricht senden
session.stream(): Die Antwort abrufen

Installation

Agent SDK 0.2.x ist die letzte Version, die die V2-Schnittstelle enthält. Die Paketversion sprang von 0.2.x direkt zu 0.3.142, sodass die oben genannte Entfernungsversion und die Installationsfestlegung unten dieselbe Grenze beschreiben. Um die letzte V2-kompatible Version zu installieren, legen Sie die Hauptversion und Nebenversion fest:

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

Das 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.

Schnellstart

Einmalige Anfrage

Für einfache Einzelturn-Abfragen, bei denen Sie keine Sitzung beibehalten müssen, verwenden Sie unstable_v2_prompt(). Dieses Beispiel sendet eine Mathefrage und protokolliert die Antwort:

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

const result = await unstable_v2_prompt("What is 2 + 2?", {
  model: "claude-opus-4-7"
});
if (result.subtype === "success") {
  console.log(result.result);
}

Grundlegende Sitzung

Für Interaktionen über eine einzelne Anfrage hinaus erstellen Sie eine Sitzung. V2 trennt das Senden und Streamen in unterschiedliche Schritte:

send() sendet Ihre Nachricht
stream() streamt die Antwort zurück

Diese explizite Trennung macht es einfacher, Logik zwischen Turns hinzuzufügen (wie das Verarbeiten von Antworten vor dem Senden von Folgefragen). Das folgende Beispiel erstellt eine Sitzung, sendet „Hello!” an Claude und gibt die Textantwort aus. Es verwendet await using (TypeScript 5.2+), um die Sitzung automatisch zu schließen, wenn der Block beendet wird. Sie können auch session.close() manuell aufrufen.

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

await using session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});

await session.send("Hello!");
for await (const msg of session.stream()) {
  // Filter for assistant messages to get human-readable output
  if (msg.type === "assistant") {
    const text = msg.message.content
      .filter((block) => block.type === "text")
      .map((block) => block.text)
      .join("");
    console.log(text);
  }
}

Mehrteiliges Gespräch

Sitzungen behalten den Kontext über mehrere Austausche hinweg bei. Um ein Gespräch fortzusetzen, rufen Sie send() erneut in derselben Sitzung auf. Claude merkt sich die vorherigen Turns. Dieses Beispiel stellt eine Mathefrage und stellt dann eine Folgefrage, die sich auf die vorherige Antwort bezieht:

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

await using session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});

// Turn 1
await session.send("What is 5 + 3?");
for await (const msg of session.stream()) {
  // Filter for assistant messages to get human-readable output
  if (msg.type === "assistant") {
    const text = msg.message.content
      .filter((block) => block.type === "text")
      .map((block) => block.text)
      .join("");
    console.log(text);
  }
}

// Turn 2
await session.send("Multiply that by 2");
for await (const msg of session.stream()) {
  if (msg.type === "assistant") {
    const text = msg.message.content
      .filter((block) => block.type === "text")
      .map((block) => block.text)
      .join("");
    console.log(text);
  }
}

Sitzung fortsetzen

Wenn Sie eine Sitzungs-ID aus einer vorherigen Interaktion haben, können Sie diese später fortsetzen. Dies ist nützlich für langfristige Workflows oder wenn Sie Gespräche über Anwendungsneustarts hinweg beibehalten müssen. Dieses Beispiel erstellt eine Sitzung, speichert ihre ID, schließt sie und setzt das Gespräch dann fort:

import {
  unstable_v2_createSession,
  unstable_v2_resumeSession,
  type SDKMessage
} from "@anthropic-ai/claude-agent-sdk";

// Helper to extract text from assistant messages
function getAssistantText(msg: SDKMessage): string | null {
  if (msg.type !== "assistant") return null;
  return msg.message.content
    .filter((block) => block.type === "text")
    .map((block) => block.text)
    .join("");
}

// Create initial session and have a conversation
const session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});

await session.send("Remember this number: 42");

// Get the session ID from any received message
let sessionId: string | undefined;
for await (const msg of session.stream()) {
  sessionId = msg.session_id;
  const text = getAssistantText(msg);
  if (text) console.log("Initial response:", text);
}

console.log("Session ID:", sessionId);
session.close();

// Later: resume the session using the stored ID
await using resumedSession = unstable_v2_resumeSession(sessionId!, {
  model: "claude-opus-4-7"
});

await resumedSession.send("What number did I ask you to remember?");
for await (const msg of resumedSession.stream()) {
  const text = getAssistantText(msg);
  if (text) console.log("Resumed response:", text);
}

Bereinigung

Sitzungen können manuell oder automatisch mit await using geschlossen werden, einer TypeScript 5.2+-Funktion für automatische Ressourcenbereinigung. Wenn Sie eine ältere TypeScript-Version verwenden oder auf Kompatibilitätsprobleme stoßen, verwenden Sie stattdessen manuelle Bereinigung. Automatische Bereinigung (TypeScript 5.2+):

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

await using session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});
// Session closes automatically when the block exits

Manuelle Bereinigung:

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

const session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});
// ... use the session ...
session.close();

API-Referenz

`unstable_v2_createSession()`

Erstellt eine neue Sitzung für mehrteilige Gespräche.

function unstable_v2_createSession(options: {
  model: string;
  // Additional options supported
}): SDKSession;

`unstable_v2_resumeSession()`

Setzt eine vorhandene Sitzung nach ID fort.

function unstable_v2_resumeSession(
  sessionId: string,
  options: {
    model: string;
    // Additional options supported
  }
): SDKSession;

`unstable_v2_prompt()`

Einmalige Komfortfunktion für Einzelturn-Abfragen.

function unstable_v2_prompt(
  prompt: string,
  options: {
    model: string;
    // Additional options supported
  }
): Promise<SDKResultMessage>;

SDKSession-Schnittstelle

interface SDKSession {
  readonly sessionId: string;
  send(message: string | SDKUserMessage): Promise<void>;
  stream(): AsyncGenerator<SDKMessage, void>;
  close(): void;
}

Funktionsverfügbarkeit

Die V2 Sitzungs-API unterstützt nicht alle V1-Funktionen. Die folgenden erfordern das V1 SDK:

Sitzungs-Forking (forkSession-Option)
Einige erweiterte Streaming-Eingabemuster

Siehe auch

TypeScript SDK-Referenz (V1) - Vollständige V1 SDK-Dokumentation
SDK-Übersicht - Allgemeine SDK-Konzepte
V2-Beispiele auf GitHub - Funktionierende Code-Beispiele

Agent SDK

Kernkonzepte

Eingabe und Ausgabe

Mit Tools erweitern

Verhalten anpassen

Kontrolle und Beobachtbarkeit

Bereitstellung

SDK-Referenzen

TypeScript SDK V2 Sitzungs-API (entfernt)

Installation

Schnellstart

Einmalige Anfrage

Grundlegende Sitzung

Mehrteiliges Gespräch

Sitzung fortsetzen

Bereinigung

API-Referenz

`unstable_v2_createSession()`

`unstable_v2_resumeSession()`

`unstable_v2_prompt()`

SDKSession-Schnittstelle

Funktionsverfügbarkeit

Siehe auch

​Installation

​Schnellstart

​Einmalige Anfrage

​Grundlegende Sitzung

​Mehrteiliges Gespräch

​Sitzung fortsetzen

​Bereinigung

​API-Referenz

​unstable_v2_createSession()

​unstable_v2_resumeSession()

​unstable_v2_prompt()

​SDKSession-Schnittstelle

​Funktionsverfügbarkeit

​Siehe auch

Installation

Schnellstart

Einmalige Anfrage

Grundlegende Sitzung

Mehrteiliges Gespräch

Sitzung fortsetzen

Bereinigung

API-Referenz

`unstable_v2_createSession()`

`unstable_v2_resumeSession()`

`unstable_v2_prompt()`

SDKSession-Schnittstelle

Funktionsverfügbarkeit

Siehe auch