Ikhtisar
Claude Code SDK telah diganti namanya menjadi Claude Agent SDK dan dokumentasinya telah ditata ulang. Perubahan ini mencerminkan kemampuan SDK yang lebih luas untuk membangun agent AI di luar tugas-tugas pemrograman. Apakah Anda justru bermigrasi dari OpenAI Agents SDK? Resep migrasi OpenAI Agents SDK memetakan setiap primitif ke Claude Agent SDK melalui satu contoh yang dikerjakan secara lengkap.Apa yang Berubah
Langkah-Langkah Migrasi
Migrasi proyek TypeScript atau JavaScript
1. Uninstall paket lama:@anthropic-ai/claude-code ke @anthropic-ai/claude-agent-sdk:
@anthropic-ai/claude-code masih tercantum dalam package.json Anda, gantikan dengan @anthropic-ai/claude-agent-sdk dan perbarui juga rentang versinya, misalnya dari "^0.0.42" menjadi "^0.3.0".
5. Tinjau perubahan yang merusak
Buat perubahan kode apa pun yang diperlukan untuk menyelesaikan migrasi.
Migrasi proyek Python
1. Uninstall paket lama:WARNING: Skipping claude-code-sdk as it is not installed. Itu adalah hal yang diharapkan dan Anda dapat melanjutkan ke langkah berikutnya.
2. Install paket baru:
claude-code-sdk tercantum dalam requirements.txt atau pyproject.toml Anda, gantikan dengan claude-agent-sdk.
3. Perbarui impor Anda:
Ubah semua impor dari claude_code_sdk ke claude_agent_sdk:
Perubahan yang merusak kompatibilitas
Python: ClaudeCodeOptions diganti nama menjadi ClaudeAgentOptions
Apa yang berubah: Tipe SDK PythonClaudeCodeOptions telah diganti nama menjadi ClaudeAgentOptions.
Migrasi:
System prompt tidak lagi default
Apa yang berubah: SDK tidak lagi menggunakan system prompt Claude Code secara default. Migrasi:Default sumber pengaturan
Default ini secara singkat diubah di v0.1.0 untuk tidak memuat pengaturan filesystem dan kemudian dikembalikan, jadi tidak ada tindakan migrasi yang diperlukan. Perilaku saat ini: MenghilangkansettingSources pada query() memuat pengaturan pengguna, proyek, dan filesystem lokal, sesuai dengan CLI. Ini mencakup ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, file CLAUDE.md, dan perintah kustom.
Untuk menjalankan terisolasi dari pengaturan filesystem, teruskan settingSources: [], atau setting_sources=[] di Python. Lihat Kontrol pengaturan filesystem dengan settingSources untuk mengetahui apa yang dimuat setiap sumber.
Isolasi sangat penting untuk pipeline CI/CD, aplikasi yang diterapkan, lingkungan pengujian, dan sistem multi-tenant di mana kustomisasi lokal tidak boleh bocor.
Python SDK 0.1.59 dan lebih awal memperlakukan daftar kosong sama dengan menghilangkan opsi, jadi tingkatkan sebelum mengandalkan
setting_sources=[]. Lihat Apa yang tidak dikontrol settingSources untuk input yang dibaca bahkan ketika settingSources adalah [].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