Langsung ke konten utama

​
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

AspekLamaBaru
Nama Paket (TS/JS)@anthropic-ai/claude-code@anthropic-ai/claude-agent-sdk
Paket Pythonclaude-code-sdkclaude-agent-sdk
Lokasi DokumentasiDokumentasi Claude CodeAPI Guide → Bagian Agent SDK
Perubahan Dokumentasi: Dokumentasi Agent SDK telah dipindahkan dari dokumentasi Claude Code ke API Guide di bawah bagian Agent SDK yang didedikasikan. Dokumentasi Claude Code sekarang fokus pada alat CLI dan fitur otomasi.

​
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"
  }
}
Itu saja! Tidak ada perubahan kode lain yang diperlukan.

​
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

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

​
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: 
// SEBELUMNYA (v0.0.x) - Menggunakan prompt sistem Claude Code secara default
const result = query({ prompt: "Hello" });

// SESUDAHNYA (v0.1.0) - Menggunakan prompt sistem minimal 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 prompt sistem 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.

​
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 file ~/.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: 
const result = query({
  prompt: "Hello",
  options: {
    settingSources: [] // Tidak ada pengaturan sistem file yang dimuat
  }
});

// Atau muat hanya sumber tertentu:
const result = query({
  prompt: "Hello",
  options: {
    settingSources: ["project"] // Hanya pengaturan proyek
  }
});
Isolasi sangat penting untuk pipeline CI/CD, aplikasi yang diterapkan, lingkungan pengujian, dan sistem multi-tenant di mana kustomisasi lokal tidak boleh bocor.
SDK v0.1.0 secara singkat default ke tidak ada pengaturan yang dimuat; ini dikembalikan dalam rilis berikutnya. Python SDK 0.1.59 dan lebih awal memperlakukan daftar kosong sama dengan menghilangkan opsi, jadi upgrade sebelum mengandalkan setting_sources=[]. Lihat Apa yang settingSources tidak kontrol untuk input yang dibaca bahkan ketika settingSources adalah [].

​
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:
  1. Periksa bahwa semua impor diperbarui untuk menggunakan @anthropic-ai/claude-agent-sdk
  2. Verifikasi bahwa package.json Anda memiliki nama paket baru
  3. Jalankan npm install untuk memastikan dependensi diperbarui
Untuk Python:
  1. Periksa bahwa semua impor diperbarui untuk menggunakan claude_agent_sdk
  2. Verifikasi bahwa requirements.txt atau pyproject.toml Anda memiliki nama paket baru
  3. Jalankan pip install claude-agent-sdk untuk memastikan paket terinstal

​
Langkah Berikutnya