Ikhtisar
Bangun agen AI kustom dengan Claude Code SDK
Opsi SDK
Claude Code SDK tersedia dalam berbagai bentuk untuk memenuhi berbagai kasus penggunaan:
- Mode Headless - Untuk skrip CLI dan otomatisasi
- TypeScript SDK - Untuk aplikasi Node.js dan web
- Python SDK - Untuk aplikasi Python dan data science
Mengapa menggunakan Claude Code SDK?
Dibangun di atas harness agen yang menggerakkan Claude Code, Claude Code SDK menyediakan semua blok bangunan yang Anda butuhkan untuk membangun agen yang siap produksi:
- Integrasi Claude yang dioptimalkan: Caching prompt otomatis dan optimisasi performa
- 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 monitoring
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 Anthropic dari Anthropic 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:
- Subagen: Luncurkan agen khusus yang disimpan sebagai file Markdown di
./.claude/agents/
- Hook: Jalankan perintah kustom yang dikonfigurasi di
./.claude/settings.json
yang merespons event tool - Perintah Slash: Gunakan perintah kustom yang didefinisikan sebagai file Markdown di
./.claude/commands/
- Memori (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.
Prompt Sistem
Prompt sistem mendefinisikan peran, keahlian, dan perilaku agen Anda. Di sinilah Anda menentukan jenis agen apa yang sedang Anda bangun.
Izin Tool
Kontrol tool mana yang dapat digunakan agen Anda dengan izin yang detail:
allowedTools
- Secara eksplisit izinkan tool tertentudisallowedTools
- Blokir tool tertentupermissionMode
- 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.
Sumber Daya Terkait
- Referensi CLI - Dokumentasi CLI lengkap
- Integrasi GitHub Actions - Otomatisasi alur kerja GitHub Anda
- Dokumentasi MCP - Perluas Claude dengan tool kustom
- Alur Kerja Umum - Panduan langkah demi langkah
- Pemecahan Masalah - Masalah umum dan solusi