Ikhtisar
Bangun agen AI kustom dengan Claude Code SDK
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
Opsi SDK
Claude Code SDK tersedia dalam berbagai bentuk untuk menyesuaikan kasus penggunaan yang berbeda:
- Mode Headless - Untuk skrip CLI dan otomasi
- TypeScript SDK - Untuk aplikasi Node.js dan web
- Python SDK - Untuk aplikasi Python dan data science
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.
System Prompts
System prompts 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 mengizinkan tool tertentudisallowedTools
- Memblokir tool tertentupermissionMode
- Mengatur 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.
Kasus Penggunaan Umum
Pengujian Otomatis dan CI/CD
Buat agen yang menjalankan tes, menganalisis hasil, dan memperbaiki masalah secara otomatis dalam pipeline CI/CD Anda.
Review Kode dan Audit Keamanan
Bangun agen yang meninjau pull request untuk kerentanan keamanan, kualitas kode, dan kepatuhan.
Respons Insiden
Deploy agen SRE yang mendiagnosis masalah produksi, menganalisis log, dan menyarankan perbaikan.
Generasi Dokumentasi
Buat agen yang menghasilkan dan memelihara dokumentasi berdasarkan codebase Anda.
Analisis Data
Bangun agen yang menganalisis data, menghasilkan laporan, dan membuat visualisasi.
Praktik Terbaik
- Gunakan format output JSON untuk parsing programatik dari respons
- Tangani error dengan baik - periksa kode keluar dan implementasikan logika retry
- Gunakan manajemen sesi untuk mempertahankan konteks dalam percakapan multi-turn
- Implementasikan timeout untuk operasi yang berjalan lama
- Hormati batas rate saat membuat beberapa permintaan
- Uji secara menyeluruh sebelum deploy ke produksi
Sumber Daya Terkait
- Referensi CLI - Dokumentasi CLI lengkap
- Integrasi GitHub Actions - Otomatisasi workflow GitHub Anda
- Dokumentasi MCP - Perluas Claude dengan tool kustom
- Workflow Umum - Panduan langkah demi langkah
- Troubleshooting - Masalah umum dan solusi