Claude Code SDK telah diubah nama menjadi Claude Agent SDK. Jika Anda bermigrasi dari SDK lama, lihat Panduan Migrasi.

​
Instalasi

npm install @anthropic-ai/claude-agent-sdk

​
Opsi SDK

Claude Agent SDK tersedia dalam berbagai bentuk untuk memenuhi berbagai kasus penggunaan:

​
Mengapa menggunakan Claude Agent SDK?

Dibangun di atas harness agen yang mendukung Claude Code, Claude Agent SDK menyediakan semua blok bangunan yang Anda butuhkan untuk membangun agen yang siap produksi. Memanfaatkan pekerjaan yang telah kami lakukan pada Claude Code termasuk:
  • Manajemen Konteks: Pemadatan otomatis dan manajemen konteks untuk memastikan agen Anda tidak kehabisan konteks.
  • Ekosistem alat yang kaya: Operasi file, eksekusi kode, pencarian web, dan ekstensibilitas MCP
  • Izin lanjutan: Kontrol terperinci atas kemampuan agen
  • Esensi produksi: Penanganan kesalahan bawaan, manajemen sesi, dan pemantauan
  • Integrasi Claude yang dioptimalkan: Caching prompt otomatis dan optimasi kinerja

​
Apa yang dapat Anda bangun dengan SDK?

Berikut adalah beberapa jenis agen contoh yang dapat Anda buat: Agen pengkodean:
  • Agen SRE yang mendiagnosis dan memperbaiki masalah produksi
  • Bot tinjauan keamanan yang mengaudit kode untuk kerentanan
  • Asisten teknik oncall yang melakukan triase insiden
  • Agen tinjauan kode yang menerapkan gaya dan praktik terbaik
Agen bisnis:
  • Asisten hukum yang meninjau kontrak dan kepatuhan
  • Penasihat keuangan yang menganalisis laporan dan prakiraan
  • Agen dukungan pelanggan yang menyelesaikan masalah teknis
  • Asisten pembuatan konten untuk tim pemasaran

​
Konsep Inti

​
Autentikasi

Untuk autentikasi dasar, ambil kunci API Claude dari Konsol Claude dan atur variabel lingkungan ANTHROPIC_API_KEY. SDK juga mendukung autentikasi melalui penyedia API pihak ketiga:
  • Amazon Bedrock: Atur variabel lingkungan CLAUDE_CODE_USE_BEDROCK=1 dan konfigurasikan kredensial AWS
  • Google Vertex AI: Atur variabel lingkungan CLAUDE_CODE_USE_VERTEX=1 dan konfigurasikan kredensial Google Cloud
Untuk instruksi konfigurasi terperinci untuk penyedia pihak ketiga, lihat dokumentasi Amazon Bedrock dan Google Vertex AI.
Kecuali telah disetujui sebelumnya, kami tidak mengizinkan pengembang pihak ketiga untuk menerapkan batas laju Claude.ai untuk produk mereka, termasuk agen yang dibangun di Claude Agent SDK. Silakan gunakan metode autentikasi kunci API yang dijelaskan dalam dokumen ini.

​
Dukungan Fitur Claude Code Lengkap

SDK menyediakan akses ke semua fitur default yang tersedia di Claude Code, memanfaatkan konfigurasi berbasis sistem file yang sama:
  • Subagen: Luncurkan agen khusus yang disimpan sebagai file Markdown di ./.claude/agents/
  • Keterampilan Agen: Perluas Claude dengan kemampuan khusus yang disimpan sebagai file SKILL.md di ./.claude/skills/
  • Hook: Jalankan perintah kustom yang dikonfigurasi di ./.claude/settings.json yang merespons peristiwa alat
  • Perintah Slash: Gunakan perintah kustom yang didefinisikan sebagai file Markdown di ./.claude/commands/
  • Plugin: Muat plugin kustom secara terprogram menggunakan opsi plugins untuk memperluas Claude Code dengan perintah kustom, agen, keterampilan, hook, dan server MCP. Lihat Plugin untuk detail.
  • Memori (CLAUDE.md): Pertahankan konteks proyek melalui file CLAUDE.md atau .claude/CLAUDE.md di direktori proyek Anda, atau ~/.claude/CLAUDE.md untuk instruksi tingkat pengguna. Untuk memuat file ini, Anda harus secara eksplisit menetapkan settingSources: ['project'] (TypeScript) atau setting_sources=["project"] (Python) dalam opsi Anda. Lihat Memodifikasi prompt sistem untuk detail.
Fitur-fitur ini bekerja identik dengan rekan Claude Code mereka dengan membaca dari lokasi sistem file yang sama.

​
Prompt Sistem

Prompt sistem menentukan peran, keahlian, dan perilaku agen Anda. Di sinilah Anda menentukan jenis agen apa yang Anda bangun.

​
Izin Alat

Kontrol alat mana yang dapat digunakan agen Anda dengan izin terperinci:
  • allowedTools - Izinkan secara eksplisit alat tertentu
  • disallowedTools - Blokir alat tertentu
  • permissionMode - Atur strategi izin keseluruhan

​
Model Context Protocol (MCP)

Perluas agen Anda dengan alat dan integrasi kustom melalui server MCP. Ini memungkinkan Anda untuk terhubung ke database, API, dan layanan eksternal lainnya.

​
Melaporkan Bug

Jika Anda menemukan bug atau masalah dengan Agent SDK:

​
Changelog

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

​
Sumber Daya Terkait