Blog

Cara Menggunakan Claude Agent SDK dengan Paket Claude Anda

Ashley Innocent

Ashley Innocent

14 May 2026

Cara Menggunakan Claude Agent SDK dengan Paket Claude Anda

Apidog untuk Perusahaan

Penerapan On-Premises

SSO & RBAC

Sesuai SOC 2

Jelajahi Apidog Enterprise

Anthropic mengizinkan Anda menjalankan Claude Agent SDK pada langganan Claude Anda yang sudah ada mulai 15 Juni 2026. Sebelumnya, membangun apa pun dengan Agent SDK berarti memerlukan kunci API terpisah dengan penagihan pay-as-you-go terukur di atas apa pun yang sudah Anda bayar untuk Claude Pro atau Max. Mulai 15 Juni dan seterusnya, paket Claude bulanan Anda menyertakan saldo kredit khusus untuk penggunaan Agent SDK. Tidak diperlukan kunci API.

Jika Anda pernah ingin membangun agen kustom (bot penyebaran, asisten penelitian, alat triase) tetapi tidak ingin menempatkan kartu penagihan terpisah di Anthropic hanya untuk membuat prototipe, inilah perubahan yang penting. Langganan Pro Anda kini dilengkapi dengan $20/bulan penggunaan Agent SDK. Max 20x dilengkapi dengan $200. Paket Team Premium dilengkapi dengan $100.

tombol

Apa yang berubah pada 15 Juni 2026

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

Berikut adalah kredit berdasarkan paket, diambil langsung dari pengumuman Anthropic:

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

Beberapa aturan penting:

Apa yang dicakup kredit, dan apa yang tidak

Anthropic membagi ini dengan hati-hati. Bacalah dengan seksama; batas antara “dicakup” dan “tidak dicakup” adalah yang menentukan apakah tagihan Anda benar-benar berubah.

Dicakup oleh kredit Agent SDK:

Tidak dicakup (ini masih diambil dari paket Claude reguler Anda, atau tetap terpisah):

Dengan kata lain, kredit Agent SDK secara khusus ditujukan untuk beban kerja terprogram, otomatis, atau non-interaktif. Pekerjaan Claude Code normal Anda berada di batas penggunaan yang ada pada paket, yang Anthropic baru-baru ini dinaikkan sebesar 50% hingga 13 Juli. Dua anggaran terpisah, dua tujuan terpisah.

Ini adalah pilihan desain yang berarti. Ini berarti Anda dapat bereksperimen dengan agen kustom yang dibangun di atas SDK tanpa mengurangi anggaran yang Anda gunakan untuk pengkodean harian melalui Claude Code.

Saat kredit Anda habis

Kredit mencakup jumlah dolar tetap per bulan. Apa yang terjadi ketika Anda melebihi itu tergantung pada satu pengaturan:

Untuk pekerjaan prototipe, biarkan penggunaan tambahan dinonaktifkan. Anda akan mendapatkan sinyal berhenti yang jelas dan menghindari tagihan tak terduga. Untuk otomatisasi tingkat produksi yang perlu terus berjalan, aktifkanlah.

Kredit selalu digunakan terlebih dahulu. Anda tidak membayar tarif kelebihan sampai jatah bulanan Anda habis.

Cara ikut serta

Kredit tidak aktif secara default. Persetujuan adalah satu kali dan berlaku di seluruh siklus penagihan, tetapi Anda harus melakukannya sekali.

  1. Masuk ke akun Claude yang memiliki langganan (akun pengguna di Pro/Max, atau akun seat di Team/Enterprise).
  2. Kunjungi pengaturan paket Claude Agent SDK (ditautkan dari artikel dukungan resmi Anthropic).
  3. Klaim kredit. Setelah ini, kredit diperbarui secara otomatis setiap bulan.

Jika Anda memiliki beberapa seat pada paket Tim, setiap pengguna harus mengklaim secara independen. Admin tidak dapat mengklaim atas nama anggota seat.

Mengatur SDK di Python atau TypeScript

Agent SDK tersedia dalam Python dan TypeScript. Keduanya mengautentikasi dengan cara yang sama terhadap paket Anda: melalui Claude Code CLI daripada kunci API mentah.

Python

Instal:

pip install claude-agent-sdk

Autentikasi dengan masuk ke Claude Code terlebih dahulu:

claude login

Ini menyimpan kredensial yang terhubung dengan paket secara lokal. Python SDK akan mengambilnya secara otomatis; Anda tidak perlu mengatur ANTHROPIC_API_KEY untuk penggunaan berbasis paket.

Agen minimal terlihat seperti ini:

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)

Panggilan yang sama sebelumnya akan membutuhkan ANTHROPIC_API_KEY dan penagihan API terukur. Sekarang, panggilan tersebut menggunakan kredit paket Anda.

TypeScript

Instal:

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

Autentikasi melalui login Claude Code yang sama:

claude login

Agen minimal di TypeScript:

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 lingkungan di mana SDK tidak dapat menemukan kredensial Claude Code secara otomatis (CI runners, kontainer Docker, remote dev boxes), Anda dapat mengaturnya sebagai variabel lingkungan. Anthropic memublikasikan nama variabel yang tepat di dokumen Agent SDK.

Jika login Claude Code Anda menampilkan kesalahan konfigurasi bahkan sebelum Anda sampai ke pengaturan SDK, perbaikan konfigurasi enterprise custom3p yang tidak valid mencakup penyebab paling umum.

Alur kerja claude -p

Ada cara kedua untuk menggunakan kredit Agent SDK yang tidak melibatkan penulisan kode: perintah claude -p di Claude Code.

-p menempatkan Claude Code ke mode non-interaktif. Anda memberikannya prompt, itu dieksekusi terhadap repo Anda, dan keluar. Tidak ada sesi bolak-balik. Ini adalah cara Anda menskrip Claude Code ke dalam pipeline CI, cron jobs, dan Git hooks.

Contoh sederhana: sebuah pre-commit hook yang meminta Claude untuk menandai perubahan berisiko.

#!/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:\n\n$DIFF"

Setiap pemanggilan claude -p setelah 15 Juni akan menggunakan kredit Agent SDK Anda, bukan anggaran Claude Code interaktif Anda. Ini berarti Anda dapat mengintegrasikannya ke dalam alur kerja otomatis tanpa khawatir menghabiskan batas yang Anda butuhkan untuk pengkodean harian.

Ini sangat cocok dengan perintah /goal untuk loop otonom, dan dengan file konteks AGENTS.md untuk mengarahkan agen secara andal di setiap eksekusi.

Integrasi GitHub Actions

Integrasi Claude Code GitHub Actions adalah beban kerja ketiga yang dicakup oleh kredit SDK. Jika Anda telah menghubungkan Claude ke ulasan PR, triase masalah, atau pembuatan catatan rilis, eksekusi alur kerja tersebut kini akan ditagih terhadap kredit Agent SDK pada pengguna mana pun yang menginstal Aplikasi GitHub.

Ini berguna untuk proyek seperti Clawsweeper, bot triase GitHub yang dibangun di Claude Code, di mana otomatisasi berjalan secara konstan dan tagihan biasanya jatuh pada kunci API mana pun yang terpasang pada Aplikasi.

Membangun agen nyata: memasangkan SDK dengan Apidog

Nilai sebenarnya dari Agent SDK adalah untuk agen yang melakukan lebih dari sekadar merespons teks; agen yang memanggil API nyata, mengkueri basis data, menerapkan kode. Agar itu berfungsi dengan andal, agen membutuhkan kontrak yang ditentukan untuk setiap API eksternal yang diaksesnya. Tanpa itu, agen akan menebak bentuk permintaan dan Anda akan menghabiskan waktu debugging Anda untuk memperbaiki payload yang terhalusinasi.

Di sinilah Apidog cocok dengan alur kerja:

  1. Definisikan kontrak API terlebih dahulu di Apidog. Tentukan titik akhir, skema permintaan/respons, dan contoh payload. Ini menjadi sumber kebenaran.
  2. Ekspor OpenAPI dan berikan ke agen Anda sebagai konteks.
  3. Gunakan SDK untuk menghubungkan agen dengan titik akhir yang sebenarnya. Agen memanggil API Anda menggunakan skema yang diketahuinya benar.
  4. Validasi dengan Apidog CLI. Setiap eksekusi agen dapat memverifikasi bahwa API masih mengembalikan apa yang dijanjikan kontrak.

Untuk agen yang mengatur alat lain melalui server MCP, alur kerja pengujian server MCP dengan Apidog adalah panduan yang cocok. Anda mendapatkan cakupan pengujian end-to-end pada alat yang dipanggil agen Anda.

Gambaran yang lebih besar ada dalam panduan alur kerja API design-first: ketika agen memiliki kontrak untuk divalidasi, waktu Anda sebagai pengembang beralih ke penulisan kontrak dan batasan yang lebih baik, bukan mengejar bug skema JSON dalam output agen.

Unduh Apidog gratis jika Anda ingin lapisan kontrak mendukung proyek Agent SDK Anda.

Ketika Anda masih menginginkan kunci API terpisah

Kredit berbasis paket adalah default yang tepat untuk sebagian besar pembangun. Masih ada kasus di mana kunci API mandiri masuk akal:

Panduan akses API Claude gratis mencakup jalur penggunaan Claude yang tidak memerlukan paket Pro atau kunci API berbayar.

Daftar periksa yang jelas sebelum Anda memulai

FAQ

Apakah saya perlu menghapus ANTHROPIC_API_KEY lama saya agar kredit paket berfungsi? SDK menggunakan kredensial lokal Claude Code jika ada, yang berarti claude login sudah cukup untuk mengalihkan SDK ke penagihan berbasis paket. Jika Anda memiliki ANTHROPIC_API_KEY yang diatur di lingkungan Anda untuk alat lain, biarkan saja; SDK akan memilih autentikasi paket jika ada.

Apa yang dihitung sebagai satu “permintaan” terhadap kredit? Kredit dinyatakan dalam dolar, bukan permintaan. Setiap panggilan SDK ditagih dengan tarif yang sama yang dipublikasikan Anthropic untuk penggunaan API; saldo kredit Anda berkurang sejumlah biaya setiap panggilan model, termasuk penggunaan alat dan token konteks. Tidak ada biaya per permintaan tambahan di atas itu.

Bisakah saya membagikan kredit saya dengan rekan tim? Tidak. Kredit berlaku per pengguna dan tidak dapat dipindahtangankan. Setiap paket Tim atau Enterprise memiliki kumpulan kreditnya sendiri.

Apa yang terjadi dengan saldo konsol API Anthropic lama saya? Saldo itu tetap ada. Kredit paket adalah mekanisme penagihan terpisah. Jika Anda memiliki saldo prabayar di konsol API Anda, itu masih berfungsi untuk beban kerja kunci API apa pun.

Apakah Agent SDK sama dengan Claude Code? Tidak. Claude Code adalah ekstensi CLI dan IDE resmi yang dikirimkan Anthropic. Agent SDK adalah pustaka pemrograman (Python atau TypeScript) untuk membangun agen kustom. Kredit mencakup SDK ditambah perintah claude -p non-interaktif di Claude Code; Claude Code interaktif tetap pada penggunaan paket reguler Anda.

Akankah tagihan GitHub Actions saya berubah? Jika GitHub Actions Anda menggunakan integrasi resmi Claude Code GitHub Actions dan kredit diklaim pada akun pengguna penginstal, eksekusi tersebut kini akan menggunakan kredit SDK daripada penagihan kunci API.

Apakah kredit berfungsi di luar Agent SDK dan claude -p? Tidak untuk empat area yang dicakup (SDK di Python/TS, claude -p, GitHub Actions, aplikasi Agent SDK pihak ketiga). Penggunaan Claude lainnya akan kembali ke batas normal paket Anda atau kunci API Anda, tergantung dari mana permintaan berasal.

tombol

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.

Daftar gratisUnduh