Ringkasan Agent SDK

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

Bangun agen AI yang secara mandiri membaca file, menjalankan perintah, mencari web, mengedit kode, dan banyak lagi. Agent SDK memberi Anda alat yang sama, loop agen, dan manajemen konteks yang mendukung Claude Code, dapat diprogram dalam Python dan TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Agent SDK mencakup alat bawaan untuk membaca file, menjalankan perintah, dan mengedit kode, sehingga agen Anda dapat mulai bekerja segera tanpa Anda perlu mengimplementasikan eksekusi alat. Selami panduan cepat atau jelajahi agen nyata yang dibangun dengan SDK:

Panduan Cepat

Bangun agen perbaikan bug dalam hitungan menit

Agen contoh

Asisten email, agen penelitian, dan banyak lagi

Memulai

Siap untuk membangun? Ikuti Panduan Cepat untuk membuat agen yang menemukan dan memperbaiki bug dalam hitungan menit.

Kemampuan

Semua yang membuat Claude Code kuat tersedia di SDK:

Fitur Claude Code

SDK juga mendukung konfigurasi berbasis sistem file Claude Code. Untuk menggunakan fitur ini, atur setting_sources=["project"] (Python) atau settingSources: ['project'] (TypeScript) dalam opsi Anda.

Fitur	Deskripsi	Lokasi
Skills	Kemampuan khusus yang ditentukan dalam Markdown	`.claude/skills/SKILL.md`
Slash commands	Perintah khusus untuk tugas umum	`.claude/commands/*.md`
Memory	Konteks proyek dan instruksi	`CLAUDE.md` atau `.claude/CLAUDE.md`
Plugins	Perluas dengan perintah khusus, agen, dan server MCP	Programmatic via `plugins` option

Bandingkan Agent SDK dengan alat Claude lainnya

Platform Claude menawarkan berbagai cara untuk membangun dengan Claude. Berikut cara Agent SDK cocok:

Changelog

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

TypeScript SDK: lihat CHANGELOG.md
Python SDK: lihat CHANGELOG.md

Melaporkan bug

Jika Anda menemukan bug atau masalah dengan Agent SDK:

TypeScript SDK: laporkan masalah di GitHub
Python SDK: laporkan masalah di GitHub

Pedoman branding

Untuk mitra yang mengintegrasikan Claude Agent SDK, penggunaan branding Claude bersifat opsional. Saat mereferensikan Claude di produk Anda:

Diizinkan:

"Claude Agent" (lebih disukai untuk menu dropdown)
"Claude" (ketika sudah dalam menu berlabel "Agents")
"{YourAgentName} Powered by Claude" (jika Anda memiliki nama agen yang ada)

Tidak diizinkan:

"Claude Code" atau "Claude Code Agent"
Elemen visual atau ASCII art bermerek Claude Code yang meniru Claude Code

Produk Anda harus mempertahankan branding sendiri dan tidak boleh terlihat seperti Claude Code atau produk Anthropic apa pun. Untuk pertanyaan tentang kepatuhan branding, hubungi tim penjualan kami.

Lisensi dan persyaratan

Penggunaan Claude Agent SDK diatur oleh Persyaratan Layanan Komersial Anthropic, termasuk ketika Anda menggunakannya untuk memberdayakan produk dan layanan yang Anda buat tersedia untuk pelanggan dan pengguna akhir Anda sendiri, kecuali sejauh komponen atau dependensi tertentu dicakup oleh lisensi berbeda seperti yang ditunjukkan dalam file LICENSE komponen tersebut.

Langkah berikutnya

Panduan Cepat

Bangun agen yang menemukan dan memperbaiki bug dalam hitungan menit

Agen contoh

Asisten email, agen penelitian, dan banyak lagi

Instal SDK
Atur kunci API Anda
Dapatkan kunci API dari Konsol, kemudian atur sebagai variabel lingkungan:
export ANTHROPIC_API_KEY=your-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
- Microsoft Azure: atur variabel lingkungan CLAUDE_CODE_USE_FOUNDRY=1 dan konfigurasi kredensial Azure
Lihat panduan penyiapan untuk Bedrock, Vertex AI, atau Azure AI Foundry untuk detail.
Kecuali sebelumnya disetujui, Anthropic tidak mengizinkan pengembang pihak ketiga untuk menawarkan login claude.ai atau batasan tingkat untuk produk mereka, termasuk agen yang dibangun di Claude Agent SDK. Silakan gunakan metode autentikasi kunci API yang dijelaskan dalam dokumen ini.

Jalankan agen pertama Anda

Contoh ini membuat agen yang mencantumkan file di direktori saat ini menggunakan alat bawaan.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())