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 masing-masing sesuai dengan kebutuhan yang berbeda. Gunakan tabel untuk menemukan yang cocok dengan apa yang Anda bangun.
| Jika Anda... | Gunakan | Mengapa |
|---|---|---|
| Membangun agen tanpa mengimplementasikan loop alat sendiri | Agent SDK | Sebuah library Python atau TypeScript yang menjalankan loop agen untuk Anda. |
| Melakukan pengembangan interaktif atau menjalankan tugas sekali jadi dari terminal | Claude Code CLI | Antarmuka terminal, dibangun untuk penggunaan interaktif sehari-hari. |
| Memanggil API secara langsung dan mengimplementasikan loop alat sendiri | Client SDK | Akses langsung ke API Anthropic daripada ke Claude Code. Anda mengimplementasikan loop alat sendiri. |
| Menjalankan agen jangka panjang atau asinkron tanpa mengelola infrastruktur sandbox atau sesi Anda sendiri | Managed Agents | REST API yang dihosting, produk terpisah dari Agent SDK. Anthropic menjalankan agen dan sandbox. |
SDK tersedia sebagai library untuk Python dan TypeScript saja. Untuk menjalankan loop agen yang sama dari bahasa lain, 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