Ikhtisar Agent SDK

Instalasi

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

pip install claude-agent-sdk

Opsi SDK

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

• TypeScript SDK - Untuk aplikasi Node.js dan web
• Python SDK - Untuk aplikasi Python dan sains data
• Mode Streaming vs Mode Tunggal - Memahami mode input dan praktik terbaik

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.

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:

• TypeScript SDK: Laporkan masalah di GitHub
• Python SDK: Laporkan masalah di GitHub

Changelog

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

• TypeScript SDK: Lihat CHANGELOG.md
• Python SDK: Lihat CHANGELOG.md

Sumber Daya Terkait

• Referensi CLI - Dokumentasi CLI lengkap
• Integrasi GitHub Actions - Otomatisasi alur kerja GitHub Anda
• Dokumentasi MCP - Perluas Claude dengan alat kustom
• Alur Kerja Umum - Panduan langkah demi langkah
• Pemecahan Masalah - Masalah umum dan solusi