Hubungkan Claude Code ke gateway LLM

Arahkan Claude Code ke gateway LLM organisasi Anda. Periksa apakah admin Anda sudah mengonfigurasinya, atau atur URL dasar dan kredensial sendiri, kemudian verifikasi koneksi dan perbaiki kesalahan gateway.

Gateway LLM adalah proxy yang dijalankan organisasi Anda antara Claude Code dan penyedia model. Ketika organisasi Anda menggunakan satu, Claude Code melakukan autentikasi ke gateway dengan kredensial yang dikeluarkan organisasi Anda, bukan login claude.ai pribadi Anda.

Halaman ini untuk pengembang yang menjalankan Claude Code melalui gateway yang dioperasikan organisasi mereka. Ini mencakup dua jalur: memeriksa apakah administrator Anda sudah mengonfigurasinya untuk Anda, dan mengonfigurasinya sendiri ketika mereka belum.

Periksa konfigurasi yang ada

Administrator dapat mendistribusikan alamat gateway dan kredensial melalui pengaturan terkelola, manajemen perangkat, atau apiKeyHelper, sehingga Claude Code mengambilnya saat startup tanpa apa pun yang perlu Anda atur. Untuk memeriksa apakah organisasi Anda sudah melakukan ini:

Jika kedua baris di menu /status terlihat benar tetapi pesan ke Claude gagal, lihat tabel pemecahan masalah.

Konfigurasikan Claude Code sendiri

Untuk mengonfigurasi Claude Code untuk gateway sendiri, Anda memerlukan dari tim gateway Anda:

• URL dasar gateway
• Kredensial: string kunci atau token, atau perintah yang mengambilnya
  • Jika tim gateway Anda tidak mengatakan jenis kredensial apa itu, bagian variabel kredensial di bawah mencakup apa yang harus dicoba

Bagian di bawah mencakup konfigurasi secara berurutan:

• Atur variabel kredensial dan atur URL dasar: dua variabel yang setiap koneksi gateway butuhkan
• Verifikasi koneksi: konfirmasi berfungsi sebelum menyimpan apa pun
• Konfigurasikan setiap permukaan: jika Anda menggunakan permukaan selain CLI Claude Code, seperti VS Code, lihat cara mengonfigurasinya dengan kredensial gateway Anda
• Konfigurasi tambahan: variabel yang beberapa gateway butuhkan di luar URL dasar dan kredensial, seperti header khusus, pembantu kredensial, penemuan model, URL dasar format penyedia, atau mematikan lalu lintas di luar jalur gateway. Atur ini hanya jika administrator Anda menamakannya atau jaringan Anda membatasi egress

Atur variabel kredensial

Untuk melakukan autentikasi Claude Code ke gateway, atur kredensial Anda dalam variabel lingkungan. Variabel mana tergantung pada apa yang diberitahu tim gateway Anda:

Jika Anda tidak diberitahu jenis mana, gunakan ANTHROPIC_AUTH_TOKEN; permintaan verifikasi di bawah menunjukkan cara mengetahui apakah Anda perlu beralih.

Atur URL dasar dan kredensial

Atur URL dasar gateway dan variabel kredensial yang Anda pilih di atas sebagai variabel lingkungan. Contoh menggunakan ANTHROPIC_AUTH_TOKEN; tukarnya dengan ANTHROPIC_API_KEY jika itu variabel yang Anda pilih. Anda dapat mengaturnya di shell Anda, yang berlaku untuk satu sesi terminal, atau di file pengaturan Claude Code, yang bertahan di mana pun Claude Code berjalan.

Untuk koneksi pertama Anda, mulai dengan ekspor shell dan jalankan permintaan verifikasi sebelum memindahkan nilai ke file pengaturan.

Atur sebagai variabel lingkungan shell

Ganti nilai dengan yang diberikan tim gateway Anda:

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

Ekspor shell hanya berlaku untuk sesi terminal itu dan program yang dimulai darinya. Editor yang diluncurkan dari dock atau menu Start tidak akan melihatnya. Untuk membuatnya bertahan di terminal baru, tambahkan baris yang sama ke profil shell Anda, seperti ~/.zshrc, ~/.bashrc, atau $PROFILE PowerShell Anda.

Jika Anda mengekspor gateway hanya di shell Anda, itu tidak dapat diandalkan mencapai agen latar belakang yang dihosting oleh supervisor; lihat bagaimana setiap sesi latar belakang bersumber gatewaynya. Gunakan file pengaturan untuk gateway apa pun yang harus selalu dirutekan oleh agen latar belakang.

Atur di file pengaturan

Untuk membuat konfigurasi berlaku di mana pun Claude Code berjalan, termasuk agen latar belakang, atur variabel di blok env dari file pengaturan daripada mengandalkan shell Anda. File pengaturan memiliki cakupan berbeda:

• ~/.claude/settings.json berlaku untuk semua proyek Anda. Di Windows jalurnya adalah %USERPROFILE%\.claude\settings.json
• .claude/settings.local.json berlaku untuk satu proyek. Claude Code menambahkannya ke gitignore global Anda ketika menyimpan pengaturan di sana; jika Anda membuatnya dengan tangan atau membiarkan Claude menulisnya, tambahkan ke gitignore Anda sendiri terlebih dahulu sehingga Anda tidak secara tidak sengaja melakukan komit kredensial Anda

Blok env terlihat sama di kedua file:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

Ketika ekspor shell dan blok env file pengaturan mengatur variabel yang sama, nilai file pengaturan berlaku. Jalankan /status untuk melihat URL dasar dan sumber kredensial mana yang digunakan Claude Code.

Verifikasi koneksi

Dengan variabel yang diekspor di shell Anda, kirim permintaan satu token ke gateway secara langsung. Ini mengonfirmasi URL dan kredensial berfungsi sebelum Anda membuka Claude Code, sehingga kegagalan menunjuk ke gateway daripada konfigurasi Anda. Perintah di bawah membaca variabel shell, jadi mereka memerlukan ekspor shell bahkan jika Anda juga menempatkan nilai di file pengaturan.

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
-Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" `
-Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Jika gateway Anda mengharapkan kunci di header x-api-key, ganti header Authorization dengan x-api-key: $ANTHROPIC_API_KEY di perintah Bash, atau entri hashtable "Authorization" dengan "x-api-key" = "$env:ANTHROPIC_API_KEY" di perintah PowerShell.

Respons JSON yang dimulai dengan {"id":"msg_ dan menyertakan bidang "content":[...] berarti gateway dapat dijangkau dan kredensial berfungsi. Kesalahan yang menamai model yang tidak dikenal masih membuktikan URL dan kredensial berfungsi, karena gateway melakukan autentikasi permintaan sebelum menolak nama model; Anda tidak perlu menemukan model yang dilayani gateway Anda untuk tes ini. 401 berarti kredensial ditolak: jika Anda menebak variabel, beralih ke yang lain dan ekspor ulang.

Konfirmasi di Claude Code

Mulai claude dari shell yang sama sehingga mewarisi ekspor, kirim pesan, dan jalankan /status.

Di tab Status, baris Anthropic base URL harus menampilkan alamat gateway Anda, yang mengonfirmasi permintaan dirutekan ke sana; jika baris tidak ada, variabel tidak mencapai sesi. Baris Auth token atau API key yang menamai variabel yang Anda atur mengonfirmasi kredensial gateway aktif daripada login claude.ai yang disimpan.

Jika pesan gagal, atau /status tidak menampilkan URL gateway, lihat tabel pemecahan masalah di bawah.

Bagaimana variabel kredensial memetakan ke header

Setiap variabel mengirim kredensial di header HTTP berbeda: ANTHROPIC_AUTH_TOKEN di Authorization: Bearer, ANTHROPIC_API_KEY di x-api-key, dan apiKeyHelper di keduanya. Kredensial dalam variabel yang salah mencapai gateway di header yang tidak dibacanya, dan permintaan gagal dengan 401. Jika permintaan verifikasi mengembalikan 401, beralih ke variabel lain dan coba lagi.

Konflik dengan login yang ada

Variabel kredensial gateway mengambil alih login claude.ai yang disimpan atau kunci Console. Login claude.ai Anda tetap disimpan dan tidak digunakan sementara variabel diatur; batalkan pengaturan variabel dan Claude Code kembali ke itu. Dengan ANTHROPIC_AUTH_TOKEN, variabel mengambil alih segera. Dengan ANTHROPIC_API_KEY, Anda diminta sekali dalam mode interaktif untuk menyetujui kunci sebelum mengambil alih.

Jalankan /status untuk mengonfirmasi sumber kredensial mana yang aktif. Jika startup menampilkan peringatan konflik auth yang menamai dua sumber, lihat baris pertama tabel pemecahan masalah untuk mengetahui mana yang harus dihapus. Untuk menghapus login yang disimpan sehingga hanya kredensial gateway yang tersisa, jalankan /logout.

Konfigurasikan setiap permukaan

CLI membaca variabel lingkungan dan file pengaturan di atas. Permukaan lainnya adalah ekstensi VS Code, aplikasi desktop, GitHub Actions, Agent SDK, dan permukaan cloud seperti Slack dan web; bagian di bawah mencakup apakah pengaturan itu mencapai masing-masing.

Ekstensi VS Code

Atur variabel gateway untuk ekstensi VS Code di claudeCode.environmentVariables, di pengaturan pengguna VS Code sendiri yang dibuka dengan perintah Preferences: Open User Settings (JSON). Ekstensi memeriksa kredensial dari pengaturan ini sebelum meluncurkan, jadi itu tempat yang andal untuk kredensial gateway; nilai di ~/.claude/settings.json mencapai proses yang dihasilkan tetapi bukan pemeriksaan login ekstensi sendiri.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}

Aplikasi desktop

Aplikasi desktop membaca perutean gateway dari konfigurasi inferensi pihak ketiga, bukan dari ANTHROPIC_BASE_URL atau settings.json. Konfigurasi itu dapat berasal dari organisasi Anda atau dari formulir di aplikasi itu sendiri:

• Didistribusikan oleh administrator: jika organisasi Anda telah menerapkan konfigurasi, aplikasi desktop merutekan melalui gateway tanpa pengaturan di pihak Anda
• Dikonfigurasi secara lokal: untuk perangkat tanpa konfigurasi yang didistribusikan administrator, buka Help → Troubleshooting → Enable Developer Mode, yang memulai ulang aplikasi dengan menu Developer. Kemudian buka Developer → Configure Third-Party Inference dan masukkan URL dasar gateway Anda. Konfigurasi yang didistribusikan administrator memiliki prioritas dan membuat formulir ini hanya-baca

Dengan konfigurasi gateway aktif, aplikasi desktop menjalankan sesi hanya di mesin lokal Anda: pemilih lingkungan tidak menawarkan sesi SSH atau lingkungan cloud yang dihosting Anthropic, dan Remote Control tidak tersedia. Untuk menggunakan Claude Code pada host jarak jauh melalui gateway, jalankan CLI pada host itu dengan ANTHROPIC_BASE_URL dan kredensial gateway diatur di sana.

Jika aplikasi desktop menampilkan Gateway was unreachable, aplikasi tidak dapat menjangkau URL dasar yang dikonfigurasi saat startup; periksa URL dan jalur jaringan dengan tes curl di atas.

GitHub Actions

Claude Code GitHub Actions membaca ANTHROPIC_BASE_URL dan ANTHROPIC_CUSTOM_HEADERS dari blok env alur kerja. Teruskan kredensial sebagai input anthropic_api_key tindakan; tindakan mengaturnya sebagai ANTHROPIC_API_KEY, sehingga mencapai gateway di header x-api-key.

Untuk gateway x-api-key, atur URL dasar di env dan teruskan kunci gateway sebagai input:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Untuk gateway bearer-token, teruskan rahasia yang sama dua kali: sebagai input anthropic_api_key dan sebagai ANTHROPIC_AUTH_TOKEN di blok env alur kerja. Tindakan memerlukan anthropic_api_key, CLAUDE_CODE_OAUTH_TOKEN, atau federasi identitas beban kerja sebelum meluncurkan Claude Code, dan tidak membaca ANTHROPIC_AUTH_TOKEN, jadi input hanya ada untuk memenuhi pemeriksaan peluncuran itu. Variabel env adalah yang menempatkan kunci di header Authorization yang dibaca gateway; salinan di x-api-key diabaikan:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.GATEWAY_API_KEY }}

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Untuk opsi autentikasi lain tindakan, termasuk CLAUDE_CODE_OAUTH_TOKEN dan federasi identitas beban kerja, lihat Claude Code GitHub Actions dan README tindakan.

Agent SDK

Agent SDK tidak memiliki opsi khusus gateway; itu melewatkan variabel lingkungan ke proses Claude Code yang dihasilkannya. Setiap SDK menerima opsi env yang mengatur lingkungan proses yang dihasilkan, dan SDK TypeScript dan Python memperlakukannya berbeda:

• TypeScript: proses yang dihasilkan mewarisi lingkungan induk secara default, tetapi pengaturan options.env mengganti lingkungan sepenuhnya. Sebarkan process.env ke dalamnya untuk menyimpan variabel gateway Anda.
• Python: ClaudeAgentOptions(env=...) menggabungkan di atas lingkungan yang diwarisi, jadi variabel gateway yang diatur dalam proses induk membawa tanpa penyebaran.

const result = query({
prompt: "...",
options: {
env: {
...process.env,
ANTHROPIC_BASE_URL: "https://llm-gateway.example.com",
ANTHROPIC_AUTH_TOKEN: process.env.GATEWAY_KEY,
},
},
})

options = ClaudeAgentOptions(
env={
"ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
"ANTHROPIC_AUTH_TOKEN": os.environ["GATEWAY_KEY"],
}
)

Slack, web, dan Remote Control

Claude Code di Slack dan Claude Code di web adalah produk yang dihosting Anthropic yang selalu menggunakan API Anthropic; mereka bukan bagian dari penerapan gateway. Variabel gateway yang diatur dalam konfigurasi lingkungan sesi cloud tidak diterapkan. Jika lalu lintas Anda harus tetap di gateway, jangan aktifkan permukaan ini untuk pengguna tersebut.

Remote Control dan voice dictation keduanya mengandalkan identitas claude.ai: Remote Control untuk memasangkan sesi langsung dengan akun Anda, dan voice dictation untuk menjangkau titik akhir transkripsi claude.ai. Mereka tidak tersedia sementara ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper aktif. Remote Control juga dinonaktifkan sementara ANTHROPIC_BASE_URL menunjuk ke host non-Anthropic, jadi masuk dengan claude.ai saja tidak cukup. Sebelum v2.1.196, URL dasar non-Anthropic tidak memblokir Remote Control.

Untuk mengembalikan salah satu fitur, masuk dengan claude.ai dan batalkan pengaturan variabel gateway yang diperiksa fitur tersebut. Bagian Remote Control dari claude doctor menamai apa yang saat ini memblokir Remote Control.

• Voice dictation: batalkan pengaturan kredensial gateway
• Remote Control: batalkan pengaturan kredensial gateway dan ANTHROPIC_BASE_URL

Konfigurasi tambahan

Pengaturan ini mencakup kasus di luar URL dasar dan kredensial. Atur hanya jika instruksi administrator Anda, aturan egress jaringan Anda, atau tabel pemecahan masalah memanggil satu.

Kirim header tambahan

Beberapa gateway merutekan atau menandai permintaan menggunakan header khusus selain kredensial, misalnya pengidentifikasi penyewa atau kunci perutean. Untuk mengirim satu, atur ANTHROPIC_CUSTOM_HEADERS dengan satu pasangan Name: Value per baris. Contoh di bawah menambahkan header perutean bernama X-Org-Route:

export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

Anda juga dapat mengatur ANTHROPIC_CUSTOM_HEADERS di blok env file pengaturan. Gunakan \n antara pasangan di sana, karena string JSON tidak dapat mencakup beberapa baris:

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Org-Route: prod\nX-Tenant: example"
  }
}

Header perutean dan penyewa seperti ini dihitung sebagai header yang memerlukan persetujuan. Ketika header berasal dari file pengaturan proyek, Claude Code menerapkannya di bawah aturan untuk ketika menerapkan nilai env.

Tambahkan model gateway ke pemilih model

Dengan penemuan model diaktifkan, Claude Code menanyakan gateway untuk daftar modelnya saat startup dan menambahkan nama tersebut ke pemilih /model bersama entri bawaan. Jika Anda atau administrator Anda mengatur replaceBuiltInOptions dalam lineup modelPicker, Claude Code juga menyembunyikan nama yang ditemukan. Ini menyimpan baris untuk model yang sudah digunakan sesi.

Aktifkan jika gateway Anda melayani nama model yang tidak ada dalam daftar bawaan Claude Code dan Anda ingin memilihnya dari pemilih. Jika model bawaan adalah apa yang Anda gunakan, Anda tidak memerlukan penemuan; administrator Anda mungkin juga telah mengaktifkannya melalui pengaturan terkelola.

Untuk mengaktifkannya, atur CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 di shell Anda atau di blok env dari ~/.claude/settings.json.

Model yang ditemukan muncul sebagai entri /model tambahan. Setiap entri menampilkan deskripsi yang disediakan gateway Anda untuk model, atau From gateway ketika tidak menyediakannya.

Untuk mengonfirmasi penemuan berjalan, mulai claude --debug dan cari baris [gatewayDiscovery] dalam log debug di ~/.claude/debug/<session-id>.txt. Pertama kali penemuan berhasil, Claude Code mencatat berapa banyak model yang di-cache, dan hanya mencatat lagi ketika daftar gateway berubah. 404, timeout, atau pengalihan juga muncul di sana. Untuk kapan penemuan berjalan, apa yang disaringnya, dan format respons yang dilayani gateway, lihat referensi penemuan model.

Putar kredensial dengan apiKeyHelper

apiKeyHelper adalah perintah yang dijalankan Claude Code untuk mengambil kredensial gateway Anda, alih-alih membacanya dari variabel lingkungan statis.

Gunakan pembantu ketika kredensial kedaluwarsa sesuai jadwal, berasal dari vault atau perintah SSO, atau administrator Anda mengatakan untuk mengonfigurasi satu. Jika kredensial Anda adalah string tetap yang Anda atur sekali, variabel kredensial adalah semua yang Anda butuhkan dan Anda dapat melewati bagian ini.

Pembantu adalah perintah shell apa pun yang mencetak kredensial saat ini ke stdout. Claude Code menjalankannya melalui shell sistem Anda, jadi di Windows itu dapat berupa executable atau invokasi PowerShell. Tulis skrip, buat dapat dieksekusi, dan referensikan dari apiKeyHelper di file pengaturan Anda: Pada Claude Code v2.1.227 atau lebih baru, banner atau baris log yang dicetak bersama kunci membuat pembantu gagal. Tulis skrip, buat dapat dieksekusi, dan referensikan dari apiKeyHelper di file pengaturan Anda:

#!/bin/bash
vault kv get -field=api_key secret/llm-gateway/claude-code

{
"apiKeyHelper": "~/bin/get-gateway-key.sh"
}

vault kv get -field=api_key secret/llm-gateway/claude-code

{
"apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"
}

Claude Code menyimpan output pembantu selama lima menit secara default dan menjalankan kembali pembantu setelah masa pakai cache berakhir. Untuk mengubah masa pakai, atur CLAUDE_CODE_API_KEY_HELPER_TTL_MS dalam milidetik, misalnya CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000 untuk 15 menit.

Lihat apiKeyHelper untuk kasus lain di mana Claude Code menjalankan kembali pembantu.

Nilai pembantu dikirim di header Authorization dan x-api-key, jadi berfungsi di mana pun header gateway Anda dibaca.

Matikan lalu lintas di luar jalur gateway

Gateway membawa permintaan model, tetapi Claude Code juga mengirim lalu lintas latar belakang yang tidak penting di luar jalur gateway, ke Anthropic dan ke layanan pihak ketiga seperti GitHub: pemeriksaan versi, telemetri, catatan rilis, dan permintaan serupa. Di jaringan yang hanya memungkinkan egress ke gateway, permintaan ini gagal dan dapat muncul sebagai koneksi yang diblokir dalam pemantauan egress Anda.

Claude Code melampirkan kredensial ke permintaan telemetri atau metrik penggunaan hanya ketika permintaan pergi ke host yang kredensial miliknya. Sementara ANTHROPIC_BASE_URL menunjuk ke gateway, Claude Code mengirim acara telemetrinya ke Anthropic tanpa kredensial gateway Anda. Dengan variabel kredensial atau apiKeyHelper juga aktif, Claude Code tidak melaporkan metrik penggunaan ke dasbor analitik Konsol. Sebelum v2.1.246, Claude Code dapat melampirkan kredensial gateway ke permintaan telemetri dan metrik penggunaan yang ditujukan untuk host Anthropic; permintaan model selalu pergi ke gateway dengan kredensial yang diharapkan gateway.

Untuk mematikan lalu lintas itu, atur CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 bersama variabel gateway, di ekspor shell yang sama atau blok env file pengaturan:

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

Mengatur variabel memiliki efek dan batasan ini:

• Ini menonaktifkan pembaruan otomatis, jadi rencanakan jalur pembaruan lain, seperti pengelola paket Anda atau distribusi terkelola.
• Ini menekan pemeriksaan ketersediaan mode cepat. Kecuali pemeriksaan sebelumnya telah mengaktifkan mode cepat di mesin, /fast melaporkan bahwa mode cepat tidak tersedia.
• Ini tidak mempengaruhi penemuan model gateway, yang menanyakan hanya gateway Anda. Sebelum v2.1.257, variabel juga menghentikan penemuan dari penyegaran, jadi pemilih menyimpan daftar yang sebelumnya di-cache.
• Pemeriksaan keamanan domain alat WebFetch tidak terpengaruh dan masih memanggil api.anthropic.com. Matikan secara terpisah dengan skipWebFetchPreflight: true di pengaturan jika jaringan Anda memblokir host itu.
• Untuk setiap aliran telemetri dan variabel yang mengontrolnya, lihat layanan telemetri.

Rutekan ke penyedia cloud melalui gateway

Konfigurasi ini menunjukkan Claude Code ke gateway melalui variabel URL dasar khusus penyedia sebagai pengganti ANTHROPIC_BASE_URL. Gateway Amazon Bedrock dan Google Cloud's Agent Platform menerima format permintaan asli penyedia tersebut; gateway Microsoft Foundry dan Claude Platform di AWS menerima format Anthropic Messages. Pada rute Amazon Bedrock dan Google Cloud's Agent Platform, Claude Code juga membatasi header beta dan bidang permintaan yang dikirimnya ke set yang diterima penyedia tersebut. Untuk apa yang diterima gateway Anda di setiap rute, lihat panduan kompatibilitas gateway.

Gunakan satu hanya jika tim gateway Anda secara khusus menamai Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform di AWS. Jika permintaan verifikasi di atas mengembalikan JSON, Anda dapat melewati bagian ini.

Atur blok untuk penyedia yang dinamai tim gateway Anda. Variabel skip-auth di blok Amazon Bedrock, Google Cloud's Agent Platform, dan Claude Platform di AWS memberitahu Claude Code untuk tidak menandatangani permintaan dengan kredensial penyedia cloud, karena gateway menyimpannya. Jika gateway juga memerlukan token sendiri, tempat Anda meletakkannya tergantung pada penyedia:

• Amazon Bedrock, Google Cloud's Agent Platform, atau Claude Platform di AWS: tambahkan ANTHROPIC_AUTH_TOKEN setelah blok. Claude Code mengirimnya ke gateway sebagai header Authorization: Bearer. Untuk kredensial dalam skema atau header yang berbeda, gunakan ANTHROPIC_CUSTOM_HEADERS sebagai gantinya. Jaga variabel skip-auth tetap diatur baik cara apa pun, karena tanpanya Claude Code menghapus header Authorization apa pun yang akan ditambahkan oleh ANTHROPIC_AUTH_TOKEN, apiKeyHelper, atau ANTHROPIC_CUSTOM_HEADERS.
• Microsoft Foundry: gunakan ANTHROPIC_FOUNDRY_API_KEY seperti yang ditunjukkan bloknya

Amazon Bedrock

Biarkan AWS_BEARER_TOKEN_BEDROCK tidak diatur ketika gateway mengeluarkan kredensialnya sendiri. Jika Anda mengaturnya, Claude Code mengirim kunci API Amazon Bedrock itu sebagai header Authorization alih-alih token gateway Anda, bahkan dengan CLAUDE_CODE_SKIP_BEDROCK_AUTH diatur.

export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:CLAUDE_CODE_USE_BEDROCK = "1"

Google Cloud's Agent Platform

Ganti ID proyek dan wilayah dengan nilai Anda sendiri. Claude Code menyertakan keduanya dalam jalur setiap permintaan yang dikirimnya ke gateway:

export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:CLOUD_ML_REGION = "us-east5"

Blok ini mencakup perutean dan autentikasi. Penggantian wilayah dan pin model dari pengaturan Agent Platform berlaku melalui gateway juga:

• Wilayah per-model: jika gateway Anda melayani beberapa model dari wilayah selain CLOUD_ML_REGION, atur variabel VERTEX_REGION_CLAUDE_* yang cocok untuk masing-masing, misalnya VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1. Referensi variabel lingkungan mencantumkan nama yang tepat.
• Versi model: pin ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, dan ANTHROPIC_DEFAULT_HAIKU_MODEL seperti dalam Pin model versions. Mengatur ANTHROPIC_DEFAULT_HAIKU_MODEL juga memindahkan tugas latar belakang seperti judul sesi ke model itu, dan bagian itu menjelaskan model mana yang menjalankannya sebaliknya.
• Kemampuan model: jika Anda pin ID model yang versi Claude Code Anda tidak kenal, fitur seperti tingkat upaya atau pemikiran yang diperluas dapat tetap dinonaktifkan di dalamnya. Deklarasikan apa yang didukung model dengan ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES dan rekan Sonnet dan Haiku-nya.

Microsoft Foundry

Letakkan kredensial gateway di ANTHROPIC_FOUNDRY_API_KEY; itu dikirim ke gateway sebagai header x-api-key. Gateway yang mengharapkan token bearer dapat mengambil ANTHROPIC_FOUNDRY_AUTH_TOKEN sebagai gantinya. Claude Code mengirim nilai itu sebagai header Authorization: Bearer, dan itu mengambil prioritas atas ANTHROPIC_FOUNDRY_API_KEY ketika keduanya diatur. Memerlukan Claude Code v2.1.203 atau lebih baru.

Untuk gateway yang menyuntikkan header Authorization miliknya sendiri, atur CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1 dan biarkan kedua variabel kredensial tidak diatur. Claude Code kemudian mengirim permintaan tanpa kredensial Azure dan mempertahankan header Authorization yang Anda suplai, misalnya melalui ANTHROPIC_CUSTOM_HEADERS. Sebelum v2.1.203, CLAUDE_CODE_SKIP_FOUNDRY_AUTH tanpa kunci API membuat klien Microsoft Foundry tidak dapat mengirim permintaan.

export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
export CLAUDE_CODE_USE_FOUNDRY=1

$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"
$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

Claude Platform di AWS

Lihat Claude Platform di AWS untuk ID ruang kerja.

export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"
$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"
$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"
$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

Konfirmasi rute penyedia

Mulai claude dari shell tempat Anda mengatur blok dan jalankan /status. Dengan blok Amazon Bedrock, tab Status menampilkan baris seperti ini:

API provider: Amazon Bedrock
Bedrock base URL: https://llm-gateway.example.com/bedrock
AWS auth skipped

Blok lainnya menghasilkan baris yang sama di bawah nama penyedia mereka, misalnya Vertex base URL dan GCP auth skipped untuk Google Cloud's Agent Platform; blok Microsoft Foundry menampilkan baris auth skipped hanya jika Anda mengatur CLAUDE_CODE_SKIP_FOUNDRY_AUTH. Jika Anda juga merutekan melalui proxy korporat, baris Proxy menampilkan URL proxy. Jika baris URL dasar hilang, variabel tidak mencapai sesi.

Pemecahan masalah kesalahan gateway

Ini adalah kesalahan paling umum saat menjalankan Claude Code melalui gateway, dengan penyebab sisi gateway dan perbaikannya:

Jika Claude Code meminta Anda untuk masuk berulang kali setelah menghapus konfigurasi gateway, penyebabnya biasanya penyimpanan kredensial daripada gateway; lihat kesalahan autentikasi.

Sumber daya terkait

• Ikhtisar gateway LLM: apa itu gateway dan bagaimana berinteraksi dengan langganan claude.ai
• Luncurkan gateway LLM untuk organisasi Anda: daftar periksa yang menghadap admin untuk menerapkan dan mendistribusikan konfigurasi gateway
• Panduan kompatibilitas gateway: apa yang dikirim Claude Code ke gateway, termasuk header dan bidang yang harus diteruskan gateway
• Pengaturan: di mana file pengaturan berada dan bagaimana blok env dibaca
• Autentikasi: bagaimana variabel kredensial, apiKeyHelper, dan login OAuth berinteraksi