Panduan Lengkap Variabel Lingkungan Claude Code: Mengatasi Kesalahan Kompatibilitas AWS Bedrock Hanya dengan 1 Pengaturan

Catatan Penulis: Penjelasan mendalam tentang fungsi dan cara konfigurasi semua 60+ variabel lingkungan Claude Code, dengan fokus pada penggunaan CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS untuk mengatasi error header anthropic-beta di platform pihak ketiga.

Saat menggunakan Claude Code untuk terhubung ke AWS Bedrock, Google Vertex AI, atau gateway LLM pihak ketiga lainnya, Anda kemungkinan besar akan menemui error ini: "Unexpected value(s) for the anthropic-beta header". Akar masalahnya adalah Claude Code secara default mengirimkan header Beta eksperimental khusus untuk Anthropic API, sementara platform pihak ketiga seperti AWS Bedrock tidak mengenali header tersebut.

Solusinya hanya satu baris pengaturan: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.

Namun, variabel lingkungan Claude Code jauh lebih banyak dari itu—dokumentasi resmi mencantumkan 60+ variabel lingkungan yang mencakup konfigurasi autentikasi, pemilihan model, pengoptimalan performa, sakelar fitur, dan lainnya. Artikel ini akan merangkum variabel-variabel tersebut secara sistematis untuk membantu Anda menemukan dan menyelesaikan berbagai masalah konfigurasi Claude Code dengan cepat.

Nilai Inti: Setelah membaca artikel ini, Anda akan menguasai sistem lengkap variabel lingkungan Claude Code, mampu menyelesaikan masalah kompatibilitas AWS Bedrock/Vertex AI dengan cepat, dan belajar cara mengoptimalkan pengalaman penggunaan serta biaya Claude Code melalui variabel lingkungan.

Poin Utama Variabel Lingkungan Claude Code

60+ variabel lingkungan Claude Code dapat dibagi menjadi 6 kategori utama. Berikut adalah variabel inti yang paling perlu Anda perhatikan:

Dua Cara Mengatur Variabel Lingkungan Claude Code

Cara 1: Variabel Lingkungan Shell (Berlaku Sementara)

Atur di terminal sebelum menjalankan Claude Code, hanya berlaku untuk sesi saat ini:

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export ANTHROPIC_API_KEY="your-api-key"
claude

Cara 2: Konfigurasi settings.json (Berlaku Permanen)

Konfigurasikan kolom env di ~/.claude/settings.json, akan dimuat otomatis setiap kali dijalankan:

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "ANTHROPIC_API_KEY": "your-api-key"
  }
}

🎯 Rekomendasi: Untuk pengaturan yang perlu berlaku jangka panjang (seperti API Key atau perbaikan kompatibilitas platform), disarankan menggunakan cara settings.json agar tidak perlu melakukan export manual setiap saat. Jika kunci API Anda berasal dari platform pihak ketiga seperti APIYI (apiyi.com), konfigurasikan juga di sini.

Panduan Penting Variabel Lingkungan Claude Code: Mengatasi Masalah Kompatibilitas AWS Bedrock

Penjelasan Detail CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS

Ini adalah poin utama dalam artikel ini. Saat Anda menggunakan Claude Code melalui gateway pihak ketiga seperti AWS Bedrock, Google Vertex AI, atau LiteLLM, Claude Code secara otomatis menambahkan identitas Beta eksperimental Anthropic ke dalam header permintaan, misalnya:

anthropic-beta: prompt-caching-scope-2026-01-05,advanced-tool-use-2025-11-20

Identitas Beta ini adalah fitur khusus untuk koneksi langsung ke API Anthropic. Platform pihak ketiga seperti AWS Bedrock tidak dapat mengenalinya, sehingga muncul pesan kesalahan:

Error: Unexpected value(s) for the anthropic-beta header

Solusi:

# Cara 1: Perintah Shell
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

# Cara 2: settings.json
{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Setelah diatur ke 1, Claude Code tidak akan lagi mengirimkan header Beta eksperimental tersebut, sehingga kompatibel dengan semua platform pihak ketiga.

Masalah yang Diketahui dan Solusi Sementara

Berdasarkan catatan GitHub Issues, beberapa versi Claude Code (setelah 2.1.18) memiliki masalah di mana variabel lingkungan ini tidak sepenuhnya berfungsi—meskipun CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 sudah diatur, beberapa header Beta baru (seperti advanced-tool-use-2025-11-20) tetap terkirim.

Jika Anda masih mengalami masalah, Anda bisa mencoba langkah tambahan berikut:

• Downgrade versi Claude Code: Kembali ke versi stabil yang diketahui seperti 2.1.68.
• Gunakan Gateway LiteLLM: LiteLLM menyediakan file konfigurasi anthropic_beta_headers_config.json yang memungkinkan kontrol mendetail atas header Beta mana yang akan diteruskan.
• Atur DISABLE_PROMPT_CACHING secara bersamaan: Menonaktifkan cache petunjuk dapat menghindari header Beta yang terkait dengan prompt-caching-scope.

# Pengaturan kompatibilitas penuh
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export DISABLE_PROMPT_CACHING=1

Daftar Cepat Klasifikasi Variabel Lingkungan Claude Code

Kategori 1: Autentikasi dan Konfigurasi API

Ini adalah kategori variabel lingkungan yang paling dasar dan sering digunakan, yang mengontrol bagaimana Claude Code terhubung ke layanan API:

🎯 Catatan untuk pengguna platform pihak ketiga: Saat menggunakan platform API pihak ketiga seperti APIYI apiyi.com, Anda perlu mengatur ANTHROPIC_API_KEY dan ANTHROPIC_BASE_URL secara bersamaan. Claude Code akan memprioritaskan kunci API dari variabel lingkungan, meskipun Anda sudah login dengan akun langganan Anthropic.

Kategori 2: Pemilihan dan Konfigurasi Model

Mengontrol model mana yang digunakan oleh Claude Code serta parameter perilaku model tersebut:

Kategori 3: Kompatibilitas Platform dan Konfigurasi Gateway

Variabel ini khusus untuk menyelesaikan masalah kompatibilitas antara Claude Code dengan berbagai platform cloud dan gateway LLM:

Kategori 4: Sakelar Fitur

Menonaktifkan fitur tertentu melalui variabel dengan awalan DISABLE_ atau CLAUDE_CODE_DISABLE_:

Kategori 5: Manajemen Konteks dan Performa

Mengontrol bagaimana Claude Code mengelola jendela konteks dan penggunaan sumber daya:

🎯 Saran Optimasi Performa: Jika Anda merasa Claude Code terlalu sering mengompresi konteks dalam percakapan panjang, Anda dapat mengatur CLAUDE_AUTOCOMPACT_PCT_OVERRIDE ke nilai yang lebih rendah (seperti 50) agar kompresi dipicu lebih awal, guna mengurangi kehilangan informasi. Konfigurasi variabel lingkungan ini juga didukung saat melakukan pemanggilan melalui APIYI apiyi.com.

Panduan Cepat Variabel Lingkungan Claude Code

Contoh Sederhana: Mengonfigurasi Claude Code untuk Terhubung ke Platform API Pihak Ketiga

# Atur variabel lingkungan di terminal lalu jalankan Claude Code
export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://vip.apiyi.com/v1"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://vip.apiyi.com/v1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "80",
    "DISABLE_TELEMETRY": "1"
  },
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": []
  }
}

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "DISABLE_PROMPT_CACHING": "1",
    "ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION": "us-east-1"
  }
}

{
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_BASE_URL": "https://my-resource.services.ai.azure.com/anthropic",
    "ANTHROPIC_FOUNDRY_API_KEY": "your-foundry-key",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Saran: Jika Anda tidak ingin repot dengan konfigurasi AWS Bedrock atau Azure yang rumit, Anda bisa langsung menggunakan seluruh seri model Claude melalui APIYI (apiyi.com). Cukup atur dua variabel, yaitu kunci API dan Base URL, tanpa perlu mengurus autentikasi platform cloud dan masalah kompatibilitas.

Pertanyaan yang Sering Diajukan (FAQ)

Ringkasan

Poin-poin utama variabel lingkungan Claude Code:

1. Mengatasi Error AWS Bedrock: Atur CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 untuk menonaktifkan header Beta eksperimental. Konfigurasi satu baris ini menyelesaikan kesalahan "Unexpected value(s) for the anthropic-beta header".
2. 60+ Variabel Lingkungan dalam 6 Kategori: Konfigurasi autentikasi, pemilihan model, kompatibilitas platform, sakelar fitur, manajemen konteks, dan pengaturan lainnya.
3. Dua Cara Konfigurasi: Shell export (sementara) dan settings.json (permanen). Sangat disarankan untuk menuliskan konfigurasi permanen ke dalam settings.json.
4. Solusi Penyederhanaan Platform Pihak Ketiga: Melalui platform API terpadu seperti APIYI (apiyi.com), Anda hanya perlu mengatur dua variabel yaitu ANTHROPIC_API_KEY dan ANTHROPIC_BASE_URL, tanpa perlu berurusan dengan autentikasi platform cloud yang rumit dan masalah kompatibilitas header Beta.

Kami merekomendasikan penggunaan APIYI (apiyi.com) untuk mencoba Claude Code dengan cepat. Platform ini menyediakan kuota gratis dan antarmuka terpadu, sehingga Anda bisa menghindari berbagai kendala kompatibilitas saat melakukan konfigurasi di AWS Bedrock atau Vertex AI.

📚 Referensi

1. Dokumentasi Resmi Claude Code – Variabel Lingkungan: Daftar lengkap variabel lingkungan beserta penjelasannya.

   • Link: code.claude.com/docs/en/env-vars
   • Penjelasan: Referensi otoritas resmi untuk semua 60+ variabel lingkungan.

2. Dokumentasi Resmi Claude Code – Pengaturan: Cakupan konfigurasi dan spesifikasi settings.json.

   • Link: code.claude.com/docs/en/settings
   • Penjelasan: Memahami sistem konfigurasi empat tingkat: Managed/User/Project/Local.

3. Dokumentasi Resmi Claude Code – Amazon Bedrock: Panduan integrasi AWS Bedrock.

   • Link: code.claude.com/docs/en/amazon-bedrock
   • Penjelasan: Konfigurasi khusus Bedrock dan solusi untuk masalah umum.

4. GitHub Issue #22893 – DISABLE_EXPERIMENTAL_BETAS Tidak Sepenuhnya Berfungsi: Laporan bug dari komunitas.

   • Link: github.com/anthropics/claude-code/issues/22893
   • Penjelasan: Memahami batasan yang diketahui dari variabel lingkungan ini dan solusi sementaranya.

5. LiteLLM – Manajemen Beta Header Claude Code: Solusi penyaringan header Beta di tingkat gateway.

   • Link: docs.litellm.ai/docs/tutorials/claude_code_beta_headers
   • Penjelasan: Kontrol header Beta yang lebih halus saat menggunakan gateway LiteLLM.

Penulis: Tim Teknis APIYI
Diskusi Teknis: Selamat berdiskusi tentang pengalaman konfigurasi Claude Code di kolom komentar. Untuk tutorial penggunaan lebih lanjut, silakan kunjungi pusat dokumentasi APIYI di docs.apiyi.com.