Panduan

Manajemen Sesi

Memahami cara Claude Agent SDK menangani sesi dan resumsi sesi

Manajemen Sesi

Claude Agent SDK menyediakan kemampuan manajemen sesi untuk menangani status percakapan dan resumsi. Sesi memungkinkan Anda melanjutkan percakapan di berbagai interaksi sambil mempertahankan konteks penuh.

Cara Kerja Sesi

Ketika Anda memulai kueri baru, SDK secara otomatis membuat sesi dan mengembalikan ID sesi dalam pesan sistem awal. Anda dapat menangkap ID ini untuk melanjutkan sesi nanti.

Mendapatkan ID Sesi

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

let sessionId: string | undefined

const response = query({
  prompt: "Help me build a web application",
  options: {
    model: "claude-opus-4-6"
  }
})

for await (const message of response) {
  // The first message is a system init message with the session ID
  if (message.type === 'system' && message.subtype === 'init') {
    sessionId = message.session_id
    console.log(`Session started with ID: ${sessionId}`)
    // You can save this ID for later resumption
  }

  // Process other messages...
  console.log(message)
}

// Later, you can use the saved sessionId to resume
if (sessionId) {
  const resumedResponse = query({
    prompt: "Continue where we left off",
    options: {
      resume: sessionId
    }
  })
}

Melanjutkan Sesi

SDK mendukung melanjutkan sesi dari status percakapan sebelumnya, memungkinkan alur kerja pengembangan berkelanjutan. Gunakan opsi resume dengan ID sesi untuk melanjutkan percakapan sebelumnya.

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

// Resume a previous session using its ID
const response = query({
  prompt: "Continue implementing the authentication system from where we left off",
  options: {
    resume: "session-xyz", // Session ID from previous conversation
    model: "claude-opus-4-6",
    allowedTools: ["Read", "Edit", "Write", "Glob", "Grep", "Bash"]
  }
})

// The conversation continues with full context from the previous session
for await (const message of response) {
  console.log(message)
}

SDK secara otomatis menangani pemuatan riwayat percakapan dan konteks ketika Anda melanjutkan sesi, memungkinkan Claude untuk melanjutkan tepat di mana ia berhenti.

Untuk melacak dan mengembalikan perubahan file di seluruh sesi, lihat File Checkpointing.

Memisahkan Sesi

Ketika melanjutkan sesi, Anda dapat memilih untuk melanjutkan sesi asli atau memisahnya menjadi cabang baru. Secara default, melanjutkan akan terus sesi asli. Gunakan opsi forkSession (TypeScript) atau opsi fork_session (Python) untuk membuat ID sesi baru yang dimulai dari status yang dilanjutkan.

Kapan Harus Memisahkan Sesi

Pemisahan berguna ketika Anda ingin:

Menjelajahi pendekatan berbeda dari titik awal yang sama
Membuat beberapa cabang percakapan tanpa mengubah yang asli
Menguji perubahan tanpa mempengaruhi riwayat sesi asli
Mempertahankan jalur percakapan terpisah untuk eksperimen berbeda

Memisahkan vs Melanjutkan

Perilaku	`forkSession: false` (default)	`forkSession: true`
ID Sesi	Sama dengan asli	ID sesi baru dihasilkan
Riwayat	Menambahkan ke sesi asli	Membuat cabang baru dari titik lanjutan
Sesi Asli	Dimodifikasi	Dipertahankan tidak berubah
Kasus Penggunaan	Lanjutkan percakapan linear	Cabang untuk menjelajahi alternatif

Contoh: Memisahkan Sesi

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

// First, capture the session ID
let sessionId: string | undefined

const response = query({
  prompt: "Help me design a REST API",
  options: { model: "claude-opus-4-6" }
})

for await (const message of response) {
  if (message.type === 'system' && message.subtype === 'init') {
    sessionId = message.session_id
    console.log(`Original session: ${sessionId}`)
  }
}

// Fork the session to try a different approach
const forkedResponse = query({
  prompt: "Now let's redesign this as a GraphQL API instead",
  options: {
    resume: sessionId,
    forkSession: true,  // Creates a new session ID
    model: "claude-opus-4-6"
  }
})

for await (const message of forkedResponse) {
  if (message.type === 'system' && message.subtype === 'init') {
    console.log(`Forked session: ${message.session_id}`)
    // This will be a different session ID
  }
}

// The original session remains unchanged and can still be resumed
const originalContinued = query({
  prompt: "Add authentication to the REST API",
  options: {
    resume: sessionId,
    forkSession: false,  // Continue original session (default)
    model: "claude-opus-4-6"
  }
})

Was this page helpful?

Panduan

Manajemen Sesi

Memahami cara Claude Agent SDK menangani sesi dan resumsi sesi

Manajemen Sesi

Cara Kerja Sesi

Ketika Anda memulai kueri baru, SDK secara otomatis membuat sesi dan mengembalikan ID sesi dalam pesan sistem awal. Anda dapat menangkap ID ini untuk melanjutkan sesi nanti.

Mendapatkan ID Sesi

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

let sessionId: string | undefined

const response = query({
  prompt: "Help me build a web application",
  options: {
    model: "claude-opus-4-6"
  }
})

for await (const message of response) {
  // The first message is a system init message with the session ID
  if (message.type === 'system' && message.subtype === 'init') {
    sessionId = message.session_id
    console.log(`Session started with ID: ${sessionId}`)
    // You can save this ID for later resumption
  }

  // Process other messages...
  console.log(message)
}

// Later, you can use the saved sessionId to resume
if (sessionId) {
  const resumedResponse = query({
    prompt: "Continue where we left off",
    options: {
      resume: sessionId
    }
  })
}

Melanjutkan Sesi

SDK mendukung melanjutkan sesi dari status percakapan sebelumnya, memungkinkan alur kerja pengembangan berkelanjutan. Gunakan opsi resume dengan ID sesi untuk melanjutkan percakapan sebelumnya.

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

// Resume a previous session using its ID
const response = query({
  prompt: "Continue implementing the authentication system from where we left off",
  options: {
    resume: "session-xyz", // Session ID from previous conversation
    model: "claude-opus-4-6",
    allowedTools: ["Read", "Edit", "Write", "Glob", "Grep", "Bash"]
  }
})

// The conversation continues with full context from the previous session
for await (const message of response) {
  console.log(message)
}

SDK secara otomatis menangani pemuatan riwayat percakapan dan konteks ketika Anda melanjutkan sesi, memungkinkan Claude untuk melanjutkan tepat di mana ia berhenti.

Untuk melacak dan mengembalikan perubahan file di seluruh sesi, lihat File Checkpointing.

Memisahkan Sesi

Kapan Harus Memisahkan Sesi

Pemisahan berguna ketika Anda ingin:

Menjelajahi pendekatan berbeda dari titik awal yang sama
Membuat beberapa cabang percakapan tanpa mengubah yang asli
Menguji perubahan tanpa mempengaruhi riwayat sesi asli
Mempertahankan jalur percakapan terpisah untuk eksperimen berbeda

Memisahkan vs Melanjutkan

Perilaku	`forkSession: false` (default)	`forkSession: true`
ID Sesi	Sama dengan asli	ID sesi baru dihasilkan
Riwayat	Menambahkan ke sesi asli	Membuat cabang baru dari titik lanjutan
Sesi Asli	Dimodifikasi	Dipertahankan tidak berubah
Kasus Penggunaan	Lanjutkan percakapan linear	Cabang untuk menjelajahi alternatif

Contoh: Memisahkan Sesi

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

// First, capture the session ID
let sessionId: string | undefined

const response = query({
  prompt: "Help me design a REST API",
  options: { model: "claude-opus-4-6" }
})

for await (const message of response) {
  if (message.type === 'system' && message.subtype === 'init') {
    sessionId = message.session_id
    console.log(`Original session: ${sessionId}`)
  }
}

// Fork the session to try a different approach
const forkedResponse = query({
  prompt: "Now let's redesign this as a GraphQL API instead",
  options: {
    resume: sessionId,
    forkSession: true,  // Creates a new session ID
    model: "claude-opus-4-6"
  }
})

for await (const message of forkedResponse) {
  if (message.type === 'system' && message.subtype === 'init') {
    console.log(`Forked session: ${message.session_id}`)
    // This will be a different session ID
  }
}

// The original session remains unchanged and can still be resumed
const originalContinued = query({
  prompt: "Add authentication to the REST API",
  options: {
    resume: sessionId,
    forkSession: false,  // Continue original session (default)
    model: "claude-opus-4-6"
  }
})

Was this page helpful?