Claude Code SDK telah diubah namanya 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 kasus penggunaan yang berbeda:

​
Mengapa menggunakan Claude Agent SDK?

Dibangun di atas agent harness yang menggerakkan 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: Kompaksi otomatis dan manajemen konteks untuk memastikan agen Anda tidak kehabisan konteks.
  • Ekosistem tool yang kaya: Operasi file, eksekusi kode, pencarian web, dan ekstensibilitas MCP
  • Izin lanjutan: Kontrol yang detail atas kemampuan agen
  • Esensi produksi: Penanganan error bawaan, manajemen sesi, dan pemantauan
  • Integrasi Claude yang dioptimalkan: Caching prompt otomatis dan optimasi performa

​
Apa yang bisa Anda bangun dengan SDK?

Berikut adalah beberapa contoh jenis agen yang dapat Anda buat: Agen coding:
  • Agen SRE yang mendiagnosis dan memperbaiki masalah produksi
  • Bot review keamanan yang mengaudit kode untuk kerentanan
  • Asisten engineering oncall yang melakukan triase insiden
  • Agen review kode yang menegakkan 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 Claude Console 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 konfigurasi kredensial AWS
  • Google Vertex AI: Atur variabel lingkungan CLAUDE_CODE_USE_VERTEX=1 dan konfigurasi kredensial Google Cloud
Untuk instruksi konfigurasi detail untuk penyedia pihak ketiga, lihat dokumentasi Amazon Bedrock dan Google Vertex AI.

​
Dukungan Fitur Claude Code Lengkap

SDK menyediakan akses ke semua fitur default yang tersedia di Claude Code, memanfaatkan konfigurasi berbasis sistem file yang sama:
  • Subagents: Luncurkan agen khusus yang disimpan sebagai file Markdown di ./.claude/agents/
  • Hooks: Jalankan perintah kustom yang dikonfigurasi di ./.claude/settings.json yang merespons event tool
  • Slash Commands: Gunakan perintah kustom yang didefinisikan sebagai file Markdown di ./.claude/commands/
  • Memory (CLAUDE.md): Pertahankan konteks proyek melalui file CLAUDE.md yang menyediakan instruksi dan konteks persisten
Fitur-fitur ini bekerja identik dengan rekan Claude Code mereka dengan membaca dari lokasi sistem file yang sama.

​
System Prompts

System prompts mendefinisikan peran, keahlian, dan perilaku agen Anda. Di sinilah Anda menentukan jenis agen apa yang Anda bangun.

​
Tool Permissions

Kontrol tool mana yang dapat digunakan agen Anda dengan izin yang detail:
  • allowedTools - Secara eksplisit izinkan tool tertentu
  • disallowedTools - Blokir tool tertentu
  • permissionMode - Atur strategi izin keseluruhan

​
Model Context Protocol (MCP)

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

​
Melaporkan Bug

Jika Anda mengalami bug atau masalah dengan Agent SDK:

​
Sumber Daya Terkait