Gambaran Umum Agent SDK
Bangun agen AI produksi dengan Claude Code sebagai perpustakaan
Agen adalah aplikasi yang menyelesaikan tugas dengan merencanakan langkah-langkahnya sendiri dan memanggil alat yang membaca file, menjalankan perintah, atau mengedit kode. Agent SDK memberi Anda alat yang sama, agent loop, dan manajemen konteks yang mendukung Claude Code, dapat diprogram dalam Python dan TypeScript.
Bandingkan Agent SDK dengan alat Claude lainnya
Agent SDK, CLI, Client SDK, dan Managed Agents berbeda dalam hal siapa yang menjalankan agen, apa yang sudah tertanam, dan bagaimana Anda mengaksesnya. Temukan baris yang sesuai dengan cara Anda ingin membangun dan menjalankannya.
| Anda ingin | Gunakan | Apa yang Anda dapatkan |
|---|---|---|
| Menyematkan agen Claude Code dalam aplikasi Python atau TypeScript Anda sendiri, dalam proses yang Anda operasikan | Agent SDK | Sebuah library yang menjalankan biner Claude Code, dengan kemampuan Claude Code, seperti alat bawaan, izin, sesi, dan hooks. |
| Melakukan pengembangan interaktif atau menjalankan tugas sekali jadi dari terminal | Claude Code CLI | Antarmuka terminal, dibangun untuk penggunaan interaktif sehari-hari. |
| Memanggil API Claude secara langsung dari kode Anda sendiri | Client SDK | Akses langsung ke API Claude dari salah satu bahasa Client SDK. Anda menulis loop alat sendiri, atau biarkan tool runner beta Client SDK menjalankannya. |
| Memiliki Anthropic menjalankan agen, dikonfigurasi melalui API Claude | Managed Agents | Harness agen yang dihosting yang menjalankan loop agen, dengan sesi dalam sandbox cloud yang dikelola Anthropic atau sandbox yang dihosting sendiri pada infrastruktur Anda sendiri. Gunakan dari SDK untuk bahasa Anda, CLI ant, atau REST API. |
Untuk menjalankan loop agen yang sama dari bahasa selain Python atau TypeScript, jalankan CLI sebagai subprocess dengan flag -p dan --output-format json.
Kemampuan
Kemampuan Claude Code ini tersedia di SDK:
| Kemampuan | Apa yang dilakukannya | Pelajari lebih lanjut |
|---|---|---|
| Alat bawaan | Baca, tulis, edit file, jalankan perintah, dan cari web | Referensi alat |
| Hooks | Jalankan kode khusus pada titik-titik kunci dalam siklus hidup agen | Hooks |
| Subagents | Spawn agen khusus untuk menangani subtask yang terfokus | Subagents |
| MCP | Terhubung ke alat eksternal dan sumber data melalui Model Context Protocol | MCP |
| Izin | Kontrol alat mana yang berjalan secara otomatis, mana yang memerlukan persetujuan | Izin |
| Sesi | Pertahankan konteks di seluruh pertukaran, lanjutkan atau fork nanti | Sesi |
| Skills, commands, dan memory | Muat secara otomatis dari .claude/ proyek Anda dan dari ~/.claude/, sama seperti Claude Code |
Skills, Commands, Memory, Pemuatan konfigurasi |
| Plugins | Paket skills, agen, hooks, dan server MCP, dan muat mereka berdasarkan jalur lokal | Plugins |
Mulai
Ikuti Quickstart untuk memasang SDK, mengatur kunci API Anda, dan membangun agen pertama Anda, yang menemukan dan memperbaiki bug dalam kode yang ada.
Changelog
Lihat changelog lengkap untuk pembaruan SDK, perbaikan bug, dan fitur baru:
- TypeScript SDK: lihat CHANGELOG.md
- Python SDK: lihat CHANGELOG.md
Melaporkan bug
Jika Anda mengalami bug atau masalah dengan Agent SDK:
- TypeScript SDK: laporkan masalah di GitHub
- Python SDK: laporkan masalah di GitHub
Pedoman branding
Untuk mitra yang mengintegrasikan Claude Agent SDK, penggunaan branding Claude bersifat opsional. Saat mereferensikan Claude dalam produk Anda:
Diizinkan:
- "Claude Agent", lebih disukai untuk menu dropdown
- "Claude", ketika sudah dalam menu berlabel "Agents"
- "{YourAgentName} Powered by Claude", jika Anda memiliki nama agen yang ada
Tidak diizinkan:
- "Claude Code" atau "Claude Code Agent"
- Elemen visual atau ASCII art bermerek Claude Code yang meniru Claude Code
Produk Anda harus mempertahankan branding sendiri dan tidak boleh terlihat seperti Claude Code atau produk Anthropic apa pun. Untuk pertanyaan tentang kepatuhan branding, hubungi tim penjualan Anthropic.
Lisensi dan persyaratan
Penggunaan Claude Agent SDK diatur oleh Persyaratan Layanan Komersial Anthropic, termasuk ketika Anda menggunakannya untuk memberdayakan produk dan layanan yang Anda buat tersedia untuk pelanggan dan pengguna akhir Anda sendiri, kecuali sejauh komponen atau dependensi tertentu dicakup oleh lisensi berbeda seperti yang ditunjukkan dalam file LICENSE komponen tersebut.
Langkah berikutnya
Sumber daya ini mencakup detail teknis yang lebih mendalam dan proyek contoh untuk membangun dengan Agent SDK.
- Panduan Cepat: bangun agen pertama Anda yang menemukan dan memperbaiki bug
- Panduan migrasi: migrasi dari paket Claude Code SDK ke Agent SDK
- Loop agen: bagaimana Claude merencanakan, memanggil alat, dan memutuskan kapan tugas selesai
- Agen contoh: aplikasi demo untuk pengembangan lokal
- TypeScript SDK: referensi API TypeScript lengkap dan contoh
- Python SDK: referensi API Python lengkap dan contoh
- Desain harness agen: bagaimana tim Claude Code menggunakan alur kerja dinamis untuk mengorkestrasi banyak subagen sekaligus