Bahasa Indonesia

Migrasi ke Claude Agent SDK

Panduan untuk migrasi Claude Code TypeScript dan Python SDKs ke Claude Agent SDK

Ringkasan

Claude Code SDK telah diubah namanya menjadi Claude Agent SDK dan dokumentasinya telah diorganisir ulang. Perubahan ini mencerminkan kemampuan SDK yang lebih luas untuk membangun agen AI di luar sekadar tugas pengkodean.

Apa yang Berubah

Aspek	Lama	Baru
Nama Paket (TS/JS)	`@anthropic-ai/claude-code`	`@anthropic-ai/claude-agent-sdk`
Paket Python	`claude-code-sdk`	`claude-agent-sdk`
Lokasi Dokumentasi	Dokumentasi Claude Code	API Guide → Bagian Agent SDK

Langkah-Langkah Migrasi

Untuk Proyek TypeScript/JavaScript

1. Uninstall paket lama:

npm uninstall @anthropic-ai/claude-code

2. Install paket baru:

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

3. Perbarui impor Anda:

Ubah semua impor dari @anthropic-ai/claude-code ke @anthropic-ai/claude-agent-sdk:

// Sebelumnya
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// Sesudahnya
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";

4. Perbarui dependensi package.json:

Jika Anda memiliki paket yang terdaftar di package.json Anda, perbarui:

Sebelumnya:

{
  "dependencies": {
    "@anthropic-ai/claude-code": "^0.0.42"
  }
}

Sesudahnya:

{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.2.0"
  }
}

5. Tinjau perubahan yang merusak

Buat perubahan kode apa pun yang diperlukan untuk menyelesaikan migrasi.

Untuk Proyek Python

1. Uninstall paket lama:

pip uninstall claude-code-sdk

2. Install paket baru:

pip install claude-agent-sdk

3. Perbarui impor Anda:

Ubah semua impor dari claude_code_sdk ke claude_agent_sdk:

# Sebelumnya
from claude_code_sdk import query, ClaudeCodeOptions

# Sesudahnya
from claude_agent_sdk import query, ClaudeAgentOptions

4. Perbarui nama tipe:

Ubah ClaudeCodeOptions menjadi ClaudeAgentOptions:

# Sebelumnya
from claude_code_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(model="claude-opus-4-7")

# Sesudahnya
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(model="claude-opus-4-7")

5. Tinjau perubahan yang merusak

Buat perubahan kode apa pun yang diperlukan untuk menyelesaikan migrasi.

Perubahan yang merusak

Python: ClaudeCodeOptions diubah nama menjadi ClaudeAgentOptions

Apa yang berubah: Tipe Python SDK ClaudeCodeOptions telah diubah nama menjadi ClaudeAgentOptions.

Migrasi:

# SEBELUMNYA (claude-code-sdk)
from claude_code_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(model="claude-opus-4-7", permission_mode="acceptEdits")

# SESUDAHNYA (claude-agent-sdk)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(model="claude-opus-4-7", permission_mode="acceptEdits")

Mengapa ini berubah: Nama tipe sekarang cocok dengan branding "Claude Agent SDK" dan memberikan konsistensi di seluruh konvensi penamaan SDK.

Prompt sistem tidak lagi default

Apa yang berubah: SDK tidak lagi menggunakan prompt sistem Claude Code secara default.

Migrasi:

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

// SEBELUMNYA (v0.0.x) - Menggunakan prompt sistem Claude Code secara default
const before = query({ prompt: "Hello" });

// SESUDAHNYA (v0.1.0) - Menggunakan prompt sistem minimal secara default
// Untuk mendapatkan perilaku lama, secara eksplisit minta preset Claude Code:
const presetResult = query({
prompt: "Hello",
options: {
systemPrompt: { type: "preset", preset: "claude_code" }
}
});

// Atau gunakan prompt sistem kustom:
const customResult = query({
prompt: "Hello",
options: {
systemPrompt: "You are a helpful coding assistant"
}
});

# SEBELUMNYA (v0.0.x) - Menggunakan prompt sistem Claude Code secara default
async for message in query(prompt="Hello"):
print(message)

# SESUDAHNYA (v0.1.0) - Menggunakan prompt sistem minimal secara default
# Untuk mendapatkan perilaku lama, secara eksplisit minta preset Claude Code:
from claude_agent_sdk import query, ClaudeAgentOptions

async for message in query(
prompt="Hello",
options=ClaudeAgentOptions(
system_prompt={"type": "preset", "preset": "claude_code"}  # Gunakan preset
),
):
print(message)

# Atau gunakan prompt sistem kustom:
async for message in query(
prompt="Hello",
options=ClaudeAgentOptions(system_prompt="You are a helpful coding assistant"),
):
print(message)

Mengapa ini berubah: Memberikan kontrol dan isolasi yang lebih baik untuk aplikasi SDK. Anda sekarang dapat membangun agen dengan perilaku kustom tanpa mewarisi instruksi yang berfokus pada CLI dari Claude Code.

Default sumber pengaturan

Default ini secara singkat diubah di v0.1.0 dan kemudian dikembalikan, jadi tidak ada tindakan migrasi yang diperlukan.

Perilaku saat ini: Menghilangkan settingSources pada query() memuat pengaturan pengguna, proyek, dan sistem file lokal, cocok dengan CLI. Ini termasuk ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, file CLAUDE.md, dan perintah kustom.

Untuk menjalankan terisolasi dari pengaturan sistem file, teruskan array kosong:

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

const isolatedResult = query({
prompt: "Hello",
options: {
settingSources: [] // Tidak ada pengaturan sistem file yang dimuat
}
});

// Atau muat hanya sumber tertentu:
const projectOnlyResult = query({
prompt: "Hello",
options: {
settingSources: ["project"] // Hanya pengaturan proyek
}
});

from claude_agent_sdk import query, ClaudeAgentOptions

async for message in query(
prompt="Hello",
options=ClaudeAgentOptions(setting_sources=[]),  # Tidak ada pengaturan sistem file yang dimuat
):
print(message)

# Atau muat hanya sumber tertentu:
async for message in query(
prompt="Hello",
options=ClaudeAgentOptions(
setting_sources=["project"]  # Hanya pengaturan proyek
),
):
print(message)

Isolasi sangat penting untuk pipeline CI/CD, aplikasi yang diterapkan, lingkungan pengujian, dan sistem multi-tenant di mana kustomisasi lokal tidak boleh bocor.

Mengapa Pengubahan Nama?

Claude Code SDK awalnya dirancang untuk tugas pengkodean, tetapi telah berkembang menjadi kerangka kerja yang kuat untuk membangun semua jenis agen AI. Nama baru "Claude Agent SDK" lebih mencerminkan kemampuannya:

Membangun agen bisnis (asisten hukum, penasihat keuangan, dukungan pelanggan)
Membuat agen pengkodean khusus (bot SRE, pengulas keamanan, agen tinjauan kode)
Mengembangkan agen kustom untuk domain apa pun dengan penggunaan alat, integrasi MCP, dan banyak lagi

Mendapatkan Bantuan

Jika Anda mengalami masalah apa pun selama migrasi:

Untuk TypeScript/JavaScript:

Periksa bahwa semua impor diperbarui untuk menggunakan @anthropic-ai/claude-agent-sdk
Verifikasi bahwa package.json Anda memiliki nama paket baru
Jalankan npm install untuk memastikan dependensi diperbarui

Untuk Python:

Periksa bahwa semua impor diperbarui untuk menggunakan claude_agent_sdk
Verifikasi bahwa requirements.txt atau pyproject.toml Anda memiliki nama paket baru
Jalankan pip install claude-agent-sdk untuk memastikan paket terinstal

Langkah Berikutnya

Jelajahi Ringkasan Agent SDK untuk mempelajari fitur yang tersedia
Lihat Referensi SDK TypeScript untuk dokumentasi API terperinci
Tinjau Referensi SDK Python untuk dokumentasi khusus Python
Pelajari tentang Custom Tools dan Integrasi MCP

agent-sdk/migration-guide.md +14 −8

12 12

13Claude Code SDK telah diubah namanya menjadi **Claude Agent SDK** dan dokumentasinya telah diorganisir ulang. Perubahan ini mencerminkan kemampuan SDK yang lebih luas untuk membangun agen AI di luar sekadar tugas pengkodean.13Claude Code SDK telah diubah namanya menjadi **Claude Agent SDK** dan dokumentasinya telah diorganisir ulang. Perubahan ini mencerminkan kemampuan SDK yang lebih luas untuk membangun agen AI di luar sekadar tugas pengkodean.

14 14

~~15<h2 id="what-s-changed">~~15<h2 id="what’s-changed">

16 Apa yang Berubah16 Apa yang Berubah

17</h2>17</h2>

18 18

82}82}

83```83```

84 84

~~85Itu saja! Tidak ada perubahan kode lain yang diperlukan.~~85**5. Tinjau [perubahan yang merusak](#breaking-changes)**

87Buat perubahan kode apa pun yang diperlukan untuk menyelesaikan migrasi.

86 88

87<h3 id="for-python-projects">89<h3 id="for-python-projects">

88 Untuk Proyek Python90 Untuk Proyek Python

172 174

173<CodeGroup>175<CodeGroup>

174 ```typescript TypeScript theme={null}176 ```typescript TypeScript theme={null}

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

178

175 // SEBELUMNYA (v0.0.x) - Menggunakan prompt sistem Claude Code secara default179 // SEBELUMNYA (v0.0.x) - Menggunakan prompt sistem Claude Code secara default

176 const result = query({ prompt: "Hello" });180 const before = query({ prompt: "Hello" });

177 181

178 // SESUDAHNYA (v0.1.0) - Menggunakan prompt sistem minimal secara default182 // SESUDAHNYA (v0.1.0) - Menggunakan prompt sistem minimal secara default

179 // Untuk mendapatkan perilaku lama, secara eksplisit minta preset Claude Code:183 // Untuk mendapatkan perilaku lama, secara eksplisit minta preset Claude Code:

180 const result = query({184 const presetResult = query({

181 prompt: "Hello",185 prompt: "Hello",

182 options: {186 options: {

183 systemPrompt: { type: "preset", preset: "claude_code" }187 systemPrompt: { type: "preset", preset: "claude_code" }

185 });189 });

186 190

187 // Atau gunakan prompt sistem kustom:191 // Atau gunakan prompt sistem kustom:

188 const result = query({192 const customResult = query({

189 prompt: "Hello",193 prompt: "Hello",

190 options: {194 options: {

191 systemPrompt: "You are a helpful coding assistant"195 systemPrompt: "You are a helpful coding assistant"

227 231

228Default ini secara singkat diubah di v0.1.0 dan kemudian dikembalikan, jadi tidak ada tindakan migrasi yang diperlukan.232Default ini secara singkat diubah di v0.1.0 dan kemudian dikembalikan, jadi tidak ada tindakan migrasi yang diperlukan.

229 233

230**Perilaku saat ini:** Menghilangkan `settingSources` pada `query()` memuat pengaturan pengguna, proyek, dan sistem file lokal, cocok dengan CLI. Ini termasuk file `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, file CLAUDE.md, dan perintah kustom.234**Perilaku saat ini:** Menghilangkan `settingSources` pada `query()` memuat pengaturan pengguna, proyek, dan sistem file lokal, cocok dengan CLI. Ini termasuk `~/.claude/settings.json`, `.claude/settings.json`, `.claude/settings.local.json`, file CLAUDE.md, dan perintah kustom.

231 235

232Untuk menjalankan terisolasi dari pengaturan sistem file, teruskan array kosong:236Untuk menjalankan terisolasi dari pengaturan sistem file, teruskan array kosong:

233 237

234<CodeGroup>238<CodeGroup>

235 ```typescript TypeScript theme={null}239 ```typescript TypeScript theme={null}

236 const result = query({240 import { query } from "@anthropic-ai/claude-agent-sdk";

241

242 const isolatedResult = query({

237 prompt: "Hello",243 prompt: "Hello",

238 options: {244 options: {

239 settingSources: [] // Tidak ada pengaturan sistem file yang dimuat245 settingSources: [] // Tidak ada pengaturan sistem file yang dimuat

241 });247 });

242 248

243 // Atau muat hanya sumber tertentu:249 // Atau muat hanya sumber tertentu:

244 const result = query({250 const projectOnlyResult = query({

245 prompt: "Hello",251 prompt: "Hello",

246 options: {252 options: {

247 settingSources: ["project"] // Hanya pengaturan proyek253 settingSources: ["project"] // Hanya pengaturan proyek

agent-sdk/migration-guide.md 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

Migrasi ke Claude Agent SDK

Ringkasan

Apa yang Berubah

Langkah-Langkah Migrasi

Untuk Proyek TypeScript/JavaScript

Untuk Proyek Python

Perubahan yang merusak

Python: ClaudeCodeOptions diubah nama menjadi ClaudeAgentOptions

Prompt sistem tidak lagi default

Default sumber pengaturan

Mengapa Pengubahan Nama?

Mendapatkan Bantuan

Langkah Berikutnya