SpyBara
Go Premium

agent-sdk/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 18 additions and 18 deletions.

2026
Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

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.

[!NOTE]

Kecuali telah disetujui sebelumnya, Anthropic tidak mengizinkan pengembang pihak ketiga untuk menawarkan login claude.ai atau batas laju untuk produk mereka, termasuk agen yang dibangun di Agent SDK Claude. Gunakan metode autentikasi kunci API yang dijelaskan dalam Quickstart sebagai gantinya.

Changelog

Lihat changelog lengkap untuk pembaruan SDK, perbaikan bug, dan fitur baru:

Melaporkan bug

Jika Anda mengalami bug atau masalah dengan Agent SDK:

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