​
Gambaran Umum

Claude Code SDK telah diubah namanya menjadi Claude Agent SDK dan dokumentasinya telah direorganisasi. Perubahan ini mencerminkan kemampuan SDK yang lebih luas untuk membangun agen AI di luar hanya tugas-tugas coding.

​
Apa yang Berubah

AspekLamaBaru
Nama Package (TS/JS)@anthropic-ai/claude-code@anthropic-ai/claude-agent-sdk
Python Packageclaude-code-sdkclaude-agent-sdk
Lokasi DokumentasiClaude Code docs → bagian SDKAPI Guide → bagian Agent SDK
Perubahan Dokumentasi: Dokumentasi Agent SDK telah dipindahkan dari Claude Code docs ke API Guide di bawah bagian Agent SDK yang khusus. Claude Code docs sekarang fokus pada alat CLI dan fitur otomatisasi.

​
Langkah-langkah Migrasi

​
Untuk Proyek TypeScript/JavaScript

1. Uninstall package lama: 
npm uninstall @anthropic-ai/claude-code
2. Install package baru: 
npm install @anthropic-ai/claude-agent-sdk
3. Update import Anda: Ubah semua import dari @anthropic-ai/claude-code ke @anthropic-ai/claude-agent-sdk: 
// Sebelum
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-code";

// Sesudah
import {
  query,
  tool,
  createSdkMcpServer,
} from "@anthropic-ai/claude-agent-sdk";
4. Update dependencies package.json: Jika Anda memiliki package yang terdaftar di package.json Anda, update: 
// Sebelum
{
  "dependencies": {
    "@anthropic-ai/claude-code": "^1.0.0"
  }
}

// Sesudah
{
  "dependencies": {
    "@anthropic-ai/claude-agent-sdk": "^0.1.0"
  }
}
Itu saja! Tidak ada perubahan kode lain yang diperlukan.

​
Untuk Proyek Python

1. Uninstall package lama: 
pip uninstall claude-code-sdk
2. Install package baru: 
pip install claude-agent-sdk
3. Update import Anda: Ubah semua import dari claude_code_sdk ke claude_agent_sdk: 
# Sebelum
from claude_code_sdk import query, ClaudeCodeOptions

# Sesudah
from claude_agent_sdk import query, ClaudeAgentOptions
4. Update nama type: Ubah ClaudeCodeOptions ke ClaudeAgentOptions: 
# Sebelum
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5"
)

# Sesudah
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5"
)
5. Tinjau breaking changes Buat perubahan kode yang diperlukan untuk menyelesaikan migrasi.

​
Breaking changes

Untuk meningkatkan isolasi dan konfigurasi eksplisit, Claude Agent SDK v0.1.0 memperkenalkan breaking changes untuk pengguna yang bermigrasi dari Claude Code SDK. Tinjau bagian ini dengan hati-hati sebelum bermigrasi.

​
Python: ClaudeCodeOptions diubah namanya menjadi ClaudeAgentOptions

Apa yang berubah: Type Python SDK ClaudeCodeOptions telah diubah namanya menjadi ClaudeAgentOptions. Migrasi: 
# SEBELUM (v0.0.x)
from claude_agent_sdk import query, ClaudeCodeOptions

options = ClaudeCodeOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)

# SESUDAH (v0.1.0)
from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    model="claude-sonnet-4-5",
    permission_mode="acceptEdits"
)
Mengapa ini berubah: Nama type sekarang sesuai dengan branding “Claude Agent SDK” dan memberikan konsistensi di seluruh konvensi penamaan SDK.

​
System prompt tidak lagi default

Apa yang berubah: SDK tidak lagi menggunakan system prompt Claude Code secara default. Migrasi: 
// SEBELUM (v0.0.x) - Menggunakan system prompt Claude Code secara default
const result = query({ prompt: "Hello" });

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

// Atau gunakan system prompt kustom:
const result = query({
  prompt: "Hello",
  options: {
    systemPrompt: "You are a helpful coding assistant"
  }
});
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.

​
Settings Sources Tidak Lagi Dimuat Secara Default

Apa yang berubah: SDK tidak lagi membaca dari pengaturan filesystem (CLAUDE.md, settings.json, slash commands, dll.) secara default. Migrasi: 
// SEBELUM (v0.0.x) - Memuat semua pengaturan secara otomatis
const result = query({ prompt: "Hello" });
// Akan membaca dari:
// - ~/.claude/settings.json (user)
// - .claude/settings.json (project)
// - .claude/settings.local.json (local)
// - File CLAUDE.md
// - Slash commands kustom

// SESUDAH (v0.1.0) - Tidak ada pengaturan yang dimuat secara default
// Untuk mendapatkan perilaku lama:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["user", "project", "local"]
  }
});

// Atau muat hanya sumber tertentu:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"]  // Hanya pengaturan proyek
  }
});
Mengapa ini berubah: Memastikan aplikasi SDK memiliki perilaku yang dapat diprediksi independen dari konfigurasi filesystem lokal. Ini sangat penting untuk:
  • Lingkungan CI/CD - Perilaku konsisten tanpa kustomisasi lokal
  • Aplikasi yang di-deploy - Tidak bergantung pada pengaturan filesystem
  • Testing - Lingkungan tes yang terisolasi
  • Sistem multi-tenant - Mencegah kebocoran pengaturan antar pengguna
Kompatibilitas mundur: Jika aplikasi Anda bergantung pada pengaturan filesystem (slash commands kustom, instruksi CLAUDE.md, dll.), tambahkan settingSources: ['user', 'project', 'local'] ke opsi Anda.

​
Mengapa Perubahan Nama?

Claude Code SDK awalnya dirancang untuk tugas coding, tetapi telah berkembang menjadi framework 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 coding khusus (bot SRE, reviewer keamanan, agen review kode)
  • Mengembangkan agen kustom untuk domain apa pun dengan penggunaan alat, integrasi MCP, dan lainnya

​
Mendapatkan Bantuan

Jika Anda mengalami masalah selama migrasi: Untuk TypeScript/JavaScript:
  1. Periksa bahwa semua import telah diperbarui untuk menggunakan @anthropic-ai/claude-agent-sdk
  2. Verifikasi package.json Anda memiliki nama package baru
  3. Jalankan npm install untuk memastikan dependencies diperbarui
Untuk Python:
  1. Periksa bahwa semua import telah diperbarui untuk menggunakan claude_agent_sdk
  2. Verifikasi requirements.txt atau pyproject.toml Anda memiliki nama package baru
  3. Jalankan pip install claude-agent-sdk untuk memastikan package terinstall
Lihat panduan Troubleshooting untuk masalah umum.

​
Langkah Selanjutnya