Panggilan pertama Claude API: pisahkan kunci, workspace, dan batas biaya sejak awal

Untuk membuat panggilan pertama Claude API, siapkan akun Claude Console dan kunci API, simpan kunci sebagai variabel lingkungan, lalu kirim permintaan Messages dengan autentikasi yang benar. Panduan awal Claude menunjukkan prasyarat tersebut dan contoh permintaan yang dapat diikuti.

Sebelum kunci dipakai bersama oleh aplikasi tim, tentukan workspace untuk percobaan dan batas pengeluarannya. Pemisahan ini membuat akses dan biaya percobaan dapat dikelola terpisah dari produksi. Contoh di bawah memakai Claude API langsung; jalur melalui penyedia cloud menggunakan kredensial dan pengaturan platform masing-masing.

Siapkan kunci, workspace, dan batas biaya

Buat workspace tambahan untuk percobaan bila tim perlu memisahkan akses atau pengeluaran dari produksi. Dokumentasi Workspaces menjelaskan bahwa kunci dapat dibatasi ke satu workspace dan batas pengeluaran bulanan dapat dipasang pada workspace tambahan, tetapi tidak pada Default Workspace. Admin organisasi perlu membuat workspace dan menambahkan anggota yang memerlukannya.

Buat kunci untuk workspace yang dipilih, lalu simpan di mesin pengembangan dengan perintah export ANTHROPIC_API_KEY="kunci-Anda". Ganti nilai contoh dengan kunci asli. Jangan masukkan kunci ke kode sumber, riwayat Git, atau kode yang dikirim ke peramban; pada layanan yang diterapkan, gunakan pengelola rahasia milik tim dan batasi siapa yang dapat membacanya.

Di pengaturan workspace, tetapkan batas pengeluaran bulanan yang sesuai dengan anggaran percobaan dan periksa batas organisasi. Batas workspace tidak dapat melebihi batas organisasi; jika tidak diatur, batasnya mengikuti organisasi. Batas ini berbeda dari max_tokens dalam sebuah permintaan: parameter tersebut membatasi panjang keluaran respons, sedangkan batas pengeluaran berlaku pada pemakaian workspace selama sebulan.

Kirim permintaan Messages dengan cURL

Ikhtisar API Claude menetapkan endpoint POST /v1/messages serta header versi API dan tipe konten JSON. Untuk autentikasi, contoh ini memakai Authorization: Bearer berisi kunci API; x-api-key masih didukung sebagai alternatif. SDK resmi mengirim header autentikasi, versi, dan tipe konten secara otomatis, tetapi cURL memerlukannya secara eksplisit.

Setelah variabel lingkungan terisi, jalankan perintah berikut sebagai satu baris. Prompt dan max_tokens di sini adalah contoh untuk percobaan singkat; model claude-opus-5-5 mengikuti contoh dalam panduan awal.

cURL: curl -i https://api.anthropic.com/v1/messages -H "Authorization: Bearer $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model":"claude-opus-5-5","max_tokens":128,"messages":[{"role":"user","content":"Jelaskan API dalam satu kalimat."}]}'

Opsi -i menampilkan header bersama isi respons. Pada respons yang berhasil, jawaban berada dalam blok content; catat pula header request-id untuk menelusuri permintaan tertentu. Header anthropic-workspace-id menunjukkan workspace yang menerima pemakaian tersebut, sehingga Anda dapat mencocokkannya dengan workspace yang dipilih sebelum meneruskan percobaan.

Jika kunci memiliki akses ke beberapa workspace, tambahkan -H "anthropic-workspace-id: ID_WORKSPACE" pada perintah cURL. Ganti penanda itu dengan ID workspace dari Console, bukan nama tampilannya. Kunci yang dibatasi ke satu workspace tidak memerlukan header pemilihan untuk contoh dasar; bila header tetap dikirim, ID-nya harus sesuai dengan workspace kunci tersebut.

Jalankan contoh Python dan TypeScript

Untuk Python, pasang SDK resmi dengan pip install anthropic. Contoh berikut memakai kunci dari ANTHROPIC_API_KEY dan mencetak blok respons serta ID permintaan. Jalankan dari lingkungan Python tempat paket telah terpasang.

Python: python -c 'import anthropic; m = anthropic.Anthropic().messages.create(model="claude-opus-5-5", max_tokens=128, messages=[{"role":"user","content":"Jelaskan API dalam satu kalimat."}]); print(m.content); print(m._request_id)'

Untuk proyek TypeScript, pasang npm install @anthropic-ai/sdk. Simpan pernyataan berikut dalam modul yang mendukung import dan await, lalu jalankan dengan konfigurasi TypeScript proyek. Kunci tetap dibaca dari lingkungan, sehingga tidak perlu ditulis di dalam berkas.

TypeScript: import Anthropic from "@anthropic-ai/sdk"; const m = await new Anthropic().messages.create({ model: "claude-opus-5-5", max_tokens: 128, messages: [{ role: "user", content: "Jelaskan API dalam satu kalimat." }] }); console.log(m.content, m._request_id);

Kedua contoh mencetak content sebagai kumpulan blok, bukan menganggap seluruh respons sebagai satu string. Jika aplikasi hanya membutuhkan teks, pilih blok berjenis text. Properti _request_id pada respons Python dan TypeScript memudahkan pencatatan ID yang sama tanpa membaca header secara manual.

SDK tidak memilihkan workspace untuk kunci yang dapat mengakses beberapa workspace. Dalam keadaan itu, teruskan anthropic-workspace-id melalui opsi header permintaan SDK sesuai ID yang digunakan tim. Periksa ID workspace pada respons mentah bila pencatatan biaya harus memastikan permintaan benar-benar masuk ke lingkungan yang dimaksud.

Catat permintaan dan atur percobaan ulang

Untuk log aplikasi, simpan waktu, model, status, request-id, dan workspace yang dipakai, tetapi jangan simpan nilai kunci API. ID permintaan membantu menelusuri panggilan tertentu saat terjadi kesalahan. Respons yang gagal sebelum autentikasi selesai dapat tidak memiliki header workspace; ketiadaan header itu sendiri tidak membuktikan bahwa permintaan masuk ke Default Workspace.

SDK resmi menyediakan penanganan kesalahan, percobaan ulang, streaming, dan pengaturan batas waktu. Karena SDK sudah dapat mencoba ulang kesalahan tertentu, hitung percobaan ulang bawaan saat merancang kebijakan retry aplikasi. Untuk kegagalan autentikasi, periksa kunci dan akses workspace terlebih dahulu; untuk pembatasan laju atau gangguan sementara, simpan status dan ID permintaan sebelum memutuskan kapan mencoba lagi.

Pilih jalur akses dan periksa kesiapan tim

Contoh di atas menggunakan Claude API langsung dengan penagihan melalui Anthropic. Claude juga dapat diakses melalui Amazon Bedrock, Google Cloud, Claude Platform on AWS, dan Microsoft Foundry. Jika aplikasi memakai salah satu jalur cloud tersebut, ikuti pengaturan identitas, kredensial, dan header platform yang dipilih; contoh kunci untuk akses langsung tidak dapat diasumsikan berlaku tanpa perubahan.

Sebelum panggilan percobaan menjadi bagian dari trafik aplikasi, periksa konfigurasi berikut:

• Kunci disimpan sebagai rahasia, memiliki pemilik yang jelas, dan tidak dikirim ke peramban.
• Workspace percobaan dipisahkan dari produksi bila akses atau biaya perlu dilacak tersendiri; batas pengeluaran workspace dan organisasi sudah diperiksa.
• Permintaan menggunakan model, max_tokens, autentikasi, dan versi API yang sesuai dengan jalur akses.
• Log mencatat request-id, workspace, dan status tanpa mencatat kunci; kebijakan retry memperhitungkan perilaku SDK.

Sesudah respons pertama berhasil, cocokkan ID workspace pada respons dengan lingkungan yang direncanakan dan amati pemakaiannya di Console. Pemeriksaan itu menghubungkan hasil percobaan dengan akses dan biaya yang memang ingin dikelola tim.

Baca juga:

• Agents API membuka orkestrasi Codex—sandbox tetap pilihan pengembang
• Views YouTube naik sejak frame pertama—penghasilan tetap memakai engaged views
• beehiiv atau Substack: biaya 10% mengubah pilihan saat newsletter tumbuh