Cara Menggunakan Claude Agent SDK dengan Paket Claude Anda

Anthropic mengizinkan Anda menjalankan Claude Agent SDK menggunakan langganan Claude yang sudah ada mulai 15 Juni 2026. Sebelumnya, membangun agen dengan Agent SDK memerlukan kunci API terpisah dan penagihan pay-as-you-go di luar biaya Claude Pro atau Max. Mulai tanggal tersebut, paket Claude bulanan menyertakan kredit khusus untuk penggunaan Agent SDK. Tidak perlu kunci API.

Coba Apidog hari ini

Jika Anda ingin membuat agen kustom seperti bot deployment, asisten riset, atau alat triase tanpa menambahkan metode penagihan API terpisah di Anthropic, perubahan ini penting. Paket Pro menyertakan kredit Agent SDK $20/bulan, Max 20x menyertakan $200, dan Team Premium menyertakan $100.

Apa yang berubah pada 15 Juni 2026

Intinya: penggunaan Agent SDK kini dapat diambil dari kredit bulanan yang terhubung ke paket Claude Anda. Sebelumnya, penggunaan ini ditagih melalui API Anthropic dengan saldo konsol terpisah.

Kredit berdasarkan paket:

Paket	Kredit Agent SDK Bulanan
Pro	$20
Max 5x	$100
Max 20x	$200
Team Standard (per seat)	$20
Team Premium (per seat)	$100
Enterprise (berbasis penggunaan)	$20
Enterprise Premium seat	$200

Aturan penting:

• Anggota Enterprise Standard tidak mendapatkan kredit. Mereka harus menggunakan kunci API atau meningkatkan ke paket Premium.
• Kredit berlaku per pengguna dan tidak dapat dipindahtangankan. Kredit Anda tidak dapat digabungkan dengan kredit rekan tim.
• Kredit tidak terpakai tidak diakumulasikan. Sisa kredit di akhir siklus penagihan akan di-reset.
• Persetujuan satu kali diperlukan. Kredit tidak aktif sampai Anda mengklaimnya sekali. Setelah itu, kredit diperbarui otomatis setiap bulan.
• Pengguna kunci API tidak menerima kredit ini. Jika Anda mengautentikasi melalui ANTHROPIC_API_KEY, Anda masih memakai model penagihan API lama.

Apa yang dicakup kredit Agent SDK

Baca batasannya dengan jelas. Kredit ini hanya berlaku untuk workload tertentu.

Dicakup oleh kredit Agent SDK:

• Panggilan Claude Agent SDK dari proyek Python atau TypeScript Anda
• Perintah claude -p di Claude Code untuk mode non-interaktif
• Integrasi Claude Code GitHub Actions
• Aplikasi pihak ketiga yang mengautentikasi menggunakan Agent SDK

Tidak dicakup:

• Sesi Claude Code interaktif
• Percakapan di aplikasi web atau mobile Claude
• Sesi Claude Cowork

Dengan kata lain, kredit Agent SDK ditujukan untuk workload terprogram, otomatis, dan non-interaktif. Penggunaan Claude Code harian tetap berada di batas penggunaan paket reguler Anda, yang Anthropic baru-baru ini naikkan sebesar 50% hingga 13 Juli.

Artinya, Anda bisa bereksperimen dengan agen kustom tanpa menghabiskan kuota yang dipakai untuk coding harian di Claude Code.

Saat kredit Anda habis

Kredit adalah batas dolar bulanan. Perilaku setelah kredit habis bergantung pada pengaturan penggunaan tambahan:

• Penggunaan tambahan aktif: kelebihan ditagih sebagai pay-as-you-go dengan tarif API standar ke metode pembayaran paket Anda.
• Penggunaan tambahan nonaktif: request berhenti sampai siklus penagihan berikutnya.

Rekomendasi praktis:

• Untuk prototipe: matikan penggunaan tambahan.
• Untuk otomatisasi produksi: aktifkan jika agen harus terus berjalan.

Kredit selalu digunakan terlebih dahulu. Anda baru membayar kelebihan setelah jatah bulanan habis.

Cara ikut serta

Kredit tidak aktif secara default. Anda harus mengklaimnya sekali.

1. Masuk ke akun Claude yang memiliki langganan.
2. Buka pengaturan paket Claude Agent SDK dari artikel dukungan resmi Anthropic.
3. Klaim kredit Agent SDK.
4. Setelah diklaim, kredit diperbarui otomatis setiap bulan.

Jika Anda memakai paket Team, setiap seat harus mengklaim kreditnya sendiri. Admin tidak dapat mengklaim atas nama anggota lain.

Setup Agent SDK di Python

Install package:

pip install claude-agent-sdk

Login ke Claude Code:

claude login

Login ini menyimpan kredensial lokal yang terhubung ke paket Claude Anda. Untuk penggunaan berbasis paket, Anda tidak perlu mengatur ANTHROPIC_API_KEY.

Contoh agen minimal:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run(
    "Review the diff in /tmp/patch.diff and flag concerns."
)

print(response.text)

Sebelumnya, pemanggilan seperti ini membutuhkan ANTHROPIC_API_KEY dan penagihan API terukur. Setelah kredit diklaim, panggilan SDK dapat menggunakan kredit paket Anda.

Setup Agent SDK di TypeScript

Install package:

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

Login ke Claude Code:

claude login

Contoh agen minimal:

import { Agent } from "@anthropic-ai/claude-agent-sdk";

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

Untuk environment seperti CI runner, Docker container, atau remote dev box, SDK mungkin tidak menemukan kredensial Claude Code secara otomatis. Gunakan variabel environment yang didokumentasikan di dokumen Agent SDK.

Jika claude login gagal karena konfigurasi enterprise, lihat panduan untuk memperbaiki konfigurasi enterprise custom3p yang tidak valid.

Menggunakan claude -p untuk workflow otomatis

Selain SDK, kredit juga berlaku untuk perintah claude -p.

Flag -p menjalankan Claude Code dalam mode non-interaktif. Anda mengirim prompt, Claude menjalankan instruksi terhadap repo, lalu proses selesai. Ini cocok untuk:

• CI pipeline
• cron job
• Git hook
• script audit otomatis
• workflow release

Contoh pre-commit hook untuk meninjau diff:

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:

$DIFF"

Setiap pemanggilan claude -p setelah 15 Juni menggunakan kredit Agent SDK, bukan kuota Claude Code interaktif.

Workflow ini juga cocok digabungkan dengan perintah /goal untuk loop otonom dan file konteks AGENTS.md agar agen mendapatkan instruksi yang konsisten.

Integrasi GitHub Actions

Integrasi Claude Code GitHub Actions juga termasuk workload yang dicakup kredit SDK.

Jika Anda memakai Claude untuk:

• review pull request
• triase issue
• pembuatan release notes
• automasi repo

maka eksekusi workflow tersebut akan ditagih ke kredit Agent SDK dari akun pengguna yang menginstal GitHub App.

Ini berguna untuk proyek seperti Clawsweeper, bot triase GitHub yang dibangun di Claude Code, di mana otomatisasi berjalan terus-menerus dan biasanya membutuhkan kunci API terpisah.

Membangun agen nyata dengan SDK dan Apidog

Agent SDK paling berguna ketika agen tidak hanya membalas teks, tetapi juga memanggil API, membaca data, atau menjalankan workflow nyata.

Masalahnya: agen perlu tahu kontrak API yang benar. Tanpa kontrak, agen bisa menebak bentuk request dan menghasilkan payload yang salah.

Di sinilah Apidog masuk ke workflow.

Langkah implementasi:

1. Definisikan kontrak API di Apidog.
   
   Buat endpoint, skema request/response, parameter, header, dan contoh payload.

2. Ekspor OpenAPI spec.
   
   Gunakan spec ini sebagai konteks untuk agen agar ia tidak menebak struktur request.

3. Hubungkan Agent SDK ke endpoint nyata.
   
   Agen dapat memanggil API berdasarkan skema yang sudah didefinisikan.

4. Validasi response API.
   
   Gunakan Apidog CLI untuk memastikan API masih memenuhi kontrak.

Contoh pola kerja:

Apidog API Contract
        ↓
OpenAPI Spec
        ↓
Claude Agent SDK
        ↓
API Request
        ↓
Apidog CLI Validation

Untuk agen yang memakai tool melalui server MCP, lihat workflow pengujian server MCP dengan Apidog. Anda bisa menguji tool yang dipanggil agen secara end-to-end.

Panduan yang lebih lengkap ada di alur kerja API design-first. Prinsipnya: semakin jelas kontrak API, semakin sedikit waktu yang habis untuk memperbaiki payload yang salah.

Anda juga dapat mengunduh Apidog gratis untuk menyiapkan lapisan kontrak API pada proyek Agent SDK.

Kapan masih perlu kunci API terpisah

Kredit berbasis paket cocok untuk banyak kasus, terutama prototipe dan automasi ringan. Namun, kunci API terpisah masih masuk akal jika:

• Agen produksi membutuhkan anggaran terpisah.
  
  Kredit paket memiliki batas dolar tetap. Untuk workload berskala besar, kunci API berbasis penggunaan bisa lebih mudah dikelola oleh tim finance dan ops.

• Butuh akses lintas organisasi.
  
  Kunci API tidak terikat ke satu pengguna seperti kredit paket.

• Anda memakai Enterprise Standard.
  
  Paket ini tidak menerima kredit Agent SDK. Jika butuh SDK, gunakan kunci API atau upgrade paket.

Panduan akses API Claude gratis membahas opsi penggunaan Claude yang tidak membutuhkan paket Pro atau kunci API berbayar.

Checklist sebelum mulai

Gunakan checklist ini sebelum menjalankan agen pertama Anda:

• [ ] Pastikan paket Anda memenuhi syarat: Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise berbasis penggunaan, atau Enterprise Premium seat.
• [ ] Klaim kredit Agent SDK satu kali.
• [ ] Tentukan apakah penggunaan tambahan perlu aktif.
• [ ] Jalankan claude login.
• [ ] Install SDK Python atau TypeScript.
• [ ] Jalankan agen minimal tanpa ANTHROPIC_API_KEY.
• [ ] Cek saldo kredit setelah beberapa eksekusi.
• [ ] Untuk workflow API, siapkan kontrak OpenAPI agar agen tidak menebak payload.
• [ ] Untuk CI/CD, uji claude -p di branch percobaan sebelum mengaktifkannya di pipeline utama.

FAQ

Apakah saya perlu menghapus ANTHROPIC_API_KEY lama?

Tidak selalu. SDK dapat memakai kredensial lokal dari claude login. Jika Anda masih memakai ANTHROPIC_API_KEY untuk tool lain, Anda bisa membiarkannya. Pastikan SDK menggunakan autentikasi paket jika tersedia.

Apa yang dihitung sebagai satu request terhadap kredit?

Kredit dinyatakan dalam dolar, bukan jumlah request. Setiap pemanggilan SDK mengurangi saldo berdasarkan tarif API Anthropic, termasuk token konteks dan penggunaan tool.

Bisakah kredit dibagikan dengan rekan tim?

Tidak. Kredit berlaku per pengguna dan tidak dapat dipindahtangankan. Pada paket Team atau Enterprise, setiap seat memiliki kreditnya sendiri.

Apa yang terjadi dengan saldo konsol API Anthropic lama?

Saldo itu tetap ada dan terpisah. Kredit paket digunakan untuk workload Agent SDK yang memenuhi syarat, sedangkan saldo API tetap berlaku untuk workload berbasis kunci API.

Apakah Agent SDK sama dengan Claude Code?

Tidak. Claude Code adalah CLI dan integrasi IDE resmi. Agent SDK adalah library Python/TypeScript untuk membangun agen kustom. Kredit mencakup Agent SDK, claude -p, GitHub Actions, dan aplikasi pihak ketiga yang memakai Agent SDK.

Apakah GitHub Actions saya otomatis memakai kredit?

Jika workflow memakai integrasi resmi Claude Code GitHub Actions dan kredit sudah diklaim oleh akun pengguna penginstal, eksekusi tersebut menggunakan kredit SDK.

Apakah kredit berlaku untuk semua penggunaan Claude?

Tidak. Kredit hanya berlaku untuk Agent SDK, claude -p, GitHub Actions, dan aplikasi pihak ketiga yang mengautentikasi lewat Agent SDK. Penggunaan Claude lainnya tetap mengikuti batas paket reguler atau penagihan kunci API.