3 Solusi untuk Memperbaiki Kesalahan scope cache_control pada Claude Code Bedrock: Panduan Pemecahan Masalah Lengkap untuk Kegagalan Pemulihan Sesi –resume

Jika Anda menemui pesan error ini saat menghubungkan Claude Code dengan AWS Bedrock:

InvokeModelWithResponseStream: operation error Bedrock Runtime:
InvokeModelWithResponseStream, https response error StatusCode: 400,
RequestID: 47574f13-c884-4b12-a003-6d0cf252d8dd,
ValidationException: system.1.cache_control.***.scope:
Extra inputs are not permitted

Terutama jika sering muncul saat menggunakan --resume untuk melanjutkan sesi historis—ini adalah masalah kompatibilitas yang sudah diketahui, bukan kesalahan konfigurasi Anda.

Penyebab utamanya adalah Claude Code mengirimkan field scope yang tidak didukung oleh Bedrock. Perbaikannya cukup dengan mengatur 1 variabel lingkungan, selesai dalam 30 detik.

Nilai Inti: Setelah membaca artikel ini, Anda akan memahami akar penyebab error ini, menguasai 3 solusi perbaikan, serta mengetahui cara konfigurasi yang tepat di berbagai lingkungan seperti CLI, VS Code, dan JetBrains.

Analisis Mendalam Penyebab Error Claude Code di Bedrock

Untuk memahami error ini, Anda perlu mengetahui latar belakang penting: tingkat dukungan cache_control yang berbeda antara API asli Anthropic dan AWS Bedrock.

Akar Penyebab Teknis

Pada Januari 2026, Anthropic meluncurkan fitur Beta prompt-caching-scope-2026-01-05 pada API aslinya, yang menambahkan field scope ke objek cache_control:

{
  "cache_control": {
    "type": "ephemeral",
    "scope": "turn"
  }
}

Mulai dari Claude Code v2.1.24, field scope ini disertakan secara default dalam permintaan API.

Masalahnya adalah: AWS Bedrock tidak mengenali field scope, dan validasi skema Bedrock sangat ketat—setiap field yang tidak dikenal akan langsung menghasilkan error 400.

Singkatnya: API asli Anthropic lebih toleran dan akan mengabaikan field yang tidak dikenal. Bedrock lebih ketat dan langsung menolaknya. Claude Code mengirimkan field yang tidak dikenal oleh Bedrock, sehingga Bedrock memicu error.

🎯 Saran Teknis: Masalah ini hanya memengaruhi pengguna yang memanggil Claude melalui AWS Bedrock. Jika Anda menggunakan API asli Anthropic (misalnya melalui platform APIYI apiyi.com), Anda tidak akan menemui error ini karena API asli mendukung penuh field scope.

Mengapa --resume Lebih Sering Memicu Error

Meskipun error ini tidak eksklusif untuk --resume, penggunaan perintah ini memang lebih sering memicu masalah tersebut. Berikut alasannya:

Mekanisme internal --resume:

1. Memuat sesi historis: Membaca catatan percakapan lengkap dari ~/.claude/projects/<proyek>/<ID_sesi>.jsonl.
2. Membangun kembali konteks: Menggabungkan kembali system prompt, definisi alat, dan semua pesan historis menjadi array messages yang utuh.
3. Optimasi cache: Karena konteks yang dipulihkan biasanya besar (berisi riwayat percakapan lengkap), Claude Code akan lebih agresif dalam menetapkan titik henti cache_control pada pesan sistem untuk mengoptimalkan biaya.
4. Mengirim permintaan: Panggilan API pertama sudah menyertakan konteks yang dibangun kembali + cache_control (termasuk field scope).

Poin Kunci: Saat memulihkan sesi, konteks lebih besar → optimasi cache lebih agresif → field cache_control muncul lebih sering → probabilitas memicu error lebih tinggi.

Memulai sesi baru juga bisa memicu error, tetapi karena konteks awal lebih kecil, penanda cache mungkin tidak sepadat itu.

Solusi Perbaikan Error Claude Code Bedrock 1: Nonaktifkan Beta Eksperimental (Direkomendasikan)

Ini adalah solusi yang paling disarankan—selain memperbaiki error, fitur dasar Prompt Caching juga tetap bisa digunakan.

Prinsip Solusi

Dengan mengatur CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, Claude Code akan:

• Menghapus header Beta dari permintaan (seperti prompt-caching-scope-2026-01-05)
• Menghapus kolom scope di dalam cache_control
• Mempertahankan kolom yang didukung Bedrock seperti cache_control.type dan cache_control.ttl

Artinya, Anda tetap bisa menikmati optimasi biaya dari Prompt Caching, hanya saja fitur scope yang baru tidak digunakan.

Pengaturan Terminal CLI

macOS / Linux:

# Pengaturan sementara (hanya berlaku untuk sesi terminal saat ini)
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

# Pengaturan permanen (tambahkan ke file konfigurasi shell)
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.zshrc
source ~/.zshrc

# Jika menggunakan bash
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1' >> ~/.bashrc
source ~/.bashrc

Windows (PowerShell):

# Pengaturan sementara
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"

# Pengaturan permanen
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS", "1", "User")

Setelah diatur, jalankan saja Claude Code seperti biasa:

# Sesi baru
claude

# Melanjutkan sesi (sekarang tidak akan error lagi)
claude --resume

Pengaturan Ekstensi VS Code (Penting!)

Ekstensi VS Code tidak membaca variabel lingkungan shell—meskipun Anda sudah mengaturnya di .zshrc, ekstensi Claude Code di VS Code tidak akan membacanya. Anda harus mengaturnya melalui cara berikut:

Metode 1: Mengubah file konfigurasi global Claude (Direkomendasikan)

Edit ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Metode 2: Melalui pengaturan VS Code

Buka pengaturan VS Code → cari claude → temukan opsi konfigurasi variabel lingkungan → tambahkan CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Pengaturan IDE JetBrains

Plugin Claude Code di seri IDE JetBrains (IntelliJ, WebStorm, PyCharm, dll.) juga perlu dikonfigurasi secara terpisah:

Edit ~/.claude/settings.json (menggunakan file yang sama dengan VS Code):

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

💡 Tips: ~/.claude/settings.json adalah file konfigurasi global untuk Claude Code, yang akan dibaca oleh semua klien (CLI, VS Code, JetBrains). Mengatur variabel lingkungan di sini adalah cara paling praktis agar berlaku di semua platform sekaligus.

Solusi Perbaikan Error Claude Code Bedrock 2: Nonaktifkan Prompt Caching

Jika solusi pertama masih belum menyelesaikan masalah Anda (dalam kasus yang sangat jarang), Anda bisa menonaktifkan Prompt Caching sepenuhnya.

Prinsip Solusi

Dengan mengatur DISABLE_PROMPT_CACHING=1, Claude Code akan menghapus semua kolom cache_control dari permintaan. Tanpa cache_control, secara otomatis tidak ada scope, sehingga error akan hilang sepenuhnya.

Konsekuensi: Kehilangan optimasi biaya dari Prompt Caching. Untuk percakapan panjang, ini bisa berarti biaya token yang lebih tinggi.

Cara Pengaturan

# CLI
export DISABLE_PROMPT_CACHING=1

# ~/.claude/settings.json (berlaku untuk semua platform)
{
  "env": {
    "DISABLE_PROMPT_CACHING": "1"
  }
}

Kapan Harus Memilih Solusi 2?

Solusi Perbaikan Error Claude Code Bedrock 3: Konfigurasi "Asuransi Ganda"

Atur kedua variabel lingkungan secara bersamaan untuk memastikan semua kolom yang tidak didukung oleh Bedrock dibersihkan.

# CLI
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export DISABLE_PROMPT_CACHING=1

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "DISABLE_PROMPT_CACHING": "1"
  }
}

Ini adalah konfigurasi paling aman, cocok untuk skenario di lingkungan produksi yang membutuhkan stabilitas mutlak.

🚀 Ide Lain: Jika Anda tidak ingin repot dengan variabel lingkungan dan tidak ingin dibatasi oleh masalah kompatibilitas Bedrock, pertimbangkan untuk beralih ke API asli Anthropic. Melalui platform APIYI (apiyi.com), Anda dapat langsung mengakses antarmuka asli Anthropic, mendukung penuh semua fitur Prompt Caching (termasuk scope), dan tidak memerlukan akun AWS.

Alur Lengkap Pemecahan Masalah Error Claude Code Bedrock

Jika Anda tidak yakin solusi mana yang berlaku untuk situasi Anda, ikuti alur pemecahan masalah berikut:

Langkah 1: Konfirmasi Jenis Error

Periksa apakah pesan error mengandung kata kunci berikut:

cache_control.***.scope: Extra inputs are not permitted

atau

ValidationException: ... cache_control ... scope

Jika ya, berarti itu adalah masalah kompatibilitas kolom scope.

Langkah 2: Konfirmasi Jalur Pemanggilan

# Periksa endpoint API yang digunakan Claude Code saat ini
echo $ANTHROPIC_BASE_URL
echo $CLAUDE_CODE_USE_BEDROCK

Jika Anda mengatur CLAUDE_CODE_USE_BEDROCK=1 atau variabel terkait Bedrock lainnya seperti AWS_REGION, berarti Anda sedang menggunakan Bedrock.

Langkah 3: Terapkan Perbaikan

# Coba solusi pertama terlebih dahulu
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

# Tes apakah sudah diperbaiki
claude --resume

Langkah 4: Verifikasi Perbaikan

# Verifikasi apakah variabel lingkungan sudah aktif
echo $CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS
# Seharusnya menampilkan: 1

# Tes sesi baru
claude

# Tes pemulihan sesi
claude --resume

Langkah 5: Jika Masih Error

# Tambahkan solusi kedua
export DISABLE_PROMPT_CACHING=1

# Periksa juga settings.json
cat ~/.claude/settings.json

Pastikan format settings.json sudah benar:

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
    "DISABLE_PROMPT_CACHING": "1"
  }
}

🎯 Saran Teknis: Jika Anda menggunakan gateway proksi seperti LiteLLM untuk terhubung ke Bedrock, LiteLLM sejak Maret 2026 telah menyertakan fitur pembersihan otomatis untuk kolom scope (PR #22867). Memperbarui ke versi terbaru LiteLLM juga dapat menyelesaikan masalah ini. Jika Anda mencari solusi akses API Claude yang lebih stabil, APIYI (apiyi.com) menyediakan saluran API asli Anthropic yang secara alami tidak terpengaruh oleh batasan kompatibilitas semacam ini.

Masalah Kompatibilitas Umum Lainnya pada Claude Code Bedrock

cache_control.scope bukanlah satu-satunya kendala kompatibilitas di Bedrock. Berikut adalah masalah serupa yang sering ditemui pengguna Bedrock:

Sebagian besar masalah dapat diselesaikan secara menyeluruh dengan CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, karena field yang tidak didukung ini pada dasarnya adalah fitur Beta dari API asli Anthropic.

💰 Optimasi Biaya: Prompt Caching di Bedrock hanya mendukung TTL 5 menit dan 1 jam. Jika skenario penggunaan Anda sangat bergantung pada caching, mengakses API asli Anthropic melalui APIYI (apiyi.com) dapat memberikan strategi caching yang lebih fleksibel sekaligus menghindari biaya troubleshooting akibat masalah kompatibilitas di atas.

FAQ Masalah Error Claude Code Bedrock

{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Tabel Cepat Perbaikan Error Claude Code Bedrock

Ringkasan

Error cache_control.scope: Extra inputs are not permitted saat menggunakan Claude Code melalui AWS Bedrock disebabkan oleh ketidakcocokan: Bedrock tidak mendukung kolom scope Beta yang ada pada API asli Anthropic.

Cara perbaikan tercepat:

# Di CLI
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

// Di ~/.claude/settings.json (Direkomendasikan, berlaku untuk semua platform)
{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Tiga poin penting untuk diingat:

1. Ini bukan kesalahan Anda—ini adalah perbedaan fitur antara Bedrock dan API Anthropic.
2. Pengguna VS Code wajib menyetelnya di settings.json—variabel lingkungan shell tidak akan terbaca oleh ekstensi VS Code.
3. --resume bukan penyebab utama—semua pemanggilan Bedrock bisa memicu error ini, --resume hanya membuatnya lebih sering muncul.

Jika Anda tidak ingin pusing dengan masalah kompatibilitas Bedrock, beralih ke API asli Anthropic adalah solusi permanen. Melalui APIYI (apiyi.com), Anda bisa mengakses API Claude asli dengan cepat, mendukung semua fitur secara penuh tanpa perlu infrastruktur AWS.

Penulis: Tim Teknis APIYI
Diskusi Teknis: Kunjungi APIYI di apiyi.com untuk tutorial penggunaan Claude Code dan dukungan teknis lainnya
Tanggal Pembaruan: April 2026
Versi yang Berlaku: Claude Code v2.1.24+, AWS Bedrock

Referensi:

1. GitHub Issue #23220: Error cache_control.scope pada Claude Code v2.1.24+
   • Tautan: github.com/anthropics/claude-code/issues/23220
2. GitHub Issue #41731: Ekstensi VS Code mengirim kolom scope yang tidak didukung
   • Tautan: github.com/anthropics/claude-code/issues/41731
3. Dokumentasi Prompt Caching AWS Bedrock:
   • Tautan: docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html
4. Dokumentasi Prompt Caching Anthropic:
   • Tautan: docs.anthropic.com/en/docs/build-with-claude/prompt-caching
5. Dokumentasi Resmi Claude Code di Amazon Bedrock:
   • Tautan: docs.anthropic.com/en/docs/claude-code/bedrock