<Note>
  SDK 会将你平台对应的 Claude Code 原生二进制包含为可选依赖，因此无需单独安装 Claude Code。
</Note>

## 快速开始

### 单次 Prompt

**简单的单轮查询，不需要维护 session。** 使用 `unstable_v2_prompt()` 发送一个数学问题并打印答案：

```typescript theme={null}
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);
}

<details>
  <summary>V1 等效写法</summary>

  V1 中输入和输出都通过单个 async generator 流动。基本 prompt 看起来类似，但添加多轮逻辑需要重构为使用 input generator。

  ```typescript theme={null}
  import { query } from "@anthropic-ai/claude-agent-sdk";

  const q = query({
    prompt: "Hello!",
    options: { model: "claude-opus-4-7" }
  });

  for await (const msg of q) {
    if (msg.type === "assistant") {
      const text = msg.message.content
        .filter((block) => block.type === "text")
        .map((block) => block.text)
        .join("");
      console.log(text);
    }
  }
  ```
</details>

### 多轮对话

**Session 在多次交互间保持上下文。** 在同一个 session 上再次调用 `send()` 即可继续对话，Claude 会记住之前的轮次。

下面的示例先问一个数学问题，再问一个引用前一个答案的后续问题：

```typescript theme={null}
import { unstable_v2_createSession } from "@anthropic-ai/claude-agent-sdk";

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

// 第一轮
await session.send("What is 5 + 3?");
for await (const msg of session.stream()) {
  // 过滤 assistant 消息获取可读输出
  if (msg.type === "assistant") {
    const text = msg.message.content
      .filter((block) => block.type === "text")
      .map((block) => block.text)
      .join("");
    console.log(text);
  }
}

// 第二轮
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);
  }
}

<details>
  <summary>V1 等效写法</summary>

  ```typescript theme={null}
  import { query } from "@anthropic-ai/claude-agent-sdk";

  // 创建初始 session
  const initialQuery = query({
    prompt: "Remember this number: 42",
    options: { model: "claude-opus-4-7" }
  });

  // 从任意消息获取 session ID
  let sessionId: string | undefined;
  for await (const msg of initialQuery) {
    sessionId = msg.session_id;
    if (msg.type === "assistant") {
      const text = msg.message.content
        .filter((block) => block.type === "text")
        .map((block) => block.text)
        .join("");
      console.log("Initial response:", text);
    }
  }

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

  // 稍后：恢复 session
  const resumedQuery = query({
    prompt: "What number did I ask you to remember?",
    options: {
      model: "claude-opus-4-7",
      resume: sessionId
    }
  });

  for await (const msg of resumedQuery) {
    if (msg.type === "assistant") {
      const text = msg.message.content
        .filter((block) => block.type === "text")
        .map((block) => block.text)
        .join("");
      console.log("Resumed response:", text);
    }
  }
  ```
</details>

### 资源清理

**Session 可以手动或自动关闭。** 使用 [`await using`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-2.html#using-declarations-and-explicit-resource-management)（TypeScript 5.2+ 的自动资源管理特性）在代码块退出时自动清理。旧版 TypeScript 或遇到兼容问题时使用手动清理。

**自动清理（TypeScript 5.2+）：**

```typescript theme={null}
import { unstable_v2_createSession } from "@anthropic-ai/claude-agent-sdk";

await using session = unstable_v2_createSession({
  model: "claude-opus-4-7"
});
// 代码块退出时 session 自动关闭

## API 参考

### `unstable_v2_createSession()`

**创建新的多轮对话 session。**

```typescript theme={null}
function unstable_v2_createSession(options: {
  model: string;
  // 支持其他选项
}): SDKSession;

### `unstable_v2_prompt()`

**单轮查询的便捷函数。**

```typescript theme={null}
function unstable_v2_prompt(
  prompt: string,
  options: {
    model: string;
    // 支持其他选项
  }
): Promise<SDKResultMessage>;