" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` dan sesi tetap dimulai. **Yang harus dilakukan:** * Pilih advisor berperingkat lebih tinggi atau model utama berperingkat lebih rendah. [Pilih model advisor](/docs/id/advisor#choose-an-advisor-model) menampilkan peringkat dan mencantumkan advisor yang diterima untuk setiap model utama. * Biarkan advisor tetap diatur jika Anda ingin [subagent](/docs/id/sub-agents) yang modelnya dapat diberi saran olehnya tetap menggunakannya Sebelum v2.1.287, Claude Code memberi peringkat beberapa pasangan secara berbeda. Claude Code menampilkan catatan ini untuk advisor Sonnet 5.5 dengan model utama Opus 4.7 atau Opus 4.8, pasangan yang kini diterimanya. Claude Code juga melampirkan beberapa advisor yang kini menghasilkan catatan ini, seperti advisor Opus 4.8 dengan model utama Sonnet 5.5.

thinking.type.enabled tidak didukung untuk model ini

Versi Claude Code Anda lebih lama dari minimum untuk model yang dipilih. CLI mengirim konfigurasi thinking yang model tidak lagi terima. ```text theme={null} API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior. ``` **Yang harus dilakukan:** * Jalankan `claude update` dan mulai ulang Claude Code. Opus 4.7 memerlukan v2.1.111 atau lebih baru. Opus 4.8 memerlukan v2.1.154 atau lebih baru. Sonnet 5 memerlukan v2.1.197 atau lebih baru. Opus 5 memerlukan v2.1.219 atau lebih baru. Opus 5.5 memerlukan v2.1.280 atau lebih baru. Sonnet 5.5 memerlukan v2.1.284 atau lebih baru * Di [saluran rilis stable](/docs/id/setup#configure-release-channel), pembaruan tidak memindahkan Anda melewati rilis stable terbaru, yang masih dapat lebih lama dari versi-versi ini. Pindah ke saluran latest, lalu perbarui * Jika Anda tidak dapat meningkatkan, jalankan `/model` dan pilih Opus 4.6 atau Sonnet 4.6 sebagai gantinya * Jika Anda mengalami ini di [Agent SDK](/docs/id/agent-sdk/overview), tingkatkan paket SDK sebagai gantinya. Opus 4.8 memerlukan TypeScript SDK v0.3.154 atau lebih baru dan Python SDK v0.2.88 atau lebih baru. Sonnet 5 memerlukan TypeScript SDK v0.3.197 atau lebih baru. Opus 5 memerlukan TypeScript SDK v0.3.219 atau lebih baru. Opus 5.5 memerlukan TypeScript SDK v0.3.280 atau lebih baru. Sonnet 5.5 memerlukan TypeScript SDK v0.3.284 atau lebih baru

Effort tidak tersedia dengan thinking dimatikan

Anda mematikan [extended thinking](/docs/id/model-config#extended-thinking) dan berjalan pada [tingkat effort](/docs/id/model-config#adjust-effort-level) di atas `high`. Model tidak menerima kombinasi itu, jadi API menolak permintaan. ```text theme={null} API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0) ``` Petunjuk setelah `·` bervariasi menurut sesi: dalam sesi non-interaktif itu berbunyi `use --effort high (or the effortLevel setting)`, dan dalam sesi yang aplikasi Claude Desktop jalankan itu berbunyi `you can lower effort to High`. **Yang harus dilakukan:** * [Turunkan tingkat effort](/docs/id/model-config#set-the-effort-level) ke `high` atau di bawah. * Aktifkan thinking kembali, misalnya dengan membatalkan [`MAX_THINKING_TOKENS`](/docs/id/env-vars) atau menghapus [`"alwaysThinkingEnabled": false`](/docs/id/settings-reference#alwaysthinkingenabled) dari pengaturan Anda. Sebelum v2.1.242, Claude Code menampilkan pesan API sendiri: `API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.` Sebelum v2.1.251, Claude Code mengirim permintaan pada tingkat effort yang Anda atur, jadi Opus 5 menolak setiap permintaan di atas `high` dengan thinking dimatikan. Claude Code sekarang mengirim effort `high` sebagai gantinya ke model yang diketahui menolak kombinasi, seperti Opus 5.

Thinking budget melebihi batas output

Thinking budget extended thinking yang dikonfigurasi melebihi panjang respons maksimum, jadi tidak ada ruang yang tersisa untuk jawaban sebenarnya. ```text theme={null} API Error: 400 ... max_tokens must be greater than thinking.budget_tokens ``` **Yang harus dilakukan:** * Naikkan [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/id/env-vars) di atas thinking budget * Lihat [Extended thinking](/docs/id/model-config#extended-thinking) untuk bagaimana budget berinteraksi dengan panjang output

Response exceeded the output token maximum

Balasan Claude mencapai jumlah token output terbesar yang diizinkan permintaan dan terpotong di sana: ```text theme={null} API Error: Claude's response exceeded the ... output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable. API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit. ``` Bentuk yang menyebut `a request sent without streaming` berarti permintaan streaming gagal dan Claude Code mengirim ulang tanpa streaming, yang membatasi balasan hingga 64.000 token output. Sebelum v2.1.299, balasan yang terpotong pada permintaan yang dikirim ulang seperti itu mengakhiri giliran tanpa pesan ini, seolah-olah balasannya lengkap. **Yang harus dilakukan:** * Jika Claude menulis sebagian teks sebelum balasan terpotong, balas `continue` dalam sesi interaktif untuk meminta sisanya. Teks tersebut tetap ada dalam percakapan. * Jika pesannya meminta Anda mengatur `CLAUDE_CODE_MAX_OUTPUT_TOKENS`, lihat [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/id/env-vars) untuk bagaimana nilainya dibatasi dan [Mengatur environment variable](/docs/id/env-vars#set-environment-variables) untuk tempat mengaturnya * Agar setiap balasan tetap di bawah batas, minta Claude memberikan output dalam bagian-bagian yang lebih kecil, seperti satu file atau satu bagian per balasan

Ketidakcocokan blok penggunaan tool atau thinking

Riwayat percakapan mencapai API dalam keadaan tidak konsisten. ```text theme={null} API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation. API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation. API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation. API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks API Error: 400 ... thinking blocks ... cannot be modified ``` Semua varian berarti hal yang sama: urutan blok `tool_use`, `tool_result`, dan `thinking` dalam riwayat tidak lagi cocok dengan apa yang API harapkan. **Yang harus dilakukan:** * Jika Anda menggunakan Opus 4.7 atau Opus 4.8, jalankan `claude update` terlebih dahulu. Versi sebelum v2.1.156 dapat memicu kesalahan ini selama penggunaan tool normal, dan `/rewind` tidak menghapusnya. * Jalankan `/rewind`, atau tekan Esc dua kali, untuk mundur ke checkpoint sebelum giliran yang rusak dan lanjutkan dari sana. Lihat [Checkpointing](/docs/id/checkpointing) untuk bagaimana checkpoint dibuat dan dipulihkan.

Data tidak valid dalam blok redacted\_thinking

API menolak permintaan dengan 400 karena tidak dapat menerima blok `redacted_thinking` yang dibawa giliran sebelumnya dalam riwayat percakapan. ```text theme={null} API Error: 400 ... Invalid `data` in `redacted_thinking` block ``` Claude Code meninggalkan thinking percakapan sebelumnya dari permintaan dan mencoba ulang sekali, jadi sesi berlanjut tanpa menampilkan kesalahan. Sebelum v2.1.282, Claude Code menyimpan blok yang ditolak, dan setiap giliran berikutnya gagal dengan kesalahan yang sama. **Yang harus dilakukan:** * Jika Anda di v2.1.281 atau lebih awal dan setiap giliran gagal dengan kesalahan ini, jalankan `claude update` dan lanjutkan sesi * Jika kesalahan berlanjut, jalankan `/clear` untuk memulai percakapan yang tidak membawa blok

Konten tool yang tidak didukung dihapus

Ketika Claude Code terhubung langsung ke Anthropic API dan memuat atau melihat pratinjau sesi yang disimpan, Claude Code menghapus konten tool yang Anthropic API tidak terima dan meninggalkan baris ini di tempat konten yang dihapus berada di antara dua thinking block: ```text theme={null} [Unsupported tool content removed] ``` Konten seperti itu mencapai file sesi ketika sesuatu selain Anthropic API menjawab dalam format API, biasanya proxy pihak ketiga yang diatur melalui [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) yang menerjemahkan panggilan tool penyedia lain. Claude Code menghapusnya hanya ketika sesi terhubung langsung ke Anthropic API, dan memuat riwayat yang disimpan apa adanya ketika sesi berjalan melalui proxy atau di penyedia lain. Sebelum v2.1.246, Claude Code mengirim penggunaan tool dan hasilnya kembali ke API, dan setiap giliran sesi yang dilanjutkan gagal dengan kesalahan 400 seperti `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...`. **Yang harus dilakukan:** * Tidak ada yang diperlukan ketika Anda melihat baris placeholder. Sesi berlanjut tanpa konten yang dihapus. * Jika setiap giliran sesi yang dilanjutkan gagal dengan kesalahan 400 sebagai gantinya, jalankan `claude update` dan lanjutkan sesi lagi. Versi sebelum v2.1.246 tidak menghapus konten.

role 'system' harus mendahului pesan 'assistant'

API menolak permintaan dengan 400 karena pesan sistem berada pada posisi dalam percakapan yang tidak diterimanya: ```text theme={null} API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ... ``` Claude Code mengirim beberapa teks pengingat dan lampiran-nya sebagai pesan sistem di dalam percakapan. Ketika API menolak posisi salah satunya, Claude Code mencoba ulang permintaan sekali dengan teks itu dikirim sebagai pesan pengguna biasa sebagai gantinya. Pesan penempatan serupa dari API, seperti `use the top-level 'system' parameter for the initial system prompt`, mendapatkan pemulihan yang sama. Ketika kesalahan muncul, pesan sistem yang ditolak bukan yang Claude Code dapat hapus. Itu biasanya berarti proxy atau [gateway LLM](/docs/id/llm-gateway) antara Claude Code dan API menambahkan pesan sistemnya sendiri. **Yang harus dilakukan:** * Jika kesalahan berulang pada setiap giliran di belakang proxy atau gateway yang dikonfigurasi melalui [`ANTHROPIC_BASE_URL`](/docs/id/env-vars), terhubung tanpa proxy untuk mengkonfirmasi sumber, dan laporkan kesalahan ke siapa pun yang mengoperasikannya * Jalankan `/clear` untuk memulai percakapan segar. Jika kesalahan kembali di sana juga, penyebabnya ada di jalur permintaan, bukan di percakapan yang disimpan. Sebelum v2.1.280, Claude Code tidak mengenali pesan ini, jadi kesalahan juga muncul ketika pesan sistem yang ditolak adalah yang Claude Code sendiri kirim, dan setiap giliran berikutnya dalam percakapan gagal dengan cara yang sama.

Encrypted\_content tidak valid dalam blok search\_result

API menolak permintaan dengan 400 karena riwayat percakapan menyimpan konten pencarian web yang dihosting yang tidak dapat didekripsi. Pesan menyebutkan bidang yang tidak dapat dibacanya: ```text theme={null} API Error: 400 ... Invalid `encrypted_content` in `search_result` block API Error: 400 ... Invalid `encrypted_index` in `text` block API Error: 400 ... Failed to decrypt web search result content API Error: 400 ... Invalid `encrypted_stdout` in `encrypted_code_execution_result` block ``` Hasil dari [tool pencarian web yang dihosting](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool) API membawa bidang terenkripsi yang hanya dapat dibaca oleh API. Pesan `encrypted_stdout` menyebutkan output program eksekusi kode yang dihosting yang membaca hasil seperti itu; output tersebut juga dienkripsi oleh API. API menolak permintaan yang memutar ulang konten yang tidak dapat didekripsi, seperti konten yang diproduksi untuk organisasi berbeda. [Tool WebSearch](/docs/id/tools-reference#websearch-tool-behavior) Claude Code sendiri mencatat hasil pencarian sebagai teks biasa, jadi blok ini biasanya mencapai percakapan melalui proxy atau [gateway LLM](/docs/id/llm-gateway) yang menjalankan pencarian web yang dihosting itu sendiri. Untuk tiga pesan pencarian web, Claude Code meninggalkan panggilan pencarian, hasil, dan kutipan dari apa yang dikirimnya dan mencoba ulang permintaan sekali, jadi sesi berlanjut tanpa menampilkan kesalahan. Pesan `encrypted_stdout` tidak memiliki pemulihan seperti itu, jadi pesan itu masih mencapai Anda. Sebelum v2.1.282, Claude Code menyimpan blok pencarian web yang ditolak juga, dan setiap giliran berikutnya dan `/compact` gagal dengan cara yang sama. **Yang harus dilakukan:** * Jika Anda di v2.1.281 atau lebih awal dan setiap giliran gagal dengan salah satu pesan pencarian web, jalankan `claude update` dan lanjutkan sesi * Jika kesalahan berlanjut, atau pesan menyebutkan `encrypted_stdout`, jalankan `/rewind` untuk mundur ke checkpoint sebelum giliran yang menambahkan konten, atau jalankan `/clear` untuk memulai percakapan yang tidak membawanya * Jika Anda menjalankan Claude Code di belakang proxy atau gateway, laporkan kesalahan ke siapa pun yang mengoperasikannya

Penolakan Kebijakan Penggunaan

API menolak untuk merespons karena konten dalam percakapan memicu pemeriksaan [Kebijakan Penggunaan](https://www.anthropic.com/legal/aup). Jika pesan menyertakan baris `` Details: `[reasoning_extraction]` ``, lihat [Pengaman menandai permintaan untuk penalaran Claude](#safeguards-flagged-a-request-for-claudes-reasoning). Pesan menyertakan ID Permintaan dan ID Pesan yang dapat Anda kutip kepada dukungan jika Anda yakin penolakan tidak benar. ```text theme={null} API Error: Opus 4.6 can't help with this. Start a new session to continue. Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup ``` Pesan menyebutkan model yang menolak, atau `Claude` ketika tidak ada model yang dicatat. Pemeriksaan mengevaluasi seluruh percakapan, bukan hanya prompt terbaru Anda, jadi mengirim pesan baru dalam sesi yang sama biasanya memicu ulang penolakan yang sama. Hal yang sama berlaku setelah keluar dan membuka kembali sesi dengan `--continue` atau `--resume`, karena transkrip di disk masih berisi konten yang memicu. Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), pesan ini juga mencakup permintaan yang ditandai oleh langkah-langkah keselamatan model sebagai topik keamanan siber. Lihat [Langkah-langkah keselamatan menandai topik keamanan siber](#safety-measures-flagged-a-cybersecurity-topic). Sebelum v2.1.219, pesan berbunyi `Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.` **Yang harus dilakukan:** * Tekan Esc dua kali atau jalankan `/rewind` untuk mundur ke checkpoint sebelum giliran yang memicu penolakan, lalu ubah susunan kata atau ambil pendekatan berbeda. Lihat [Checkpointing](/docs/id/checkpointing). * Jika Anda tidak dapat mengidentifikasi giliran mana yang menyebabkannya, jalankan `/clear` untuk memulai percakapan segar dalam proyek yang sama. Percakapan sebelumnya Anda disimpan di disk dan tetap tersedia di `/resume`. * Dalam [mode non-interaktif](/docs/id/headless) (`-p`), di mana rewind tidak tersedia, coba lagi dengan prompt yang diubah dalam sesi baru tanpa `--continue`. Pemeriksaan kebijakan bervariasi menurut model, jadi beralih ke model berbeda dengan `--model` juga dapat menyelesaikan penolakan dalam beberapa kasus.

Langkah-langkah keselamatan menandai topik keamanan siber

Langkah-langkah keselamatan model menandai konten dalam percakapan sebagai topik keamanan siber. Pesan menyebutkan model yang menandai permintaan: ```text theme={null} API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude ``` Jika pesan menyertakan baris `` Details: `[reasoning_extraction]` ``, lihat [Pengaman menandai permintaan untuk penalaran Claude](#safeguards-flagged-a-request-for-claudes-reasoning). Pesan ini menautkan ke [Program Verifikasi Siber](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), yang memberikan akses untuk pekerjaan keamanan siber yang sah. Model dengan [fallback model otomatis](/docs/id/model-config#automatic-model-fallback) menampilkan pesan berbeda, tanpa tautan ini; di Opus 5.5 dan Sonnet 5.5 pesan itu dibuka dengan `'s safeguards flagged this session`. Bagian tersebut juga membahas kapan Claude Code beralih model sebagai gantinya. Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), penandaan keamanan siber menghasilkan pesan [Penolakan Kebijakan Penggunaan](#usage-policy-refusal) sebagai gantinya. **Yang harus dilakukan:** * Jika pekerjaan Anda memerlukan konten ini, ajukan permohonan akses melalui [Program Verifikasi Siber](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude) * Jika permintaan Anda bukan tentang topik keamanan siber, jalankan `/feedback` untuk melaporkan positif palsu * Untuk terus bekerja dalam sesi yang sama, tekan Esc dua kali atau jalankan `/rewind` untuk mundur ke checkpoint sebelum giliran yang memicu penandaan, lalu ambil pendekatan berbeda. Lihat [Checkpointing](/docs/id/checkpointing). Jika pesan yang Anda lihat memiliki susunan kata seperti salah satu dari berikut ini, itu adalah penandaan yang sama pada versi Claude Code yang lebih lama: * Dari v2.1.219 hingga v2.1.296, pesan tersebut juga dapat menyertakan `Apply to the Cyber Verification Program to reduce these interruptions.` sebelum kalimat penutupnya * Dari v2.1.203 hingga v2.1.218, pesan tersebut berbunyi ` has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center:` diikuti oleh tautan pusat bantuan yang sama. Dalam sesi interaktif, pesan tersebut dilanjutkan dengan `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.` * Sebelum v2.1.203, pesan tersebut berbunyi `'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` diikuti oleh tautan formulir pengecualian

Pengaman menandai permintaan untuk penalaran Claude

API menolak permintaan karena pengaman menandainya sebagai meminta model untuk mereproduksi penalaran internalnya dalam respons. API menamai [kategori penolakan](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#refusal-response) ini `reasoning_extraction`, dan pesan penolakan menyertakan baris ini: ```text theme={null} Details: `[reasoning_extraction]` ``` Sebelum v2.1.234, pesan penolakan tidak menyertakan baris `Details`. **Yang harus dilakukan:** * Hapus atau ubah susunan kata instruksi apa pun yang meminta Claude menuliskan thinking atau penalarannya kata demi kata atau dalam format tetap, seperti bagian ``, bagian scratchpad, atau bidang `reasoning` dalam output JSON. Instruksi tersebut dapat berada dalam prompt Anda atau dalam kustomisasi yang dimuat Claude Code bersamanya, seperti CLAUDE.md, skill, prompt subagent, gaya output, atau deskripsi tool MCP. * Untuk memeriksa apakah kustomisasi adalah pemicunya, jalankan [`claude --safe-mode`](/docs/id/cli-reference#cli-flags) di terminal Anda untuk memulai sesi dengan kustomisasi dinonaktifkan, lalu kirim prompt yang sama * Setelah Anda mengubah kustomisasi, mulai sesi baru * Untuk mengubah susunan kata prompt yang sudah Anda kirim, lihat [Rewind dan rangkum](/docs/id/checkpointing#rewind-and-summarize) * Anda masih dapat meminta Claude menjelaskan jawabannya. Minta penjelasan singkat, bukti di balik suatu hasil, atau ringkasan tindakan yang diambilnya. Untuk membaca ringkasan pemikiran Claude, lihat [`showThinkingSummaries`](/docs/id/settings-reference#showthinkingsummaries). * Untuk contoh lainnya, dan apa yang harus dilakukan jika permintaan yang sudah diubah susunan katanya masih ditolak, lihat [Simpan penalaran dalam thinking block](https://platform.claude.com/docs/en/build-with-claude/refusals-and-fallback#keep-reasoning-in-thinking-blocks)

Output blocked by content filtering policy

Filter konten output API menghentikan respons yang sedang dihasilkan Claude. Teks pesan berasal dari API: ```text theme={null} API Error: Output blocked by content filtering policy ``` **Yang harus dilakukan:** * Ubah susunan kata pesan terakhir Anda atau ambil pendekatan berbeda * Untuk mundur ke checkpoint sebelum giliran yang memicu pemblokiran, tekan Esc dua kali atau jalankan `/rewind`. Lihat [Checkpointing](/docs/id/checkpointing)

Kesalahan baris perintah

Kesalahan ini berasal dari baris perintah `claude` dan subperintahnya, dari nama perintah yang Anda kirimkan di prompt, dan dari perintah seperti `/security-review` yang mengumpulkan konteks dengan menjalankan perintah shell sebelum prompt-nya berjalan. Kesalahan ini juga berasal dari `/tui`, yang meluncurkan ulang CLI.

Konflik antara `--bg` dan `--print`

Pesan ini memerlukan Claude Code v2.1.198 atau yang lebih baru. Anda menggabungkan `--bg` dengan `-p` atau `--print` dalam pemanggilan `claude` yang sama. `--bg` memulai [sesi latar belakang](/docs/id/agent-view#from-your-shell) yang nantinya Anda sambungkan dengan `claude agents`, sedangkan `--print` berjalan secara [non-interaktif](/docs/id/headless) dan tidak pernah memulai sesi interaktif yang disambungkan oleh `claude agents`. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah dapat disambungkan. ```text theme={null} --bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg ''`. ``` **Yang perlu dilakukan:** * Hapus `-p` atau `--print`. `--bg` menerima prompt sebagai argumen posisionalnya, sehingga `claude --bg ""` adalah perintah lengkapnya. Lihat [Dispatch agent baru dari shell Anda](/docs/id/agent-view#from-your-shell). * Untuk menjalankan prompt secara non-interaktif dan mencetak hasilnya alih-alih membuat sesi latar belakang, hapus `--bg` dan jalankan `claude -p ""`

Couldn't tell whether `--bg` is a flag or text

Anda menjalankan `claude` dengan `--bg` atau `--background` pada posisi di mana Claude Code tidak dapat membedakan apakah Anda memaksudkannya sebagai flag latar belakang atau sebagai teks. Perintah tersebut tidak memulai apa pun, mencetak baris ini, dan keluar dengan kode 1: ```text theme={null} Couldn't tell whether --bg is a flag or text here, so nothing was started. To start a background session put it first: claude --bg ``` Jika Anda mengetik `--background`, baris tersebut akan menyebut `--background` sebagai gantinya. **Yang harus dilakukan:** * Untuk memulai [sesi latar belakang](/docs/id/agent-view#from-your-shell), jalankan kembali perintah di shell Anda dengan flag diletakkan pertama: `claude --bg --name nightly-audit ""`

Konflik antara flag system prompt dan bentuk file-nya

Anda memberikan [`--append-subagent-system-prompt`](/docs/id/cli-reference#cli-flags) bersama dengan `--append-subagent-system-prompt-file` dalam satu pemanggilan `claude`, sehingga `claude` keluar dengan kode 1 alih-alih memulai sesi: ```text theme={null} Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one. ``` Sebelum v2.1.283, `claude` keluar dengan cara yang sama ketika Anda memberikan `--system-prompt` dengan `--system-prompt-file`, atau `--append-system-prompt` dengan `--append-system-prompt-file`, karena pasangan tersebut berkonflik alih-alih [digabungkan](/docs/id/cli-reference#system-prompt-flags). Pada versi tersebut, pesan menyebutkan pasangan yang Anda gabungkan. **Yang perlu dilakukan:** * Pertahankan satu bentuk flag dan hapus yang lain. Untuk menggabungkan file prompt tetap dengan teks per-run, gabungkan teks tersebut ke dalam file sebelum meluncurkan alih-alih memberikan kedua flag

Konfigurasi `--agents` tidak valid

Nilai yang Anda berikan ke `--agents` tidak valid, sehingga `claude` keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda memberikan `--safe-mode` atau mengatur [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars#variables), Claude Code mengabaikan `--agents` sepenuhnya. Dengan `--resume` atau `--continue`, nilai JSON inline tidak diperiksa dan sesi dimulai; nilai yang dibaca dari file diperiksa pada setiap peluncuran. Sebelum v2.1.242, Claude Code tetap memulai sesi. ```text theme={null} Error: Invalid --agents configuration: ``` Apa yang mengikuti baris pertama bergantung pada bagaimana nilai tersebut gagal. Claude Code menjalankan pemeriksaan ini secara berurutan dan berhenti pada pemeriksaan pertama yang gagal. Jika nilai Anda memiliki dua jenis masalah, Anda baru melihat masalah kedua setelah memperbaiki yang pertama: 1. Ketika nilai diawali dengan `{` tetapi tidak dapat diurai sebagai JSON, atau isi file `--agents` tidak dapat diurai, Claude Code mencetak satu baris `invalid JSON:` yang memuat pesan dari pengurai JSON itu sendiri 2. Ketika nilai dapat diurai tetapi definisi agent tidak sesuai dengan skema untuk [subagent yang didefinisikan melalui CLI](/docs/id/sub-agents#choose-the-subagent-scope), Claude Code mencetak satu baris per masalah 3. Ketika nama agent diawali dengan `-`, Claude Code mencetak `: agent names must not start with '-'` Ketika terdapat lebih dari 20 baris masalah, Claude Code mencetak 20 baris pertama dan mengganti sisanya dengan `…and N more`. Dengan `--print`, `--agents` juga menerima [path ke file JSON](/docs/id/sub-agents#choose-the-subagent-scope) sebagai pengganti objek inline. Sebelum v2.1.281, `--agents` hanya menerima JSON inline dan memperlakukan path file sebagai JSON yang tidak valid. Bentuk file memiliki penolakannya sendiri, yang dicetak sebagai pengganti pesan ini, termasuk yang berikut: * **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code membaca nilai sebagai path file dalam sesi interaktif. Berikan definisi sebagai JSON inline, atau tambahkan `-p` untuk membacanya dari file. * **`Error: --agents file not found: `**: tidak ada file di path tersebut. Nilai yang tidak diawali dengan `{` dan bukan JSON yang valid dibaca sebagai path, sehingga JSON inline yang dirusak oleh shell Anda juga dapat gagal dengan cara ini. Periksa path atau tanda kutipnya dan jalankan perintah lagi. **Yang perlu dilakukan:** * Perbaiki setiap masalah yang dicantumkan pesan, lalu jalankan perintah lagi. Lihat [field yang diterima subagent yang didefinisikan melalui CLI](/docs/id/sub-agents#choose-the-subagent-scope).

Sesi cloud tidak dapat dibuat dari sesi `--restricted`

Ketika Anda memulai sesi dengan [`--restricted`](/docs/id/cli-reference#cli-flags), Claude Code menolak membuat [sesi cloud](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) darinya, karena sesi baru akan berjalan di luar proses yang dibatasi dan tidak akan menerapkan mode terbatas. Claude Code menolak di sisi klien, sebelum menghubungi server, sehingga tidak ada sesi cloud yang dibuat: ```text theme={null} Cloud sessions cannot be created from a --restricted session: they would not enforce it. ``` **Yang perlu dilakukan:** * Jalankan tugas secara lokal di sesi terbatas * Jika Anda mengendalikan cara sesi diluncurkan, mulai sesi `claude` baru tanpa `--restricted` dan buat sesi cloud dari sana Sebelum v2.1.248, Claude Code tidak memiliki flag `--restricted`; versi sebelumnya menolak flag itu sendiri dengan kesalahan opsi tidak dikenal.

Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda

Kebijakan `allow_remote_sessions` organisasi Anda dimatikan, sehingga [sesi cloud](/docs/id/claude-code-on-the-web) dan perintah yang menggunakannya tidak tersedia: ```text theme={null} Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them. ``` Pesan ini muncul ketika Anda [membuat sesi cloud dari terminal](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) dan ketika Anda mengirimkan perintah yang memerlukan sesi cloud, seperti `/teleport`, `/remote-env`, atau `/web-setup`. Sebelum v2.1.268, mengirimkan salah satu perintah tersebut mengembalikan [`Unknown command`](#unknown-command). Jika pesan justru menyebutkan kredensial yang digunakan sesi ini dan diakhiri dengan `Cloud sessions use your claude.ai login.`, lihat [Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login). Jika Claude Code sama sekali tidak dapat memuat kebijakan organisasi Anda, Anda akan melihat [pesan yang berbeda](#couldnt-verify-your-organizations-policy-for-cloud-sessions) sebagai gantinya. **Yang perlu dilakukan:** * Minta [Owner](/docs/id/server-managed-settings#access-control) di organisasi Anda untuk mengaktifkan sesi cloud di pengaturan admin Claude Code di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) Ketika [penolakan kebijakan](#cloud-sessions-are-disabled-by-your-organizations-policy) menyebutkan kredensial yang digunakan sesi ini dan diakhiri dengan kalimat ini, Claude Code memeriksa kebijakan sesi cloud dari organisasi yang menerbitkan kredensial tersebut. Organisasi tersebut dapat berbeda dari organisasi tempat login claude.ai Anda berada: ```text theme={null} Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login. ``` Kalimat terakhir berarti bahwa sesi cloud berjalan dengan login claude.ai Anda, bukan dengan kredensial tersebut. Bentuk ini muncul ketika Anda memulai, melanjutkan, atau mengirim pesan ke sesi cloud dari shell Anda, seperti dengan `--cloud` atau `--teleport`. Sebelum v2.1.296, Claude Code juga mencetak bentuk yang meminta Anda menghubungi admin organisasi dalam kasus ini.

Couldn't verify your organization's policy for cloud sessions

Pesan-pesan ini berarti Claude Code tidak dapat memuat kebijakan organisasi Anda, yang diperiksanya sebelum membuat, melanjutkan, atau mengirim pesan ke [sesi cloud](/docs/id/claude-code-on-the-web). Selama permintaan kebijakan belum selesai, pesannya adalah: ```text theme={null} Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again. ``` Di dalam sesi, perintah yang memerlukan sesi cloud, seperti `/teleport` atau `/web-setup`, juga memberikan pesan ini. Hal ini terjadi bahkan ketika shell Anda akan mencetak bentuk `Cloud sessions aren't available:`, dan kalimat keduanya berbunyi `Check your network connection, then restart Claude Code and try again.` Setelah permintaan kebijakan gagal, pesan menyebutkan apa yang gagal. Hal ini berlaku ketika Anda memulai, melanjutkan, atau mengirim pesan ke sesi cloud dari shell Anda dengan flag seperti `--cloud` atau `--teleport`. Tanpa rute ke API, pesannya berbunyi: ```text theme={null} Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy. ``` Kegagalan lain mengikuti pembuka yang sama dengan penyebabnya masing-masing, seperti proxy yang menolak permintaan dengan HTTP 403, kesalahan server, atau kredensial yang tidak diterima API. Ketika API tidak menerima kredensial yang digunakan sesi ini sebagai pengganti login claude.ai Anda, seperti environment variable `ANTHROPIC_API_KEY`, pesan juga dapat menyebutkannya dan meminta Anda untuk menghapusnya: ```text theme={null} Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions. ``` Sebelum v2.1.296, kegagalan ini juga mencetak pesan `Couldn't verify`. **Yang harus dilakukan:** * Untuk pesan `Couldn't verify`, periksa koneksi jaringan Anda dan coba lagi. Di dalam sesi, mulai ulang Claude Code terlebih dahulu * Untuk pesan `Cloud sessions aren't available:`, lakukan apa yang diperlukan oleh penyebabnya, seperti memeriksa proxy Anda atau menghapus kredensial yang disebutkannya, lalu jalankan perintah lagi

Nothing was stashed because a folder replaced a tracked file

Pesan ini berarti sebuah folder di checkout Anda kini berada di tempat yang sebelumnya ditempati file atau link yang dilacak git. Pesan ini muncul setelah Anda memilih opsi stash saat menarik [sesi cloud](/docs/id/claude-code-on-the-web#from-cloud-to-terminal) ke terminal Anda, misalnya dengan `claude --teleport` atau `/teleport`. Melakukan stash pada kondisi tersebut dapat menghapus file di dalam folder, sehingga Claude Code menolak stash dan membiarkan checkout serta index Anda tidak berubah: ```text wrap theme={null} Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again. ``` **Yang perlu dilakukan:** * Lakukan commit atas perubahan tersebut atau pindahkan folder ke tempat lain, seperti yang disebutkan pesan, lalu jalankan teleport lagi

Nilai `--json-schema` bukan JSON Schema yang valid

Skema yang Anda berikan ke [`--json-schema`](/docs/id/cli-reference#cli-flags) dalam [mode non-interaktif](/docs/id/headless#get-structured-output) gagal dikompilasi sebagai JSON Schema, sehingga `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan setiap skema yang menggunakan kata kunci `format` diperlakukan sebagai tidak valid. ```text theme={null} Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values ``` Teks setelah titik dua kedua adalah diagnostik validator dan menyebutkan kata kunci atau lokasi yang gagal. Skema yang menggunakan kata kunci `format`, seperti `"format": "email"`, adalah valid: Claude Code menerima `format` sebagai anotasi dan tidak menerapkannya. Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: Claude Code menolak nilai yang bukan JSON yang dapat diurai dengan `Error: --json-schema is not valid JSON`, dan JSON valid yang bukan objek dengan `Error: --json-schema must be a JSON object`. **Yang perlu dilakukan:** * Perbaiki bagian skema yang disebutkan oleh diagnostik, lalu jalankan ulang perintah * Lihat [Mendapatkan output terstruktur](/docs/id/headless#get-structured-output) untuk skema dan perintah yang berfungsi

File pengaturan melebihi batas 2MiB

File yang Anda berikan ke [`--settings`](/docs/id/cli-reference#cli-flags) berukuran lebih dari 2 MiB, sehingga `claude` keluar dengan kode 1 saat startup alih-alih memuatnya. Sebelum v2.1.214, Claude Code membaca file tanpa pemeriksaan ukuran, dan file berukuran beberapa gigabyte atau file perangkat seperti `/dev/zero` membuat memori bertambah tanpa batas. ```text theme={null} Error: Settings file exceeds the 2MiB limit: /path/to/settings.json ``` Claude Code menolak path `--settings` yang bukan file biasa dengan cara yang sama: perangkat, FIFO, atau socket melaporkan `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` diikuti path-nya, dan direktori melaporkan alasan `EISDIR`. **Yang perlu dilakukan:** * Arahkan `--settings` ke file pengaturan JSON biasa yang berukuran di bawah 2 MiB. Lihat [Pengaturan](/docs/id/settings) untuk formatnya.

Direktori saat ini sudah tidak ada

Anda memulai `claude` dari direktori yang dihapus atau dipindahkan setelah shell Anda memasukinya, misalnya worktree atau direktori sementara yang dihapus oleh shell lain. Claude Code tidak dapat membaca direktori kerjanya, sehingga keluar dengan kode 1 sebelum memulai sesi, baik dalam mode interaktif maupun [non-interaktif](/docs/id/headless). Sebelum v2.1.239, Claude Code mengalami crash dengan sumber bundle yang diminifikasi dan stack `ENOENT ... uv_cwd` mentah di stderr alih-alih pesan ini. ```text theme={null} The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory. error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again. ``` Penyebab dan perbaikannya sama untuk kedua bentuk. Ketika Claude Code tidak dapat membaca direktori kerja karena alasan lain, seperti perubahan permission, pesan menyebutkan kode kesalahannya: `Can't read the current directory (EACCES). Start Claude Code from a different directory.` Di macOS, `EPERM` untuk direktori di `~/Desktop`, `~/Documents`, `~/Downloads`, atau iCloud Drive biasanya berarti macOS memblokir aplikasi terminal Anda dari folder tersebut. Perintah lain yang membaca folder tersebut gagal dengan cara yang sama: `ls` di sana melaporkan `Operation not permitted`, bahkan dengan `sudo`. **Yang perlu dilakukan:** * Pindah ke direktori yang ada, seperti direktori home atau direktori proyek Anda, lalu jalankan `claude` lagi * Jika direktori dibuat ulang di path yang sama, shell Anda masih memegang direktori yang telah dihapus. Jalankan `cd "$PWD"` atau keluar lalu masuk kembali ke direktori tersebut, lalu jalankan `claude` lagi * Untuk `EPERM` di macOS, tutup aplikasi terminal Anda dengan Cmd+Q, buka lagi, kembali ke folder tersebut, dan jalankan `claude`. Jika `ls` di folder tersebut masih gagal, buka **System Settings > Privacy & Security > Files and Folders**, aktifkan folder tersebut untuk aplikasi terminal Anda, lalu buka kembali terminal

Direktori sementara ditolak atau tidak dapat dibuat

Di macOS dan Linux, Claude Code membuat direktori sementara privat saat startup, `claude-` di bawah direktori sementara sistem atau override [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars). Ketika direktori tidak dapat dibuat, atau entri yang sudah ada di path tersebut gagal dalam pemeriksaan keamanan, Claude Code mencetak kegagalan ke stderr dan keluar dengan kode 1 alih-alih memulai sesi: ```text wrap theme={null} ENOSPC: no space left on device, mkdir '/tmp/claude-501' Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it. Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it. Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it. ``` **Yang perlu dilakukan:** * Untuk `ENOSPC`, kosongkan ruang disk pada volume yang menampung direktori sementara * Untuk bentuk `Refusing to use it`, hapus entri yang disebutkan itu sendiri, bukan yang ditunjuk oleh tautan, dan mulai Claude Code lagi; untuk bentuk `owned by uid`, hanya administrator atau pengguna tersebut yang dapat menghapusnya * Untuk `is not readable`, jalankan `chmod 0700` pada direktori yang disebutkan, atau hapus direktori tersebut dan mulai lagi * Dalam semua kasus ini, atur [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars) ke direktori yang Anda kendalikan dan mulai Claude Code lagi, tanpa mengubah path yang ditolak

Direktori tidak dapat di-resolve ke lokasi sebenarnya

Anda menjalankan `/add-dir` untuk subdirektori dari direktori kerja Anda, dan Claude Code tidak dapat me-resolve direktori tersebut ke lokasi sebenarnya. Anda sudah memiliki akses file ke subdirektori dari direktori kerja, sehingga `/add-dir` hanya memuat skill, perintah, dan agent-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi sebenarnya direktori tersebut, dengan semua symlink di-resolve, berada di dalam direktori kerja. Ketika Claude Code tidak dapat me-resolve lokasi tersebut, Claude Code tidak memuat apa pun dan menampilkan pesan ini: ```text theme={null} packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again. ``` **Yang perlu dilakukan:** * Periksa bahwa path tersebut menunjuk ke direktori nyata di dalam direktori kerja, lalu jalankan `/add-dir` lagi * Pesan ini tidak mengubah akses file Anda; pesan ini hanya melaporkan bahwa konten `.claude/` direktori tersebut tidak dimuat Sebelum v2.1.261, pesan ini juga muncul untuk setiap `/add-dir ` ketika direktori kerja berada di automount `/net/`, tempat Claude Code memang tidak me-resolve path berdasarkan desain; direktorinya baik-baik saja dan mencoba ulang tidak membantu.

Workspace tidak dipercaya saat memulai Remote Control

Anda memulai mode server [Remote Control](/docs/id/remote-control) dengan `claude remote-control` atau alias `claude rc`-nya di direktori yang belum Anda percayai, dan perintah tersebut tidak dapat menanyakan apakah Anda ingin memercayainya. Misalnya, input standar atau output standar perintah bukan terminal karena salah satunya dialihkan atau di-pipe. Perintah keluar dengan kode 1: ```text theme={null} Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog. ``` Dua varian yang juga diawali dengan `Error: Workspace not trusted.` muncul di terminal yang terlalu kecil untuk menampilkan apa yang diaktifkan dengan memercayai direktori, atau terminal yang tidak melaporkan ukurannya. Perbesar jendela atau beralih ke jendela terminal biasa, lalu jalankan `claude rc` lagi. Di direktori home Anda, pesannya berbeda, karena dialog kepercayaan workspace tidak pernah menyimpan kepercayaan untuk direktori home, sehingga menerimanya di sana tidak dapat memenuhi pemeriksaan ini. Sebelum v2.1.214, direktori home menampilkan pesan di atas, yang sarannya tidak dapat berhasil di sana. ```text theme={null} Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog). ``` Jika Anda menjawab `n` atau menekan Enter pada [pertanyaan `Trust ?`](/docs/id/remote-control#requirements), perintah mencetak pesan `Remote Control did not start` yang menyebutkan direktori tersebut dan keluar dengan kode 1. Jalankan `claude rc` lagi untuk menjawab `y`. **Yang perlu dilakukan:** * Percayai direktori tersebut dari terminal terlebih dahulu: jalankan `claude rc` di sana dan jawab `y`, atau jalankan `claude` di sana dan terima [dialog kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust), lalu jalankan perintah asli Anda lagi * Di direktori home Anda, pindah ke direktori proyek dan mulai Remote Control di sana Sebelum v2.1.284, perintah tidak pernah bertanya, bahkan di terminal.

Tidak diteruskan ke sesi yang dimulai Remote Control

Anda memulai [Remote Control](/docs/id/remote-control) dengan flag `claude` global sebelum kata kerja `remote-control`, yaitu flag yang akan membatasi atau mengonfigurasi sesi yang dimulai Remote Control, seperti `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools`, atau `--mcp-config`. Flag yang ditempatkan sebelum kata kerja tidak pernah mencapai sesi tersebut. Claude Code menolak untuk memulai, dengan menyebutkan flag tersebut: ```text theme={null} Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). ``` Claude Code tidak menolak flag global yang aman untuk diabaikan, seperti `--verbose`, `--model`, atau `--session-id` atau `--plugin-dir` yang disisipkan oleh wrapper: Claude Code mengabaikannya dan Remote Control dimulai. Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai aman, sehingga flag yang ditambahkan dalam rilis yang lebih baru dapat muncul dalam pesan ini hingga rilis berikutnya menandainya sebagai aman. **Yang perlu dilakukan:** * Hapus flag dari posisi sebelum kata kerja dan berikan [opsi Remote Control sendiri](/docs/id/remote-control#start-a-remote-control-session) setelahnya; `claude remote-control --help` mencantumkannya * Ketika flag yang ditolak adalah `--permission-mode`, jalankan `claude remote-control --permission-mode ` untuk mengatur mode izin bagi sesi yang dimulai Remote Control Sebelum v2.1.248, `claude remote-control` tidak menerima flag-nya sendiri ketika flag global muncul lebih dulu, dan perintah gagal dengan kesalahan `unknown option`.

`--sandbox` or `--no-sandbox` is not supported by claude remote-control

Error ini berarti perintah yang memulai server [Remote Control](/docs/id/remote-control) Anda meneruskan `--sandbox` atau `--no-sandbox` setelah `remote-control`, dan `claude remote-control` tidak menerima kedua flag tersebut. Server keluar dengan kode 1 alih-alih dimulai: ```text theme={null} Error: --sandbox is not supported by claude remote-control. The flag had no effect and was removed. To sandbox sessions, set sandbox.enabled to true in settings. Error: --no-sandbox is not supported by claude remote-control. The flag had no effect and was removed. Remove it from the command. ``` **Yang harus dilakukan:** * Hapus flag dari perintah, termasuk di skrip atau definisi layanan yang memulai server untuk Anda, lalu jalankan lagi * Untuk menjalankan sesi yang dimulai server dalam sandbox, aktifkan [sandboxing](/docs/id/sandboxing) dengan mengatur [`sandbox.enabled`](/docs/id/settings-reference#sandbox-enabled) ke `true` dalam [file pengaturan](/docs/id/settings#where-settings-live) Kedua flag dihapus dari `claude remote-control` di v2.1.300, sehingga perintah yang ditulis untuk versi sebelumnya masih dapat memuat salah satunya.

claude import belum tersedia dalam build ini

Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands), dan Claude Code mendapati alur impor dimatikan, sehingga perintah keluar dengan kode 1 alih-alih memulai impor. Sebelum v2.1.222, build dengan alur impor yang dimatikan memperlakukan `import` sebagai prompt dan memulai sesi interaktif alih-alih mencetak pesan ini. ```text theme={null} `claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly. ``` Claude Code mengaktifkan `claude import` melalui feature flag yang diambilnya dari Anthropic dan di-cache di disk. Pesan ini berarti nilai yang di-cache dimatikan. Penyebabnya biasanya salah satu dari berikut: * Anda belum memulai sesi sejak instalasi, sehingga Claude Code belum mengambil flag tersebut. `claude import` pertama dapat mencetak pesan ini bahkan ketika fitur tersebut tersedia untuk Anda. * Anda menggunakan Claude Code melalui Amazon Bedrock, Agent Platform dari Google Cloud, Microsoft Foundry, atau Claude Platform on AWS, atau melalui [Claude apps gateway](/docs/id/claude-apps-gateway#availability-and-limitations). Claude Code tidak mengambil feature flag dalam sesi ini, sehingga `claude import` tetap tidak tersedia. * Anda mengatur `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK`, atau [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars), yang mematikan pengambilan feature flag, sehingga `claude import` tetap tidak tersedia. **Yang perlu dilakukan:** * Pada instalasi baru, mulai `claude`, tunggu hingga sesi dimuat, keluar, dan jalankan `claude import` lagi * Jika pengambilan feature flag tetap dimatikan, siapkan konfigurasi sendiri: tambahkan server MCP dengan [`claude mcp add`](/docs/id/mcp#installing-mcp-servers), dan buat [file `CLAUDE.md`](/docs/id/memory#how-claude-md-files-load), [skill dan perintah](/docs/id/skills#where-skills-live), serta [subagent](/docs/id/sub-agents#choose-the-subagent-scope) yang ingin Anda bawa. Pesan ini juga menyebutkan `~/.claude/settings.json`. Dari konfigurasi yang dibawa `claude import`, file tersebut hanya menyimpan [mode izin](/docs/id/settings-reference#permission-settings); Claude Code tidak membaca server MCP darinya.

Tidak dapat membaca konfigurasi Claude Code

Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands) saat Claude Code tidak dapat mengurai `~/.claude.json`, file tempat Claude Code menyimpan login dan status per proyek Anda. Subperintah membaca file tersebut untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang ditampilkan sesi interaktif, sehingga keluar dengan kode 1. Sebelum v2.1.222, `claude import` dengan file konfigurasi yang tidak dapat dibaca memulai sesi interaktif, yang dialog pemulihannya menangani file tersebut. ```text theme={null} Could not read Claude Code config — run `claude` with no arguments to recover it. ``` **Yang perlu dilakukan:** * Jalankan `claude` tanpa argumen. Claude Code mendeteksi file yang tidak valid dan menawarkan untuk meresetnya. Lalu jalankan `claude import` lagi. * Untuk mempertahankan suntingan manual yang telah Anda buat, perbaiki sintaks JSON di `~/.claude.json` dengan editor, lalu jalankan ulang `claude import`

Tidak dapat mengimpor server dari Claude Desktop

Claude Code tidak dapat menambahkan salah satu server yang Anda pilih di `claude mcp add-from-claude-desktop`. Perintah tetap mengimpor server terpilih lainnya dan mencetak satu baris per server yang tidak dapat ditambahkannya. Sebelum v2.1.205, server pertama yang gagal menghentikan impor. ```text theme={null} Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores. ``` Teks setelah nama server adalah alasannya. Yang paling umum adalah pemeriksaan nama: Claude Desktop mengizinkan karakter dalam nama server, seperti spasi dan titik, yang dibatasi `claude mcp` hanya pada huruf, angka, tanda hubung, dan garis bawah. Alasan lainnya termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh [kebijakan MCP](/docs/id/managed-mcp) organisasi Anda. **Yang perlu dilakukan:** * Ganti nama server di `claude_desktop_config.json` agar hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, lalu jalankan `claude mcp add-from-claude-desktop` lagi * Tambahkan server tersebut secara langsung dengan `claude mcp add` atau `claude mcp add-json` dengan nama yang valid. Lihat [Mengimpor server MCP dari Claude Desktop](/docs/id/mcp#import-mcp-servers-from-claude-desktop).

Tidak dapat menambahkan server MCP ke cakupan managed

Anda menjalankan `claude mcp add` atau `claude mcp add-json` dengan `--scope managed`. Cakupan tersebut menampung server yang disediakan organisasi Anda melalui pengaturan terkelola [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers). Claude Code hanya membacanya dari pengaturan terkelola, sehingga perintah tidak dapat menulis server ke cakupan tersebut. ```text theme={null} Cannot add MCP server to scope: managed ``` **Yang perlu dilakukan:** * Tambahkan server ke cakupan yang dapat Anda tulis: `local`, `user`, atau `project`. Tanpa `--scope`, perintah menggunakan `local`. Lihat [Cakupan instalasi MCP](/docs/id/mcp#mcp-installation-scopes) * Untuk menyediakan server bagi setiap pengguna di organisasi Anda, tambahkan ke [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) di pengaturan terkelola yang Anda deploy

Tidak dapat menambahkan server MCP ketika pengaturan terkelola hanya mengizinkan server plugin

Anda menjalankan `claude mcp add` atau `claude mcp add-json` sementara pengaturan terkelola organisasi Anda mengatur [`strictPluginOnlyCustomization`](/docs/id/settings-reference#strictpluginonlycustomization) ke `true` atau ke daftar yang mencakup `mcp`. Dengan pengaturan tersebut, Claude Code tidak memuat server MCP dari `~/.claude.json` atau `.mcp.json`, sehingga perintah keluar dengan kode 1 alih-alih menyimpan server yang tidak akan pernah dimuat: ```text theme={null} Cannot add MCP server: your organization's managed settings allow only MCP servers that plugins provide. Install a plugin that provides this server, or ask your administrator to make it available. ``` `claude mcp add-from-claude-desktop` melaporkan setiap server yang Anda pilih sebagai tidak diimpor, dengan pesan ini sebagai alasannya. [`/import`](/docs/id/commands#all-commands) melaporkan pesan ini untuk setiap server MCP yang coba ditambahkannya dan tetap mengimpor item lain yang ditemukannya. Sebelum v2.1.284, perintah ini menyimpan server dan melaporkan keberhasilan, dan server tidak pernah dimuat. **Yang perlu dilakukan:** * Instal [plugin](/docs/id/plugins/install) yang menyediakan server tersebut * Minta administrator Anda untuk mendistribusikan server dalam [plugin](/docs/id/plugins/org), atau menyediakannya melalui [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) jika server tersebut adalah server HTTP atau SSE jarak jauh

Tidak dapat membaca .mcp.json

Perintah yang membaca [`.mcp.json`](/docs/id/mcp#project-scope) proyek, seperti `claude mcp add` atau `claude mcp add-json` dengan `--scope project`, atau `claude mcp remove`, mendapati bahwa file di direktori Anda saat ini bukan file biasa atau berukuran lebih dari 2 MiB, sehingga perintah keluar dengan kesalahan ini alih-alih membaca file. ```text theme={null} Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again. ``` Sebelum v2.1.257, FIFO di `.mcp.json` membuat perintah menunggu selamanya tanpa output, dan symlink ke file perangkat seperti `/dev/zero` membuat memori bertambah hingga proses dihentikan. **Yang perlu dilakukan:** * Periksa apa yang ada di `.mcp.json` di direktori Anda saat ini. Ganti dengan file JSON biasa dalam [format cakupan proyek](/docs/id/mcp#project-scope), atau hapus, lalu jalankan perintah lagi.

Server MCP tidak disimpan atau dihapus

Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server di [cakupan](/docs/id/mcp#mcp-installation-scopes) `user` atau `local`. Kedua cakupan disimpan di `~/.claude.json`, dan perubahan tidak ada di file tersebut ketika Claude Code membacanya kembali setelah menulis. Perintah keluar dengan kesalahan ini alih-alih baris keberhasilannya. ```text theme={null} MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again. ``` Setelah penghapusan, pesan berbunyi `was not removed from` dan diakhiri dengan `then remove the server again`. Untuk server cakupan `local`, path diikuti oleh direktori proyek tempat entri tersebut berada, sebagai `(local scope for /path/to/project)`. Sebelum v2.1.283, `claude mcp add`, `claude mcp add-json`, dan `claude mcp remove` melaporkan keberhasilan bahkan ketika perubahan tidak mencapai file. **Yang perlu dilakukan:** * Buat file yang disebutkan pesan dapat ditulis, atau jalankan perintah di luar sandbox, lalu jalankan perintah tambah atau hapus yang sama lagi.

Server MCP mungkin tidak disimpan atau dihapus

Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server di [cakupan](/docs/id/mcp#mcp-installation-scopes) `user` atau `local`, dan Claude Code tidak dapat membaca kembali `~/.claude.json` untuk mengonfirmasi perubahan. Perubahan mungkin ada atau tidak ada di disk. Teks dalam tanda kurung adalah kesalahan dari pembacaan tersebut. ```text theme={null} MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing. ``` Setelah penghapusan, pesan berbunyi `may not have been removed` dan diakhiri dengan `then remove the server again if it is still listed`. Sebelum v2.1.283, perintah melaporkan keberhasilan bahkan ketika perubahan tidak dapat dikonfirmasi. **Yang perlu dilakukan:** * Jalankan `claude mcp get ` untuk memeriksa apakah perubahan ada di disk. Untuk server cakupan `local`, jalankan dari direktori proyek tempat server tersebut berada, karena cakupan lokal berlaku per proyek. * Jika server tidak ada setelah penambahan, atau masih tercantum setelah penghapusan, jalankan perintah tambah atau hapus yang sama lagi.

Server di-host oleh Anthropic dan tidak mendukung OAuth lokal

Anda memulai proses masuk untuk server MCP yang URL-nya menunjuk ke host konektor yang di-host Anthropic yang melakukan autentikasi melalui penyedia identitas pihak ketiga. Host ini mencakup `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com`, dan `gcal.mcp.claude.com`. Claude Code menolak memulai alur OAuth lokalnya untuk host ini baik dari panel `/mcp` maupun `claude mcp login`, karena [proses masuknya hanya berfungsi melalui claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai). ```text theme={null} "gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically. ``` **Yang perlu dilakukan:** * Hapus entri Anda dengan `claude mcp remove `, agar entri tersebut tidak menyembunyikan konektor claude.ai di URL yang sama * Setelah menghapusnya, hubungkan layanan di [claude.ai/customize/connectors](https://claude.ai/customize/connectors), sambil masuk ke akun yang Anda gunakan di Claude Code. Setelah terhubung, [konektor muncul di Claude Code secara otomatis](/docs/id/mcp#use-mcp-servers-from-claude-ai) jika metode autentikasi aktif Anda adalah login langganan claude.ai

Server menolak header Authorization yang dibuat oleh headersHelper yang dikonfigurasi

Server MCP yang [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication)-nya menyediakan header `Authorization` menjawab koneksi dengan HTTP 401 atau 403, sehingga Claude Code melaporkan koneksi sebagai gagal. Karena helper menyediakan header `Authorization`, Claude Code [tidak melakukan fallback ke OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers) untuk server tersebut: ```text theme={null} Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization. ``` Claude Code menjalankan ulang helper pada setiap upaya koneksi, sehingga retry setelah penolakan sementara, seperti race rotasi token, dapat berhasil dengan kredensial baru. **Yang perlu dilakukan:** * Jalankan perintah `headersHelper` sendiri dengan cara yang sama seperti Claude Code menjalankannya: dari [direktori tempat Claude Code menjalankannya](/docs/id/mcp#where-the-helper-runs), dengan [environment variable yang diatur Claude Code untuknya](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), dan tanpa [variabel kredensial yang dihapus Claude Code](/docs/id/mcp#which-variables-a-helper-can-read) untuk server dari `.mcp.json` proyek, plugin, atau file agent proyek. Periksa bahwa perintah tersebut mencetak nilai `Authorization` yang diterima endpoint server * Setelah memperbaiki helper atau sumber kredensialnya, pilih server di `/mcp` dan pilih **Reconnect** Sebelum v2.1.248, Claude Code menjalankan penemuan OAuth untuk server yang helper-nya menyediakan header `Authorization`. Penemuan tersebut dapat gagal dengan `Incompatible auth server: does not support dynamic client registration` alih-alih melaporkan kredensial yang ditolak.

Tool prompt izin MCP tidak ditemukan

Tool yang Anda berikan ke [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) tidak termasuk di antara tool MCP yang terhubung saat run pertama kali memerlukan keputusan izin, baik karena servernya tidak pernah terhubung atau karena tidak ada server terhubung yang menyediakan tool dengan nama tersebut. Claude Code tetap mengirimkan prompt Anda: run [non-interaktif](/docs/id/headless) keluar dengan kesalahan ini, dan exit code 1, pada panggilan tool pertama, sehingga tidak menghasilkan jawaban meskipun permintaan telah dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per server selama 30 detik yang diatur oleh [`MCP_TIMEOUT`](/docs/id/env-vars) agar server tersebut terhubung. Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, sehingga server yang lambat dimulai tetapi sehat juga menghasilkan kesalahan ini. ```text theme={null} Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none ``` Daftar setelah `Available MCP tools:` menyebutkan tool MCP yang terhubung. **Yang perlu dilakukan:** * Periksa bahwa server dimulai dan tetap terhubung: jalankan `claude mcp list` di direktori yang sama dan pastikan server tercantum sebagai terhubung * Pastikan nama tool cocok dengan nama `mcp____` yang disediakan server * Jika server memerlukan lebih dari 30 detik untuk dimulai, naikkan [`MCP_TIMEOUT`](/docs/id/env-vars)

Port callback OAuth sudah digunakan

Ketika Anda masuk ke server MCP jarak jauh dengan OAuth, Claude Code memulai listener lokal untuk menerima callback proses masuk. Jika port yang diperlukan listener tersebut dipegang oleh proses lain, proses masuk gagal dengan pesan ini. Hal ini sebagian besar terjadi dengan [port callback tetap](/docs/id/mcp#use-a-fixed-oauth-callback-port) yang diatur melalui variabel [`MCP_OAUTH_CALLBACK_PORT`](/docs/id/env-vars) atau `--callback-port`, karena tanpa itu Claude Code memilih port yang tersedia. ```text theme={null} OAuth callback port is already in use — another process may be holding it. Run `lsof -ti: -sTCP:LISTEN` to find it. ``` Di Windows, perintah yang disarankan adalah `netstat -ano | findstr :`. **Yang perlu dilakukan:** * Jalankan perintah dari pesan untuk menemukan proses yang memegang port, dan hentikan proses tersebut atau tunggu hingga selesai * Jika program lain memerlukan port tersebut secara permanen, daftarkan URI redirect yang berbeda dengan server dan atur port-nya dengan `MCP_OAUTH_CALLBACK_PORT` atau `--callback-port`, mana pun yang Anda gunakan * Lalu mulai proses masuk lagi, misalnya dengan memilih server di `/mcp`

Tidak ada port yang tersedia untuk redirect OAuth

Ketika Anda masuk ke server MCP jarak jauh dengan [OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers), Claude Code memulai listener lokal untuk menerima callback proses masuk. Proses masuk gagal dengan pesan ini ketika Claude Code tidak dapat mengikat port lokal untuknya. Sesuatu di mesin mencegahnya mendengarkan di `127.0.0.1`, misalnya perangkat lunak keamanan atau kebijakan sandbox yang menolak listener lokal. ```text theme={null} No available ports for OAuth redirect ``` Sebelum v2.1.268, Claude Code tidak melakukan fallback ke port yang ditetapkan sistem operasi, sehingga pesan ini juga muncul ketika hanya port yang dipilih sendiri olehnya yang tidak dapat diikat. Hal itu dapat terjadi pada host Windows tempat Hyper-V mencadangkan rentang port yang mencakup port yang dipilih Claude Code. **Yang perlu dilakukan:** * Periksa apakah perangkat lunak keamanan atau kebijakan sandbox memblokir proses dari mendengarkan di `127.0.0.1`, dan izinkan Claude Code mengikat port lokal * Lalu mulai proses masuk lagi, misalnya dengan memilih server di `/mcp`

/security-review gagal tanpa origin/HEAD

[`/security-review`](/docs/id/commands#all-commands) membangun konteks review-nya dengan membuat diff branch Anda terhadap `origin/HEAD`, ref lokal yang mencatat branch mana yang menjadi default pada remote `origin` Anda. Ketika ref tersebut tidak ada, perintah git yang mengumpulkan diff gagal dan review berhenti sebelum dimulai. ```text theme={null} Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr] fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree. Use '--' to separate paths from revisions, like this: 'git [...] -- [...]' ``` Pesan ini mungkin mengutip `git log` atau `git diff` yang berbeda. Git membuat `origin/HEAD` hanya ketika remote mengiklankan branch default dan refspec fetch Anda mencakupnya, yang dilakukan oleh `git clone` penuh dari remote yang memiliki commit. Ref tersebut tidak ada dalam pengaturan berikut: * Checkout single-branch atau CI, yang melakukan fetch dengan refspec yang terlalu sempit * Remote yang HEAD di sisi server-nya menunjuk ke branch yang tidak pernah di-push siapa pun * Repositori tanpa remote `origin`, atau yang tidak pernah Anda fetch Claude Code menampilkan error yang sama untuk skill apa pun yang [menyisipkan konteks dinamis](/docs/id/skills#when-an-injected-command-fails), dan perintah sisipan yang gagal membatalkan pemanggilan skill tersebut. String serupa muncul sebelum perintah dijalankan sama sekali: * `Shell command permission check failed for pattern "..."`: pemeriksaan izin perintah tidak mengizinkannya. [Pemeriksaan izin pada perintah sisipan](/docs/id/skills#permission-checks-on-injected-commands) menjelaskan hasil mana yang membatalkan di setiap mode izin dan cara menyetujui perintah sebelumnya dengan `allowed-tools` * ``Skill requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill menuntut bash pada mesin yang tidak memilikinya. Instal Git for Windows atau ubah frontmatter menjadi `shell: powershell`. Lihat [Cara perintah sisipan dijalankan](/docs/id/skills#how-injected-commands-run) * `No shell command in was run`: salah satu perintah `!` di file mengandung karakter kontrol mentah selain tab atau baris baru, sehingga tidak ada satu pun yang dijalankan. Lihat [cara menemukan dan menghapus karakter tersebut](#no-shell-command-was-run) **Yang perlu dilakukan:** * Buat ref dengan menyebutkan branch default remote Anda: `git remote set-head origin `. Ini berfungsi setiap kali ref pelacakan lokal `origin/` ada. Jika tidak ada, seperti pada clone single-branch, fetch branch tersebut terlebih dahulu: jalankan `git remote set-branches --add origin `, lalu `git fetch origin`, lalu jalankan ulang perintah set-head. Jalankan ulang `/security-review`. * Jika Anda lebih memilih tidak menyebutkan branch, jalankan `git fetch origin` lalu `git remote set-head origin --auto`, yang menanyakan kepada remote branch mana yang menjadi default-nya. Perintah ini gagal dengan `error: Cannot determine remote HEAD` ketika remote tidak mengiklankan branch default, karena remote kosong atau HEAD-nya menunjuk ke branch yang tidak pernah di-push siapa pun; sebutkan branch secara eksplisit sebagai gantinya. Perintah ini gagal dengan `error: Not a valid ref` ketika clone Anda tidak melakukan fetch branch tersebut; perluas refspec seperti di atas terlebih dahulu. * Jika repositori tidak memiliki remote, tambahkan dengan `git remote add origin ` dan lakukan fetch sebelum membuat ref. Jika remote kosong, push branch Anda terlebih dahulu dengan `git push -u origin HEAD` dan sebutkan branch tersebut dalam perintah set-head; `origin/HEAD` kemudian menunjuk ke branch yang baru saja Anda push, sehingga `/security-review` melihat diff kosong hingga branch menyimpang darinya.

No shell command in a skill or command was run

Salah satu [perintah konteks dinamis](/docs/id/skills#inject-dynamic-context) `` !`` `` dalam file skill atau perintah kustom mengandung karakter kontrol mentah selain tab atau baris baru. Claude Code menolak seluruh pemanggilan sebelum perintah mana pun di file tersebut dijalankan. Pesan menyebutkan tool shell yang seharusnya menjalankan perintah-perintah tersebut, Bash atau PowerShell, dan diakhiri dengan perintah yang ditolak. Setiap karakter tersebut diganti dengan `�` sehingga Anda dapat melihat lokasinya: ```text theme={null} No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as � below: remove them from the skill or command file, or from the arguments or options substituted into it. build.sh --target�dist ``` **Yang harus dilakukan:** * Temukan setiap `�` dalam perintah yang dikutip di akhir pesan. Hapus karakter yang diwakilinya dari file skill atau perintah, atau dari argumen atau opsi yang disubstitusikan ke dalam file.

Input harus diberikan saat menggunakan `--print`

`claude` tanpa argumen memerlukan stdout berupa terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal sungguhan, seperti PowerShell ISE dan beberapa panel output IDE, `claude` berjalan secara [non-interaktif](/docs/id/headless). Itu adalah mode yang sama dengan `claude -p`, yang memerlukan prompt, sehingga pesan menyebutkan `--print` bahkan ketika Anda tidak memberikan flag tersebut. Memberikan `-p`/`--print` tanpa prompt dan tanpa apa pun yang di-pipe ke stdin menghasilkan kesalahan yang sama di mana pun. ```text theme={null} Error: Input must be provided either through stdin or as a prompt argument when using --print ``` **Yang perlu dilakukan:** * Untuk penggunaan interaktif, jalankan `claude` di terminal sungguhan: Windows Terminal atau konsol PowerShell alih-alih ISE, dan terminal terintegrasi IDE Anda alih-alih panel output * Untuk penggunaan sekali jalan, berikan prompt: `claude -p "your question"`, atau pipe dengan `echo "your question" | claude -p`

Claude Code tidak dapat membaca keyboard di sini

Anda menjalankan `claude` tanpa [`-p`](/docs/id/headless), yang memulai [sesi interaktif](/docs/id/interactive-mode), tetapi input standarnya bukan terminal. Sesuatu melakukan pipe atau mengalihkannya, atau program yang meluncurkan `claude` menyediakan aliran inputnya sendiri. Sesi interaktif memerlukan terminal untuk membaca ketikan Anda, dan apa yang dilakukan Claude Code tanpa terminal bergantung pada platform Anda: * **Windows**: Claude Code mencetak pesan ke stderr dan keluar dengan kode 1 alih-alih memulai antarmuka * **macOS dan Linux**: Claude Code membaca ketikan Anda dari `/dev/tty` dan memulai sesi, dengan teks yang di-pipe sebagai prompt pertama Anda. Anda melihat pesan ini ketika `/dev/tty` tidak dapat dibuka, dan baris pertamanya menyebutkan `/dev/tty` sebagai pengganti kata-kata untuk Windows. Di Windows, pesannya berbunyi: ```text theme={null} Claude Code can't read the keyboard here: stdin is not a terminal (it is piped, redirected, or supplied by the program that launched claude), and on Windows it can't fall back to the console for input yet. Run claude directly in Windows Terminal, PowerShell, or Command Prompt, without piping or redirecting its input. To send text as a prompt and print the reply instead, add -p; it also works with --continue and --resume (for example: type notes.md | claude -p --continue). ``` **Yang perlu dilakukan:** * Untuk bekerja secara interaktif, jalankan `claude` langsung di terminal, tanpa melakukan pipe atau mengalihkan inputnya * Untuk mendapatkan balasan tanpa antarmuka interaktif, misalnya dari skrip, tambahkan `-p` dan berikan prompt sebagai argumen atau melalui stdin, seperti `claude -p "your question"` atau `echo "your question" | claude -p`. Hal yang sama berlaku dengan `--continue` dan `--resume `. Sebelum v2.1.287, Claude Code memulai antarmuka alih-alih mencetak pesan ini, lalu tidak menampilkan apa pun di layar atau gagal dengan kesalahan yang berisi `Raw mode is not supported`. Jika Anda melihat `Raw mode is not supported` selama `claude install`, lihat [`Raw mode is not supported` selama instalasi](/docs/id/troubleshoot-install#raw-mode-is-not-supported-during-install).

Input hanya berisi whitespace

Dalam [mode non-interaktif](/docs/id/headless), Claude Code menolak prompt yang seluruhnya terdiri dari spasi, tab, atau baris baru alih-alih mengirimkannya, karena API menolak pesan tanpa teks yang terlihat. Pesan yang Anda lihat bergantung pada asal prompt kosong tersebut: * **Argumen prompt atau stdin yang di-pipe untuk `claude -p`**: `claude` keluar dengan `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` * **Pesan yang dikirimkan ke sesi `--input-format stream-json` atau [Agent SDK](/docs/id/agent-sdk/overview) yang sedang berjalan**: Claude Code mengakhiri giliran tanpa memanggil model dan sesi tetap dapat digunakan. Penolakan tiba sebagai pesan informasi dan sebagai teks hasil giliran: `Blank prompt — the message was only whitespace, so nothing was sent to the model.` Sebelum v2.1.229, Claude Code mengirimkan pesan yang hanya berisi whitespace ke API, yang menolak permintaan dengan kesalahan 400. **Yang perlu dilakukan:** * Sertakan teks yang terlihat dalam prompt. Jika skrip membangun prompt dari variabel atau file, periksa bahwa sumbernya tidak kosong sebelum memanggil Claude Code.

Input stream-json membawa lebih dari 256M karakter tanpa baris baru

Program Anda mengirimkan lebih dari 268.435.456 karakter di stdin tanpa baris baru ke run `claude -p --input-format stream-json`, sehingga Claude Code mencetak kesalahan ini ke stderr dan keluar dengan kode 1 alih-alih menampung lebih banyak input. Pesan menyatakan batas tersebut sebagai `256M`. Sebelum v2.1.257, Claude Code menampung input semacam itu tanpa batas, membuat memori bertambah hingga proses crash atau dihentikan. ```text theme={null} Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget. ``` Input sepanjang ini tanpa baris baru biasanya berarti produsernya sama sekali bukan produsen stream-json, seperti file biner atau output log biasa yang tidak sengaja di-pipe. Satu pesan yang melebihi batas gagal dalam pemeriksaan yang sama. **Yang perlu dilakukan:** * Periksa apa yang di-pipe ke stdin. Dengan [`--input-format stream-json`](/docs/id/cli-reference#cli-flags), setiap pesan harus berupa satu baris JSON yang diakhiri baris baru * Untuk mengirimkan teks biasa, hapus `--input-format stream-json`; `claude -p` membaca prompt teks biasa dari stdin secara default

Unknown command

Dalam sesi terminal interaktif, Anda mengirimkan nama `/` yang tidak cocok dengan perintah apa pun dalam sesi ini, sehingga Claude Code melaporkan nama tersebut alih-alih menjalankan apa pun: ```text theme={null} Unknown command: /hepl. Did you mean /help? ``` Claude Code menyarankan nama perintah atau alias terdekat yang dicantumkan menu dalam sesi ini. Ketika tidak ada yang mendekati, pesan berakhir setelah nama tersebut. Penyebabnya biasanya salah satu dari berikut: * Salah ketik, seperti `/hepl` untuk `/help`. [Cara menu perintah mencocokkan apa yang Anda ketik](/docs/id/commands#how-the-command-menu-matches-what-you-type) membahas cara memilih kecocokan terdekat sebelum Anda mengirimkan * Perintah yang ada tetapi tidak tersedia dalam sesi ini karena suatu persyaratan tidak terpenuhi, seperti platform, paket, atau metode autentikasi Anda. Entri pemecahan masalah untuk [`/web-setup`](/docs/id/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) dan [`/schedule`](/docs/id/routines#schedule-returns-unknown-command) menjelaskan dua kasus umum. Beberapa perintah menjawab dengan pesannya sendiri ketika kebijakan organisasi Anda menonaktifkannya, seperti [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) * Perintah dari [plugin](/docs/id/plugins/overview) atau [server MCP](/docs/id/mcp#use-mcp-prompts-as-commands) yang tidak diinstal atau tidak terhubung dalam sesi ini Claude Code menjawab nama `/` yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Dalam setiap sesi lainnya, Claude Code mengirimkan prompt ke Claude sebagai pesan biasa, dengan catatan bahwa perintah tidak dijalankan dan daftar perintah yang dapat dijalankan Claude dalam sesi tersebut. Sesi tersebut meliputi: * Run `-p` * Aplikasi [Agent SDK](/docs/id/agent-sdk/overview) * Tab Code di [aplikasi Desktop](/docs/id/desktop) * Panel chat [ekstensi VS Code](/docs/id/vs-code) * [Sesi cloud](/docs/id/claude-code-on-the-web) dan [routine](/docs/id/routines) Untuk perintah bawaan yang tidak dapat berjalan di salah satu sesi tersebut, Claude Code tetap menjawab bahwa perintah tidak tersedia alih-alih mengirimkannya ke Claude. Sebelum v2.1.274, hanya sesi cloud dan routine yang mengirimkan nama yang tidak cocok ke Claude. Sebelum v2.1.273, sesi tersebut juga menjawab `Unknown command`. Claude Code tidak memperlakukan setiap prompt yang diawali dengan `/` sebagai perintah. Claude Code mengirimkan prompt ke Claude sebagai pesan biasa ketika kata pertama setelah `/` diawali dengan tanda baca, seperti `/--` yang membuka komentar dokumentasi Lean, atau merupakan path seperti `/var/log/syslog`. Sebelum v2.1.236, jika Anda menekan `Enter` saat menu perintah mencantumkan kecocokan terdekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan tersebut, sehingga salah ketik seperti `/hepl` menjalankan `/help` alih-alih menghasilkan pesan ini. **Yang perlu dilakukan:** * Jalankan nama yang disarankan, atau ketik `/` diikuti sebagian nama untuk melihat apa yang tersedia dalam sesi ini * Jika Claude Code melaporkan perintah yang terdokumentasi sebagai tidak dikenal, periksa barisnya di [referensi perintah](/docs/id/commands) untuk persyaratan yang disebutkannya

Diff terlalu besar untuk ultrareview

Diff antara branch Anda dan branch dasar, termasuk perubahan yang belum di-commit dan yang di-stage, melebihi batas ukuran untuk [ultrareview](/docs/id/ultrareview), sehingga `/code-review ultra` dan subperintah `claude ultrareview` menolak review sebelum sesi cloud dimulai. Review yang ditolak tidak menggunakan run gratis dan tidak menagih kredit penggunaan. Pesan menyebutkan batas yang berlaku, ukuran diff Anda, dan file yang paling banyak menyumbang baris yang diubah. Sebelum v2.1.216, pesan hanya menampilkan statistik diff mentah. ```text theme={null} Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra `) to narrow the scope, or split the change. ``` Me-review pull request menerapkan batas yang sama; bentuk pesan tersebut diawali dengan `PR # is too large for ultrareview` dan menyebutkan jumlah file dan baris PR. **Yang perlu dilakukan:** * Berikan branch dasar yang lebih dekat dengan pekerjaan Anda, seperti `/code-review ultra develop`, sehingga review hanya mencakup diff terhadap branch tersebut * Pecah perubahan menjadi branch yang lebih kecil dan review masing-masing. File yang disebutkan pesan menyumbang baris yang diubah paling banyak, jadi mulailah dengan memindahkannya ke branch tersendiri.

Tidak dapat menemukan merge-base dengan branch dasar

`/code-review ultra` dan subperintah `claude ultrareview` me-review diff antara branch Anda dan branch dasar, yang memerlukan commit yang dimiliki bersama oleh keduanya. Ketika `git merge-base` tidak menemukannya, Claude Code menolak review sebelum sesi cloud dimulai. Pada clone yang dapat diverifikasi Claude Code sebagai lengkap, dengan setidaknya satu branch, Claude Code melakukan fallback ke [me-review setiap file yang dilacak](/docs/id/ultrareview#diff-limits-and-fallbacks) alih-alih menolak. Anda melihat penolakan ini ketika branch dasar sama sekali tidak dapat ditemukan, ketika Claude Code tidak dapat memverifikasi bahwa clone Anda lengkap, atau pada repositori langka tempat diff seluruh tree tidak dimungkinkan, seperti format objek SHA-256. ```text theme={null} Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch. ``` Petunjuk setelah kalimat pertama bergantung pada apa yang diamati Claude Code: * **Anda tidak memberikan branch dasar**: Claude Code membandingkan dengan branch default repositori dan menyarankan untuk memberikan branch dasar Anda secara eksplisit, seperti pada contoh di atas * **Anda memberikan branch dasar yang sudah ada di clone Anda**: petunjuknya berbunyi ``Make sure exists locally or on origin (try `git fetch origin `)`` * **Anda meneruskan base branch yang tidak ada di clone Anda**: Claude Code melakukan fetch dari origin sebelum membandingkan. Petunjuk berbunyi `` was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra `)``; ketika Claude Code tidak dapat mengetahui apakah clone Anda shallow, ia menyarankan `git fetch --unshallow origin` sebagai gantinya. Sebelum v2.1.221, petunjuk menyarankan `git fetch --unshallow origin` untuk setiap base branch yang di-fetch, dan pada clone yang lengkap perintah tersebut gagal dengan `fatal: --unshallow on a complete repository does not make sense`. **Yang perlu dilakukan:** * Jika branch lain adalah branch dasar Anda yang sebenarnya, berikan secara eksplisit: `/code-review ultra ` * Jika clone Anda mungkin tidak memiliki riwayat lengkap, jalankan `git fetch --unshallow origin` dan jalankan ulang review

Checkout Anda tidak memiliki branch

Checkout dapat memiliki commit tetapi tidak memiliki branch: jika Anda menjalankan `git init` diikuti dengan `git fetch ` dan `git checkout FETCH_HEAD`, Anda mendapatkan HEAD terlepas tanpa ref. Claude Code mengemas repositori Anda sebagai git bundle untuk mengunggahnya untuk [ultrareview](/docs/id/ultrareview), dan tidak dapat mem-bundle repositori yang tidak memiliki branch atau ref lain, sehingga `/code-review ultra` dan subperintah `claude ultrareview` menolak review sebelum sesi cloud dimulai. ```text theme={null} Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b ` — then rerun /code-review ultra. ``` Sebelum v2.1.221, Claude Code mencoba me-review setiap file yang dilacak dalam checkout ini, dan unggahan gagal. **Yang perlu dilakukan:** * Buat branch pada commit Anda saat ini dengan `git checkout -b `, lalu jalankan ulang review

Tidak ada akun GitHub yang terhubung ke akun Claude Anda

Anda menjalankan `/code-review ultra ` atau `claude ultrareview `, dan sebelum membuat sesi cloud, Claude Code menanyakan kepada server apakah [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) dapat menjangkau repositori PR. Tidak ada akun yang terhubung, atau koneksinya kedaluwarsa, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak. ```text theme={null} Ultrareview clones / in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting). ``` Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menyebutkan tautan claude.ai. **Yang perlu dilakukan:** * Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github) * Jalankan ulang review satu menit setelah menghubungkan Sebelum v2.1.248, Claude Code tidak memeriksa hal ini sebelum peluncuran.

Akun GitHub yang terhubung tidak dapat melihat repositori

Anda menjalankan `/code-review ultra ` atau `claude ultrareview `, dan [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) tidak dapat membaca repositori PR, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak. ```text theme={null} Your connected GitHub account can't see / — usually the Claude GitHub app isn't installed on or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234. ``` Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menyebutkan instalasi aplikasi. **Yang perlu dilakukan:** * Jika CLI `gh` lokal Anda dapat membaca repositori, jalankan `/web-setup` untuk menghubungkan login tersebut ke akun Claude Anda * Jalankan ulang review setelah perubahan Sebelum v2.1.248, Claude Code tidak memeriksa hal ini sebelum peluncuran.

Preflight GitHub App gagal sementara

Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repositori lokal, dan dua langkah gagal bersamaan. Claude Code tidak dapat mem-build atau mengunggah bundle repositori Anda. Sebelum pengunggahan, Claude Code memeriksa apakah layanan cloud dapat melakukan clone repositori dari GitHub, dan alih-alih jawaban pasti, pemeriksaan tersebut berakhir dengan kesalahan yang dapat diatasi dengan retry, seperti kesalahan jaringan, timeout, atau kesalahan server sementara. Pesan lengkap diawali dengan apa yang menghentikan bundle, misalnya `Could not upload repo bundle ()`, dan diakhiri dengan kalimat preflight: ```text theme={null} Could not upload repo bundle (). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead ``` **Yang perlu dilakukan:** * Jalankan ulang perintah setelah beberapa saat. Ketika pemeriksaan GitHub berhasil, Claude Code dapat memulai sesi dari clone GitHub, sehingga unggahan yang gagal tidak lagi memblokir peluncuran * Jika retry terus gagal, awal pesan menyebutkan apa yang menghentikan unggahan. Ketika penyebab tersebut dapat Anda perbaiki, perbaiki agar sesi dapat dimulai dari repositori lokal Anda Sebelum v2.1.251, Claude Code mengakhiri pesan dengan `Please set up GitHub on https://claude.ai/code` bahkan ketika pemeriksaan GitHub hanya gagal sementara, dan saran penyiapan tidak dapat mengatasi kegagalan sementara.

Unggahan repositori tidak dapat mengikuti pengaturan git

Anda memulai [sesi cloud yang mengunggah repositori lokal Anda](/docs/id/claude-code-on-the-web#send-local-repositories-without-github), atau [ultrareview](/docs/id/ultrareview) dari suatu branch, dan unggahan tidak dapat mengikuti salah satu pengaturan git yang menentukan aturan atribut mana yang berlaku untuk file Anda. Jika unggahan tetap dilanjutkan dan melewatkan suatu aturan, file yang diubah git sebelum menyimpannya, seperti file yang dienkripsi oleh clean filter, dapat sampai ke cloud dalam keadaan seperti di disk. Claude Code menolak unggahan, dan tidak ada yang diunggah: ```text theme={null} Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in , and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry. ``` Pesan menyebutkan pengaturan dan tempat pengaturan tersebut diatur, dan diakhiri dengan perbaikan untuk kasus yang Anda alami. Penolakan yang sama muncul untuk `core.attributesFile` dan `attr.tree`, masing-masing dengan perbaikannya sendiri. Pesan dapat menyebutkan file konfigurasi yang ditarik konfigurasi git Anda melalui direktif `include` atau `includeIf`, bahkan ketika kondisi direktif tersebut tidak berlaku untuk repositori ini. **Yang perlu dilakukan:** * Terapkan perbaikan pada kalimat terakhir pesan

GitHub tidak terhubung ke akun Claude Anda

Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repositori lokal Anda, misalnya dengan `/autofix-pr`. Tidak ada akun GitHub yang terhubung ke akun Claude Anda, atau koneksinya kedaluwarsa, sehingga Claude Code menolak peluncuran: ```text theme={null} GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github ``` Ketika Anda membuat routine dengan [`/schedule`](/docs/id/routines), pesan yang sama muncul sebagai catatan penyiapan yang menyebutkan repositori; catatan tersebut tidak memblokir pembuatan routine. **Yang perlu dilakukan:** * Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github). Lihat [Opsi autentikasi GitHub](/docs/id/claude-code-on-the-web#github-authentication-options) untuk perbedaan keduanya. * Jalankan ulang perintah satu menit setelah menghubungkan Sebelum v2.1.268, Claude Code melaporkan hal ini sebagai kegagalan sementara pemeriksaan Claude GitHub App dan menyarankan untuk mencoba ulang atau menginstal aplikasi; tidak satu pun dari keduanya menghubungkan akun GitHub.

Kebijakan organisasi GitHub memblokir Claude

Anda menjalankan perintah di prompt Claude Code yang memulai sesi cloud, seperti [`/autofix-pr`](/docs/id/claude-code-on-the-web#auto-fix-pull-requests). Sebelum membuat sesi, Claude Code memeriksa akses Claude ke repositori di GitHub, dan GitHub menolak karena organisasi GitHub Anda memiliki kebijakan yang memblokir Claude. Claude Code berhenti di situ dan menampilkan pesan yang menyebutkan kebijakan tersebut. Jika yang memblokir akses adalah IP allow list, pesannya berbunyi: ```text theme={null} Your GitHub organization has an IP allowlist that is blocking Claude. Add Claude's IP ranges to your GitHub allowlist. ``` Jika yang memblokirnya adalah single sign-on, pesannya berbunyi: ```text theme={null} Your GitHub organization requires single sign-on. Disconnect and reconnect GitHub on the Connectors page in Claude on the web, click Authorize next to your organization when GitHub asks, then try again. ``` Jika yang memblokirnya adalah kebijakan Conditional Access Microsoft Entra ID, pesannya berbunyi: ```text theme={null} Your GitHub organization's identity provider (Microsoft Entra ID) has a Conditional Access policy that is blocking Claude. Ask your GitHub Enterprise or Entra ID admin to allow Claude in that policy. ``` **Yang perlu dilakukan:** * **IP allow list**: minta pemilik organisasi atau enterprise GitHub Anda untuk mengizinkan alamat IP keluar Anthropic. Lihat [Allow list dan firewall GitHub](/docs/id/network-config#github-allow-lists-and-firewalls) untuk alamat dan pengaturan GitHub yang perlu diubah. * **Single sign-on**: putuskan koneksi GitHub di [claude.ai/customize/connectors](https://claude.ai/customize/connectors), lalu hubungkan kembali. Saat GitHub meminta, klik **Authorize** di samping organisasi Anda agar koneksi baru diotorisasi untuk single sign-on-nya. * **Kebijakan Conditional Access**: minta admin GitHub Enterprise atau Microsoft Entra ID Anda untuk mengizinkan Claude dalam kebijakan tersebut * Setelah perubahan, jalankan perintah itu lagi

Otorisasi single sign-on diperlukan

Anda menjalankan [`/install-github-app`](/docs/id/github-actions#quick-setup) dan memilih repositori yang organisasinya menerapkan SAML single sign-on. Sebelum penyiapan, Claude Code memeriksa akses Anda ke repositori dengan GitHub CLI, dan GitHub menolak pemeriksaan tersebut karena token `gh` Anda belum diotorisasi untuk organisasi tersebut. Wizard menampilkan peringatan beserta langkah-langkah untuk mengotorisasi: ```text theme={null} Single sign-on authorization needed / belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet. ``` **Yang perlu dilakukan:** * Otorisasi ulang login GitHub CLI Anda dengan scope `repo` dan `workflow` dengan menjalankan `gh auth refresh -h github.com -s repo,workflow`, lalu otorisasi organisasi saat GitHub meminta single sign-on * Jika Anda mengautentikasi dengan personal access token di `GH_TOKEN`, buka [github.com/settings/tokens](https://github.com/settings/tokens), pilih **Configure SSO** pada token tersebut, lalu otorisasi organisasi * Jalankan `/install-github-app` lagi Sebelum v2.1.273, Claude Code menampilkan peringatan `Admin permissions required` untuk kondisi ini.

Gagal melanjutkan percakapan

Claude Code tidak dapat membaca atau memproses transkrip tersimpan untuk sesi yang Anda pilih dari [pemilih `claude --resume`](/docs/id/sessions#use-the-session-picker), sehingga ia mengakhiri proses alih-alih melanjutkan dalam keadaan termuat sebagian. Pesan tersebut menyertakan perintah untuk mencoba ulang: ```text theme={null} Failed to resume the conversation. Run claude --resume to retry, or claude to start a new session. ``` Claude Code keluar dengan kode 1 setelah menampilkan pesan tersebut. Pemilih `/resume` di dalam sesi yang sedang berjalan melaporkan `Failed to resume conversation` di dalam percakapan, dan sesi Anda saat ini tetap berjalan. Sebelum v2.1.216, kegagalan melanjutkan dari pemilih `claude --resume` tetap berada di spinner `Resuming conversation…` tanpa batas waktu alih-alih menampilkan pesan ini. **Yang perlu dilakukan:** * Jalankan `claude --resume ` dengan ID sesi dari pesan tersebut untuk mencoba ulang * Pada versi sebelum v2.1.285, jika percobaan ulang gagal dengan cara yang sama, jalankan `claude update` lalu lanjutkan lagi. Versi-versi tersebut gagal melanjutkan ketika transkrip tersimpan berisi entri yang tidak dapat dibacanya. * Jika percobaan ulang gagal lagi, jalankan `claude` untuk memulai sesi baru

Tidak ada percakapan yang ditemukan dengan ID sesi

Anda meneruskan ID sesi ke `claude --resume ` dan tidak ada transkrip tersimpan yang cocok dengannya: ```text theme={null} No conversation found with session ID: ``` Claude Code keluar dengan kode 1 setelah menampilkan pesan tersebut. Claude Code [mencari ID tersebut di proyek saat ini terlebih dahulu, lalu di setiap proyek lain di mesin ini](/docs/id/sessions#where-the-session-picker-looks). Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan git worktree-nya, jadi lanjutkan sesi dari direktori tempat sesi terakhir bekerja. Penyebab umum: * **Salah ketik ID**: untuk eksekusi non-interaktif, ID adalah field `session_id` dari [output `--output-format json`](/docs/id/headless#get-structured-output) * **Transkrip terhapus**: Claude Code menghapus transkrip setelah [periode retensi](/docs/id/sessions#where-transcripts-are-stored), 30 hari secara default, mengikuti [aturan pembersihan retensi](/docs/id/claude-directory#cleaned-up-automatically) * **Mesin berbeda**: Claude Code menyimpan transkrip secara lokal, jadi lanjutkan sesi di mesin tempat sesi tersebut dijalankan * **Salinan duplikat**: jika Anda menyalin direktori proyek di bawah `~/.claude/projects` sehingga dua transkrip memiliki ID yang sama, Claude Code melaporkan pesan ini alih-alih melanjutkan salah satu salinan secara sembarang **Yang perlu dilakukan:** * Untuk sesi interaktif, buka [pemilih sesi](/docs/id/sessions#use-the-session-picker) dengan `claude --resume` dan tekan `Ctrl+A` untuk memperluasnya ke setiap proyek di mesin ini, lalu pilih sesinya * Sesi yang dibuat dengan `claude -p` atau [Agent SDK](/docs/id/agent-sdk/overview) tidak muncul di pemilih, jadi periksa kembali ID tersebut terhadap `session_id` yang dicetak oleh eksekusi awal Anda

Windows melaporkan kesalahan (EBADF) saat Claude Code membaca file transkrip sesi ini

Anda melanjutkan sesi di Windows, [file transkrip](/docs/id/sessions#where-transcripts-are-stored) tersimpannya terbuka secara normal, lalu pembacaannya gagal dengan kesalahan sistem EBADF. Kesalahan sistem tidak menyebutkan alasan pembacaan gagal, sehingga pesan tersebut menyarankan kemungkinan penyebab dan hal yang dapat dicoba: ```text theme={null} Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again. ``` Pesan tersebut muncul setelah baris kegagalan perintah itu sendiri, seperti `Failed to resume session `. Perintah `claude --resume` atau [`claude -p`](/docs/id/headless) keluar dengan kode 1 setelah menampilkannya. Setelah `/resume` di dalam sesi, sesi Anda saat ini tetap berjalan. **Yang perlu dilakukan:** * Kecualikan folder yang menyimpan transkrip sesi Anda dari perangkat lunak yang memindai atau mencegat pembacaan file, seperti alat keamanan, enkripsi, atau manajemen endpoint. Transkrip berada di `%USERPROFILE%\.claude\projects` secara default, atau di direktori yang disebutkan oleh [`CLAUDE_CONFIG_DIR`](/docs/id/env-vars) * Jika Anda tidak dapat menambahkan pengecualian, tambahkan Claude Code ke daftar aplikasi yang diizinkan oleh perangkat lunak tersebut * Lanjutkan sesi lagi Sebelum v2.1.282, kegagalan muncul tanpa penjelasan: `claude --resume ` berakhir di `Failed to resume session `, dan eksekusi `-p` hanya mencetak teks kesalahan sistem, seperti `Failed to resume session: EBADF: bad file descriptor, read`.

Tidak dapat beralih renderer dalam sesi ini

Saat Anda beralih renderer, Claude Code memulai ulang prosesnya. Anda menjalankan [`/tui`](/docs/id/fullscreen#enable-fullscreen-rendering) dalam sesi yang ditolak untuk dimulai ulang oleh Claude Code, sehingga ia tidak beralih dan tidak menyimpan apa pun. Pesan yang Anda lihat menunjukkan penyebabnya: * `Cannot switch renderers while work is running in the background`: Anda memiliki pekerjaan latar belakang yang sedang berjalan yang akan ditinggalkan oleh mulai ulang, seperti shell latar belakang atau subagent. Tunggu hingga pekerjaan selesai atau hentikan dengan [`/tasks`](/docs/id/commands), lalu jalankan `/tui fullscreen` atau `/tui default` lagi * `Cannot switch renderers in this session`: sesi memiliki batasan yang tidak dapat diteruskan Claude Code ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code tetap memulai ulang dan sesi yang diluncurkan kembali berjalan tanpa batasan tersebut Dalam pesan batasan, bagian di dalam tanda kurung menyebutkan batasan yang ditemukan Claude Code: ```text theme={null} Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too. ``` Setiap alasan yang dapat ditampilkan pesan di dalam tanda kurung: * `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Anda memulai sesi dengan flag yang tidak diteruskan kembali oleh Claude Code ke proses yang dimulai ulang. Flag ini mencakup [`--system-prompt`](/docs/id/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, allowlist [`--tools`](/docs/id/cli-reference#cli-flags), [`--setting-sources`](/docs/id/cli-reference#cli-flags), dan [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) * `permission rules set for this session only`: sebuah [pembaruan izin](/docs/id/hooks#permission-update-entries) dari hook atau pemanggil SDK menambahkan aturan deny atau ask dengan tujuan `session`. Aturan allow yang dibatasi ke sesi tidak memicu penolakan. Mulai ulang akan menghapusnya, dan Claude Code akan meminta izin lagi * `ask-before-running rules with no command-line form`: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan ask di samping aturan yang diteruskan kembali oleh Claude Code sebagai `--allowed-tools` dan `--disallowed-tools`. Tidak ada flag untuk aturan ask * `permission rules a command line cannot carry intact` dan `added directories a command line cannot carry intact`: pembaruan izin menambahkan aturan atau path direktori di tengah sesi. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama **Yang perlu dilakukan:** * Dalam sesi yang dimulai tanpa batasan tersebut, jalankan `/tui fullscreen`, atau `/tui default` untuk beralih kembali. Claude Code menyimpan [pengaturan `tui`](/docs/id/settings-reference#tui) di sana

Claude Code couldn't restart

Jika pesan ini menyatakan bahwa percakapan Anda tersimpan, percakapan tersebut ada di disk dan Anda dapat melanjutkannya dari titik berhentinya. Claude Code sedang memulai ulang dirinya sendiri, misalnya untuk beralih ke atau dari rendering fullscreen setelah Anda menjalankan [`/tui`](/docs/id/fullscreen#enable-fullscreen-rendering), dan tidak dapat memulai proses baru, sehingga keluar dengan status 1: ```text theme={null} Claude Code couldn't restart. Your conversation is saved. Start Claude Code again and run /resume to pick it up. ``` Jika proses mulai ulang tidak memiliki percakapan untuk dibuka kembali, misalnya karena `/tui` adalah input pertama Anda di sesi baru, pesannya berbunyi `Claude Code couldn't restart. Start Claude Code again.` **Yang perlu dilakukan:** * Jalankan `claude` lagi di shell Anda. Jika pesan menyatakan bahwa percakapan Anda tersimpan, jalankan [`/resume`](/docs/id/sessions#resume-a-session) di sesi baru dan pilih percakapannya. Jika tidak ada di daftar, [perluas picker sesi](/docs/id/sessions#where-the-session-picker-looks) * Jika proses mulai ulang terus gagal, mulai Claude Code dari shell Anda dengan [`claude --debug-file claude-debug.log`](/docs/id/cli-reference#cli-flags). Jika mulai ulang dari sesi tersebut gagal, `claude-debug.log` di direktori tempat Anda memulai mencatat baris `Failed to relaunch:` dengan error dari sistem operasi. Sertakan baris tersebut saat Anda [melaporkan masalahnya](#report-an-error)

Tidak dapat membuka Claude Desktop

Anda menjalankan [`/desktop`](/docs/id/desktop#coming-from-the-cli) atau aliasnya `/app` dalam sesi, atau [`claude --desktop`](/docs/id/cli-reference#cli-flags) di shell Anda, dan perintah sistem yang digunakan Claude Code untuk membuka Claude Desktop gagal. Setelah `/desktop`, sesi tetap berada di terminal; `claude --desktop` mencetak pesan tanpa awalan `Error:` dan keluar dengan status 1. Teks di dalam tanda kurung menyebutkan perintah yang gagal, beserta status keluarnya dan baris pertama output kesalahannya jika perintah tersebut menghasilkannya. Di macOS perintah tersebut adalah `open`, seperti dalam contoh ini; di Windows perintahnya adalah `rundll32`: ```text theme={null} Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session= with error -10814). Open Claude Desktop and try again. ``` **Yang perlu dilakukan:** * Buka Claude Desktop sendiri, lalu jalankan `/desktop` atau `claude --desktop` lagi * Untuk membaca output kesalahan lengkap dari perintah yang gagal, aktifkan logging debug dengan `/debug` lalu jalankan `/desktop` lagi, atau jalankan `claude --desktop --debug-file `, lalu periksa log debug Sebelum v2.1.285, pesan tersebut diakhiri dengan `Open Claude Desktop and run /desktop again.` Sebelum v2.1.275, pesannya adalah `Failed to open Claude Desktop. Please try opening it manually.` dan tidak menyebutkan apa yang gagal.

/terminal-setup membiarkan keymap Zed Anda tidak berubah

Anda menjalankan [`/terminal-setup`](/docs/id/terminal-config#enter-multiline-prompts) di Zed, dan Claude Code tidak dapat menyelesaikan pembaruan pada `keymap.json` Zed Anda, sehingga file tersebut dibiarkan seperti semula. Setiap pesan menyebutkan path ke keymap Anda dan diakhiri dengan blok pintasan keyboard untuk Anda tambahkan sendiri: ```text theme={null} Couldn't update your Zed keymap, so it was left unchanged. To add the binding yourself, add this block to the keymap array in : { "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } } ``` Baris pertama pesan menyebutkan penyebabnya: * `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code tidak dapat membaca file tersebut, misalnya karena hak akses file * `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: file terbaca dengan baik tetapi tidak dapat di-parse sebagai array blok pintasan keyboard, bahkan dengan komentar `//` dan koma di akhir yang diizinkan * `Couldn't back up your Zed keymap; not modifying it.`: Claude Code tidak dapat menyalin file ke cadangan `.bak` di sebelahnya, sehingga tidak mengubah apa pun * `Couldn't update your Zed keymap, so it was left unchanged.`: hasil penggabungan tidak terverifikasi sebagai keymap valid yang memuat pintasan tersebut, sehingga Claude Code membuangnya alih-alih menulisnya. Blok pintasan keyboard dengan kunci duplikat dapat menyebabkan hal ini **Yang perlu dilakukan:** * Salin blok dari pesan ke dalam array tingkat atas di `keymap.json` Anda pada path yang disebutkan pesan * Untuk `isn't a readable list of keybindings`, perbaiki kesalahan sintaksis, atau jadikan nilai tingkat atas file sebagai array, lalu jalankan `/terminal-setup` lagi Sebelum v2.1.247, `/terminal-setup` tidak dapat mem-parse keymap Zed yang menggunakan komentar `//` atau koma di akhir, dan mengganti seluruh file hanya dengan pintasannya sendiri sambil melaporkan pintasan tersebut sebagai terpasang. Untuk memulihkan keymap yang diganti oleh versi sebelumnya, gunakan file cadangan `.bak` yang dijelaskan di [Memasukkan prompt multibaris](/docs/id/terminal-config#enter-multiline-prompts).

Laporan penggunaan skill tidak tersedia pada koneksi ini

Anda menjalankan [`/skill-doctor`](/docs/id/skills#find-unused-skills) melalui [Remote Control](/docs/id/remote-control), dari ponsel atau browser Anda. Claude Code tidak mengirim laporan penggunaan skill melalui Remote Control dan membalas dengan pesan ini: ```text theme={null} Skill usage reports are not available on this connection. ``` **Yang perlu dilakukan:** * Jalankan `/skill-doctor` di terminal pada mesin tempat sesi berjalan, atau jalankan `claude -p "/skill-doctor"` di sana

Gaya output kustom tidak dapat dipilih melalui Remote Control

Anda menjalankan [`/output-style`](/docs/id/output-styles#change-your-output-style) dari aplikasi seluler atau web melalui [Remote Control](/docs/id/remote-control), atau perintah tersebut tiba dalam pesan yang diteruskan ke dalam sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code hanya mencantumkan dan memilih [gaya bawaan](/docs/id/output-styles#built-in-output-styles) pada giliran tersebut, dan menambahkan pemberitahuan ini setiap kali perintah mencantumkan gaya atau tidak mengenali nama yang Anda berikan. Nama [gaya kustom](/docs/id/output-styles#create-a-custom-output-style) mendapat balasan yang sama dengan nama yang tidak ada: ```text theme={null} Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here. ``` **Yang perlu dilakukan:** * Pilih gaya bawaan, misalnya `/output-style concise` * Untuk menggunakan gaya kustom, atur [`outputStyle`](/docs/id/settings-reference#outputstyle) di `.claude/settings.local.json` proyek, atau jalankan `/output-style

Temukan kesalahan Anda

Retry otomatis

Apa yang Anda lihat saat Claude Code mencoba ulang atau menunggu

Sesuaikan perilaku retry

Kesalahan server

API Error: 500 Internal server error

API Error: Repeated 529 Overloaded errors

Request timed out

No response from API

The response above may be incomplete

Auto mode cannot determine the safety of an action

The server returned no safety verdict

Agent terminated early due to an API error

Batas penggunaan

You've hit your session limit

Usage credits required for 1M context

The prompt to confirm went unanswered

Server is temporarily limiting requests

Request rejected (429)

You've hit your monthly spend limit

Spend limit reached

Credit balance is too low

Could not update your spend limit

Error autentikasi

Not logged in

Could not resolve authentication method

Invalid API key

Your apiKeyHelper script is failing

Invalid request header value

This organization has been disabled

Your organization has disabled API key authentication

Your organization has disabled Claude subscription access

Routines are disabled by your organization's policy

Remote Control requires the Anthropic API

Remote Control couldn't refresh your login

Remote Control could not renew this computer's connection

Remote Control stopped because the signed-in account changed

Remote Control stopped because the app running the session signed out or switched accounts

OAuth token revoked or expired

API Error: 401 Invalid authentication credentials

Login expired

Could not refresh your login because another Claude Code process is refreshing it

Couldn't save your login

Failed to start OAuth callback server

Claude login not accepted

Artifacts need a claude.ai login

Administrator policy requires a Cloud gateway sign-in

Your account is on hold

Anthropic profile login expired

OAuth scope requirement

claude.ai rejected the session token

MCP server needs you to sign in again

MCP server URL is missing or not a valid URL

Issuer mismatch in authorization response

Refusing to send credentials to non-https token endpoint

AWS credentials expired or invalid

AWS authentication failed

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Microsoft Foundry authentication failed

Could not load AWS or Google Cloud credentials

AWS default-chain credential resolve timed out

Bedrock setup verification timed out waiting for AWS

Cloud gateway session expired

Sign-in timed out while waiting for you to continue

Gateway refused the request

Kesalahan jaringan dan koneksi

Unable to connect to API

Unable to connect to Anthropic services

Socket is closed

API returned an empty or malformed response

Streaming response ended before any complete data was received

Bedrock streaming response has an unexpected content-type

SSL certificate errors

Host not allowed in a cloud session

The proxy refused the connection

The cloud environments service returned an empty or unexpected response

Failed to fetch session from Sessions API

Couldn't reconnect to your Remote Control session

Sessions ended while this machine was offline