TypeScript SDK V2 세션 API (제거됨)
공식 기준: https://code.claude.com/docs/en/agent-sdk/typescript-v2-preview
기준일: 2026-07-26 · CLI 기준 2.1.220
개요
V2 session API는 더 이상 지원되지 않습니다. TypeScript Agent SDK 0.3.142에서 다음이 제거되었습니다.
unstable_v2_createSessionunstable_v2_resumeSessionunstable_v2_promptSDKSession,SDKSessionOptions타입
마이그레이션: query() API와 session options를 사용하세요. multi-turn은 AsyncIterable<SDKUserMessage>, 저장 세션 이어가기는 options.resume입니다. 이 페이지는 0.2.x 유지보수 참고용입니다.
핵심 개념 (과거 V2)
createSession()/resumeSession()— 세션 시작·재개session.send()— 메시지 전송session.stream()— 응답 스트림
async generator 조율 없이 send/stream 사이클을 분리하는 실험 API였습니다.
상세
마지막 V2 호환 설치
패키지 버전은 0.2.x에서 0.3.142로 점프했습니다.
npm install @anthropic-ai/claude-agent-sdk@0.2
과거 one-shot
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);
}
V1 동등:
import { query } from "@anthropic-ai/claude-agent-sdk";
const q = query({
prompt: "What is 2 + 2?",
options: { model: "claude-opus-4-7" }
});
for await (const msg of q) {
if (msg.type === "result" && msg.subtype === "success") {
console.log(msg.result);
}
}
과거 세션·multi-turn
V2는 send 후 stream을 반복했습니다. V1/현재는 동일 세션에서 async iterable로 메시지를 yield하거나, session id를 저장해 resume합니다.
마이그레이션 체크
unstable_v2_*import 검색·제거- multi-turn을
query({ prompt: async function*() {...}})또는 client 패턴으로 재구성 - resume은
options.resume = sessionId - SDK를 0.3.x+로 올리고 타입 체크
체크리스트
- 코드베이스에 V2 API 잔존 없음
- 0.3.142+에서 빌드 통과
- multi-turn·resume 시나리오 테스트