Biaya, penagihan, dan operasional22 Oktober 2026Flatkey Team

API Key Anthropic (2026): Cara Mendapatkan, Jenis Kunci, Setup Claude Code, dan Solusi Error

Panduan langkah demi langkah API key Anthropic 2026: setup Console, kunci pribadi dan service account, aturan kedaluwarsa, request pertama, Claude Code, biaya, dan solusi error.

API Key Anthropic (2026): Cara Mendapatkan, Jenis Kunci, Setup Claude Code, dan Solusi Error

Untuk mendapatkan API key Anthropic, masuk ke Claude Console, buka API keys, klik Create key, pilih nama, masa berlaku, dan akun tertaut (Anda sendiri atau service account), lalu salin kunci yang diawali sk-ant- karena Console hanya menampilkannya sekali. Tambahkan metode pembayaran atau kredit sebelum memanggil API: penggunaan ditagih per token dan akun baru hanya mendapat sedikit kredit uji gratis, menurut halaman harga Anthropic per 22 Oktober 2026. Kunci yang sama berlaku untuk semua model Claude; tidak ada "API key Claude" atau "kunci Sonnet" terpisah.

Panduan ini ditujukan bagi developer yang membutuhkan kunci untuk skrip, coding agent seperti Claude Code, atau layanan produksi. Isinya mencakup jenis kunci 2026 (pribadi, service account, dan kunci workspace lama), aturan kedaluwarsa, header anthropic-workspace-id yang sering membuat request pertama gagal, kode yang bisa langsung dijalankan, error 401/400/429 yang umum, dan kapan satu kunci untuk banyak penyedia lebih masuk akal.

API key Anthropic dalam 60 detik

Langkah	Di mana	Yang perlu diketahui (dicek 22 Okt 2026)
1. Masuk	platform.claude.com	API key dikelola di Claude Console, bukan di aplikasi chat claude.ai
2. Buka API keys	Settings → API keys	Jika Create key berwarna abu-abu, peran Anda tidak boleh membuat kunci
3. Buat kunci	Nama, masa berlaku, akun tertaut, workspace opsional	Pilihan masa berlaku: 3 jam, 1 hari, 7 hari, 30 hari, kustom, atau Never
4. Salin sekali	Hanya tampil saat dibuat	Diawali `sk-ant-`; kunci yang hilang tidak bisa dilihat lagi
5. Atur penagihan	Settings → Billing	Bayar sesuai pemakaian dalam USD; tiap tier punya batas belanja bulanan
6. Uji	`POST https://api.anthropic.com/v1/messages`	Kirim kunci sebagai `Authorization: Bearer` (atau `x-api-key` versi lama)

Sumber: dokumentasi Anthropic Get your Claude API key dan Authentication, dicek 22 Oktober 2026.

Langkah demi langkah: buat API key Anthropic

Buat atau masuk ke akun Console di platform.claude.com. Langganan chat Claude dan API ditagih terpisah, meski paket Max menyertakan kredit API bulanan (detail di bawah dan di panduan harga API Anthropic kami).
Buka halaman API keys. Jika organisasi Anda punya beberapa workspace, Anda bisa memilih satu untuk membatasi kunci ke workspace itu.
Klik Create key dan isi tiga kolom: nama yang jelas (misalnya ci-staging-claude), masa berlaku, dan Linked account. Menautkan ke diri sendiri menghasilkan kunci pribadi; menautkan ke service account menghasilkan kunci untuk beban kerja bersama.
Segera salin kuncinya. Dokumentasi Anthropic menyebut kunci lengkap hanya ditampilkan sekali. Simpan di password manager atau secrets manager, jangan pernah di repositori Git.
Tambahkan kredit atau kartu di halaman Billing. Tanpa saldo, request pertama akan gagal walaupun kuncinya valid.
Ekspor sebagai variabel lingkungan agar SDK membacanya otomatis:

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Jenis kunci mana yang sebaiknya dipilih?

Pada 2026 Anthropic membedakan tiga jenis kunci. Salah memilih jenis adalah penyebab paling umum kunci "tiba-tiba tidak berfungsi" ketika ada anggota yang keluar dari tim.

Jenis kunci	Bertindak sebagai	Berhenti berfungsi ketika	Gunakan untuk
Kunci pribadi	Anda, dengan peran Anda	Anda keluar dari organisasi, atau kunci satu workspace kehilangan workspace tersebut	Pengembangan lokal, skrip pribadi, Claude Code milik Anda
Kunci service account	Sebuah service account	Service account diarsipkan atau dikeluarkan dari workspace	Pipeline CI, layanan produksi, agent bersama
Kunci workspace (lama)	Tidak ada (milik workspace)	Kedaluwarsa, dinonaktifkan/dihapus, atau workspace diarsipkan	Hanya integrasi yang sudah ada; sebaiknya migrasi

Data dari halaman Authentication Anthropic, 22 Oktober 2026. Anthropic merekomendasikan kunci pribadi atau service account karena terikat pada identitas dan tidak bisa bertahan lebih lama dari orang atau beban kerja pemiliknya. Untuk produksi di AWS, Google Cloud, Azure, GitHub Actions, atau Kubernetes, halaman yang sama merekomendasikan Workload Identity Federation, yang mengganti kunci statis dengan token berumur pendek.

Aturan kedaluwarsa yang perlu diketahui

Masa berlaku dipilih saat pembuatan dan tidak bisa diubah setelahnya.
Anthropic mengirim email ke pembuat 7 hari sebelum kedaluwarsa untuk kunci dengan masa berlaku minimal 14 hari, dan 1 hari sebelumnya untuk kunci minimal 7 hari; kunci yang lebih pendek kedaluwarsa tanpa pemberitahuan.
Setelah kedaluwarsa, request mengembalikan 401 authentication_error, dan kunci kedaluwarsa tidak bisa diaktifkan kembali, hanya dihapus.
Disable bisa dibatalkan; Delete bersifat permanen.

Pola praktis: gunakan kunci 30 hari untuk laptop dan coding agent, dan kunci service account yang disimpan di secrets manager (dengan rotasi) untuk server. Panduan kami tentang manajemen API key yang aman untuk produk AI dan rotasi kunci di balik gateway membahasnya lebih dalam.

Uji kunci Anda: request pertama dengan curl, Python, dan Node.js

ID model di bawah, claude-sonnet-5-5, adalah model Sonnet terbaru di ikhtisar model Anthropic per 22 Oktober 2026.

curl 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-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Uji seperti ini biayanya kurang dari satu sen: dengan harga resmi Sonnet 5.5 sebesar $2 per juta token input dan $10 per juta token output (harga Anthropic, 22 Oktober 2026), 30 token input dan 5 token output menghabiskan sekitar $0,0001.

Header workspace yang membuat request pertama gagal

Jika kunci Anda tidak dibatasi ke satu workspace, setiap request wajib menyertakan anthropic-workspace-id; jika tidak, API mengembalikan 400 invalid_request_error dengan pesan "This API key is not scoped to a workspace...". ID-nya ada di halaman Workspaces di Console. Perbaikannya di Python:

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Kunci yang dibuat untuk satu workspace bisa melewati header ini, itulah sebabnya Anthropic menyarankan membatasi kunci sejak dibuat (dokumentasi Authentication).

Gunakan API key Anthropic dengan Claude Code

Claude Code dapat diautentikasi dengan langganan claude.ai, login Console, penyedia cloud, atau API key. Menurut dokumentasi autentikasi Claude Code, dicek 22 Oktober 2026:

Jika ANTHROPIC_API_KEY sudah diatur, Claude Code akan menanyakan apakah kunci itu dipakai saat pertama dijalankan, dan melewati login browser setelah Anda setujui.
ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, dan pengaturan apiKeyHelper berlaku untuk CLI, ekstensi VS Code, Agent SDK, dan GitHub Actions, tetapi tidak untuk Claude Desktop atau sesi cloud.
apiKeyHelper menjalankan skrip yang mengembalikan kunci, berguna untuk mengambil kunci berumur pendek dari vault. Jika skrip gagal tiga kali, request akan gagal.
Pengguna Console kini bisa masuk tanpa membuat API key (Claude Code v2.1.242 atau lebih baru), yang menyimpan profil OAuth alih-alih kunci statis. Hapus ANTHROPIC_API_KEY sebelum melakukannya.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Jika Claude Code melaporkan error token atau login, lihat panduan error token autentikasi Claude Code. Untuk mengarahkan Claude Code ke router alih-alih langsung ke Anthropic, lihat setup router API untuk Claude Code.

Apakah API key Anthropic gratis?

Membuat kunci gratis, tetapi memakainya tidak. FAQ harga Anthropic menyebut pengguna baru menerima "sedikit kredit gratis untuk menguji API"; setelah itu setiap request ditagih per token. Ada satu pengecualian yang perlu diketahui: di claude.com/pricing, dicek 22 Oktober 2026, paket Max 5x ($100/bulan) menyertakan $100 per bulan dan Max 20x $200 per bulan kredit API untuk Claude Platform; Pro ($20/bulan jika ditagih bulanan) tidak menyertakannya. Harga daftar saat ini per juta token di halaman harga Anthropic, 22 Oktober 2026:

Model	ID model	Input	Output	Baca cache
Claude Fable 5.1	`claude-fable-5-1`	$10.00	$50.00	$0.25
Claude Opus 5.5	`claude-opus-5-5`	$4.00	$20.00	$0.20
Claude Sonnet 5.5	`claude-sonnet-5-5`	$2.00	$10.00	$0.10
Claude Haiku 5.5 (prompt hingga 100K)	`claude-haiku-5-5`	$0.10	$0.50	$0.01

Batch API memotong harga input dan output menjadi setengah, sedangkan inferensi khusus AS (inference_geo: "us") dikenai pengali 1,1x. Untuk menghitung biaya beban kerja, lihat panduan lengkap harga API Anthropic kami. Jika butuh model yang benar-benar gratis untuk prototipe, perbandingan API LLM gratis kami mencantumkan opsi beserta batas nyatanya.

Kunci disertai batas belanja dan rate limit

Tier penggunaan organisasi menentukan rate limit sekaligus batas belanja bulanan. Menurut halaman rate limit Anthropic, dicek 22 Oktober 2026, batasnya adalah $500 (Start), $1.000 (Build), dan $200.000 (Scale) per bulan; organisasi baru mungkin mulai di tier Evaluation yang lebih rendah. Saat batas tercapai, API mengembalikan HTTP 429 hingga 00:00 UTC tanggal 1 bulan berikutnya, kecuali Anda meminta tier lebih tinggi. Anda juga bisa menetapkan batas belanja sendiri yang lebih rendah di halaman Billing, kebiasaan yang baik untuk setiap kunci yang dipakai agent otonom.

Error umum API key Anthropic dan solusinya

Error	Kemungkinan penyebab	Solusi
`401 authentication_error`	Salah ketik, kunci dicabut, dinonaktifkan, atau kedaluwarsa	Buat kunci baru; kunci kedaluwarsa tidak bisa diaktifkan lagi
`400 invalid_request_error` yang menyebut workspace	Kunci tidak dibatasi workspace dan header tidak dikirim	Tambahkan `anthropic-workspace-id` atau buat kunci yang dibatasi workspace
`404 not_found_error` "Workspace ... not found"	ID workspace salah, atau identitas kunci tidak punya akses	Periksa ID di halaman Workspaces
`429` "reached your API usage limits"	Batas belanja bulanan tier tercapai	Minta kenaikan tier atau tunggu reset bulanan
`429` dengan `retry-after`	Melebihi request atau token per menit	Tunggu lalu coba lagi; lihat penjelasan rate limit LLM
`529 overloaded_error`	Kapasitas Anthropic, bukan kunci Anda	Coba lagi dengan backoff atau failover; lihat error API 529
Tombol Create key nonaktif	Peran Console Anda tidak boleh membuat kunci	Minta admin mengubah peran atau memberikan kunci service account

Sumber: dokumentasi Anthropic tentang Authentication, rate limit, dan error, dicek 22 Oktober 2026.

Jaga keamanan kunci

Jangan pernah menempelkan kunci di kode front-end, aplikasi seluler, atau notebook publik. Untuk aplikasi iOS dan macOS yang harus memanggil Claude langsung, Anthropic menyediakan App Attest yang menerbitkan token perangkat dengan masa berlaku 1 jam.
Gunakan satu kunci per lingkungan dan per agent agar Anda bisa mencabut satu tanpa merusak yang lain.
Tetapkan masa berlaku, meski panjang, supaya kunci yang bocor punya batas waktu.
Jalankan secret scanning di CI; panduan secret scanning API AI kami menunjukkan cara setup-nya.
Pantau penggunaan di Console dan tetapkan batas belanja di bawah batas tier Anda.

Kapan satu kunci untuk banyak model lebih sederhana

Kunci Anthropic hanya membuka akses ke Claude. Jika produk atau coding agent Anda juga memanggil GPT, Gemini, DeepSeek, Qwen, atau Kimi, Anda harus mengelola lima kunci, lima saldo, dan lima set batas. API terpadu seperti Flatkey menerbitkan satu kunci untuk semuanya. Pada 22 Oktober 2026, halaman model Flatkey mencantumkan Claude Sonnet 5.5 seharga $1,60 input / $8,00 output per juta token dan Claude Opus 5.5 seharga $3,20 / $16,00, dibandingkan harga daftar Anthropic $2 / $10 dan $4 / $20. Anthropic SDK bisa dipakai cukup dengan mengganti base URL, sesuai panduan Anthropic SDK dari Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Tetap gunakan kunci Anthropic langsung jika Anda membutuhkan fitur khusus Anthropic sejak hari peluncuran, Workload Identity Federation, kontrol residensi data, atau kontrak enterprise. Untuk perbandingan yang lebih luas, baca Flatkey vs akun langsung di penyedia dan satu API key untuk banyak model AI.

FAQ

Bagaimana cara mendapatkan API key Anthropic?

Masuk ke Claude Console di platform.claude.com, buka Settings → API keys, klik Create key, atur nama, masa berlaku, dan akun tertaut, lalu salin kunci sk-ant- yang hanya tampil sekali. Tambahkan kredit di halaman Billing sebelum mengirim request.

Apakah API key Anthropic gratis?

Membuat kunci gratis dan akun baru mendapat sedikit kredit uji, tetapi setelah itu penggunaan API ditagih per token. Per 22 Oktober 2026, tidak ada tier gratis permanen untuk Claude API.

Apakah API key Claude sama dengan API key Anthropic?

Ya. Dokumentasi Anthropic menyebut kunci Claude API juga disebut API key Anthropic. Satu kunci berlaku untuk semua model Claude yang bisa diakses organisasi Anda.

Di mana saya menemukan API key Anthropic yang sudah ada?

Di platform.claude.com/settings/keys Anda bisa melihat nama, petunjuk, dan masa berlaku setiap kunci, tetapi tidak rahasia lengkapnya. Jika hilang, buat kunci baru dan hapus yang lama.

Apakah langganan Claude Pro atau Max menyertakan kredit API?

Pro tidak. Paket Max mencantumkan kredit API bulanan di claude.com/pricing per 22 Oktober 2026 ($100/bulan di Max 5x, $200/bulan di Max 20x). Di luar kredit tersebut, penggunaan API melalui kunci Console ditagih per token, terpisah dari langganan chat.

Mengapa API key Anthropic saya mengembalikan 401?

Kunci salah ketik, dinonaktifkan, dihapus, atau kedaluwarsa. Kunci kedaluwarsa tidak bisa diaktifkan kembali; buat yang baru. Jika error menyebut workspace, itu sebenarnya error 400 karena header anthropic-workspace-id tidak dikirim.

Bagaimana cara memakai API key Anthropic di Claude Code?

Atur ANTHROPIC_API_KEY di shell, jalankan claude, dan setujui kunci saat diminta. Gunakan /status di dalam Claude Code untuk memastikan kredensial mana yang aktif.