SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Diperbarui 2026-11-18

Autentikasi Claude API: Key, Bedrock, Vertex, Foundry

Pelajari autentikasi client Claude API di VPS dengan API key Anthropic, AWS IAM, Google ADC, atau Microsoft Entra, serta cara menyimpan kredensial server dengan aman.

Rute autentikasi Claude API

Autentikasi Claude API ditentukan oleh satu keputusan: kredensial mana yang dikirim client melalui jaringan. Anthropic mencantumkan Claude API langsung serta lima platform cloud: Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (dikelola Google), Claude Models on Google Cloud (dikelola Anthropic), dan Microsoft Foundry. Anthropic API langsung menerima API key atau token berumur pendek dalam header Authorization: Bearer, dan masih menerima API key dalam header lama x-api-key. Amazon Bedrock mendukung penandatanganan permintaan AWS dan API key Bedrock; dalam konfigurasi tersebut, tidak ada key Anthropic yang digunakan. Google Cloud mengirim token akses Google berumur pendek. Microsoft Foundry menerima key yang diterbitkan Azure atau token Microsoft Entra. Keempat bagian di bawah membahas konfigurasi kredensial ini, dengan penjelasan tentang penawaran AWS dan Google Cloud yang dikelola Anthropic bersama layanan cloud terkait.

Panduan ini menjelaskan cara menghubungkan SDK (software development kit) ke service yang berjalan pada server Linux. Jika Anda mengonfigurasi alat command line Claude Code, variabel dan alurnya berbeda: lihat mengarahkan Claude Code ke Bedrock atau Vertex. Jika service belum tersedia, buat terlebih dahulu dengan aplikasi Claude API pertama pada VPS, lalu kembali ke sini untuk mengonfigurasi kredensial.

Semua informasi di bawah ini diperiksa berdasarkan dokumentasi platform Anthropic pada August 2026 dan diperiksa ulang berdasarkan dokumentasi masing-masing provider pada 16 October 2026; detail akses model Bedrock diperiksa ulang berdasarkan dokumentasi AWS pada 19 October 2026. Halaman Anthropic untuk keempat rute, API key, dan versi API diperiksa ulang pada 27 October 2026. Halaman Anthropic untuk Microsoft Foundry, kedua endpoint Bedrock, rute yang dikelola Google, Claude Platform on AWS, autentikasi, Workload Identity Federation, dan versi API diperiksa ulang pada 10 November 2026, bersama changelog SDK Ruby. Identifier model, harga, versi SDK, dan bentuk endpoint dapat berubah, sehingga panduan ini menautkan halaman provider terkait alih-alih mencetak nilai yang dapat menjadi usang.

Rute 1: API key Anthropic

Ini adalah jalur langsung dan satu-satunya jalur yang menerbitkan secret oleh Anthropic. Request dikirim ke endpoint Messages pada host API Anthropic, dan setiap request membawa tiga header.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

Ganti MODEL_ID dengan identifier yang masih berlaku dari ringkasan model Anthropic. Response yang valid berupa JSON yang berisi array content dan object usage. Key yang salah atau sudah kedaluwarsa mengembalikan HTTP 401 dengan authentication_error. Header anthropic-version yang tidak ada menyebabkan kegagalan terpisah karena header tersebut wajib ada pada setiap request; SDK mengaturnya secara otomatis. Per Oktober 2026, dokumentasi Anthropic menyebut Authorization: Bearer sebagai cara utama untuk mengirim key dan menyebut x-api-key sebagai legacy, tetapi keduanya masih diterima sehingga command di atas tetap berfungsi. Versi mayor SDK saat ini juga mengirim key sebagai Authorization: Bearer, sehingga proxy atau gateway yang membaca X-Api-Key perlu diubah saat Anda melakukan upgrade. Versi 2023-06-01 pada command masih diterima; versi API terbaru Anthropic adalah 2026-10-21, yang dikirim secara default oleh versi SDK tersebut dan menolak beberapa parameter request lama, seperti temperature.

Pembuatan client adalah yang paling singkat di antara setup ini karena tidak ada yang perlu dibuat. Setiap SDK resmi membaca ANTHROPIC_API_KEY dari environment secara otomatis.

import os
from anthropic import Anthropic

client = Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)

Menyimpan identifier model di environment bersama key merupakan langkah yang baik. Nama model berubah sesuai jadwal yang tidak dapat Anda kendalikan, dan melakukan redeploy code hanya untuk mengubah satu string merupakan pekerjaan yang dapat dihindari.

Key dibuat di Console. Saat membuatnya, Anda memilih masa berlaku: preset 3 jam, 1 hari, 7 hari, atau 30 hari, durasi kustom, atau Never, sesuai kebijakan maksimum masa berlaku organisasi Anda. Masa berlaku ditetapkan saat pembuatan dan tidak dapat diubah setelahnya. Anthropic mengirim email kepada pembuat key sebelum key dengan masa berlaku panjang kedaluwarsa, tetapi key dengan masa berlaku pendek akan kedaluwarsa tanpa email peringatan. Key yang kedaluwarsa mengembalikan 401 dan tidak dapat diaktifkan kembali, sehingga solusinya selalu membuat key baru.

Tidak ada region yang perlu dipilih pada API langsung, dan tagihan langsung dibebankan ke organisasi Anthropic Anda. Workspace membatasi cakupan key ke satu project. Ini adalah cara paling jelas untuk mengetahui pengeluaran satu service. Saat membuat key server, batasi cakupannya ke workspace: key akun personal atau service account yang tidak dibatasi ke workspace harus mengirim header anthropic-workspace-id pada setiap request, atau API mengembalikan 400 dengan invalid_request_error. Untuk service, pilih key service account karena key personal berhenti berfungsi ketika orang yang membuatnya keluar dari organisasi. Untuk perhitungan di balik tagihan tersebut, lihat perbandingan harga API per token dengan subscription.

Ada satu opsi lain yang relevan karena sepenuhnya menghilangkan secret statis. Workload Identity Federation memungkinkan workload menukar token OpenID Connect (OIDC) dari identity provider yang sudah Anda percaya dengan token Anthropic berumur pendek pada POST /v1/oauth/token, dan SDK memperbarui token tersebut sebelum kedaluwarsa. Tidak ada string sk-ant-api... yang pernah dibuat atau disalin di mana pun. Opsi ini cocok untuk Kubernetes, GitHub Actions, dan VM cloud yang sudah memiliki identity platform. VPS biasa umumnya tidak memiliki issuer seperti itu. Karena itu, pada server tersebut, API key dalam file adalah pilihan yang realistis, dan panduan ini membahasnya dengan pendekatan tersebut.

Rute 2: kredensial AWS di Amazon Bedrock

Di Bedrock, Anda sama sekali tidak menyimpan kunci Anthropic. Dengan kredensial AWS, SDK menandatangani setiap permintaan HTTP menggunakan AWS Signature Version 4 (SigV4), lalu AWS menentukan apakah pemanggil tersebut diizinkan untuk memanggil model.

pip install -U "anthropic[bedrock]"
aws sts get-caller-identity

aws sts get-caller-identity menampilkan nomor akun dan ARN (Amazon Resource Name) dari identitas yang terkait dengan kredensial Anda. Jalankan perintah ini sebelum melakukan hal lain saat menggunakan SigV4. Untuk SigV4, SDK mencari kredensial konstruktor, kredensial lingkungan, dan rantai kredensial AWS standar; pemilihan region dilakukan secara terpisah. Pada client AnthropicBedrock Python, API key Bedrock yang diberikan melalui api_key atau AWS_BEARER_TOKEN_BEDROCK akan memicu ValueError jika Anda juga memberikan aws_access_key, aws_secret_key, aws_session_token, atau aws_profile. Tanpa argumen eksplisit tersebut, key memilih autentikasi bearer, bukan rantai kredensial AWS. Client TypeScript memprioritaskan API key Bedrock dibandingkan kredensial AWS eksplisit. Perintah STS tidak menguji autentikasi bearer.

Perubahan pada pembuatan client hanya menyangkut class dan satu argumen.

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-east-1")

AnthropicBedrock menangani integrasi Bedrock InvokeModel. Per Oktober 2026, Anthropic juga mendokumentasikan Claude di Amazon Bedrock, yaitu endpoint Messages API pada https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages untuk Claude Opus 4.7 dan model yang lebih baru, yang diakses melalui client AnthropicBedrockMantle dari package yang sama. Endpoint ini mendukung kredensial AWS dan token bearer Bedrock; persyaratan akses model berbeda di antara kedua endpoint tersebut, seperti dijelaskan di bawah.

Perhatikan pembaruan pada baris pip install -U tersebut. Per 27 October 2026, SDK terbaru mengirimkan versi API 2026-10-21 secara default, termasuk melalui Bedrock. Anthropic mendokumentasikan bahwa ID model berversi ARN yang dicantumkan untuk Claude Opus 4.6 dan versi sebelumnya tidak mendukung versi tersebut di Bedrock dan dapat mengembalikan error 400. Jika sebuah service memanggil salah satu model tersebut, pertahankan SDK pada versi yang saat ini digunakan service dan pin versinya, atau pindahkan service ke model Claude 4.7 atau versi yang lebih baru terlebih dahulu.

Region bukan sekadar pelengkap di sini. Endpoint Bedrock bersifat spesifik untuk setiap region, model Claude yang tersedia berbeda antarregion, dan region menjadi bagian dari tanda tangan SigV4. Karena itu, tanda tangan yang dibuat untuk satu region akan ditolak oleh region lain. Tetapkan AWS_REGION secara eksplisit di lingkungan service, karena SDK tidak memiliki perilaku yang sama jika nilai tersebut tidak diisi. Seperti didokumentasikan pada October 2026, client AnthropicBedrock Python membaca AWS_REGION atau AWS_DEFAULT_REGION, kemudian region dari sesi boto3 atau profil AWS Anda, termasuk ~/.aws/config, lalu memicu ValueError jika tidak ada nilai yang berhasil ditentukan. Client TypeScript membaca AWS_REGION, menggunakan us-east-1 sebagai fallback jika nilai tersebut tidak ditetapkan, dan tidak membaca ~/.aws/config untuk menentukan region. Karena itu, AWS CLI dapat mencantumkan model Claude dengan berhasil pada server yang sama ketika proses Node memanggil region yang salah: CLI membaca file konfigurasi Anda, sedangkan client tidak.

Pada instance EC2, Anda memasang role IAM (identity and access management), sehingga tidak ada secret yang disimpan di disk. Instance metadata service memberikan kredensial sementara kepada SDK. VPS di luar AWS tidak memiliki instance role maupun metadata service. Anda harus memilih antara pasangan access key jangka panjang milik pengguna IAM yang disimpan di server—jenis secret-nya sama dengan key Anthropic—atau federation: lakukan autentikasi terhadap identity provider Anda, panggil AWS STS (security token service), lalu gunakan kredensial sementara yang dikembalikannya. Bedrock juga menerima API key Bedrock, yaitu token bearer yang diteruskan melalui AWS_BEARER_TOKEN_BEDROCK, dan AWS mendokumentasikan dua jenis key. Key jangka pendek berlaku hingga 12 jam, atau selama durasi sesi yang membuatnya jika durasi tersebut lebih singkat, mewarisi izin dari identitas IAM yang membuatnya, dan merupakan jenis yang direkomendasikan AWS untuk production. Key jangka panjang berlaku hingga waktu kedaluwarsa yang Anda pilih saat membuatnya, misalnya 30 atau 90 hari dengan --credential-age-days, atau tidak kedaluwarsa jika parameter API tersebut dihilangkan. Console membuat pengguna IAM di balik key tersebut, dan AWS merekomendasikannya hanya untuk exploration. Key jangka panjang hanya berfungsi di region tempat key tersebut dibuat; penggunaan di region lain mengembalikan Credential should be scoped to a valid region.

Tagihan dibebankan ke akun AWS Anda, bukan ke Anthropic. Biasanya, inilah alasan utama menggunakan Bedrock. Endpoint regional mengenakan premium 10% dibandingkan endpoint global, seperti didokumentasikan pada October 2026. Claude Platform di AWS adalah product terpisah: Anthropic mengoperasikannya, AWS menagihnya melalui AWS Marketplace, dan autentikasinya menggunakan SigV4 atau API key yang dibuat di AWS Console. Key dari Claude Console tidak dapat digunakan di sana. Akses dilakukan melalui client AnthropicAWS yang ditandai Anthropic sebagai beta. Ada satu error Bedrock yang perlu dikenali karena tampak seperti masalah izin, padahal bukan: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. Itu adalah routing model, sehingga perubahan kredensial tidak akan memperbaikinya.

Rute 3: Kredensial Google di Vertex AI

Dokumentasi Anthropic sekarang menyebut rute ini Claude Models on Google Cloud (Google managed), yang dijalankan Google sebagai bagian dari Agent Platform, nama baru Google untuk layanan yang berkembang dari Vertex AI. Host aiplatform.googleapis.com, extra anthropic[vertex], dan class AnthropicVertex yang ditunjukkan di bawah ini tidak berubah.

Google Cloud menggunakan Application Default Credentials (ADC), yaitu urutan pencarian tetap yang diikuti library autentikasi Google untuk menemukan kredensial tanpa Anda menentukannya secara eksplisit. ADC memeriksa GOOGLE_APPLICATION_CREDENTIALS terlebih dahulu, kemudian file yang ditulis oleh gcloud auth application-default login, lalu service account yang terpasang melalui metadata server.

pip install -U "anthropic[vertex]"
gcloud auth application-default login

Pada workstation, login tersebut menulis $HOME/.config/gcloud/application_default_credentials.json dan Anda selesai. Pada server, hindari menyimpan kredensial pengguna; perintah tersebut juga mendukung impersonation service account. Di luar Google Cloud, metadata server Google juga tidak tersedia. Karena itu, gunakan GOOGLE_APPLICATION_CREDENTIALS untuk mengarahkan ADC ke file konfigurasi Workload Identity Federation atau file kunci service account. File JSON kunci service account merupakan secret berumur panjang dan harus ditangani persis seperti yang dijelaskan di bagian berikutnya pada panduan ini. Di dalam Google Cloud, pasang service account ke VM sehingga tidak ada file yang perlu dilindungi. Identitas apa pun yang ditemukan ADC harus memiliki peran IAM yang mencakup permission aiplatform.endpoints.predict, misalnya Agent Platform User (roles/aiplatform.user).

from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="my-project", region="global")

Ada dua hal yang berubah jika Anda menggunakan HTTP mentah tanpa SDK. Identifier model berpindah dari body request ke path URL, sedangkan anthropic_version berpindah dari header ke body. Per 27 October 2026, dokumentasi Anthropic menerima vertex-2023-10-16 di sana atau API version yang lebih baru, 2026-10-21. Kredensialnya adalah access token Google biasa. Pada perintah di bawah ini, gcloud auth print-access-token menggunakan login milik gcloud CLI, bukan ADC. Karena itu, jalankan gcloud auth login atau gcloud init terlebih dahulu pada mesin tempat Anda mengujinya.

curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

Region merupakan argumen utama. global melakukan routing secara dinamis berdasarkan ketersediaan, us dan eu merupakan identifier multi-region, sedangkan nama seperti us-east5 menetapkan satu region tertentu. Per October 2026, Anthropic hanya mendokumentasikan endpoint single-region untuk Claude Sonnet 4.6 dan versi sebelumnya. Model yang lebih baru menggunakan endpoint global atau multi-region. Endpoint multi-region dan regional berbiaya 10% lebih tinggi daripada endpoint global, sebagaimana didokumentasikan pada October 2026. Penagihan dilakukan melalui project Google Cloud. Karena itu, quota dan invoice ditangani Google.

Per 27 October 2026, Anthropic juga mendokumentasikan penawaran Google Cloud kedua dengan bentuk request yang berbeda. Dalam Claude Models on Google Cloud (Anthropic managed), Anthropic mengoperasikan Claude API sendiri di claude.googleapis.com, yang diakses melalui client AnthropicGoogleCloud. Layanan ini tetap menggunakan kredensial Google Cloud, termasuk ADC, tetapi request-nya menyerupai API langsung: model tetap berada di body, sedangkan version dikirim dalam header anthropic-version. Akses menggunakan peran IAM miliknya sendiri (roles/claude.user dan peran terkait), proses setup membuat organisasi Anthropic baru untuk project tersebut, dan penggunaan ditagihkan melalui Google Cloud Marketplace. Jika URL request Anda memuat aiplatform dan diakhiri :rawPredict, berarti Anda menggunakan rute yang dikelola Google dan dijelaskan di bagian ini.

Rute 4: Microsoft Foundry adalah rute Azure

Jika Anda mencari Claude di Azure, inilah bagian yang Anda perlukan, dan rute yang didukung memang tersedia. Claude berjalan di Microsoft Foundry (sebelumnya Azure AI Foundry), dengan penagihan melalui Azure Marketplace dalam Claude Consumption Units. Anda membuat resource Foundry, melakukan deployment model Claude di dalamnya, lalu memanggil endpoint yang di-host di Azure pada https://{resource}.services.ai.azure.com/anthropic/v1/*.

Ada dua kredensial yang dapat digunakan. Yang pertama adalah key yang diterbitkan Azure dari tab Details pada deployment di portal Foundry, yang dikirim dalam header api-key atau x-api-key. Yang kedua adalah token Microsoft Entra. Token ini merupakan pilihan yang lebih baik pada server karena Azure role-based access control kemudian mengatur siapa yang dapat memanggil endpoint tersebut.

ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)

curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
  -H "content-type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

Field model berisi nama deployment, bukan pengenal model. Secara default, keduanya sama. Keduanya tidak lagi sama saat Anda menetapkan sendiri nama deployment, yang biasanya menjadi penyebab error Deployment not found pada request yang sebenarnya sudah benar. SDK Python dan TypeScript membaca ANTHROPIC_FOUNDRY_API_KEY dan ANTHROPIC_FOUNDRY_RESOURCE dari environment. Berdasarkan dokumentasi per 10 November 2026, dukungan Foundry mencakup ketujuh SDK resmi: C#, Go, Java, PHP, Python, Ruby, dan TypeScript. Go menggunakan package khusus foundry (go get github.com/anthropics/anthropic-sdk-go/v2/foundry), sedangkan Ruby memperoleh Anthropic::FoundryClient khusus pada version 2.5.0 gem yang dirilis pada 4 November 2026. Sebelum rilis tersebut, kode Ruby harus mengarahkan client generik ke base URL Foundry.

Mengarahkan client generik ke base URL Foundry tetap memiliki risiko tertentu, baik pada kode Ruby yang ditulis sebelum 2.5.0 maupun pada CLI ant, yang juga digunakan dengan cara tersebut dalam contoh Foundry dari Anthropic. Jika Anda tidak meneruskan kredensial secara eksplisit ke client generik dan ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN masih disetel di environment, client akan mengambilnya dan mengirim kredensial Anthropic Anda ke endpoint Microsoft. Hapus setelan variabel tersebut, atau teruskan key atau token Foundry ke client secara eksplisit. Di Ruby, beralih ke Anthropic::FoundryClient, yang menerima key Foundry atau provider token Entra, merupakan perbaikan yang lebih tepat. Access token Entra memiliki masa berlaku default acak antara 60 hingga 90 menit. Karena itu, proses yang berjalan lama harus memperbarui token tersebut, bukan menyimpannya hanya sekali saat proses dimulai.

Berapa lama kredensial pada server Anda tetap berlaku?

GrafikDocumented credential lifetime by route, hours
Data di balik grafik ini
[
  {
    "label": "Anthropic key, 30-day preset",
    "max_lifetime_hours": 720
  },
  {
    "label": "Anthropic key, 7-day preset",
    "max_lifetime_hours": 168
  },
  {
    "label": "AWS STS assumed role",
    "max_lifetime_hours": 12
  },
  {
    "label": "Bedrock short-term API key",
    "max_lifetime_hours": 12
  },
  {
    "label": "Entra ID access token, default upper bound",
    "max_lifetime_hours": 1.5
  },
  {
    "label": "Federated Anthropic token, default",
    "max_lifetime_hours": 1
  }
]

Nilai batas dan default ini dipublikasikan oleh setiap penyedia dan dibaca pada Oktober 2026, bukan hasil pengukuran. Nilai ini penting karena menunjukkan berapa lama kredensial yang bocor tetap dapat digunakan saat Anda masih mencari tahu bahwa kredensial tersebut telah bocor. Token Anthropic federasi di bagian bawah grafik berlaku hingga 1 jam secara default. Masa berlaku ini juga dibatasi oleh dua kali sisa masa berlaku token penyedia identitas. Token akses Microsoft Entra tidak memiliki satu nilai default. Microsoft memberikan masa berlaku acak antara 60 dan 90 menit untuk setiap token, dengan rata-rata 75 menit. Pada grafik, token ini ditampilkan pada batas atas 1.5 jam. Default tersebut juga berbeda-beda, bergantung pada client, resource, dan apakah Conditional Access diaktifkan pada tenant. Jika client dan resource sama-sama mendukung Continuous Access Evaluation, Entra dapat memperpanjang masa berlaku hingga 24 sampai 28 jam. Sebagai gantinya, Entra mencabut token hampir secara real-time ketika terjadi peristiwa seperti penonaktifan akun. Kebijakan masa berlaku token tenant dapat menetapkan masa berlaku mulai dari 10 menit hingga 23:59:59. SDK secara otomatis memperbarui token Anthropic federasi. Di Foundry, konfigurasikan penyedia token Entra untuk memperbarui token, bukan meneruskan string token tetap. Aturan federation dapat menetapkan masa berlaku token sendiri, mulai dari satu menit hingga 24 jam. Wizard Connect workload pada Console mengisi nilai awal 10 menit. Karena itu, baca aturan tersebut dan jangan mengasumsikan default. Role yang diasumsikan dan API key jangka pendek Bedrock sama-sama memiliki masa berlaku 12 jam. API key jangka panjang Bedrock tidak ditampilkan pada grafik karena tidak memiliki batas tetap. API key tersebut berlaku hingga waktu kedaluwarsa yang dipilih saat dibuat, atau tidak kedaluwarsa jika CredentialAgeDays tidak disertakan dalam panggilan API. Karena itu, AWS merekomendasikannya hanya untuk eksplorasi. Key yang dibuat dengan preset 30 hari tetap berlaku selama 720 jam. Kredensial inilah yang tersimpan dalam file di server Anda selama satu bulan.

Tempat penyimpanan kredensial di VPS

Simpan secret dalam file yang hanya dapat dibaca oleh root, lalu biarkan systemd meneruskannya ke proses. Bagian ini tidak bergantung pada versi SDK, sehingga cukup dikonfigurasi sekali dengan benar.

sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/env

File tersebut berisi baris plain KEY=value. Jangan gunakan export, tanda kutip, atau sintaks shell, karena systemd menguraikannya sendiri dan tidak menjalankannya melalui shell.

ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME
[Unit]
Description=Claude API service
After=network-online.target

[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure

[Install]
WantedBy=multi-user.target

systemd membaca EnvironmentFile= sebagai root sebelum menurunkan hak aksesnya menjadi User=claudeapp, sehingga akun service tidak perlu memiliki izin baca ke file tersebut. Mode 600 dengan root sebagai pemilik sudah cukup. Karena itu, perintah install di atas mengaturnya demikian. Jalankan service dengan sudo systemctl enable --now claude-app, lalu pastikan melalui systemctl status claude-app bahwa unit mencapai status active (running) dan tidak terus-menerus restart.

Hindari empat hal berikut. Masing-masing memiliki alasan yang dapat Anda periksa sendiri:

  • Jangan menulis key dengan Environment= di dalam file unit. Unit di bawah /etc/systemd/system dapat dibaca oleh semua pengguna, sehingga systemctl cat claude-app dapat menampilkan secret kepada pengguna lokal mana pun.
  • Jangan commit file tersebut. .gitignore hanya mencegah file baru masuk ke commit dan tidak melakukan apa pun terhadap file yang sudah di-commit, karena riwayat git menyimpan apa pun yang pernah diberikan kepadanya.
  • Jangan memasukkan secret ke dalam container image. Nilai ENV tetap tersimpan dalam konfigurasi image, sedangkan build argument dapat terlihat dalam riwayat image atau metadata provenance. Menghapus file pada layer berikutnya tidak menghapusnya dari layer sebelumnya. Teruskan secret saat runtime menggunakan --env-file atau file yang di-mount.
  • Jangan menganggap environment proses bersifat privat dari root. sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n' dapat menampilkan key tersebut. Perintah untuk membaca file sendiri memerlukan sudo; pengalihan input shell berjalan sebelum sudo dan menggunakan izin akun Anda saat ini. Tujuannya adalah menjaga secret dari semua akun lain pada server, bukan dari root, yang tetap dapat membacanya apa pun yang Anda lakukan.

Poin terakhir tersebut menetapkan batas manfaat desain ini. File yang hanya dapat dibaca oleh root melindungi key yang tersimpan, tetapi kode apa pun yang berjalan sebagai akun service dapat membaca environment proses, dan proses anak mewarisinya. Container ini tidak tepat jika proses menjalankan kode yang tidak Anda tulis, karena apa pun yang dapat dijalankan proses tersebut dapat membaca environment-nya sendiri. Menjauhkan secret dari jangkauan agen AI membahas kasus tersebut. Itu merupakan masalah yang berbeda dan memerlukan jawaban yang berbeda.

Bagaimana cara melakukan rotasi key tanpa downtime?

Lakukan rotasi ke depan, lalu cabut key lama. Restart satu service di bawah ini akan menghentikan service untuk sementara. Ketersediaan tanpa gangguan memerlukan instance lain untuk menangani request selama restart.

  1. Buat key baru di Console, pada workspace yang sama dengan key lama.
  2. Tulis key tersebut ke /etc/claude-app/env menggunakan sudoedit.
  3. Jalankan sudo systemctl restart claude-app.
  4. Pastikan service merespons request, lalu cabut key lama di Console.

EnvironmentFile dibaca saat unit dijalankan, sehingga proses yang sedang berjalan tetap menggunakan nilai yang diberikan saat proses dimulai. systemctl daemon-reload membaca ulang file unit dan tidak mengubah environment proses yang sedang berjalan. Karena itu, hanya restart yang akan menggunakan key baru. Jika Anda mencabut key pada langkah 1, bukan langkah 4, service akan mengalami outage hingga langkah 3 selesai.

Cloud routes melakukan rotasi di sisi provider. IAM user mendukung dua access key aktif secara bersamaan. Karena itu, buat key kedua, deploy key tersebut, lalu hapus key pertama. Key untuk Google service account dirotasi dengan cara yang sama. Foundry resource memiliki dua key. Membuat ulang salah satunya langsung membuat nilai lamanya tidak berfungsi. Karena itu, pindahkan service ke key lain sebelum membuat ulang key yang sedang digunakan. Entra token dan federated Anthropic token tidak memerlukan rotasi token manual. Hal ini merupakan alasan terkuat untuk menggunakannya jika memungkinkan.

Saat berada di Console, tetapkan batas pengeluaran pada workspace. Key yang bocor pertama-tama akan menimbulkan biaya besar, dan membatasi pengeluaran agent pada VPS menjelaskan kontrol yang tersedia.

Mengapa klien saya mengembalikan 401 atau 403?

401 dengan authentication_error pada API langsung. Kunci tersebut salah, telah dicabut, atau sudah melewati masa berlaku. Masa berlaku sering terlewat karena kode tidak berubah dan permintaan masih berhasil kemarin. Periksa kolom masa berlaku kunci di Console, atau baca expires_at dari Admin API. Nilainya adalah null untuk kunci tanpa masa berlaku. Kunci pribadi juga berhenti berfungsi ketika pemiliknya keluar dari organisasi.

SDK mengabaikan konfigurasi federation dan menggunakan kunci. ANTHROPIC_API_KEY dan ANTHROPIC_AUTH_TOKEN berada di atas federation dalam urutan prioritas kredensial, sehingga salah satunya menimpanya. Hal yang sering terlewat: variabel yang diekspor sebagai string kosong tetap mengisi slotnya. Akibatnya, ANTHROPIC_API_KEY="" membuat SDK melakukan autentikasi dengan kunci kosong, bukan melanjutkan ke metode berikutnya. Gunakan unset ANTHROPIC_API_KEY.

401 dengan pesan singkat Authentication failed pada federation. Pesan tersebut sengaja dibuat sama untuk semua kemungkinan penyebab. Dengan demikian, pemanggil tidak dapat memeriksa konfigurasi aturan hanya dengan membaca teks error. Alasan sebenarnya tercatat pada halaman riwayat autentikasi di Console. Periksa halaman tersebut terlebih dahulu, bukan langsung menebak masalah pada JWT.

403 pada Foundry. Token berhasil diautentikasi, tetapi akun Azure Anda tidak memiliki role yang mengizinkan panggilan tersebut. Tetapkan role Azure RBAC seperti Foundry User (sebelumnya Azure AI User) atau Cognitive Services User kepada identity yang melakukan permintaan.

Masalah apa pun pada Bedrock. Untuk autentikasi SigV4, jalankan aws sts get-caller-identity terlebih dahulu sebagai service user. Perintah tersebut menunjukkan apakah mesin memiliki kredensial AWS yang dapat digunakan. Dengan demikian, Anda dapat membedakan masalah kredensial dari masalah akses model atau ketidaksesuaian region. Per 29 October 2026, AWS mengaktifkan akses ke banyak model pada penggunaan pertama di region komersial jika izin AWS Marketplace yang diperlukan tersedia. Namun, beberapa model memerlukan akses terpisah pada tingkat akun. Model Anthropic yang dipanggil melalui route InvokeModel memerlukan formulir use case satu kali untuk setiap akun, atau satu kali untuk seluruh AWS Organization. Namun, region yang memerlukan opt-in harus mengajukannya lagi. Sebelum proses tersebut selesai, panggilan mengembalikan AccessDeniedException. AWS mendokumentasikan bahwa formulir tersebut tidak berlaku untuk endpoint bedrock-mantle. Panggilan pertama ke suatu model dalam sebuah akun juga membuat Bedrock memulai subscription AWS Marketplace di latar belakang. Subscription tersebut memerlukan identity yang memiliki izin aws-marketplace:Subscribe, aws-marketplace:Unsubscribe, dan aws-marketplace:ViewSubscriptions. Kekurangan izin tidak selalu menyebabkan panggilan pertama gagal. AWS mendokumentasikan bahwa panggilan dapat berhasil hingga 15 menit selama subscription disiapkan. Setelah subscription gagal, panggilan berikutnya mengembalikan AccessDeniedException. Jika sebuah service berfungsi selama beberapa menit pertama lalu mulai gagal, periksa masalah ini, bukan kredensialnya. Setelah Anda memberikan izin, AWS memerlukan waktu hingga 2 menit untuk menyelesaikan subscription. Model yang tidak ditawarkan di region tujuan akan gagal, sebaik apa pun kredensialnya.

FAQ

Apakah saya memerlukan kunci API Anthropic untuk menggunakan Claude di Bedrock atau Vertex?

Tidak. Di Amazon Bedrock, SDK menandatangani permintaan dengan kredensial AWS menggunakan SigV4 atau mengirimkan kunci API Bedrock. Di Google Cloud, SDK mengirimkan token akses Google yang diperoleh melalui Application Default Credentials. Tidak ada rahasia yang diterbitkan Anthropic dalam kedua konfigurasi tersebut. Biaya penggunaan dibebankan ke akun cloud, bukan ke Anthropic. Karena itu, kunci Anthropic yang tersimpan di ANTHROPIC_API_KEY merupakan risiko pada host tersebut. Klien generik yang diarahkan ke endpoint cloud akan tetap mengirimkan kunci itu ke sana.

Apakah Claude tersedia di Azure?

Ya, melalui Microsoft Foundry, yang sebelumnya bernama Azure AI Foundry. Buat resource Foundry, deploy model Claude ke dalamnya, lalu panggil https://{resource}.services.ai.azure.com/anthropic/v1/messages menggunakan kunci yang diterbitkan Azure dalam header api-key atau token bearer Microsoft Entra. Biaya penggunaan dibebankan melalui Azure Marketplace dalam satuan Claude Consumption Units. Field model dalam body permintaan harus berisi nama deployment Anda. Nama tersebut hanya sama dengan identifier model jika Anda mempertahankan nama default saat membuat deployment. Nama itu tidak dapat diubah setelahnya.

Di mana saya harus menyimpan kunci API Claude di server Linux?

Simpan dalam file milik root dengan mode 600, lalu muat melalui EnvironmentFile= dalam unit systemd. systemd membaca file tersebut sebagai root sebelum beralih ke User= milik unit. Dengan demikian, akun service tidak memerlukan akses ke file tersebut. Jangan menyimpannya di repository, di dalam file unit itu sendiri (yang dapat dibaca semua pengguna dan ditampilkan oleh systemctl cat), atau di dalam konfigurasi image container, layer, dan metadata build.

Mengapa permintaan API Claude saya mulai mengembalikan 401 padahal tidak ada yang berubah?

Kunci yang telah mencapai waktu kedaluwarsa yang ditetapkan saat dibuat akan mengembalikan 401. Waktu kedaluwarsa ditetapkan saat pembuatan dan tidak dapat diedit setelahnya. Kunci berumur pendek juga kedaluwarsa tanpa email peringatan. Kunci yang kedaluwarsa tidak dapat diaktifkan kembali. Karena itu, buat pengganti, tulis kunci tersebut ke file environment, restart service, lalu cabut kunci lama. Jika kunci tersebut dipastikan masih berlaku, periksa apakah kredensial lama menimpanya: ANTHROPIC_API_KEY yang ditetapkan sebagai string kosong tetap memiliki prioritas di atas sumber federation dan profile di bawahnya.

Apakah artikel ini bermanfaat?

#claude#api#authentication#bedrock#vertex#secrets-management