Claude Agent SDK berbeda dari API LLM stateless tradisional karena mempertahankan status percakapan dan mengeksekusi perintah di lingkungan yang persisten. Panduan ini mencakup arsitektur, pertimbangan hosting, dan praktik terbaik untuk menerapkan agen berbasis SDK dalam produksi.

Persyaratan Hosting

Sandboxing Berbasis Container

Untuk keamanan dan isolasi, SDK harus berjalan di dalam lingkungan container yang tersandbox. Ini menyediakan:

• Isolasi proses - Lingkungan eksekusi terpisah per sesi
• Batas sumber daya - Batasan CPU, memori, dan penyimpanan
• Kontrol jaringan - Batasi koneksi keluar
• Sistem file ephemeral - Status bersih untuk setiap sesi

Persyaratan Sistem

Setiap instans SDK memerlukan:

• Dependensi runtime

  • Python 3.10+ (untuk Python SDK) atau Node.js 18+ (untuk TypeScript SDK)
  • Node.js (diperlukan oleh Claude Code CLI)
  • Claude Code CLI: npm install -g @anthropic-ai/claude-code

• Alokasi sumber daya

  • Direkomendasikan: 1GiB RAM, 5GiB disk, dan 1 CPU (sesuaikan ini berdasarkan tugas Anda sesuai kebutuhan)

• Akses jaringan

  • HTTPS keluar ke api.anthropic.com
  • Opsional: Akses ke server MCP atau alat eksternal

Memahami Arsitektur SDK

Tidak seperti panggilan API stateless, Claude Agent SDK beroperasi sebagai proses yang berjalan lama yang:

• Mengeksekusi perintah di lingkungan shell yang persisten
• Mengelola operasi file dalam direktori kerja
• Menangani eksekusi alat dengan konteks dari interaksi sebelumnya

Opsi Penyedia Sandbox

Beberapa penyedia mengkhususkan diri dalam lingkungan container aman untuk eksekusi kode AI:

• Cloudflare Sandboxes
• Modal Sandboxes
• Daytona
• E2B
• Fly Machines
• Vercel Sandbox

Pola Penerapan Produksi

Pola 1: Sesi Ephemeral

Buat container baru untuk setiap tugas pengguna, kemudian hancurkan saat selesai.

Terbaik untuk tugas sekali jadi, pengguna mungkin masih berinteraksi dengan AI saat tugas sedang diselesaikan, tetapi setelah selesai container akan dihancurkan.

Contoh:

• Investigasi & Perbaikan Bug: Debug dan selesaikan masalah tertentu dengan konteks yang relevan
• Pemrosesan Invoice: Ekstrak dan strukturkan data dari kwitansi/invoice untuk sistem akuntansi
• Tugas Terjemahan: Terjemahkan dokumen atau batch konten antar bahasa
• Pemrosesan Gambar/Video: Terapkan transformasi, optimasi, atau ekstrak metadata dari file media

Pola 2: Sesi Berjalan Lama

Pertahankan instans container persisten untuk tugas yang berjalan lama. Sering kali menjalankan beberapa proses Claude Agent di dalam container berdasarkan permintaan.

Terbaik untuk agen proaktif yang mengambil tindakan tanpa masukan pengguna, agen yang melayani konten atau agen yang memproses jumlah pesan yang tinggi.

Contoh:

• Email Agent: Memantau email masuk dan secara otonom melakukan triase, merespons, atau mengambil tindakan berdasarkan konten
• Site Builder: Menampilkan situs web khusus per pengguna dengan kemampuan pengeditan langsung yang disajikan melalui port container
• Chat Bot Frekuensi Tinggi: Menangani aliran pesan berkelanjutan dari platform seperti Slack di mana waktu respons cepat sangat penting

Pola 3: Sesi Hybrid

Container ephemeral yang dihidrasi dengan riwayat dan status, mungkin dari database atau dari fitur resumption sesi SDK.

Terbaik untuk container dengan interaksi intermiten dari pengguna yang memulai pekerjaan dan berhenti saat pekerjaan selesai tetapi dapat dilanjutkan.

Contoh:

• Personal Project Manager: Membantu mengelola proyek berkelanjutan dengan check-in intermiten, mempertahankan konteks tugas, keputusan, dan kemajuan
• Deep Research: Melakukan tugas penelitian multi-jam, menyimpan temuan dan melanjutkan investigasi saat pengguna kembali
• Customer Support Agent: Menangani tiket dukungan yang mencakup beberapa interaksi, memuat riwayat tiket dan konteks pelanggan

Pola 4: Container Tunggal

Jalankan beberapa proses Claude Agent SDK dalam satu container global.

Terbaik untuk agen yang harus berkolaborasi erat. Ini mungkin pola yang paling tidak populer karena Anda harus mencegah agen saling menimpa.

Contoh:

• Simulasi: Agen yang berinteraksi satu sama lain dalam simulasi seperti video game.

FAQ

Bagaimana cara saya berkomunikasi dengan sandbox saya?

Saat hosting di container, buka port untuk berkomunikasi dengan instans SDK Anda. Aplikasi Anda dapat membuka endpoint HTTP/WebSocket untuk klien eksternal sementara SDK berjalan secara internal dalam container.

Berapa biaya hosting container?

Kami telah menemukan bahwa biaya dominan untuk melayani agen adalah token, container bervariasi berdasarkan apa yang Anda sediakan tetapi biaya minimum kira-kira 5 sen per jam berjalan.

Kapan saya harus mematikan container idle vs. menjaganya tetap hangat?

Ini mungkin bergantung pada penyedia, penyedia sandbox yang berbeda akan membiarkan Anda menetapkan kriteria berbeda untuk timeout idle setelah itu sandbox mungkin berhenti. Anda akan ingin menyesuaikan timeout ini berdasarkan seberapa sering Anda pikir respons pengguna mungkin terjadi.

Seberapa sering saya harus memperbarui Claude Code CLI?

Claude Code CLI diberi versi dengan semver, jadi perubahan breaking apa pun akan diberi versi.

Bagaimana cara saya memantau kesehatan container dan kinerja agen?

Karena container hanya server, infrastruktur logging yang sama yang Anda gunakan untuk backend akan bekerja untuk container.

Berapa lama sesi agen dapat berjalan sebelum timeout?

Sesi agen tidak akan timeout, tetapi kami merekomendasikan menetapkan properti 'maxTurns' untuk mencegah Claude terjebak dalam loop.

Langkah Berikutnya

• Sessions Guide - Pelajari tentang manajemen sesi
• Permissions - Konfigurasi izin alat
• Cost Tracking - Pantau penggunaan API
• MCP Integration - Perluas dengan alat khusus