diff --git a/id/errors.md b/id/errors.md
index 418260bceec5a90f7ded3ae337f9df01e85c9433..c0c0175fba29cce073b311c485948ec1023c917b 100644
--- a/id/errors.md
+++ b/id/errors.md
@@ -4,152 +4,387 @@
# Referensi kesalahan
-> Cari pesan kesalahan runtime Claude Code dengan penjelasan arti dan cara memperbaikinya.
+> Cari pesan kesalahan runtime Claude Code dengan arti masing-masing dan cara memperbaikinya.
Halaman ini mencantumkan kesalahan runtime yang ditampilkan Claude Code dan cara memulihkan dari masing-masing, ditambah apa yang harus diperiksa ketika respons tampak tidak normal tanpa kesalahan. Untuk kesalahan instalasi seperti `command not found` atau kegagalan TLS selama penyiapan, lihat [Troubleshoot installation and login](/docs/id/troubleshoot-install).
-Kesalahan dan perintah pemulihan ini berlaku di seluruh CLI, [aplikasi Desktop](/docs/id/desktop), dan [Claude Code di web](/docs/id/claude-code-on-the-web), karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah khusus permukaan, lihat bagian troubleshooting di halaman permukaan tersebut.
+Kecuali untuk [Wrapper and IDE errors](#wrapper-and-ide-errors), yang dicetak oleh program peluncur daripada Claude Code itu sendiri, kesalahan dan perintah pemulihan ini berlaku di seluruh CLI, [Desktop app](/docs/id/desktop), dan [cloud sessions](/docs/id/claude-code-on-the-web), karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah spesifik permukaan lainnya, lihat bagian pemecahan masalah di halaman permukaan tersebut.
- Claude Code memanggil Claude API untuk respons model, jadi sebagian besar kesalahan runtime memetakan ke kode kesalahan API yang mendasar. Halaman ini mencakup apa arti setiap kesalahan di dalam Claude Code dan cara memulihkan. Untuk definisi kode status HTTP mentah, lihat [referensi kesalahan Platform Claude](https://platform.claude.com/docs/en/api/errors).
+ Claude Code memanggil Claude API untuk respons model, jadi sebagian besar kesalahan runtime memetakan ke kode kesalahan API yang mendasar. Halaman ini mencakup apa arti setiap kesalahan di dalam Claude Code dan cara memulihkan. Untuk definisi kode status HTTP mentah, lihat [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).
Temukan kesalahan Anda
-Cocokkan pesan yang Anda lihat di terminal dengan bagian di bawah ini.
+Cocokkan pesan yang Anda lihat dengan bagian di bawah ini.
| Pesan | Bagian |
-| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
-| `API Error: 500 Internal server error` | [Kesalahan server](#api-error-500-internal-server-error) |
-| `API Error: Repeated 529 Overloaded errors` | [Kesalahan server](#api-error-repeated-529-overloaded-errors) |
-| `Request timed out` | [Kesalahan server](#request-timed-out), atau [Jaringan](#unable-to-connect-to-api) jika pesan menyebutkan koneksi internet Anda |
-| `Server error mid-response. The response above may be incomplete.` | [Kesalahan server](#the-response-above-may-be-incomplete) |
-| `Connection closed mid-response` / `Response stalled mid-stream` | [Kesalahan server](#the-response-above-may-be-incomplete) |
-| ` is temporarily unavailable, so auto mode cannot determine the safety of...` | [Kesalahan server](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Auto mode could not evaluate this action and is blocking it for safety` | [Kesalahan server](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Auto mode classifier transcript exceeded context window` | [Kesalahan server](#auto-mode-cannot-determine-the-safety-of-an-action) |
-| `Agent terminated early due to an API error` | [Kesalahan server](#agent-terminated-early-due-to-an-api-error) |
-| `You've hit your session limit` / `You've hit your weekly limit` | [Batas penggunaan](#youve-hit-your-session-limit) |
-| `Usage credits required for 1M context` | [Batas penggunaan](#usage-credits-required-for-1m-context) |
-| `Server is temporarily limiting requests` | [Batas penggunaan](#server-is-temporarily-limiting-requests) |
-| `Request rejected (429)` | [Batas penggunaan](#request-rejected-429) |
-| `Credit balance is too low` | [Batas penggunaan](#credit-balance-is-too-low) |
-| `Not logged in · Please run /login` | [Autentikasi](#not-logged-in) |
-| `Could not resolve authentication method` | [Autentikasi](#could-not-resolve-authentication-method) |
-| `Invalid API key` | [Autentikasi](#invalid-api-key) |
-| `Your apiKeyHelper script is failing` | [Autentikasi](#your-apikeyhelper-script-is-failing) |
-| `This organization has been disabled` | [Autentikasi](#this-organization-has-been-disabled) |
-| `Your organization has disabled API key authentication` | [Autentikasi](#your-organization-has-disabled-api-key-authentication) |
-| `Your organization has disabled Claude subscription access` | [Autentikasi](#your-organization-has-disabled-claude-subscription-access) |
-| `Routines are disabled by your organization's policy` | [Autentikasi](#routines-are-disabled-by-your-organizations-policy) |
-| `Remote Control is only available when using Claude via api.anthropic.com` | [Autentikasi](#remote-control-requires-the-anthropic-api) |
-| `OAuth token revoked` / `OAuth token has expired` | [Autentikasi](#oauth-token-revoked-or-expired) |
-| `Login expired · Please run /login` | [Autentikasi](#login-expired) |
-| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autentikasi](#login-expired) |
-| `does not meet scope requirement user:profile` | [Autentikasi](#oauth-scope-requirement) |
-| `AWS credentials expired or invalid` | [Autentikasi](#aws-credentials-expired-or-invalid) |
-| `AWS authentication failed` | [Autentikasi](#aws-authentication-failed) |
-| `AWS default-chain credential resolve timed out` | [Autentikasi](#aws-default-chain-credential-resolve-timed-out) |
-| `Unable to connect to API` | [Jaringan](#unable-to-connect-to-api) |
-| `Waiting for API response · will retry in` | [Percobaan ulang otomatis](#automatic-retries), atau [Jaringan](#unable-to-connect-to-api) jika terus berlanjut |
-| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Jaringan](#bedrock-streaming-response-has-an-unexpected-content-type) |
-| `SSL certificate verification failed` | [Jaringan](#ssl-certificate-errors) |
-| `SSL certificate error (...)` during login or startup | [Jaringan](#ssl-certificate-errors) |
-| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Jaringan](#host-not-allowed-in-a-cloud-session) |
-| `Couldn't reconnect to your Remote Control session` | [Jaringan](#couldnt-reconnect-to-your-remote-control-session) |
-| `Prompt is too long` | [Kesalahan permintaan](#prompt-is-too-long) |
-| `Error during compaction: Conversation too long` | [Kesalahan permintaan](#error-during-compaction-conversation-too-long) |
-| `Request too large` | [Kesalahan permintaan](#request-too-large) |
-| `Image was too large` | [Kesalahan permintaan](#image-was-too-large) |
-| `Unable to resize image` | [Kesalahan permintaan](#unable-to-resize-image) |
-| `PDF too large` / `PDF is password protected` | [Kesalahan permintaan](#pdf-errors) |
-| `Extra inputs are not permitted` | [Kesalahan permintaan](#extra-inputs-are-not-permitted) |
-| `There's an issue with the selected model` | [Kesalahan permintaan](#theres-an-issue-with-the-selected-model) |
-| `Model ... is not a recognized model id` | [Kesalahan permintaan](#model-is-not-a-recognized-model-id) |
-| `Claude Opus is not available with the Claude Pro plan` | [Kesalahan permintaan](#claude-opus-is-not-available-with-the-claude-pro-plan) |
-| `Model ... is restricted by your organization's settings` | [Kesalahan permintaan](#model-is-restricted-by-your-organizations-settings) |
-| `thinking.type.enabled is not supported for this model` | [Kesalahan permintaan](#thinking-type-enabled-is-not-supported-for-this-model) |
-| `max_tokens must be greater than thinking.budget_tokens` | [Kesalahan permintaan](#thinking-budget-exceeds-output-limit) |
-| `API Error: 400 due to tool use concurrency issues` | [Kesalahan permintaan](#tool-use-or-thinking-block-mismatch) |
-| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Kesalahan permintaan](#usage-policy-refusal) |
-| ` has safety measures that flagged this message for a cybersecurity topic` | [Kesalahan permintaan](#safety-measures-flagged-a-cybersecurity-topic) |
-| `Installation was killed before it could finish (exit code 137)` | [Kesalahan instalasi](#installation-was-killed-before-it-could-finish) |
-| `The connection dropped while downloading the update` | [Kesalahan instalasi](#the-connection-dropped-while-downloading-the-update) |
-| `Download timed out: exceeded the total deadline` | [Kesalahan instalasi](#the-connection-dropped-while-downloading-the-update) |
-| `--bg and --print conflict` | [Kesalahan baris perintah](#command-line-errors) |
-| `Error: --json-schema is not a valid JSON Schema` | [Kesalahan baris perintah](#command-line-errors) |
-| `Could not import : ` | [Kesalahan baris perintah](#could-not-import-a-server-from-claude-desktop) |
-| `Error: MCP tool (passed via --permission-prompt-tool) not found` | [Kesalahan baris perintah](#mcp-permission-prompt-tool-not-found) |
-| `Marketplace "" is registered from an untrusted source` | [Kesalahan plugin](#marketplace-is-registered-from-an-untrusted-source) |
-| `references ${user_config.*} in a shell-form command` | [Kesalahan plugin](#plugin-command-references-user-config) |
-| `Monitor "" from plugin references ${user_config.*} in its command` | [Kesalahan plugin](#plugin-command-references-user-config) |
-| `headersHelper for MCP server '' references ${user_config.*}` | [Kesalahan plugin](#plugin-command-references-user-config) |
-| `would be spawned with zero tools — refusing` | [Kesalahan alat](#agent-would-be-spawned-with-zero-tools) |
-| `File is covered by a Read deny rule in your permission settings` | [Kesalahan alat](#file-is-covered-by-a-read-deny-rule) |
-| `Can't open MCP settings in a background session` | [Kesalahan sesi latar belakang](#commands-refused-in-a-background-session) |
-| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Kesalahan sesi latar belakang](#claude_code_process_wrapper-launcher-errors) |
-| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Peringatan konfigurasi](#workspace-has-not-been-trusted) |
-| Responses seem lower quality than usual | [Kualitas respons](#responses-seem-lower-quality-than-usual) |
+| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------- |
+| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |
+| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |
+| `Request timed out` | [Server errors](#request-timed-out), atau [Network](#unable-to-connect-to-api) jika pesan menyebutkan koneksi internet Anda |
+| `API Error: No response from API` | [Server errors](#no-response-from-api) |
+| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |
+| `Connection lost before a response was produced` / `Your computer went to sleep before a response was produced` / `The response stalled before a response was produced` | [Automatic retries](#automatic-retries) |
+| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |
+| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |
+| ` is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
+| `Agent terminated early due to an API error` | [Server errors](#agent-terminated-early-due-to-an-api-error) |
+| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [Usage limits](#youve-hit-your-session-limit) |
+| `Usage credits required for 1M context` | [Usage limits](#usage-credits-required-for-1m-context) |
+| `the prompt to confirm went unanswered — nothing was sent` | [Usage limits](#the-prompt-to-confirm-went-unanswered) |
+| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |
+| `Request rejected (429)` | [Usage limits](#request-rejected-429) |
+| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |
+| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Usage limits](#youve-hit-your-monthly-spend-limit) |
+| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |
+| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |
+| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |
+| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |
+| `Invalid API key` | [Authentication](#invalid-api-key) |
+| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |
+| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |
+| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
+| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
+| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |
+| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |
+| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |
+| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |
+| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |
+| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Claude.ai login expired` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Claude.ai login was rejected — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `OAuth token unavailable — run /login to restore Remote Control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `Signed out of Claude — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
+| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |
+| `Remote Control stopped — the app running this session is now signed in to a different Claude account` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
+| `Remote Control stopped — the app running this session is signed out of Claude` | [Authentication](#remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts) |
+| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
+| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
+| `Login expired · Please run /login` | [Authentication](#login-expired) |
+| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
+| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
+| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
+| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |
+| `Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
+| `Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted` | [Authentication](#your-account-is-on-hold) |
+| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
+| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentication](#anthropic-profile-login-expired) |
+| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |
+| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
+| `MCP server "" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `MCP server "" needs additional permissions (scope: "") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `MCP server "" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
+| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |
+| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |
+| `Cloud gateway no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |
+| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |
+| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |
+| `Google Cloud credentials expired or invalid` | [Authentication](#google-cloud-credentials-expired-or-invalid) |
+| `Google Cloud authentication failed` | [Authentication](#google-cloud-authentication-failed) |
+| `Microsoft Foundry authentication failed` | [Authentication](#microsoft-foundry-authentication-failed) |
+| `Gateway refused the request` | [Authentication](#gateway-refused-the-request) |
+| `Could not load AWS credentials` / `Could not load Google Cloud credentials` | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
+| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |
+| `Timed out after 60s waiting for AWS` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
+| `A request to AWS timed out. Check your network and proxy settings, then try again.` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
+| `Could not load the default credentials` pada Google Cloud's Agent Platform | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
+| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |
+| `Connection refused —` / `Can't reach the API server —` / `No internet route —` / `Couldn't connect through your proxy` / `Connection dropped`, masing-masing dengan kode kesalahan dalam tanda kurung | [Network](#unable-to-connect-to-api) |
+| `Unable to connect to Anthropic services` selama penyiapan | [Network](#unable-to-connect-to-anthropic-services) |
+| `Socket is closed` | [Network](#socket-is-closed) |
+| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), atau [Network](#unable-to-connect-to-api) jika terus berlanjut |
+| `API returned an empty or malformed response` | [Network](#api-returned-an-empty-or-malformed-response) |
+| `Streaming response ended before any complete data was received` | [Network](#streaming-response-ended-before-any-complete-data-was-received) |
+| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |
+| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |
+| `SSL certificate error (...)` selama login atau startup | [Network](#ssl-certificate-errors) |
+| `unable to get local issuer certificate` | [Network](#ssl-certificate-errors) |
+| `403` dengan `x-deny-reason: host_not_allowed` dalam sesi cloud atau routine | [Network](#host-not-allowed-in-a-cloud-session) |
+| `proxy refused the connection` | [Network](#the-proxy-refused-the-connection) |
+| `403` dengan `This GraphQL query is not enabled for this session` dalam sesi cloud | [GitHub proxy](/docs/id/cloud-environments#github-proxy) |
+| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [Network](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |
+| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
+| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [Network](#sessions-ended-while-this-machine-was-offline) |
+| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
+| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |
+| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |
+| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |
+| `Context limit reached · /compact or /clear to continue` | [Request errors](#prompt-is-too-long) |
+| `Context limit reached · /clear to continue` | [Request errors](#prompt-is-too-long) |
+| `capability_rejected: prompt_too_long` pada sesi gateway aplikasi Claude | [Request errors](#prompt-is-too-long) |
+| `upstream rejected the request` / `request too large for this upstream` pada sesi gateway aplikasi Claude | [Upstream error messages](/docs/id/claude-apps-gateway-config#upstream-error-messages) |
+| `upstream rate limit exceeded` pada sesi gateway aplikasi Claude | [Upstream error messages](/docs/id/claude-apps-gateway-config#upstream-error-messages) |
+| `all upstreams failed (N attempted)` pada sesi gateway aplikasi Claude | [Upstream error messages](/docs/id/claude-apps-gateway-config#upstream-error-messages) |
+| `Claude Code may not be enabled for your organization` setelah login gateway aplikasi Claude | [Claude apps gateway troubleshooting](/docs/id/claude-apps-gateway-deploy#troubleshooting) |
+| `Context exceeds the ...-token limit by ... tokens` dalam output `/context` | [Request errors](#context-exceeds-the-token-limit) |
+| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |
+| `Request too large` | [Request errors](#request-too-large) |
+| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |
+| `Image was too large` | [Request errors](#image-was-too-large) |
+| `Unable to resize image` | [Request errors](#unable-to-resize-image) |
+| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |
+| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
+| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
+| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |
+| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |
+| `Model ... not found` | [Request errors](#model-not-found) |
+| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |
+| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |
+| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |
+| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
+| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |
+| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |
+| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |
+| `Effort '' isn't available with thinking turned off on this model` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
+| `effort '' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
+| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |
+| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |
+| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |
+| `server_tool_use.name: Input should be` pada setiap putaran sesi yang dilanjutkan | [Request errors](#unsupported-tool-content-removed) |
+| ` can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
+| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
+| `'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
+| ` has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
+| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |
+| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
+| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
+| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |
+| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
+| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
+| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
+| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |
+| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |
+| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |
+| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [Command-line errors](#the-current-directory-no-longer-exists) |
+| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [Command-line errors](#directory-couldnt-be-resolved-to-a-real-location) |
+| `Error: Workspace not trusted` saat memulai Remote Control | [Command-line errors](#workspace-not-trusted-when-starting-remote-control) |
+| `` `` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Command-line errors](#not-carried-over-to-the-sessions-remote-control-starts) |
+| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |
+| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
+| `Could not import : ` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |
+| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |
+| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |
+| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |
+| `Server rejected the Authorization header minted by the configured headersHelper` | [Command-line errors](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
+| `Error: MCP tool (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |
+| `OAuth callback port is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |
+| `No available ports for OAuth redirect` | [Command-line errors](#no-available-ports-for-oauth-redirect) |
+| `Shell command failed for pattern "..."`, dari `/security-review` atau skill apa pun yang menyuntikkan konteks dinamis | [Command-line errors](#security-review-fails-without-origin-head) |
+| `Shell command permission check failed for pattern "..."`, dari skill yang menyuntikkan konteks dinamis | [Command-line errors](#security-review-fails-without-origin-head) |
+| ``Skill requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
+| `Input must be provided either through stdin or as a prompt argument when using --print` | [Command-line errors](#input-must-be-provided-when-using-print) |
+| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |
+| `Blank prompt — the message was only whitespace, so nothing was sent to the model.` | [Command-line errors](#input-contained-only-whitespace) |
+| `Error: stream-json input carried over 256M characters with no newline` | [Command-line errors](#stream-json-input-carried-over-256m-characters-with-no-newline) |
+| `Unknown command: /`, dengan atau tanpa saran `Did you mean` | [Command-line errors](#unknown-command) |
+| `Diff is too large for ultrareview` / `PR # is too large for ultrareview` | [Command-line errors](#diff-is-too-large-for-ultrareview) |
+| `Could not find merge-base with ` | [Command-line errors](#could-not-find-merge-base-with-the-base-branch) |
+| `Your checkout has no branches (detached HEAD only)` | [Command-line errors](#your-checkout-has-no-branches) |
+| `Ultrareview clones / in the cloud with the GitHub account connected to your Claude account, and none is connected` | [Command-line errors](#no-github-account-is-connected-to-your-claude-account) |
+| `Your connected GitHub account can't see /` | [Command-line errors](#your-connected-github-account-cant-see-the-repository) |
+| `The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead` | [Command-line errors](#the-github-app-preflight-failed-transiently) |
+| `GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud` | [Command-line errors](#github-isnt-connected-to-your-claude-account) |
+| `Single sign-on authorization needed` | [Command-line errors](#single-sign-on-authorization-needed) |
+| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |
+| `No conversation found with session ID: ` | [Command-line errors](#no-conversation-found-with-the-session-id) |
+| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
+| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
+| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
+| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
+| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |
+| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |
+| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |
+| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
+| `Marketplace "" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
+| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
+| `Monitor "" from plugin references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
+| `headersHelper for MCP server '' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
+| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
+| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
+| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
+| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
+| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
+| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |
+| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |
+| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |
+| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
+| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
+| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
+| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
+| `Failed to write to 's inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
+| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
+| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
+| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
+| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
+| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is not the expected process` / `Refusing to send: connected endpoint identity could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is not owned by this user` / `Refusing to send: connected endpoint owner could not be read` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to send: connected endpoint is a different process with the expected pid` | [Tool errors](#refusing-to-send-a-cross-session-message) |
+| `Refusing to read : its symlink resolution changed after permission was checked ()` / `Refusing to search : its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to write : its parent-directory symlink resolution changed after permission was checked` / `Refusing to write : it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to write through symlink: ` / `Refusing to write into symlinked directory: ` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `Refusing to search : a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search : it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `its permission check expired before it ran (too many concurrent file operations)` / `ripgrep was found only by name on PATH` | [Tool errors](#refusing-after-a-symlink-changed) |
+| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |
+| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |
+| `the source file is not valid UTF-8 text` / `the source file is not valid UTF-16 text` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
+| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
+| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
+| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
+| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |
+| `Can't open MCP settings while no terminal is attached to this background session` | [Background session errors](#commands-refused-in-a-background-session) |
+| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |
+| `blocked because the path is spelled in a form that cannot be safely resolved` | [Background session errors](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |
+| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |
+| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |
+| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
+| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
+| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
+| `kept — its worktree is still at ` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `kept — unpushed commits on ` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `kept — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
+| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [Background session errors](#terminal-host-process-died) |
+| `Session isn't responding` / `Press enter again to restart this session — it isn't responding` | [Background session errors](#session-isnt-responding) |
+| `Session was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
+| `This session was running agent '', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
+| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
+| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
+| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
+| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |
+| `Couldn't start a background session (working directory no longer exists or is not accessible: ...)` | [Background session errors](#working-directory-no-longer-exists-when-starting-a-background-session) |
+| `Claude Code is being updated by npm on this machine (still not runnable after 2 min, ...)` | [Background session errors](#eacces-when-starting-a-background-session) |
+| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
+| `The connection to Claude Code ended before this message completed` | [Wrapper and IDE errors](#the-connection-to-claude-code-ended-before-this-message-completed) |
+| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |
+| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |
+| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |
+| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |
+| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |
+| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |
+| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |
+| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |
+| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |
+| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |
+| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |
+| `Remote managed settings failed to load ()` | [Configuration warnings](#remote-managed-settings-failed-to-load) |
+| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |
+| `MCP server is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |
+| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
+| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
+| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |
+| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
+| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
+| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
+| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
+| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
+| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
+| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |
+| Respons tampak berkualitas lebih rendah dari biasanya | [Response quality](#responses-seem-lower-quality-than-usual) |
- Percobaan ulang otomatis
+ Pengulangan otomatis
-Claude Code mencoba ulang kegagalan transien sebelum menampilkan kesalahan kepada Anda. Kesalahan server, respons kelebihan beban, waktu tunggu permintaan, throttle 429 sementara, dan koneksi yang terputus semuanya dicoba ulang hingga 10 kali dengan backoff eksponensial. Mulai dari v2.1.198, ini mencakup koneksi yang terputus di tengah respons sebelum output yang terlihat telah dialirkan: Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut daripada berhenti dengan kesalahan koneksi. Mulai dari v2.1.199, throttle 429 sementara yang tidak membawa header kuota paket Anda juga dicoba ulang ketika Anda masuk dengan langganan claude.ai; versi sebelumnya hanya mencoba ulang untuk autentikasi kunci API dan Enterprise.
+Claude Code mengulangi kegagalan transien hingga 10 kali dengan exponential backoff sebelum menampilkan kesalahan kepada Anda. Tidak selalu mengulangi kegagalan yang tiba di tengah respons Claude. Ketika Anda melihat salah satu kesalahan di halaman ini, Claude Code telah membuat pengulangan apa pun yang berlaku untuk kegagalan tersebut; daftar di bawah mengatakan kegagalan mana yang mendapat anggaran penuh, mana yang mendapat anggaran lebih kecil, dan mana yang tidak mendapat apa pun.
-Beberapa kelas kegagalan tidak dicoba ulang, karena percobaan ulang tidak dapat berhasil:
+Claude Code mengulangi kegagalan ini:
-* Mulai dari v2.1.199, kegagalan validasi sertifikat TLS, seperti proxy yang menginspeksi TLS, bundel `NODE_EXTRA_CA_CERTS` yang hilang, atau sertifikat yang kedaluwarsa, gagal pada percobaan pertama sehingga perbaikan muncul segera daripada setelah anggaran percobaan ulang penuh. Lihat [Kesalahan sertifikat SSL](#ssl-certificate-errors). Kondisi TLS transien seperti timeout handshake masih mencoba ulang.
-* Mulai dari v2.1.199, kesalahan server yang tiba setelah Claude telah dialirkan output yang terlihat menjaga respons parsial dan menambahkan [pemberitahuan respons tidak lengkap](#the-response-above-may-be-incomplete) daripada mencoba ulang, karena menjalankan kembali permintaan dapat menjalankan alat yang sama dua kali. Versi sebelumnya membuang output parsial dan melaporkan giliran sebagai kesalahan.
-* Respons streaming [Amazon Bedrock dengan tipe konten yang tidak terduga](#bedrock-streaming-response-has-an-unexpected-content-type) gagal pada percobaan pertama, karena gateway atau proxy yang menulis ulang respons akan menulis ulang percobaan ulang dengan cara yang sama. Memerlukan Claude Code v2.1.208 atau lebih baru.
+* Server errors, overloaded responses, dan request timeouts yang tiba sebelum respons Claude mulai streaming.
+* Dropped connections. Ketika koneksi terputus di tengah permintaan sebelum Claude menyelesaikan bagian mana pun dari responsnya, termasuk pemikirannya, Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut, bahkan jika beberapa teks telah mulai streaming. Ketika terputus setelah Claude selesai berpikir tetapi sebelum memulai teks atau panggilan alat apa pun, Claude Code malah mengeluarkan kembali permintaan hingga dua kali dengan cepat, dan mengakhiri giliran dengan `Connection lost before a response was produced` jika koneksi terus terputus pada titik itu.
+* Koneksi yang Claude Code deteksi rusak karena komputer Anda tidur di tengah permintaan. Claude Code menghitungnya sebagai dropped connection sesuai aturan di atas; setelah label pengulangan menyebutkan alasan spesifik, dibaca `Connection lost while your computer was asleep`, dan jika giliran berakhir setelah Claude selesai berpikir tetapi sebelum teks atau panggilan alat apa pun, pesan berbunyi `Your computer went to sleep before a response was produced`.
+* Stalled response stream, ketika response headers telah tiba tetapi tidak ada respons Claude yang tiba, atau ketika Claude selesai berpikir tetapi belum memulai teks atau panggilan alat apa pun: Claude Code membatalkan koneksi yang macet dan mengeluarkan kembali permintaan paling banyak sekali, di luar anggaran 10-percobaan di atas. Jika respons macet untuk kedua kalinya setelah Claude selesai berpikir tetapi sebelum teks atau panggilan alat apa pun, Claude Code mengakhiri giliran dengan `The response stalled before a response was produced`.
+* Streaming request yang API tidak pernah jawab dengan response headers, pada koneksi di mana [first-byte deadline berjalan](/docs/id/network-config#streaming-idle-watchdogs): Claude Code membatalkannya pada deadline dan mengirimnya kembali paling banyak sekali per model request, dalam anggaran pengulangan, kemudian mengakhiri giliran dengan [No response from API](#no-response-from-api) jika percobaan itu juga tidak dijawab. Pada koneksi lain, permintaan menunggu `API_TIMEOUT_MS`. Ketika Anda menetapkan `CLAUDE_CODE_RETRY_WATCHDOG`, batas satu pengulangan tidak berlaku.
+* Temporary 429 throttles, tetapi bukan `429` spend-limit gateway, yang bukan throttle; lihat [Spend limit reached](#spend-limit-reached).
+ * Ketika Anda masuk dengan langganan claude.ai, ini mencakup 429 throttles yang tidak membawa header kuota rencana Anda. Sebelum v2.1.199, Claude Code hanya mengulangi throttles tersebut untuk API key dan Enterprise sign-ins.
+* Permintaan ditolak karena input plus `max_tokens` melebihi context limit. Mengirimnya kembali tanpa perubahan akan gagal dengan cara yang sama, jadi Claude Code mengulangi dengan `max_tokens` yang dikurangi, dan berhenti mengulangi dan melakukan compact sebagai gantinya dalam dua kasus:
+ * Ketika tidak ada pengurangan yang dapat muat, misalnya ketika percakapan itu sendiri hampir mengisi context window.
+ * Ketika pengulangan tidak dapat menyusutkan `max_tokens` lebih jauh. Sebelum v2.1.218, Claude Code dapat mengirim kembali permintaan yang dikurangi yang masih tidak muat, seperti ketika extended thinking budget melebihi context yang tersisa, sampai anggaran pengulangan habis.
+* Expired atau missing Google Cloud credential pada [Google Cloud's Agent Platform](/docs/id/google-vertex-ai), atau AWS credentials yang gagal dimuat di mesin Anda. Claude Code membuang credentials yang di-cache dan mengulangi hingga dua kali, kemudian melaporkan kesalahan sehingga Anda dapat re-authenticate segera, seperti dijelaskan di bawah [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Sebelum v2.1.228, Claude Code mengulangi failing Google Cloud credential melalui anggaran pengulangan penuh sebelum menampilkan kesalahan.
+* `401` atau `403` dari Anthropic API, secara langsung atau melalui [LLM gateway](/docs/id/llm-gateway), sementara script [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) menyediakan credential. Claude Code menjalankan kembali script dan mengulangi dengan output segar-nya, dalam anggaran pengulangan penuh. Ketika script itu sendiri gagal pada re-run, Claude Code menampilkan [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing) sebagai gantinya.
-Saat mencoba ulang, spinner menampilkan hitungan mundur `Retrying in Ns · attempt x/y` setelah label kesalahan. Label menyebutkan alasan spesifik dari percobaan pertama untuk kegagalan yang dapat Anda tindaklanjuti segera: jaringan tidak aktif, handshake TLS gagal, atau Anda mencapai batas laju. Untuk kesalahan lainnya, itu berbunyi `API error` pada awalnya. Mulai dari v2.1.198, itu beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika `CLAUDE_CODE_MAX_RETRIES` memungkinkan lebih sedikit dari tiga; versi sebelumnya hanya beralih pada percobaan terakhir.
+Sebelum v2.1.227, `Connection lost before a response was produced` berbunyi `Connection closed while thinking, before producing a response` dan `The response stalled before a response was produced` berbunyi `Response stalled while thinking, before producing a response`.
-Mulai dari v2.1.198, tip spinner biasa ditekan selama percobaan ulang. Setelah alasan kesalahan terungkap, jika kegagalan adalah kelebihan beban 529, baris di bawah hitungan mundur juga menyebutkan di mana memeriksa status layanan: `status.claude.com` di API Anthropic, atau host penyedia atau gateway yang disebutkan dalam pesan pada konfigurasi lain.
+Claude Code tidak mengulangi kegagalan ini:
-Jika tidak ada data yang tiba di aliran respons selama 20 detik sementara permintaan masih tertunda, spinner menampilkan `Waiting for API response · will retry in … · check your network` sebelum percobaan ulang apa pun dimulai. Permintaan belum gagal: hitungan mundur berjalan ke titik di mana Claude Code membatalkan koneksi yang macet dan mencoba ulang, sehingga banner hilang dengan sendirinya setelah data dilanjutkan atau percobaan ulang berhasil. Mulai dari v2.1.185 ambang batasnya adalah 20 detik; versi sebelumnya menampilkan banner setelah 10 detik dengan wording yang berbeda. Jika muncul kembali pada setiap percobaan, perlakukan sebagai [masalah jaringan](#unable-to-connect-to-api).
+* TLS certificate validation failure, seperti TLS-inspecting proxy, missing `NODE_EXTRA_CA_CERTS` bundle, atau expired certificate. Claude Code melaporkan kesalahan pada percobaan pertama, sehingga Anda dapat memperbaiki setup certificate dengan segera; lihat [SSL certificate errors](#ssl-certificate-errors). Claude Code masih mengulangi transient TLS conditions seperti handshake timeout. Sebelum v2.1.199, Claude Code mengulangi certificate failures melalui anggaran pengulangan penuh sebelum menampilkan kesalahan.
+* Server error, dropped connection, atau stalled stream yang tiba setelah Claude menyelesaikan blok teks atau panggilan alat, atau telah memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum menyelesaikan respons. Claude Code tidak menjalankan kembali permintaan, karena itu dapat mengeksekusi panggilan alat yang sama dua kali. Ini menyimpan apa yang Claude selesaikan, menjalankan panggilan alat apa pun yang Claude selesaikan, dan melanjutkan giliran dari hasil mereka. Untuk apa yang Anda lihat dalam sesi interaktif dan non-interaktif, baca [The response above may be incomplete](#the-response-above-may-be-incomplete). Sebelum v2.1.199, Claude Code membuang output parsial dan melaporkan seluruh giliran sebagai kesalahan ketika server error tiba di tengah-tengah stream.
+* Kegagalan yang tiba setelah Claude menyelesaikan respons: tidak ada yang perlu diulangi, jadi Claude Code menyimpan respons lengkap dan mengakhiri giliran secara normal.
+* [Amazon Bedrock streaming response dengan unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type), karena gateway atau proxy yang menulis ulang respons akan menulis ulang pengulangan dengan cara yang sama. Memerlukan Claude Code v2.1.208 atau lebih baru.
+* Non-streaming retry dari failed streaming request yang mendapat success status tetapi [no Claude API message in the body](#api-returned-an-empty-or-malformed-response). Claude Code mengakhiri giliran dengan kesalahan itu.
+* Permintaan yang policy check organisasi Anda tolak, yang muncul sebagai baris `API Error:` yang membawa pesan penolakan. Administrator organisasi Anda menyiapkan check dengan [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), fitur Claude Enterprise, dan pesan berakhir dengan instruksi yang mereka konfigurasi, atau secara default memberi tahu Anda untuk menghubungi mereka. Claude Code tidak mengirim kembali permintaan yang ditolak ke model yang sama atau ke [fallback model](/docs/id/model-config#fallback-model-chains), karena penolakan adalah tentang konten permintaan daripada model. Sebelum v2.1.239, Claude Code dapat mengirim kembali permintaan yang ditolak, tanpa streaming atau pada fallback model yang dikonfigurasi, sebelum menampilkan penolakan kepada Anda.
-Ketika Anda melihat salah satu kesalahan di halaman ini, percobaan ulang tersebut telah habis, kecuali jika itu termasuk kelas yang tidak dicoba ulang, seperti kegagalan validasi sertifikat. Anda dapat menyesuaikan perilaku dengan variabel lingkungan ini:
+
+ Apa yang Anda lihat saat Claude Code mengulangi atau menunggu
+
+
+Saat mengulangi, spinner menampilkan countdown `Retrying in Ns · attempt x/y` setelah label kesalahan. Label menyebutkan alasan spesifik dari percobaan pertama untuk kegagalan yang dapat Anda tindaklanjuti segera: jaringan tidak aktif, TLS handshake gagal, atau Anda mencapai rate limit. Untuk kesalahan lain dibaca `API error` pada awalnya. Mulai v2.1.198 beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika `CLAUDE_CODE_MAX_RETRIES` memungkinkan lebih sedikit dari tiga; versi sebelumnya beralih hanya pada percobaan terakhir.
+
+Mulai v2.1.198, spinner tip biasa ditekan selama pengulangan. Setelah alasan kesalahan terungkap, jika kegagalan adalah 529 overload baris di bawah countdown juga menyebutkan di mana memeriksa status layanan: `status.claude.com` pada Anthropic API, atau penyedia atau host gateway yang dinamai dalam pesan pada konfigurasi lain.
+
+Jika tidak ada data yang tiba pada response stream selama 20 detik sementara permintaan masih tertunda, spinner menampilkan `Waiting for API response · will retry in … · check your network` sebelum pengulangan apa pun telah dimulai. Permintaan belum gagal: countdown berjalan ke titik di mana Claude Code membatalkan koneksi yang macet. Setelah pembatalan, apa yang Anda lihat tergantung pada seberapa jauh respons telah sampai:
+
+* Sebelum Claude menyelesaikan blok teks atau panggilan alat, atau memulai satu setelah menyelesaikan pemikirannya, Claude Code mengulangi permintaan atau mengakhiri giliran dengan kesalahan. [Automatic retries](#automatic-retries) mengatakan stalls mana yang diulanginya dan berapa kali.
+* Setelah Claude menyelesaikan blok teks atau panggilan alat, atau memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum Claude menyelesaikan respons, Claude Code menyimpan apa yang Claude selesaikan, melanjutkan giliran dari panggilan alat apa pun yang Claude selesaikan, dan menampilkan [The response above may be incomplete](#the-response-above-may-be-incomplete). Dalam sesi non-interaktif, dan untuk respons subagent dalam sesi apa pun, Claude Code mungkin pertama-tama meminta Claude untuk melanjutkan respons; entry itu mengatakan kapan itu terjadi dan kapan Anda masih melihat pemberitahuan di sana.
+* Setelah Claude menyelesaikan respons, Claude Code mengakhiri giliran secara normal.
+
+Banner menghapus dirinya sendiri setelah data dilanjutkan atau pengulangan berhasil. Jika muncul kembali pada setiap percobaan, perlakukan sebagai [network issue](#unable-to-connect-to-api). Sebelum v2.1.185, banner muncul setelah 10 detik dengan wording berbeda.
+
+Saat Claude berkonsultasi dengan [advisor](/docs/id/advisor), banner muncul setelah 90 detik tanpa data bukan 20, karena review advisor yang panjang dapat mengirim tidak ada selama lebih dari 20 detik. Sebelum v2.1.214, threshold 20-detik diterapkan selama advisor calls juga, jadi banner muncul selama advisor reviews bahkan ketika tidak ada yang salah.
+
+
+ Sesuaikan perilaku pengulangan
+
+
+Anda dapat menyesuaikan perilaku pengulangan dengan variabel lingkungan ini:
-| Variabel | Default | Efek |
-| :------------------------------------------- | :------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [`CLAUDE_CODE_MAX_RETRIES`](/docs/id/env-vars) | 10 | Jumlah percobaan ulang. Dibatasi pada 15 mulai dari v2.1.186; mulai dari v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` menaikkan default dan menghapus batas. Turunkan untuk menampilkan kegagalan lebih cepat dalam skrip. |
-| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/id/env-vars) | unset | Atur ke `1` dalam sesi tanpa pengawasan seperti pekerjaan CI untuk mencoba ulang kesalahan kapasitas `429` dan `529` tanpa batas daripada gagal setelah percobaan `CLAUDE_CODE_MAX_RETRIES`. Mulai dari v2.1.199, itu juga menaikkan jumlah percobaan ulang default untuk kesalahan transien lainnya, seperti kesalahan server, timeout, dan koneksi yang terputus, menjadi 300, kira-kira tiga jam backoff, dan menghapus batas 15 pada `CLAUDE_CODE_MAX_RETRIES` jika Anda menetapkan variabel itu secara eksplisit. |
-| [`API_TIMEOUT_MS`](/docs/id/env-vars) | 600000 | Waktu tunggu per permintaan dalam milidetik. Naikkan untuk jaringan lambat atau proxy. |
+| Variable | Default | Effect |
+| :---------------------------------------------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`CLAUDE_CODE_MAX_RETRIES`](/docs/id/env-vars) | 10 | Jumlah percobaan pengulangan. Dibatasi pada 15 mulai v2.1.186; mulai v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` menaikkan default dan menghapus batas. Turunkan untuk menampilkan kegagalan lebih cepat dalam script. |
+| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/id/env-vars) | unset | Atur ke `1` dalam sesi tanpa pengawasan seperti CI jobs untuk mengulangi `429` dan `529` capacity errors tanpa batas bukan gagal setelah `CLAUDE_CODE_MAX_RETRIES` percobaan. Claude Code gagal sekaligus ketika standard-speed request mendapat `429` yang melaporkan spend limit atau exhausted usage credits, bahkan satu dari [gateway spend cap](#spend-limit-reached) yang reset pada jadwal. Sebelum v2.1.239, watchdog mengulangi ini tanpa batas. Untuk fast mode requests, lihat [Handle rate limits](/docs/id/fast-mode#handle-rate-limits). Pada v2.1.199 atau lebih baru itu juga menaikkan default retry count untuk transient errors lainnya, seperti server errors, timeouts, dan dropped connections, menjadi 300, kira-kira tiga jam backoff, dan menghapus batas 15 pada `CLAUDE_CODE_MAX_RETRIES` jika Anda menetapkan variabel itu secara eksplisit. |
+| [`API_TIMEOUT_MS`](/docs/id/env-vars) | 600000 | Per-request timeout dalam milliseconds. Naikkan untuk jaringan lambat atau proxy. Ini juga membatasi berapa lama Claude Code menunggu response headers, dijelaskan dalam [No response from API](#no-response-from-api). |
+| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/id/env-vars) | unset | Deadline dalam milliseconds untuk first response byte dari streaming request. Memerlukan Claude Code v2.1.242 atau lebih baru. Untuk bagaimana Claude Code memilih deadline ketika ini unset, lihat [No response from API](#no-response-from-api). |
Kesalahan server
-Kesalahan ini berasal dari penyedia inferensi daripada akun atau permintaan Anda. Pada Anthropic API itu berarti infrastruktur Anthropic. Pada Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, atau gateway khusus itu berarti infrastruktur penyedia tersebut.
+Sebagian besar kesalahan ini berasal dari penyedia inferensi: layanan Anthropic di Anthropic API, dan layanan di balik titik akhir penyedia tersebut di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau gateway khusus. [Auto mode tidak dapat menentukan keamanan suatu tindakan](#auto-mode-cannot-determine-the-safety-of-an-action) dan [Agent dihentikan lebih awal karena kesalahan API](#agent-terminated-early-due-to-an-api-error) juga mencakup penyebab di sisi Anda, seperti akun Amazon Bedrock yang tidak dapat memanggil model pengklasifikasi atau subagent yang mencapai batas penggunaan.
API Error: 500 Internal server error
-Claude Code menampilkan kode status dan pesan kesalahan API untuk respons 5xx apa pun. Contoh di bawah menunjukkan respons 500 pada Anthropic API:
+Claude Code menampilkan kode status dan pesan kesalahan API untuk respons 5xx apa pun. Contoh di bawah menunjukkan respons 500 di Anthropic API:
```text theme={null}
API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.
```
-Kalimat terakhir menyebutkan tempat untuk memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry menyebutkan status layanan penyedia tersebut. `ANTHROPIC_BASE_URL` khusus menyebutkan host gateway.
+Kalimat terakhir menyebutkan tempat untuk memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry menyebutkan status layanan penyedia tersebut. `ANTHROPIC_BASE_URL` khusus menyebutkan host gateway.
Ini menunjukkan kegagalan yang tidak terduga di dalam API. Ini tidak disebabkan oleh prompt, pengaturan, atau akun Anda.
**Yang harus dilakukan:**
* Periksa [status.claude.com](https://status.claude.com), atau halaman status penyedia yang disebutkan dalam pesan, untuk insiden aktif
-* Tunggu satu menit, kemudian kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik `try again` daripada menempel seluruh hal tersebut.
-* Jika kesalahan berlanjut tanpa ada insiden yang diposting, jalankan `/feedback` sehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat [Report an error](#report-an-error) jika `/feedback` tidak tersedia di lingkungan Anda.
+* Tunggu satu menit, kemudian kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik `try again` alih-alih menempel seluruh hal.
+* Jika kesalahan berlanjut tanpa insiden yang diposting, jalankan `/feedback` sehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat [Report an error](#report-an-error) jika `/feedback` tidak tersedia di lingkungan Anda.
API Error: Repeated 529 Overloaded errors
-API sementara mencapai kapasitas di semua pengguna. Claude Code telah mencoba ulang beberapa kali sebelum menampilkan pesan ini:
+API sementara pada kapasitas di semua pengguna. Claude Code telah mencoba kembali beberapa kali sebelum menampilkan pesan ini:
```text theme={null}
API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
@@ -179,54 +414,99 @@ Ini dapat terjadi selama periode beban tinggi atau ketika model menghasilkan res
**Yang harus dilakukan:**
-* Coba ulang permintaan
+* Coba lagi permintaan
* Untuk tugas yang berjalan lama, pecah pekerjaan menjadi prompt yang lebih kecil
-* Jika jaringan lambat atau proxy adalah penyebabnya, naikkan `API_TIMEOUT_MS` seperti yang dijelaskan dalam [Automatic retries](#automatic-retries)
+* Jika penyebabnya adalah jaringan lambat atau proxy, naikkan `API_TIMEOUT_MS` seperti yang dijelaskan dalam [Automatic retries](#automatic-retries)
* Jika waktu tunggu sering terjadi dan jaringan Anda sehat, lihat [Network and connection errors](#network-and-connection-errors) di bawah
+
+ No response from API
+
+
+Claude Code mengirim permintaan streaming dan API tidak mengembalikan header respons dalam batas waktu untuk byte pertama, jadi Claude Code membatalkan permintaan alih-alih menunggu waktu tunggu permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default. Claude Code mengirim permintaan lagi paling banyak sekali, jika [retry budget](#tune-retry-behavior) memungkinkan. Ketika percobaan ulang juga tidak dijawab, giliran berakhir dengan pesan ini, yang menunjukkan berapa lama setiap upaya menunggu. Ketika Anda menetapkan [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/id/env-vars), batas satu percobaan ulang tidak berlaku dan Claude Code mencoba ulang di bawah anggaran yang dijelaskan dalam [Tune retry behavior](#tune-retry-behavior).
+
+```text theme={null}
+API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
+```
+
+Claude Code menetapkan tunggu header respons upaya pertama dan tunggu percobaan ulang secara terpisah:
+
+* **Upaya pertama**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/id/env-vars) ketika Anda menetapkannya ke 1 atau lebih, diklem antara 10 detik dan 30 menit. Jika tidak, Claude Code menggunakan waktu tunggu watchdog tingkat byte yang tercantum dalam [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs), jadi variabel yang mengubah waktu tunggu itu mengubah tunggu ini juga. Bagaimanapun, Claude Code menambahkan satu detik untuk setiap 32KB badan permintaan.
+* **Percobaan ulang**: satu detik kurang dari `API_TIMEOUT_MS`, hanya di bawah 10 menit secara default, sehingga percobaan ulang dapat melampaui proxy atau gateway yang menahan respons hingga generasi selesai. Di Amazon Bedrock, percobaan ulang menggunakan batas waktu yang sama dengan upaya pertama, dan pesan menunjukkan satu durasi alih-alih dua.
+
+Tidak ada tunggu yang melebihi satu detik kurang dari `API_TIMEOUT_MS` positif, dan `API_TIMEOUT_MS` positif di bawah 11 detik mematikan batas waktu. Watchdog tingkat byte dimulai hanya setelah header respons tiba, jadi respons yang berhenti mengirim byte setelah itu mengikuti [stalled-stream rules](#automatic-retries) alih-alih batas waktu ini.
+
+**Yang harus dilakukan:**
+
+* Kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik `try again` alih-alih menempel seluruh hal.
+* Jika terulang, perlakukan sebagai [network or proxy problem](#unable-to-connect-to-api). Proxy yang menerima koneksi dan tidak pernah meneruskan permintaan menghasilkan kesalahan ini pada setiap upaya.
+* Jika proxy atau gateway di jaringan Anda menahan respons hingga selesai, naikkan `API_TIMEOUT_MS` sehingga percobaan ulang menunggu lebih lama. Di Amazon Bedrock, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` juga.
+* Jika upaya pertama terus habis waktu dan percobaan ulang kemudian berhasil, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` sehingga upaya pertama juga menunggu cukup lama.
+
+Sebelum v2.1.242, Claude Code menunggu waktu tunggu permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default, sebelum gagal permintaan streaming yang tidak dijawab. Sebelum v2.1.261, percobaan ulang menunggu batas waktu yang sama dengan upaya pertama dan pesan tidak menunjukkan durasi.
+
The response above may be incomplete
-Respons streaming gagal setelah Claude telah menghasilkan output yang terlihat. Mengirim ulang permintaan dapat menjalankan panggilan alat yang sama dua kali, jadi Claude Code menyimpan apa yang sudah streaming dan menambahkan pemberitahuan ini sebagai gantinya dari membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya:
+Permintaan streaming gagal sementara respons masih berlangsung, setelah Claude menyelesaikan blok teks atau panggilan alat, atau telah memulai satu setelah menyelesaikan pemikirannya. Mengirim ulang permintaan dapat menjalankan panggilan alat yang sama dua kali, jadi Claude Code menyimpan output yang Claude selesaikan dan menambahkan pemberitahuan ini alih-alih membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya:
```text theme={null}
API Error: Server error mid-response. The response above may be incomplete.
-API Error: Connection closed mid-response. The response above may be incomplete.
-API Error: Response stalled mid-stream. The response above may be incomplete.
+API Error: Connection lost mid-response. The response above may be incomplete.
+API Error: Your computer went to sleep mid-response. The response above may be incomplete.
+API Error: The response stopped arriving. The response above may be incomplete.
```
* `Server error mid-response`: kesalahan server overloaded atau 5xx mid-stream. Varian ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya kasus itu membuang output parsial dan melaporkan seluruh giliran sebagai kesalahan.
-* `Connection closed mid-response`: koneksi terputus.
-* `Response stalled mid-stream`: aliran berhenti mengirim data.
+* `Connection lost mid-response`: koneksi putus.
+* `Your computer went to sleep mid-response`: Claude Code mendeteksi bahwa komputer Anda tertidur saat respons streaming. Setelah komputer Anda bangun, Claude Code memperlakukan koneksi sebagai rusak dan berhenti membacanya.
+* `The response stopped arriving`: koneksi tetap terbuka tetapi berhenti mengirimkan data, jadi watchdog streaming idle membatalkannya. Sebelum v2.1.222, Claude Code juga dapat melaporkan kegagalan ini pada koneksi [gateway](/docs/id/gateways) yang dicapai melalui `ANTHROPIC_BASE_URL` atau `ANTHROPIC_AWS_BASE_URL` sementara ping keep-alive server masih tiba, karena hanya menghitung peristiwa respons yang diurai di sana; upgrade menghentikan waktu tunggu palsu itu di rute tersebut. Gateway yang dicapai melalui URL dasar penyedia seperti `ANTHROPIC_BEDROCK_BASE_URL` tidak dibungkus oleh watchdog byte; lihat [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs).
+
+Sebelum v2.1.227, `Connection lost mid-response` membaca `Connection closed mid-response` dan `The response stopped arriving` membaca `Response stalled mid-stream`.
+
+Dalam empat kasus, Claude Code menangani kegagalan tanpa menampilkan pemberitahuan ini segera:
+
+* Sebelumnya dalam respons, Claude Code baik mencoba ulang kegagalan atau mengakhiri giliran dengan kesalahan yang berbeda. Lihat [Automatic retries](#automatic-retries).
+* Ketika salah satu kegagalan ini tiba setelah Claude menyelesaikan respons, Claude Code menyimpan respons lengkap dan mengakhiri giliran secara normal, tanpa pemberitahuan ini. Sebelum v2.1.222, Claude Code menampilkan pemberitahuan ini ketika koneksi putus atau macet setelah respons selesai, dan melaporkan giliran sebagai kesalahan meskipun respons lengkap.
+* Dalam [non-interactive session](/docs/id/headless), seperti run `-p`, run [Agent SDK](/docs/id/agent-sdk/overview), atau [cloud session](/docs/id/claude-code-on-the-web), Anda tidak harus mengirim `continue` sendiri ketika respons cut-off berada dalam percakapan utama dan berisi teks tetapi tidak ada panggilan alat: Claude Code menyimpan output parsial dan meminta Claude untuk melanjutkan dari tempat ia berhenti, hingga tiga kali berturut-turut. Anda melihat pemberitahuan ini untuk respons seperti itu hanya setelah Claude Code menggunakan kelanjutan itu. Sebelum v2.1.246, Claude Code mengakhiri giliran non-interaktif dengan pemberitahuan ini pada cut-off pertama.
+* Dalam [subagent](/docs/id/sub-agents#api-errors-in-subagents), apakah sesi interaktif atau tidak: ketika respons cut-off-nya berisi teks tetapi tidak ada panggilan alat, Claude Code meminta subagent untuk melanjutkan. Pemberitahuan menjadi pesan terakhir subagent hanya setelah kelanjutan itu digunakan. Sebelum v2.1.257, subagent menampilkan pemberitahuan ini pada cut-off pertama.
**Yang harus dilakukan:**
-* Baca respons yang streaming. Tidak ada yang hilang, tetapi kalimat atau panggilan alat terakhir mungkin hilang.
-* Balas dengan `continue` untuk membuat Claude melanjutkan dari tempat ia berhenti
-* Jika kesalahan yang sama muncul sebelum output yang terlihat, Claude Code mencoba ulang permintaan daripada menyelesaikannya. Lihat [Automatic retries](#automatic-retries).
+* Dalam sesi interaktif, baca respons yang tetap di layar: Claude Code menyimpan setiap blok yang Claude selesaikan sebelum kesalahan, tetapi membuang blok akhir yang terputus ketika giliran berakhir, jadi kalimat atau panggilan alat terakhir mungkin hilang. Balas dengan `continue` untuk membuat Claude melanjutkan dari blok terakhir yang diselesaikannya.
+* Dalam [non-interactive mode](/docs/id/headless) (`-p`):
+ * Dengan output teks default, Claude Code mencetak blok teks terakhir yang diselesaikan yang masih dipegang dari sebelumnya dalam giliran, diikuti oleh pesan ini. Ketika tidak memegang apa pun, Claude Code mencetak pesan ini saja, misalnya karena Claude Code memadatkan percakapan di tengah-giliran dan menghapus teks itu. Sebelum v2.1.219, Claude Code hanya mencetak pesan ini dalam output teks `-p` dan menjatuhkan respons yang sudah dihasilkan.
+ * Dengan `--output-format json` atau `stream-json`, Claude Code melaporkan pesan ini di bidang `result`.
+ * Untuk melanjutkan giliran setelah koneksi stabil, lanjutkan sesi dan kirim `continue` seperti yang dijelaskan dalam [Continue conversations](/docs/id/headless#continue-conversations).
Auto mode cannot determine the safety of an action
-Model yang digunakan [auto mode](/docs/id/permission-modes#eliminate-prompts-with-auto-mode) untuk mengklasifikasikan tindakan tidak dapat menghasilkan keputusan, jadi auto mode tidak menyetujui tindakan secara otomatis. Pesan yang Anda lihat tergantung pada alasan pengklasifikasi gagal.
+Model yang [auto mode](/docs/id/permission-modes#eliminate-prompts-with-auto-mode) gunakan untuk mengklasifikasikan tindakan tidak dapat menghasilkan keputusan, jadi auto mode tidak menyetujui tindakan secara otomatis. Pesan yang Anda lihat tergantung pada bagaimana pengklasifikasi gagal.
Pembacaan, pencarian, dan pengeditan di dalam direktori kerja Anda melewati pengklasifikasi, jadi mereka terus bekerja dalam semua kasus ini.
-Ketika model pengklasifikasi kelebihan beban:
+Ketika model pengklasifikasi tidak tersedia:
```text theme={null}
- is temporarily unavailable, so auto mode cannot determine the safety of right now. Wait briefly and then try this action again.
+ is temporarily unavailable, so auto mode cannot determine the safety of right now. Wait a moment and then try this action again.
```
+Ketika Claude Code dapat menentukan kategori kegagalan, ia menyebutkan kategori dalam tanda kurung setelah `temporarily unavailable`, misalnya ` is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of right now`. Kategorinya adalah `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)`, dan `(connection failed)`. Rate-limited, overloaded, dan server errors bersifat sementara, dan mencoba ulang berfungsi. Jika `(timed out)` atau `(connection failed)` terulang, periksa koneksi Anda; lihat [Unable to connect to API](#unable-to-connect-to-api). Sebelum v2.1.229, pesan tidak pernah menyebutkan kategori dan membaca `Wait briefly and then try this action again`.
+
+Ketika tidak ada kategori yang cocok, pesan muncul tanpa kategori dalam tanda kurung; lebih dari satu kegagalan menghasilkan bentuk itu. Di [Amazon Bedrock](/docs/id/amazon-bedrock), termasuk [Mantle endpoint](/docs/id/amazon-bedrock#use-the-mantle-endpoint), itu juga muncul ketika akun AWS Anda tidak dapat memanggil model yang disebutkan dalam pesan, dan kegagalan itu terulang pada setiap percobaan ulang sampai akun Anda diberi akses ke model.
+
**Yang harus dilakukan:**
-* Coba ulang setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri
-* Jika percobaan ulang terus gagal, lanjutkan dengan tugas baca-saja dan kembali ke tindakan yang diblokir nanti
-* Ini bersifat sementara dan tidak terkait dengan [auto mode eligibility](/docs/id/permission-modes#eliminate-prompts-with-auto-mode); Anda tidak perlu mengubah pengaturan
+* Coba lagi setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri. Kegagalan sementara tidak terkait dengan [auto mode eligibility](/docs/id/permission-modes#eliminate-prompts-with-auto-mode); Anda tidak perlu mengubah pengaturan
+* Jika percobaan ulang terus gagal, lanjutkan dengan tugas read-only dan kembali ke tindakan yang diblokir nanti
+* Di Amazon Bedrock, jika pesan kembali pada setiap percobaan ulang, periksa bahwa akun Anda dapat memanggil model yang disebutkan: untuk model Amazon Bedrock standar, konfirmasi [IAM policy](/docs/id/amazon-bedrock#iam-configuration) Anda memungkinkan memanggilnya; untuk ID model Mantle, [hubungi tim akun AWS Anda](/docs/id/amazon-bedrock#mantle-endpoint-errors)
-Ketika pengklasifikasi mengembalikan respons yang tidak dapat diuraikan:
+Ketika permintaan pengklasifikasi gagal karena token OAuth Anda kedaluwarsa atau diputar oleh sesi lain, Claude Code menyegarkan token dan mencoba ulang permintaan sekali, jadi kedaluwarsa token rutin tidak muncul sebagai pesan ini. Sebelum v2.1.216, token yang kedaluwarsa atau diputar gagal setiap permintaan pengklasifikasi, dan auto mode menolak setiap tindakan yang diperiksa dengan pesan ini sampai token disegarkan.
+
+Ketika pengklasifikasi mengembalikan respons yang tidak dapat diurai:
```text theme={null}
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
@@ -234,7 +514,7 @@ Auto mode could not evaluate this action and is blocking it for safety — run w
**Yang harus dilakukan:**
-* Coba ulang tindakan; ini biasanya berhasil pada percobaan berikutnya
+* Coba lagi tindakan; ini biasanya berhasil pada upaya berikutnya
* Jalankan `claude --debug` dan ulangi tindakan untuk melihat respons pengklasifikasi yang mendasar dalam log debug
Ketika pemeriksaan keamanan API terpisah memblokir permintaan pengklasifikasi karena konten percakapan sebelumnya:
@@ -243,11 +523,19 @@ Ketika pemeriksaan keamanan API terpisah memblokir permintaan pengklasifikasi ka
Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details
```
+Claude Code menolak tindakan tetapi memberi tahu Claude bahwa ini bukan penilaian bahwa tindakan tidak aman, dan untuk melanjutkan dengan tugas lain daripada mencoba ulang. Penolakan ini tidak dihitung terhadap [auto mode's pause thresholds](/docs/id/permission-modes#when-auto-mode-falls-back). Dalam run `-p` [non-interactive](/docs/id/headless), Claude Code tidak menghentikan run. Apa yang Claude terima tergantung pada tempat ia meminta tindakan:
+
+* Ke [background subagent](/docs/id/sub-agents#run-subagents-in-foreground-or-background) dalam run `-p` tanpa `--input-format stream-json`, Claude Code mengembalikan hasil kesalahan yang berisi `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`
+* Di tempat lain, termasuk sesi interaktif dan percakapan utama run `-p`, Claude Code mengembalikan penolakan itu ke Claude
+
+Sebelum v2.1.225, Claude Code menghitung penolakan ini terhadap ambang batas jeda dan mengembalikan pesan penolakan yang sama seperti blok pengklasifikasi asli.
+
**Yang harus dilakukan:**
-* Ini bukan keputusan tentang tindakan Anda. Konten yang sudah ada dalam percakapan Anda memicu filter keamanan pada API ketika auto mode mengirim percakapan ke pengklasifikasi
+* Ini bukan keputusan tentang tindakan Anda. Konten yang sudah ada dalam percakapan Anda memicu filter keamanan di API ketika auto mode mengirim percakapan ke pengklasifikasi
* Mencoba ulang tidak akan membantu; konten percakapan yang sama akan memicu filter lagi
-* Beralih ke [permission mode](/docs/id/permission-modes) yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta, atau mulai percakapan baru tanpa konten pemicu
+* Dalam sesi interaktif, beralih ke [permission mode](/docs/id/permission-modes) yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta
+* Mulai percakapan segar tanpa konten pemicu
Ketika percakapan telah tumbuh lebih besar dari jendela konteks pengklasifikasi:
@@ -255,12 +543,16 @@ Ketika percakapan telah tumbuh lebih besar dari jendela konteks pengklasifikasi:
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
```
-Dalam sesi interaktif, auto mode kembali ke prompt izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual. Dalam [non-interactive mode](/docs/id/headless) jalankan dibatalkan karena transkrip hanya tumbuh dan mencoba ulang tidak dapat berhasil.
+Apa yang terjadi pada tindakan tergantung pada tempat Claude memintanya:
+
+* Dalam sesi interaktif, auto mode kembali ke prompt izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual
+* Ke [background subagent](/docs/id/sub-agents#run-subagents-in-foreground-or-background) dalam run `-p` [non-interactive](/docs/id/headless) tanpa `--input-format stream-json`, Claude Code mengembalikan hasil kesalahan yang berisi `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, dan run berlanjut
+* Di tempat lain dalam run `-p` tanpa [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags), tidak ada prompt untuk kembali, jadi tindakan tidak berjalan dan run berlanjut
**Yang harus dilakukan:**
-* Setujui atau tolak tindakan dalam prompt yang muncul
-* Jalankan `/compact` untuk mengurangi ukuran percakapan sehingga tindakan berikutnya sesuai dengan jendela pengklasifikasi lagi
+* Dalam sesi interaktif, setujui atau tolak tindakan dalam prompt yang muncul
+* Dalam sesi interaktif, jalankan `/compact` untuk mengurangi ukuran percakapan sehingga tindakan berikutnya cocok dalam jendela pengklasifikasi lagi
Agent terminated early due to an API error
@@ -274,83 +566,112 @@ Agent terminated early due to an API error:
**Yang harus dilakukan:**
-* Cocokkan detail kesalahan setelah titik dua dengan bagiannya sendiri di halaman ini, seperti [Usage limits](#usage-limits) atau [Server errors](#server-errors), dan ikuti langkah-langkah bagian itu
+* Cocokkan detail kesalahan setelah titik dua dengan bagiannya sendiri di halaman ini, seperti [Usage limits](#usage-limits) atau [Server errors](#server-errors), dan ikuti langkah bagian itu
* Setelah kesalahan yang mendasar hilang, minta Claude untuk mencoba ulang tugas atau [resume the subagent](/docs/id/sub-agents#resume-subagents)
-Ketika batas laju, overload, atau kesalahan server mengganggu subagent latar depan yang sudah menghasilkan output teks, Claude menerima output parsial itu ditandai sebagai tidak lengkap daripada kesalahan ini. Subagent yang satu-satunya output adalah panggilan alat juga mendapatkan kesalahan ini; dalam v2.1.199 bentuk itu mengembalikan hasil parsial kosong sebagai gantinya. Lihat [API errors in subagents](/docs/id/sub-agents#api-errors-in-subagents).
+Ketika batas laju, overload, atau kesalahan server mengganggu subagent foreground yang sudah menghasilkan output teks, Claude menerima output parsial itu ditandai sebagai tidak lengkap alih-alih kesalahan ini. Subagent yang satu-satunya output adalah panggilan alat mendapat kesalahan ini juga; dalam v2.1.199 bentuk itu mengembalikan hasil parsial kosong. Lihat [API errors in subagents](/docs/id/sub-agents#api-errors-in-subagents).
Batas penggunaan
-Kesalahan ini berarti kuota yang terikat pada akun atau paket Anda telah tercapai. Kesalahan ini berbeda dari [kesalahan server](#server-errors), yang mempengaruhi semua orang.
+Sebagian besar kesalahan di bagian ini berarti kuota yang terikat pada akun atau paket Anda telah tercapai. Tiga kesalahan bekerja berbeda: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) adalah throttle sisi server yang tidak terkait dengan kuota paket Anda, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) adalah pemeriksaan hak akses daripada kuota yang habis, dan [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) berarti prompt persetujuan usage credits ditutup tanpa jawaban, terlepas dari apakah kuota tercapai atau tidak.
- Anda telah mencapai batas sesi
+ You've hit your session limit
-Paket langganan mencakup tunjangan penggunaan bergulir. Ketika habis, Anda akan melihat salah satu pesan berikut:
+Paket langganan mencakup tunjangan penggunaan bergulir. Ketika habis, Anda akan melihat salah satu pesan ini:
```text theme={null}
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
+You've hit your Sonnet limit · resets 3:45pm
```
-Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan. Batas sesi dan mingguan dibagikan di semua model, jadi beralih model tidak memulihkan akses. Batas Opus hanya berlaku untuk permintaan Opus, jadi beralih ke model lain dengan `/model` membuat Anda tetap bekerja.
+Blok Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan. Batas sesi dan mingguan dibagikan di semua model, jadi beralih model tidak mengembalikan akses. Batas Opus dan Sonnet masing-masing hanya berlaku untuk permintaan ke keluarga model tersebut, jadi beralih ke model di luar keluarga dengan `/model` membuat Anda tetap bekerja.
+
+Dalam sesi interaktif yang masuk dengan langganan claude.ai, Claude Code juga dapat menunggu di sesi terbuka dan melanjutkan tugas yang terputus segera setelah reset. Saat menunggu, baris di bagian bawah sesi berbunyi `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`. Tekan `Esc` pada prompt kosong untuk membatalkan penantian. Lihat [Wait for a usage limit to reset](/docs/id/interactive-mode#wait-for-a-usage-limit-to-reset) untuk melihat apa yang Anda lihat, cara memulai atau membatalkan penantian, dan cara mematikan lanjutan otomatis. Sebelum v2.1.234, Claude Code tidak menawarkan penantian ini.
Penggunaan dihitung terhadap tunjangan sesi dan mingguan pada saat yang sama. Satu ledakan aktivitas berat, seperti fanout alur kerja besar, dapat menghabiskan tunjangan mingguan sebelum jendela sesi direset.
**Yang harus dilakukan:**
* Tunggu waktu reset yang ditunjukkan dalam kesalahan
-* Untuk batas Opus, jalankan `/model` dan beralih ke model lain untuk terus bekerja
-* Jalankan `/usage` untuk melihat batas paket dan kapan mereka direset
-* Jalankan `/usage-credits` untuk membeli penggunaan tambahan pada Pro dan Max, atau untuk memintanya dari admin Anda pada Team dan Enterprise. Lihat [usage credits untuk paket berbayar](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) untuk cara penagihan ini.
+* Di tab Code dari [Desktop app](/docs/id/desktop), kartu batas sesi menawarkan kotak centang **Auto-continue when limits reset**. Kartu batas mingguan tidak. Ketika dicentang, aplikasi Desktop mencoba kembali giliran yang terputus setelah reset dan menampilkan waktu percobaan kembali pada kartu. Kotak centang Desktop dan pengaturan **Continue automatically at usage limit** CLI di `/config` terpisah, jadi matikan masing-masing secara terpisah.
+* Untuk batas Opus atau Sonnet, jalankan `/model` dan beralih ke model di luar keluarga tersebut untuk terus bekerja. Setiap model memiliki cache prompt-nya sendiri, jadi permintaan berikutnya membaca ulang seluruh percakapan tanpa cache hits; lihat [Switching models](/docs/id/prompt-caching#switching-models)
+* Jalankan `/usage` untuk melihat batas paket Anda dan kapan mereka direset
+* Jalankan `/usage-credits` untuk membeli penggunaan tambahan di Pro dan Max, atau memintanya dari admin Anda di Team dan Enterprise. Lihat [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) untuk cara ini ditagih.
* Untuk meningkatkan paket Anda untuk batas dasar yang lebih tinggi, lihat [claude.com/pricing](https://claude.com/pricing)
-Untuk memantau tunjangan sisa Anda sebelum mencapai batas, tambahkan bidang `rate_limits` ke [baris status kustom](/docs/id/statusline#rate-limit-usage), atau di aplikasi Desktop klik [cincin penggunaan](/docs/id/desktop#check-usage) di sebelah pemilih model.
+Sebelum jendela habis, Claude Code dapat memperingatkan Anda bahwa Anda telah menggunakan sebagian besar, dengan pesan seperti `You've used 85% of your session limit · resets 3:45pm`. Untuk memantau tunjangan sisa Anda secara terus-menerus, tambahkan bidang `rate_limits` ke [custom status line](/docs/id/statusline#rate-limit-usage), atau di aplikasi Desktop klik [usage ring](/docs/id/desktop#check-usage) di sebelah pemilih model.
- Kredit penggunaan diperlukan untuk konteks 1M
+ Usage credits required for 1M context
-Model yang dipilih menggunakan jendela konteks diperpanjang 1M-token, dan paket Anda hanya mencakupnya melalui kredit penggunaan.
+Model yang dipilih menggunakan jendela konteks diperluas 1M-token, dan paket Anda hanya mencakupnya melalui usage credits.
```text theme={null}
-API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
+API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context
```
-Ini adalah pemeriksaan hak, bukan kelelahan kuota. Ini terjadi bahkan ketika tunjangan sesi dan mingguan Anda memiliki kapasitas yang tersisa. Lihat [Extended context](/docs/id/model-config#extended-context) untuk paket mana yang mencakup konteks 1M secara langsung dan mana yang memerlukan kredit penggunaan.
+Ini adalah pemeriksaan hak akses, bukan kehabisan kuota. Ini muncul bahkan ketika tunjangan sesi dan mingguan Anda memiliki kapasitas yang tersisa. Lihat [Extended context](/docs/id/model-config#extended-context) untuk paket mana yang mencakup konteks 1M secara langsung dan mana yang memerlukan usage credits. Claude Code menjalankan pemeriksaan ini ketika Anda memilih model dengan `/model`, dan hanya pada koneksi langsung ke API Anthropic; jika Anda menunjuk `ANTHROPIC_BASE_URL` ke [LLM gateway](/docs/id/llm-gateway), `/model` memungkinkan pemilihan `[1m]` dan gateway memutuskan apakah permintaan berhasil.
-Ketika kesalahan ini muncul di tengah percakapan karena konteks tumbuh melampaui 200K token, Claude Code secara otomatis memadatkan percakapan kembali di bawah batas konteks standar dan menjaga sesi pada batas itu setelahnya, jadi tidak ada tindakan yang diperlukan. Pada versi sebelum v2.1.172, kesalahan berulang pada setiap permintaan berikutnya termasuk `/compact`; jalankan `/clear` pada versi tersebut untuk pulih. Langkah-langkah di bawah berlaku ketika Anda secara eksplisit memilih model `[1m]`.
+Ketika kesalahan ini muncul di tengah percakapan karena konteks tumbuh melampaui 200K token, Claude Code secara otomatis mengompres percakapan kembali di bawah batas konteks standar dan menjaga sesi pada batas itu sesudahnya, jadi tidak ada tindakan yang diperlukan. Pada versi sebelum v2.1.172, kesalahan berulang pada setiap permintaan berikutnya termasuk `/compact`; jalankan `/clear` pada versi tersebut untuk pulih. Langkah-langkah di bawah berlaku ketika Anda secara eksplisit memilih model `[1m]`.
**Yang harus dilakukan:**
* Jalankan `/model` dan pilih varian tanpa akhiran `[1m]` untuk kembali ke jendela konteks standar
-* Jalankan `/usage-credits` untuk mengaktifkan penagihan terukur untuk varian 1M pada Pro dan Max, atau untuk memintanya dari admin Anda pada Team dan Enterprise
-* Jika kesalahan berlanjut setelah `/model`, ID model 1M mungkin diatur di tempat lain. Lihat [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) untuk lokasi konfigurasi yang harus diperiksa dalam urutan prioritas.
+* Di mana pesan menyebutkan `/usage-credits`, jalankan untuk mengaktifkan penagihan terukur untuk varian 1M di Pro dan Max, atau untuk meminta usage credits dari admin Anda di Team dan Enterprise. Mulai ulang Claude Code setelah usage credits aktif. Sampai Anda memulai ulang, sesi tetap pada batas konteks standar.
+* Jika kesalahan berlanjut setelah `/model`, ID model 1M mungkin diatur di tempat lain. Lihat [Setting your model](/docs/id/model-config#setting-your-model) untuk lokasi konfigurasi yang harus diperiksa dalam urutan prioritas.
* Untuk menghapus varian 1M dari pemilih model sepenuhnya, atur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars)
+Sebelum v2.1.268, pesan berakhir dengan `run /usage-credits to turn them on, or /model to switch to standard context` dan tidak menyebutkan restart.
+
+
+ The prompt to confirm went unanswered
+
+
+Jika akun Anda memerlukan [Fable usage-credits consent](/docs/id/model-config#fable-and-usage-credits), Claude Code meminta Anda untuk mengonfirmasi sebelum permintaan Fable menagih usage credits. Ketika tidak ada yang menjawab prompt persetujuan itu dalam sesi yang mungkin tidak memiliki siapa pun di terminalnya, Claude Code menutup prompt dan mengakhiri giliran dengan salah satu pesan ini:
+
+```text theme={null}
+Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
+Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
+```
+
+Pesan menyebutkan model Fable sesi, jadi di Fable 5 mereka membaca `continuing on Fable 5` dan `Fable 5 now uses usage credits`. Sebelum v2.1.257, pesan pertama dimulai dengan `Fable 5 limit reached`.
+
+Ini terjadi dalam sesi [Remote Control](/docs/id/remote-control), [background sessions](/docs/id/agent-view), dan sesi rekan tim [agent team](/docs/id/agent-teams). Claude Code menampilkan prompt persetujuan hanya dalam tampilan interaktif sesi sendiri: terminal tempat ia berjalan, atau, untuk sesi latar belakang, [agents view](/docs/id/agent-view) setelah Anda melampirkan. Klien Remote Control tidak dapat menampilkannya. Claude Code menutup prompt pada batas waktu [`dialogExpiry`](/docs/id/settings-reference#dialogexpiry), lima menit secara default, atau segera setelah prompt baru tiba sementara tidak ada yang mengetik di terminal itu, seperti prompt yang dikirim dari klien Remote Control. Mengetik di terminal tempat sesi berjalan membatalkan batas waktu, dan Claude Code menunggu jawaban Anda. Dalam tampilan terlampir sesi latar belakang, mengetik tidak membatalkan batas waktu, dan prompt baru masih menutup prompt persetujuan, jadi jawab sebelum salah satu terjadi. Claude Code tidak mengirim apa pun dan menjaga model Anda, jadi ketika Anda mengirim prompt berikutnya, Claude Code menampilkan prompt persetujuan lagi.
+
+**Yang harus dilakukan:**
+
+* Di terminal tempat sesi berjalan, kirim prompt lain dan jawab prompt persetujuan ketika muncul kembali. Untuk sesi latar belakang, lampirkan terlebih dahulu dari [agents view](/docs/id/agent-view). Mengirim ulang dari klien Remote Control menampilkan pesan ini lagi, karena klien tidak dapat menampilkan prompt.
+* Jalankan `/model` untuk beralih ke model yang tidak menagih usage credits
+* Untuk memberi diri Anda lebih banyak waktu untuk mencapai terminal itu, atur [`dialogExpiry`](/docs/id/settings-reference#dialogexpiry) ke nilai yang lebih lama atau `"never"`
+
+Sebelum v2.1.236, pesan ini tidak muncul: sementara klien Remote Control terhubung, Claude Code menunggu 60 detik untuk jawaban dan kemudian melanjutkan giliran pada model default Anda.
+
- Server sedang membatasi permintaan sementara
+ Server is temporarily limiting requests
-API menerapkan throttle berumur pendek yang tidak terkait dengan kuota paket Anda.
+API menerapkan throttle jangka pendek yang tidak terkait dengan kuota paket Anda.
```text theme={null}
API Error: Server is temporarily limiting requests (not your usage limit)
```
-Claude Code membedakan ini dari batas paket Anda dengan tidak adanya header kuota terpadu yang dibawa respons batas nyata. Mulai dari v2.1.199 ini [dicoba ulang secara otomatis](#automatic-retries) dengan backoff sebelum ditampilkan, cara apa pun Anda melakukan autentikasi. Pada versi sebelumnya, sesi yang masuk dengan langganan claude.ai gagal giliran pada kemunculan pertama; hanya API key dan Enterprise sign-ins yang mencoba ulangnya.
+Claude Code membedakan ini dari batas paket Anda dengan tidak adanya header kuota terpadu yang dibawa respons batas nyata. Mulai dari v2.1.199 ini [dicoba ulang secara otomatis](#automatic-retries) dengan backoff sebelum ditampilkan, terlepas dari cara Anda mengautentikasi. Pada versi sebelumnya, sesi yang masuk dengan langganan claude.ai gagal pada giliran pertama; hanya API key dan Enterprise sign-ins yang mencoba ulangnya.
**Yang harus dilakukan:**
* Tunggu sebentar dan coba lagi
-* Periksa [status.claude.com](https://status.claude.com) jika berlanjut
+* Periksa [status.claude.com](https://status.claude.com) jika terus berlanjut
- Permintaan ditolak (429)
+ Request rejected (429)
Anda telah mencapai batas laju yang dikonfigurasi untuk kunci API, proyek Amazon Bedrock, atau proyek Google Cloud Anda.
@@ -359,20 +680,69 @@ Anda telah mencapai batas laju yang dikonfigurasi untuk kunci API, proyek Amazon
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
```
-Kalimat trailing menunjukkan di mana memeriksa kesehatan layanan dan bervariasi menurut penyedia. Amazon Bedrock, Agent Platform Google Cloud, dan konfigurasi Microsoft Foundry menyebutkan status layanan penyedia itu sebagai gantinya dari halaman status Anthropic. `ANTHROPIC_BASE_URL` kustom menyebutkan host gateway.
+Kalimat di akhir menyebutkan di mana memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry menyebutkan status layanan penyedia itu sebagai gantinya dari halaman status Anthropic. `ANTHROPIC_BASE_URL` kustom menyebutkan host gateway.
**Yang harus dilakukan:**
-* Jalankan `/status` dan konfirmasi kredensial aktif adalah yang Anda harapkan. `ANTHROPIC_API_KEY` yang tersesat di lingkungan Anda dapat merutekan permintaan melalui kunci tingkat rendah alih-alih langganan Anda.
+* Jalankan `/status` dan konfirmasi kredensial aktif adalah yang Anda harapkan. `ANTHROPIC_API_KEY` yang tersesat di lingkungan Anda dapat merutekan permintaan melalui kunci tingkat rendah daripada langganan Anda.
* Periksa konsol penyedia Anda untuk batas aktif dan minta tingkat yang lebih tinggi jika diperlukan
-* Untuk kunci API Anthropic, lihat [referensi batas laju](https://platform.claude.com/docs/en/api/rate-limits) untuk cara kerja tingkat dan cara menetapkan batas per-workspace
+* Untuk kunci API Anthropic, lihat [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) untuk cara kerja tingkat dan cara menetapkan batas per-workspace
* Kurangi concurrency: turunkan [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/id/env-vars), hindari menjalankan banyak subagen paralel, atau beralih ke model yang lebih kecil dengan `/model` untuk run skrip volume tinggi
+
+ You've hit your monthly spend limit
+
+
+Penggunaan yang disertakan paket Anda tidak dapat menutupi permintaan ini, dan [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) yang sebaliknya akan membayarnya telah mencapai batas pengeluaran. Itu terjadi ketika salah satu jendela penggunaan paket Anda telah habis, atau ketika permintaan adalah permintaan yang hanya dibayar oleh usage credits, seperti permintaan ke model yang [bills to usage credits](/docs/id/model-config#fable-and-usage-credits). Pesan menyebutkan batas siapa yang memblokir Anda. Teks setelah `·` mengatakan cara meningkatkan batas itu, dan bervariasi dengan paket Anda dan apakah Anda mengelola penagihan:
+
+```text theme={null}
+You've hit your monthly spend limit · raise it at claude.ai/settings/usage
+You've hit your individual spend limit · ask your admin for a higher limit
+You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
+You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
+You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings
+```
+
+`team's shared budget` adalah anggaran terpusat yang admin tetapkan untuk grup yang Anda termasuk; pesan tidak menyebutkan grup. `channel's monthly spend limit` adalah anggaran dari satu saluran Slack tempat sesi berjalan, jadi organisasi Anda mungkin masih memiliki anggaran di luar itu.
+
+Ketika salah satu jendela paket Anda adalah yang habis, pesan juga mengatakan kapan jendela itu direset, misalnya `· your session limit resets 3:45pm`, dan akses kembali kemudian tanpa siapa pun menaikkan batas. Pada organisasi dengan penagihan berbasis penggunaan, pesan mengatakan `usage limit` sebagai gantinya dari `spend limit`, seperti dalam `You've hit your individual usage limit`.
+
+Sebelum v2.1.239, pesan tidak menyebutkan waktu reset jendela paket. Sebelum v2.1.268, anggaran terpusat grup menghasilkan pesan `individual spend limit` daripada `team's shared budget`.
+
+Jika Anda terhubung melalui gateway aplikasi Claude dan melihat `spend limit reached` huruf kecil, itu adalah batas operator gateway Anda sebagai gantinya; lihat [Spend limit reached](#spend-limit-reached).
+
+**Yang harus dilakukan:**
+
+* Di Pro dan Max, tingkatkan batas pengeluaran bulanan Anda di [**Settings > Usage**](https://claude.ai/settings/usage) di claude.ai, atau jalankan `/usage-credits`
+* Di Team dan Enterprise, tingkatkan batas di [**Admin settings > Usage**](https://claude.ai/admin-settings/usage) jika Anda mengelola penagihan, atau minta admin untuk melakukannya. `/usage-credits` mengirim permintaan itu ke admin Anda untuk Anda
+* Untuk batas saluran, minta pemilik org atau manajer saluran untuk menaikkannya di claude.ai. Lihat [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) dalam dokumentasi Claude Tag
+* Jika pesan menyebutkan waktu reset untuk jendela paket Anda, Anda dapat menunggunya sebagai gantinya
+* Jalankan `/usage` untuk melihat jendela paket Anda dan kapan masing-masing direset
+
+
+ Spend limit reached
+
+
+Anda terhubung melalui [Claude apps gateway](/docs/id/claude-apps-gateway) dan telah melampaui [spend cap](/docs/id/claude-apps-gateway-spend-limits) yang operator gateway Anda tetapkan. Gateway memblokir permintaan Anda sampai periode yang dinamai direset atau operator menaikkan batas. Ini menandai setiap respons `429` yang diblokir `x-should-retry: false`, jadi Claude Code menampilkan pesan ini tanpa mencoba ulang.
+
+```text theme={null}
+spend limit reached (daily; resets 2026-08-09 00:00 UTC)
+```
+
+Pesan menyebutkan periode batas dan waktu reset, dan ketika operator mengonfigurasi `blocked_message`, instruksi mereka mengikutinya. Sebelum v2.1.225, pesan hanya berbunyi `spend limit reached`; gateway pada versi yang lebih lama masih mengirim bentuk yang lebih pendek itu.
+
+**Yang harus dilakukan:**
+
+* Tunggu waktu reset yang pesan namakan, atau ikuti instruksi operator jika pesan membawanya
+* Minta operator gateway Anda untuk menaikkan batas jika Anda mencapainya secara rutin
+
+Pesan terkait, `spend limit unavailable`, berarti gateway tidak dapat membaca catatan pengeluarannya dan memblokir permintaan sebagai tindakan pencegahan daripada atas batas Anda. Biasanya ini hilang dengan sendirinya; jika terus berlanjut, beri tahu operator gateway Anda.
+
- Saldo kredit terlalu rendah
+ Credit balance is too low
-Organisasi Console Anda telah kehabisan kredit prabayar.
+Organisasi Console Anda telah kehabisan kredit prabayar, atau Claude Code mengirim permintaan Anda dengan kunci API Console ketika Anda bermaksud menggunakan langganan Anda.
```text theme={null}
Credit balance is too low
@@ -380,10 +750,28 @@ Credit balance is too low
**Yang harus dilakukan:**
-* Tambahkan kredit di [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), dan pertimbangkan untuk mengaktifkan auto-reload di sana sehingga saldo terisi ulang sebelum mencapai nol
-* Beralih ke autentikasi langganan dengan `/login` jika Anda memiliki paket Pro, Max, Team, atau Enterprise
+* Jika Anda memiliki paket Pro, Max, Team, atau Enterprise dan melihat ini, jalankan `/status` dan periksa baris `API key`. `ANTHROPIC_API_KEY` yang disetujui di lingkungan Anda merutekan permintaan melalui kunci itu daripada langganan Anda. Batalkan pengaturannya di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan ulang `claude`. Jalankan `/login` jika Anda belum masuk dengan langganan Anda.
+* Tambahkan kredit di [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), dan pertimbangkan untuk mengaktifkan auto-reload di sana sehingga saldo diisi ulang sebelum mencapai nol
* Atur batas pengeluaran per-workspace di Console untuk mencegah satu proyek menguras saldo org. Lihat [Manage costs effectively](/docs/id/costs).
+
+ Could not update your spend limit
+
+
+Server menolak perubahan batas pengeluaran yang Anda buat dari prompt yang muncul ketika Anda mencapai batas pengeluaran Anda.
+
+```text theme={null}
+Could not update your spend limit:
+```
+
+Ketika server menjelaskan penolakan, pesan berakhir dengan alasan itu, dan mencoba ulang nilai yang sama gagal lagi. Ketika kegagalan tidak memiliki alasan yang disediakan server, seperti koneksi yang terputus, pesan berbunyi `Could not update your spend limit. Press Enter to retry.` dan mencoba ulang dapat berhasil. Sebelum v2.1.216, Claude Code menampilkan bentuk generik untuk setiap kegagalan.
+
+**Yang harus dilakukan:**
+
+* Jika pesan menyertakan alasan, pilih batas yang memuaskannya, seperti jumlah yang lebih rendah
+* Jika pesan hanya menampilkan bentuk generik, coba ulang; kegagalan mungkin bersifat sementara
+* Jika perubahan terus gagal, buatlah dari [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) Anda di browser sebagai gantinya
+
Kesalahan autentikasi
@@ -404,93 +792,141 @@ Not logged in · Please run /login
* Jalankan `/login` untuk autentikasi dengan langganan Claude Anda atau akun Console
* Jika Anda mengharapkan variabel lingkungan untuk mengautentikasi Anda, konfirmasi bahwa `ANTHROPIC_API_KEY` diatur dan diekspor di shell tempat Anda meluncurkan `claude`
-* Untuk CI atau otomasi di mana login interaktif tidak mungkin, konfigurasikan skrip [`apiKeyHelper`](/docs/id/settings#available-settings) yang mengambil kunci saat startup
-* Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence) untuk memahami kredensial mana yang digunakan Claude Code ketika beberapa tersedia
+* Untuk CI atau otomasi di mana login interaktif tidak mungkin, konfigurasikan skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) yang mengambil kunci saat startup
+* Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence) untuk memahami kredensial mana yang digunakan Claude Code ketika beberapa ada
-Jika Anda diminta untuk masuk berulang kali, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk perbaikan jam sistem dan Keychain macOS.
+Jika Anda diminta untuk masuk berulang kali, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS.
Tidak dapat menyelesaikan metode autentikasi
-Sesi mencapai klien API tanpa kredensial apa pun. Ini muncul di [sesi latar belakang](/docs/id/agent-view), sesi cloud, dan konteks Agent SDK di mana pemeriksaan login interaktif tidak berjalan sebelum permintaan pertama.
+Sesi mencapai klien API tanpa kredensial apa pun. [Sesi latar belakang](/docs/id/agent-view) dan sesi cloud menampilkan pesan ini ketika pekerja dimulai tanpa kredensial. Jalankan interaktif, `-p`, dan Agent SDK melaporkan kondisi yang sama seperti [Belum masuk](#not-logged-in) dan menulis string ini hanya ke log debug mereka, jadi jika Anda menemukannya di sana, ikuti entri itu sebagai gantinya.
```text theme={null}
Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
```
-Sebelum v2.1.174, sesi latar belakang atau cloud yang ditugaskan ke pekerja yang sudah diinisialisasi sebelumnya yang menganggur dapat gagal dengan cara ini bahkan ketika kredensial yang valid dikonfigurasi. Tingkatkan untuk memulihkan. Pada versi saat ini, kesalahan berarti tidak ada kredensial yang tersedia untuk proses pekerja.
+Pada versi saat ini, kesalahan berarti tidak ada kredensial yang tersedia untuk proses pekerja. Sebelum v2.1.174, sesi latar belakang yang ditugaskan ke pekerja pra-inisialisasi yang menganggur dapat gagal dengan cara ini bahkan ketika kredensial yang valid dikonfigurasi. Sebelum v2.1.176, sesi cloud yang menganggur sebelum diklaim juga dapat. Tingkatkan untuk memulihkan.
**Yang harus dilakukan:**
-* Tingkatkan ke v2.1.174 atau lebih baru jika ini muncul di sesi latar belakang atau cloud dan kredensial Anda sudah dikonfigurasi
+* Tingkatkan ke v2.1.176 atau lebih baru jika ini muncul dalam sesi latar belakang atau cloud dan kredensial Anda sudah dikonfigurasi
* Konfirmasi bahwa `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN`, atau kredensial penyedia cloud Anda diatur di lingkungan yang meluncurkan pekerja, bukan hanya di shell interaktif Anda
-* Untuk Agent SDK, lihat [pengaturan autentikasi](/docs/id/agent-sdk/overview#get-started)
+* Untuk Agent SDK, lihat [pengaturan autentikasi dalam panduan cepat](/docs/id/agent-sdk/quickstart#setup)
* Jalankan `/status` dalam sesi interaktif di lingkungan yang sama untuk mengonfirmasi sumber kredensial mana yang diselesaikan
Kunci API tidak valid
-Variabel lingkungan `ANTHROPIC_API_KEY` atau skrip `apiKeyHelper` mengembalikan kunci yang ditolak API.
+Variabel lingkungan `ANTHROPIC_API_KEY` atau skrip `apiKeyHelper` mengembalikan kunci yang ditolak API, atau Claude Code memblokir kunci dari `ANTHROPIC_API_KEY` sebelum mengirimnya.
```text theme={null}
Invalid API key · Fix external API key
```
+Ketika pesan berlanjut melampaui `Fix external API key` dengan deskripsi seperti `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API tidak pernah melihat kunci. Claude Code menemukan karakter yang tidak dapat dibawa oleh header HTTP dan menghentikan permintaan sebelum mengirimnya. Lihat [Nilai header permintaan tidak valid](#invalid-request-header-value) untuk cara membaca deskripsi dan memperbaiki nilai.
+
**Yang harus dilakukan:**
* Periksa kesalahan ketik dan konfirmasi bahwa kunci belum dicabut di [Console](https://platform.claude.com/settings/keys)
-* Jalankan `env | grep ANTHROPIC` di shell yang sama. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci yang sudah usang dari file `.env` di proyek Anda tanpa Anda mengaturnya secara eksplisit.
+* Di shell yang sama, jalankan `env | grep ANTHROPIC`, atau di PowerShell `Get-ChildItem Env:ANTHROPIC*`. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci lama dari file `.env` di proyek Anda tanpa Anda mengaturnya secara eksplisit.
* Batalkan pengaturan `ANTHROPIC_API_KEY` dan jalankan `/login` untuk menggunakan autentikasi langganan sebagai gantinya
-* Jika kunci berasal dari skrip [`apiKeyHelper`](/docs/id/settings#available-settings), jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid di stdout
+* Jika kunci berasal dari skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid ke stdout
* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code
Skrip apiKeyHelper Anda gagal
-Perintah yang dikonfigurasi dalam pengaturan [`apiKeyHelper`](/docs/id/settings#available-settings) keluar dengan kesalahan, habis waktu, atau tidak mencetak apa pun ke stdout. Tanpa kunci dari skrip, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan `401`.
+Claude Code menjalankan perintah dalam pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) Anda dan tidak mendapatkan kunci kembali. Tanpa satu, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan `401`. Panel `Authentication` di terminal menunjukkan mana dari ini yang terjadi:
+
+* Perintah keluar dengan kesalahan atau waktu habis
+* Perintah tidak mencetak apa pun ke stdout
+* Perintah mencetak sesuatu selain kunci, seperti spanduk login atau baris log. Panel menunjukkan `returned output that cannot be used as an API key` dan mengatakan apa yang salah, tanpa mengulangi output. Sebelum v2.1.227, Claude Code mengirim apa pun yang dicetak perintah, setelah memangkas spasi putih di sekitarnya.
```text theme={null}
Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
```
-Claude Code menjalankan kembali skrip dan mencoba ulang permintaan hingga dua kali lagi sebelum menampilkan pesan ini, jadi kegagalan muncul dalam tiga upaya. Sebelum v2.1.208, Claude Code menghabiskan [anggaran percobaan ulang](#automatic-retries) penuh mengirim ulang permintaan dengan kredensial placeholder dan kemudian melaporkan kesalahan autentikasi `401` generik daripada kegagalan skrip.
+Dalam [mode non-interaktif](/docs/id/headless), stderr juga membawa alasan spesifik, diawali dengan `apiKeyHelper failed:`.
+
+Claude Code menjalankan kembali skrip dan mencoba kembali permintaan hingga dua kali lagi sebelum menampilkan pesan ini, jadi kegagalan muncul dalam tiga upaya. Sebelum v2.1.208, Claude Code menghabiskan [anggaran percobaan ulang](#automatic-retries) penuh mengirim ulang permintaan dengan kredensial placeholder dan kemudian melaporkan kesalahan autentikasi `401` generik sebagai gantinya dari kegagalan skrip.
-Menjalankan `/login` tidak membantu di sini: output helper [mengambil prioritas](/docs/id/authentication#authentication-precedence) atas login yang disimpan selama pengaturan ada.
+Menjalankan `/login` tidak membantu di sini: output pembantu [mengambil prioritas](/docs/id/authentication#authentication-precedence) atas login yang disimpan selama pengaturan ada.
**Yang harus dilakukan:**
* Jalankan perintah yang dikonfigurasi dalam `apiKeyHelper` secara langsung di shell Anda untuk mereproduksi kegagalan
-* Jika perintah melaporkan sesi yang kedaluwarsa, autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau vault rahasia Anda
-* Perbaiki perintah sehingga mencetak kunci ke stdout dan keluar dengan kode 0. Lihat [putar kredensial dengan apiKeyHelper](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) untuk pengaturan yang berfungsi.
-* Jalankan `/status` untuk mengonfirmasi bahwa `apiKeyHelper` adalah sumber kredensial aktif. Setiap kali perintah gagal, kode keluar dan output kesalahannya muncul di panel `Cloud authentication` di terminal.
+* Jika perintah melaporkan sesi yang kedaluwarsa, autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau brankas rahasia Anda
+* Perbaiki perintah sehingga hanya mencetak kunci ke stdout, sebagai token ASCII yang dapat dicetak tunggal hingga 16.384 karakter, dan keluar dengan kode 0. Lihat [putar kredensial dengan apiKeyHelper](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) untuk pengaturan yang berfungsi.
+* Jalankan `/status` untuk mengonfirmasi bahwa `apiKeyHelper` adalah sumber kredensial aktif. Setiap kali perintah gagal, kode keluar dan output kesalahannya muncul dalam panel `Authentication` di terminal. Sebelum v2.1.212, panel berjudul `Cloud authentication`.
+
+
+
+Nilai yang Claude Code akan kirim sebagai header permintaan berisi karakter yang tidak dapat dibawa oleh header HTTP: jeda baris, byte NUL, atau karakter di atas `U+00FF`, seperti tanda kutip melengkung atau spasi lebar nol. Claude Code menghentikan permintaan sebelum apa pun dikirim dan menamai variabel atau pengaturan untuk diperbaiki. Penyebab umum adalah kredensial yang ditempel dari dokumen atau obrolan yang membawa karakter tak terlihat atau jeda baris yang tersesat.
+
+Claude Code menjalankan pemeriksaan ini ketika mengirim permintaan ke Claude API secara langsung atau melalui [gateway LLM](/docs/id/llm-gateway). Pada penyedia cloud pihak ketiga seperti [Amazon Bedrock](/docs/id/amazon-bedrock), Claude Code tidak menjalankannya sebelum mengirim.
+
+```text theme={null}
+Invalid auth token · Fix external auth token
+Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
+Invalid request header from the environment · Fix the environment variable
+```
+
+Bagian pertama dari pesan tergantung pada tempat nilai buruk berasal:
+
+* `Invalid auth token`: token pembawa dari [`ANTHROPIC_AUTH_TOKEN`](/docs/id/env-vars) atau [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars)
+* `Invalid ANTHROPIC_CUSTOM_HEADERS`: nama header atau nilai yang Anda atur dalam [`ANTHROPIC_CUSTOM_HEADERS`](/docs/id/env-vars). Deskripsi menghitung pasangan `Name: Value` mana yang bersalah, seperti `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, tanpa mengulangi nama atau nilai, karena Anda memilih keduanya.
+* `Invalid request header from the environment`: nilai yang Claude Code salin ke header permintaan dari variabel lingkungan lain, seperti `CLAUDE_AGENT_SDK_CLIENT_APP`. Deskripsi menamai variabel untuk diperbaiki.
+
+Claude Code melaporkan `ANTHROPIC_API_KEY` buruk yang ditangkap oleh pemeriksaan ini sebagai [Kunci API tidak valid](#invalid-api-key), dengan deskripsi trailing yang sama. Ini melaporkan kredensial `/login` yang disimpan buruk sebagai [Belum masuk](#not-logged-in) sebagai gantinya; jalankan `/login` untuk menyimpan yang baru. Output skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) tidak pernah mencapai pemeriksaan ini: Claude Code memvalidasinya ketika skrip berjalan, dan output yang tidak dapat dibawa header HTTP gagal dengan [Skrip apiKeyHelper Anda gagal](#your-apikeyhelper-script-is-failing).
+
+Setelah `·` kedua, pesan menjelaskan masalahnya, seperti dalam contoh lengkap ini:
+
+```text theme={null}
+Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
+```
+
+Posisi menghitung karakter mulai dari satu. Deskripsi dibangun dari frasa tetap dan hitungan karakter, jadi tidak pernah menyertakan nilai itu sendiri. Ini menamai karakter yang menyinggung hanya ketika itu adalah karakter tak terlihat atau tipografi yang terkenal, seperti tanda urutan byte, spasi lebar nol, atau tanda kutip melengkung, dan melaporkan apa pun yang lain sebagai `a non-ASCII character`.
+
+**Yang harus dilakukan:**
+
+* Atur ulang variabel atau pengaturan yang dinamai pesan, mengetik ulang karakter di sekitar posisi yang dilaporkan daripada menempel dari sumber yang sama lagi
+* Untuk `ANTHROPIC_CUSTOM_HEADERS`, simpan satu pasangan `Name: Value` per baris dan tulis ulang pasangan yang dihitung pesan
+* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang aktif
Organisasi ini telah dinonaktifkan
-Kunci `ANTHROPIC_API_KEY` yang sudah usang dari organisasi Console yang dinonaktifkan menimpa login langganan Anda.
+Claude Code menggunakan `ANTHROPIC_API_KEY` lama dari organisasi Console yang dinonaktifkan. Ketika Anda memiliki login langganan yang disimpan, kunci menimpanya.
```text theme={null}
-Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
+Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
+Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.
```
-Variabel lingkungan memiliki prioritas lebih tinggi daripada `/login`, jadi kunci yang diekspor di profil shell Anda atau dimuat dari file `.env` digunakan bahkan ketika Anda memiliki langganan Pro atau Max yang berfungsi. Dalam mode non-interaktif (`-p`), kunci selalu digunakan saat ada.
+Petunjuk setelah `·` tergantung pada kredensial yang disimpan Anda: bentuk pertama muncul ketika `/login` yang disimpan dapat mengambil alih setelah Anda membatalkan pengaturan kunci, dan yang kedua ketika kunci adalah satu-satunya kredensial Anda.
+
+Variabel lingkungan mengambil prioritas atas `/login`, jadi kunci yang diekspor dalam profil shell Anda atau dimuat dari file `.env` digunakan bahkan ketika Anda memiliki langganan Pro atau Max yang berfungsi. Dalam mode non-interaktif (`-p`), kunci selalu digunakan saat ada.
**Yang harus dilakukan:**
-* Batalkan pengaturan `ANTHROPIC_API_KEY` di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan kembali `claude`
-* Jalankan `/status` setelahnya untuk mengonfirmasi bahwa kredensial aktif adalah langganan Anda
-* Jika tidak ada variabel lingkungan yang diatur dan kesalahan berlanjut, organisasi yang dinonaktifkan adalah organisasi yang terikat pada `/login` Anda. Hubungi dukungan atau masuk dengan akun yang berbeda.
+* Batalkan pengaturan `ANTHROPIC_API_KEY` di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan ulang `claude`
+* Jika pesan mengatakan `Update or unset`, Anda tidak memiliki login yang disimpan untuk kembali. Batalkan pengaturan kunci dan jalankan `/login`, atau ganti kunci dengan yang dari organisasi Console aktif.
+* Jalankan `/status` setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda
+* Jika tidak ada variabel lingkungan yang diatur dan kesalahan berlanjut, organisasi yang dinonaktifkan adalah yang terikat pada `/login` Anda. Hubungi dukungan atau masuk dengan akun berbeda.
Organisasi Anda telah menonaktifkan autentikasi kunci API
-Pesan ini memerlukan Claude Code v2.1.169 atau lebih baru. Admin organisasi Console Anda telah mematikan autentikasi kunci API, jadi API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah `·` bervariasi tergantung di mana kunci berasal:
+Pesan ini memerlukan Claude Code v2.1.169 atau lebih baru. Admin organisasi Console Anda telah mematikan autentikasi kunci API, jadi API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah `·` bervariasi tergantung pada tempat kunci berasal:
```text theme={null}
Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
@@ -499,21 +935,21 @@ Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account
```
-Variabel lingkungan dan `apiKeyHelper` memiliki prioritas lebih tinggi daripada `/login`, jadi menjalankan `/login` saja tidak membantu sementara salah satu masih menyuplai kunci. Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence).
+Variabel lingkungan dan `apiKeyHelper` mengambil prioritas atas `/login`, jadi menjalankan `/login` saja tidak membantu sementara salah satu masih memasok kunci. Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence).
**Yang harus dilakukan:**
-* Jika pesan menyebutkan `ANTHROPIC_API_KEY`, batalkan pengaturannya di shell saat ini dan hapus dari profil shell Anda atau file `.env`, kemudian luncurkan kembali `claude`
-* Jika pesan menyebutkan `apiKeyHelper`, hapus pengaturan [`apiKeyHelper`](/docs/id/settings#available-settings) dari `settings.json` Anda
+* Jika pesan menamai `ANTHROPIC_API_KEY`, batalkan pengaturannya di shell saat ini dan hapus dari profil shell atau file `.env` Anda, kemudian luncurkan ulang `claude`
+* Jika pesan menamai `apiKeyHelper`, hapus pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) dari `settings.json` Anda
* Jalankan `/login` untuk masuk dengan akun claude.ai Anda
-* Jalankan `/status` setelahnya untuk mengonfirmasi bahwa kredensial aktif adalah langganan Anda daripada kunci API
+* Jalankan `/status` setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda daripada kunci API
* Jika Anda memerlukan autentikasi kunci API untuk otomasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console
Organisasi Anda telah menonaktifkan akses langganan Claude
-Organisasi Claude Anda tidak mengizinkan masuk ke Claude Code dengan login langganan. Menjalankan `/login` lagi dengan akun yang sama mengembalikan kesalahan yang sama.
+Organisasi Claude Anda tidak memungkinkan masuk ke Claude Code dengan login langganan. Menjalankan `/login` lagi dengan akun yang sama mengembalikan kesalahan yang sama.
```text theme={null}
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
@@ -526,14 +962,14 @@ Agent SDK dan mode non-interaktif `-p` menampilkan ini sebagai kode kesalahan `o
**Yang harus dilakukan:**
* Minta admin Anda untuk mengaktifkan akses Claude Code untuk organisasi Anda
-* Autentikasi dengan kunci API Console daripada langganan Anda. Lihat [autentikasi Claude Console](/docs/id/authentication#claude-console-authentication) untuk pengaturan.
+* Autentikasi dengan kunci API Console sebagai gantinya dari langganan Anda. Lihat [Autentikasi Claude Console](/docs/id/authentication#claude-console-authentication) untuk pengaturan.
* Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi [dukungan Anthropic](https://support.claude.com)
Rutinitas dinonaktifkan oleh kebijakan organisasi Anda
-Pemilik di organisasi Tim atau Enterprise Anda telah mematikan rutinitas di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan rutinitas, termasuk dari `/schedule` dan UI [Rutinitas](/docs/id/routines) di claude.ai/code.
+Pemilik dalam organisasi Tim atau Enterprise Anda telah mematikan rutinitas di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan rutinitas, misalnya dari UI [Rutinitas](/docs/id/routines) di claude.ai/code. Pada Claude Code v2.1.227 atau lebih baru, pengaturan yang sama juga [menyembunyikan `/schedule`](/docs/id/routines#troubleshooting) di CLI.
```text theme={null}
Routines are disabled by your organization's policy.
@@ -543,852 +979,3670 @@ Ini adalah pengaturan sisi server, jadi tidak dapat ditimpa dari pengaturan loka
**Yang harus dilakukan:**
-* Minta Pemilik di organisasi Anda untuk mengaktifkan toggle **Rutinitas** di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
-* Untuk pekerjaan terjadwal sekali pakai yang tidak memerlukan rutinitas tingkat organisasi, lihat [tugas terjadwal](/docs/id/scheduled-tasks)
+* Minta Pemilik dalam organisasi Anda untuk mengaktifkan toggle **Routines** di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
+* Untuk pekerjaan terjadwal satu kali yang tidak memerlukan rutinitas tingkat organisasi, lihat [tugas terjadwal](/docs/id/scheduled-tasks)
- Remote Control memerlukan API Anthropic
+ Remote Control memerlukan Anthropic API
-Sesi tidak berbicara langsung ke API Anthropic, jadi tidak ada backend claude.ai untuk [Remote Control](/docs/id/remote-control) untuk dipasangkan.
+Sesi tidak berbicara langsung dengan Anthropic API, jadi tidak ada backend claude.ai untuk [Remote Control](/docs/id/remote-control) untuk dipasangkan.
```text theme={null}
-Remote Control is only available when using Claude via api.anthropic.com.
+Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
```
-Ini muncul di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry. Mulai dari v2.1.196, ini juga muncul ketika [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) menunjuk ke host selain `api.anthropic.com`, seperti [gateway LLM](/docs/id/llm-gateway) atau proxy, bahkan ketika Anda masuk dengan claude.ai.
+Kalimat kedua menjelaskan apa yang mengarahkan sesi menjauh dari Anthropic API; sebelum v2.1.219, pesan hanya kalimat pertama. Tergantung pada penyebabnya, pesan menamai:
+
+* Variabel penyedia `CLAUDE_CODE_USE_*`, seperti `CLAUDE_CODE_USE_BEDROCK` untuk [Amazon Bedrock](/docs/id/amazon-bedrock) atau `CLAUDE_CODE_USE_VERTEX` untuk [Platform Agen Google Cloud](/docs/id/google-vertex-ai)
+* [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) menunjuk ke host selain `api.anthropic.com`, seperti [gateway LLM](/docs/id/llm-gateway) atau proxy, bahkan ketika Anda masuk dengan claude.ai; sebelum v2.1.196, URL dasar khusus tidak memblokir Remote Control
+* `ANTHROPIC_UNIX_SOCKET` diatur, jadi sesi mengirim permintaannya melalui soket lokal daripada ke `api.anthropic.com`
+* Masuk [gateway cloud](/docs/id/claude-apps-gateway) perusahaan melalui `/login`, yang tidak mendukung Remote Control dan tidak memiliki variabel untuk dibatalkan pengaturannya
**Yang harus dilakukan:**
-* Batalkan pengaturan `ANTHROPIC_BASE_URL` dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berbicara langsung ke API Anthropic
+* Batalkan pengaturan variabel yang dinamai pesan, seperti `CLAUDE_CODE_USE_BEDROCK` atau `ANTHROPIC_BASE_URL`, dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berbicara langsung dengan Anthropic API
+* Jika variabel tidak diatur di shell Anda, periksa kunci `env` dalam [file pengaturan](/docs/id/settings#where-settings-live) Anda, yang menerapkan variabel lingkungan ke setiap sesi
* Untuk pesan startup Remote Control ini dan lainnya, lihat [Troubleshoot Remote Control](/docs/id/remote-control#troubleshooting)
-
- Token OAuth dicabut atau kedaluwarsa
+
+ Remote Control tidak dapat menyegarkan login Anda
-Login yang disimpan Anda tidak lagi valid. Token yang dicabut berarti Anda keluar di mana-mana atau admin menghapus akses; token yang kedaluwarsa berarti penyegaran otomatis gagal di tengah sesi.
+Claude Code menjalankan koneksi [Remote Control](/docs/id/remote-control) langsung pada kredensial berumur pendek yang diperoleh dan diperbarui menggunakan login claude.ai yang disimpan. Ketika claude.ai berhenti menerima login itu, atau Claude Code tidak memiliki login yang disimpan lagi, Claude Code menghentikan Remote Control dan memerlukan Anda untuk masuk lagi. Kedua kegagalan dapat terjadi saat Claude Code masih terhubung atau nanti, ketika memperbaharui kredensial.
-Kedua pesan melaporkan penolakan yang dikembalikan API untuk permintaan yang dikirim Claude Code. Ketika login yang disimpan sudah dihapus setelah penyegaran yang gagal, Anda melihat [Login kedaluwarsa](#login-expired) sebagai gantinya.
+Ketika Claude Code meminta layanan login untuk menyegarkan login yang disimpan dan tidak mendapat jawaban, itu membuat Remote Control tetap berjalan dan mencoba penyegaran lagi saat kredensial koneksi masih berlaku. Penyegaran tidak mendapat jawaban ketika Claude Code tidak dapat menjangkau layanan login, permintaan habis waktu, atau layanan gagal tanpa menolak login Anda. Jika layanan login masih tidak menjawab ketika kredensial itu kedaluwarsa, Claude Code menghentikan Remote Control dan melaporkan `OAuth token refresh failed`.
+
+Ketika Claude Code menghentikan Remote Control, itu menunjukkan alasannya dalam peringatan dan dalam baris transkrip yang dimulai dengan `Remote Control disconnected`. Sesi lokal Anda terus berjalan tanpa Remote Control. Bagian ini mencakup baris-baris ini:
```text theme={null}
-OAuth token revoked · Please run /login
-OAuth token has expired · Please run /login
-API Error: 401 ... authentication_error
+Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
+Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
+Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
+Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
+Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
+Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
+Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
```
+Claude Code menamai penyebabnya di tengah pesan:
+
+* ` Claude.ai login expired` dan `Claude.ai login was rejected`: claude.ai tidak lagi menerima token login yang disimpan Anda, karena kedaluwarsa atau dicabut
+* ` OAuth token unavailable`: Claude Code tidak memiliki token login yang disimpan ketika kredensial koneksi jatuh tempo untuk pembaruan
+* `OAuth token refresh failed`: claude.ai menolak token login yang disimpan Anda saat Claude Code terhubung kembali, dan menyegarkan token tidak menghasilkan yang baru
+* `JWT refresh failed: no OAuth token`: Claude Code tidak menemukan token login yang disimpan untuk diperbarui
+* ` Signed out of Claude`: Anda keluar di mesin ini, misalnya dengan menjalankan `/logout` di terminal lain, jadi Claude Code tidak memiliki login yang disimpan untuk memperbarui koneksi
+
**Yang harus dilakukan:**
* Jalankan `/login` untuk masuk lagi
-* Jika kesalahan kembali dalam sesi yang sama setelah autentikasi ulang, jalankan `/logout` terlebih dahulu untuk sepenuhnya menghapus token yang disimpan, kemudian `/login`
-* Untuk prompt login berulang di seluruh peluncuran, lihat pemeriksaan jam sistem dan Keychain macOS di [Troubleshooting](/docs/id/troubleshoot-install#not-logged-in-or-token-expired)
-* Untuk kegagalan lainnya termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
+* Jalankan `/remote-control` untuk menghubungkan kembali sesi. Pesan yang berakhir `run /login to restore Remote Control` tidak memerlukan langkah ini: Claude Code terhubung kembali dengan sendirinya setelah Anda masuk.
-
- Login kedaluwarsa
+Sebelum v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` membaca `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, dan `JWT refresh failed: no OAuth token — run /login` membaca `no OAuth token available for recovery (code )`. Pesan `Claude.ai login expired`, `Claude.ai login was rejected`, dan `OAuth token unavailable` ditambahkan dalam v2.1.225.
+
+Sebelum v2.1.238, Claude Code melaporkan kasus yang sekarang mengatakan `Signed out of Claude` sebagai `JWT refresh failed: no OAuth token — run /login`, dan menghentikan Remote Control dengan `Claude.ai login expired — run /login to restore Remote Control` segera setelah satu penyegaran login tidak mendapat jawaban.
+
+
+ Remote Control berhenti karena akun yang masuk berubah
-Claude Code mencoba memperbarui login claude.ai atau Claude Console yang disimpan dan layanan OAuth menolak token penyegaran yang disimpan, jadi Claude Code menghapus kredensial yang disimpan. Setelah itu, setiap permintaan berhenti secara lokal sebelum mencapai API, karena hanya `/login` yang dapat membuat kredensial baru. Sebelum v2.1.206, Claude Code mengirim permintaan bagaimanapun dengan kredensial apa pun yang tersisa di lingkungan, dan setiap model kemudian gagal dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model) atau 401 daripada prompt untuk masuk.
+Claude Code menampilkan baris ini selama sesi [Remote Control](/docs/id/remote-control) ketika Anda masuk ke akun claude.ai atau organisasi berbeda di mesin ini. Anda membuat sakelar di luar sesi Claude Code, misalnya dengan menjalankan `/login` di terminal lain.
+
+Sesi Remote Control yang Anda mulai saat masuk melalui `/login` milik akun claude.ai dan organisasi yang masuk pada saat itu.
```text theme={null}
-Login expired · Please run /login
+Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
```
-Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah `authentication_failed`:
+Claude Code menghentikan sesi Remote Control segera setelah claude.ai mengonfirmasi bahwa akun atau organisasi berubah. Sesi lokal Anda terus berjalan tanpa Remote Control.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/remote-control` untuk memulai sesi Remote Control baru di bawah akun atau organisasi saat ini
+* Untuk beralih kembali, jalankan `/login` dan masuk ke akun atau organisasi sebelumnya lagi. Kemudian jalankan `/remote-control`.
+
+Sebelum v2.1.234, Claude Code tidak memperhatikan ketika Anda beralih ke akun atau organisasi berbeda di luar sesi Claude Code. Claude Code membuat sesi Remote Control tetap terhubung sampai permintaan nanti ke server Remote Control gagal dengan `Remote Control server rejected the request (HTTP 404)`. Kegagalan itu bisa datang berjam-jam setelah sakelar.
+
+
+ Remote Control berhenti karena aplikasi yang menjalankan sesi keluar atau beralih akun
+
+
+Ketika aplikasi desktop Claude atau IDE menghosting sesi Anda, Claude Code mendapatkan token login dari aplikasi itu daripada dari `/login`. Ketika claude.ai menolak token itu, Claude Code meminta aplikasi untuk yang baru. Jika aplikasi menjawab bahwa itu keluar, atau bahwa itu sekarang masuk ke akun Claude berbeda, Claude Code mengakhiri sesi [Remote Control](/docs/id/remote-control) dan mengirim aplikasi salah satu baris ini:
```text theme={null}
-Failed to authenticate: OAuth session expired and could not be refreshed
+Remote Control stopped — the app running this session is now signed in to a different Claude account
+Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
```
-Ini bukan keadaan yang sama dengan [Token OAuth dicabut atau kedaluwarsa](#oauth-token-revoked-or-expired). Pesan tersebut melaporkan 401 yang dikembalikan API. Claude Code sendiri menghasilkan `Login expired` untuk login yang sudah gagal diperbaharui, jadi tidak mengirim permintaan.
-
-Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.
+Sesi lokal Anda terus berjalan tanpa Remote Control.
**Yang harus dilakukan:**
-* Jalankan `/login` untuk masuk lagi. Mencoba ulang tanpa masuk menunjukkan pesan yang sama pada setiap permintaan.
-* Dalam mode non-interaktif, jalankan `claude` di lingkungan yang sama, selesaikan `/login`, kemudian jalankan kembali perintah Anda. Untuk otomasi yang tidak dapat masuk secara interaktif, autentikasi dengan `ANTHROPIC_API_KEY` atau [buat token jangka panjang dengan `claude setup-token`](/docs/id/authentication#generate-a-long-lived-token).
-* Jika masuk terus gagal, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
+* Jika aplikasi keluar, masuk lagi, kemudian aktifkan Remote Control kembali di aplikasi
+* Jika aplikasi beralih akun, Claude Code tidak dapat melanjutkan sesi yang berakhir di bawah akun baru. Mulai sesi Remote Control baru di bawah akun itu.
-
- Persyaratan cakupan OAuth
+Sebelum v2.1.238, Claude Code mengirim aplikasi pesan `run /login` yang tercantum di bawah [Remote Control tidak dapat menyegarkan login Anda](#remote-control-couldnt-refresh-your-login) dalam kedua kasus.
+
+
+ Token OAuth dicabut atau kedaluwarsa
-Token yang disimpan mendahului cakupan izin yang diperlukan fitur yang lebih baru. Anda paling sering melihat ini dari `/usage` dan indikator penggunaan baris status:
+Login yang disimpan tidak lagi valid. Token yang dicabut berarti Anda keluar di mana-mana atau admin menghapus akses; token yang kedaluwarsa berarti penyegaran otomatis gagal di tengah sesi.
+
+Kedua pesan melaporkan penolakan yang dikembalikan API untuk permintaan yang dikirim Claude Code. Ketika login yang disimpan sudah dihapus setelah penyegaran yang gagal, Anda melihat [Login kedaluwarsa](#login-expired) sebagai gantinya. Jika Anda autentikasi dengan token berumur panjang dalam [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), Anda melihat pesan yang sama ketika token itu kedaluwarsa atau dicabut.
```text theme={null}
-OAuth token does not meet scope requirement: user:profile
+OAuth token revoked · Please run /login
+Please run /login · API Error: 401 OAuth token has expired ...
```
**Yang harus dilakukan:**
-* Jalankan `/login` untuk mendapatkan token baru dengan cakupan saat ini. Anda tidak perlu keluar terlebih dahulu.
+* Jalankan `/login` untuk masuk lagi
+* Jika kesalahan kembali dalam sesi yang sama setelah autentikasi ulang, jalankan `/logout` terlebih dahulu untuk sepenuhnya menghapus token yang disimpan, kemudian `/login`
+* Jika Anda autentikasi dengan variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code terus mengirim nilai yang Anda atur setelah permintaan gagal dengan 401, daripada beralih ke token login yang disimpan. [`/status`](/docs/id/commands) menunjukkan kredensial ini sebagai baris `Auth token` membaca `CLAUDE_CODE_OAUTH_TOKEN`. Hasilkan token segar dengan [`claude setup-token`](/docs/id/authentication#generate-a-long-lived-token) dan mulai ulang dengannya, atau batalkan pengaturan variabel dan jalankan `/login`. Sebelum v2.1.225, Claude Code dapat mengganti nilai variabel di tengah sesi dengan token akses berumur pendek dari login yang disimpan, dan sesi gagal dengan kesalahan 401 lagi setelah token itu kedaluwarsa.
+* Untuk prompt berulang untuk masuk di seluruh peluncuran, lihat pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS dalam [Troubleshooting](/docs/id/troubleshoot-install#not-logged-in-or-token-expired)
+* Untuk kegagalan lainnya termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
-
- Kredensial AWS kedaluwarsa atau tidak valid
+
+ API Error: 401 Kredensial autentikasi tidak valid
-Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru dan hanya muncul ketika [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) diatur dalam file pengaturan Anda. Token sesi AWS Anda kedaluwarsa atau ditolak, dan penyegaran otomatis yang sudah dijalankan Claude Code tidak menghasilkan kredensial yang diterima API. Ini muncul pada 401 dari [Claude Platform on AWS](/docs/id/claude-platform-on-aws) atau [endpoint Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), yang merupakan cara penyedia tersebut melaporkan token keamanan yang kedaluwarsa.
-
-Petunjuk tindakan di tengah menyebutkan perintah `awsAuthRefresh` dari pengaturan Anda, jadi bervariasi. Bagian yang stabil adalah `AWS credentials expired or invalid` di awal:
+API mengenali format kredensial Anda tetapi menolak akun atau organisasi di baliknya. Anthropic mengembalikan pesan ini ketika kredensial baru saja dicabut, ketika organisasi dinonaktifkan atau menghapus akses Anda, atau ketika akun itu sendiri dinonaktifkan, jadi token yang kedaluwarsa bukan penyebabnya. Kredensial dapat berupa login yang disimpan atau `ANTHROPIC_API_KEY` yang disetujui, dan perbaikannya berbeda, jadi mulai dengan menjalankan `/status` untuk melihat mana yang aktif.
```text theme={null}
-AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
+Please run /login · API Error: 401 Invalid authentication credentials
```
-Tanpa `awsAuthRefresh` yang dikonfigurasi, 401 yang sama menunjukkan pesan generik `Please run /login` sebagai gantinya, yang tidak dapat menyegarkan kredensial AWS.
-
**Yang harus dilakukan:**
-* Jalankan perintah `awsAuthRefresh` yang disebutkan dalam pesan, seperti `aws sso login --profile myprofile`, di terminal lain dan selesaikan masuk browser, kemudian coba lagi
-* Dalam sesi interaktif, jalankan `/login`, pilih **platform pihak ketiga**, kemudian pilih **Claude Platform on AWS · refresh credentials** di bawah **Menggunakan platform pihak ketiga** untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat [Konfigurasi kredensial AWS](/docs/id/claude-platform-on-aws#1-configure-aws-credentials)
-* Jika kesalahan berulang setelah perintah penyegaran berhasil, konfirmasi identitas valid di luar Claude Code dengan `aws sts get-caller-identity` di shell dan profil yang sama
+* Jika `/status` menunjukkan baris `API key` yang tidak ditandai sebagai tidak digunakan, `ANTHROPIC_API_KEY` yang disetujui [`ANTHROPIC_API_KEY`](/docs/id/authentication#authentication-precedence) adalah kredensial aktif dan mengambil prioritas atas login Anda, jadi `/login` tidak menggantinya. Putar kunci di Claude Console, atau kembali ke langganan Anda dengan menjalankan `unset ANTHROPIC_API_KEY`, atau di PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
+* Jika `/status` hanya menunjukkan login Anda, jalankan `/login` sekali. Jika kredensial dicabut, login segar menggantinya.
+* Jika pesan yang sama kembali untuk akun login yang sama, akun atau organisasi tidak lagi aktif. Periksa akun dan organisasi yang dilaporkan `/status`, dan minta admin organisasi Anda untuk memulihkan akses.
+* Jika [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) menunjuk ke [gateway LLM](/docs/id/llm-gateway), teks setelah `401` adalah pesan gateway Anda daripada Anthropic, dan `/login` tidak mengubahnya. Perbaiki kredensial yang diharapkan gateway Anda sebagai gantinya.
-
- Autentikasi AWS gagal
+
+ Login kedaluwarsa
-Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru dan hanya muncul ketika [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) diatur dalam file pengaturan Anda. Penyedia AWS Anda mengembalikan 403, atau [Amazon Bedrock](/docs/id/amazon-bedrock) mengembalikan 401.
+Claude Code mencoba memperbarui login claude.ai atau Claude Console yang disimpan dan layanan OAuth menolak token penyegaran yang disimpan, jadi Claude Code menghapus kredensial yang disimpan. Setelah itu, setiap permintaan model berhenti secara lokal dengan pesan ini sebelum mencapai API, karena hanya `/login` yang dapat membuat kredensial baru.
-Claude Code tidak dapat mengetahui penyebab mana yang Anda alami. Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara melaporkan penolakan otorisasi, seperti `AccessDeniedException` dari izin IAM yang hilang atau model yang tidak diaktifkan untuk akun Anda.
+Sebelum v2.1.206, Claude Code mengirim permintaan model bagaimanapun dengan kredensial apa pun yang tersisa di lingkungan, dan setiap model kemudian gagal dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model) atau 401 sebagai gantinya dari prompt untuk masuk.
-401 dari Amazon Bedrock juga mendarat di sini daripada di bawah [Kredensial AWS kedaluwarsa atau tidak valid](#aws-credentials-expired-or-invalid), karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari endpoint tersebut biasanya berasal dari sesuatu yang lain di jalur permintaan, seperti proxy perusahaan.
+```text theme={null}
+Login expired · Please run /login
+```
-Penyegaran kredensial memperbaiki token yang kedaluwarsa dan tidak dapat memperbaiki penyebab lainnya, jadi pesan menawarkan keduanya:
+Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah `authentication_failed`:
```text theme={null}
-AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
+Failed to authenticate: OAuth session expired and could not be refreshed
```
-Petunjuk tindakan di tengah menyebutkan perintah `awsAuthRefresh` dari pengaturan Anda, jadi bervariasi. Bagian yang stabil adalah `AWS authentication failed` di awal.
+Ini bukan keadaan yang sama seperti [Token OAuth dicabut atau kedaluwarsa](#oauth-token-revoked-or-expired). Pesan-pesan itu melaporkan penolakan yang dikembalikan API. Claude Code sendiri menghasilkan `Login expired` untuk login yang sudah gagal diperbarui, jadi tidak mengirim permintaan. Ketika pembaruan gagal karena akun itu sendiri ditangguhkan daripada login yang sudah usang, Claude Code menunjukkan [Akun Anda ditahan](#your-account-is-on-hold) sebagai gantinya.
+
+Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.
+
+Anda dapat memeriksa keadaan ini sebelum permintaan gagal: [`/status`](/docs/id/commands) menunjukkan baris `Login` membaca `Expired — log in again`, ditambah organisasi dan email yang disimpannya untuk login yang kedaluwarsa. Baris muncul hanya ketika login yang disimpan adalah kredensial aktif Anda dan tidak dapat lagi disegarkan. Sesi yang diautentikasi dengan cara lain tidak menunjukkan baris, bahkan jika login yang kedaluwarsa tetap disimpan. Sebelum v2.1.210, `/status` tidak memberikan indikasi dalam keadaan ini bahwa login pernah ada, karena kredensial yang dihapus meninggalkannya tidak ada untuk dilaporkan.
**Yang harus dilakukan:**
-* Jalankan perintah `awsAuthRefresh` yang disebutkan dalam pesan, atau `aws sso login`, untuk berjaga-jaga jika kredensial yang kedaluwarsa adalah penyebabnya
-* Jika kredensial Anda saat ini, konfirmasi izin IAM di [Konfigurasi IAM](/docs/id/amazon-bedrock#iam-configuration) terlampir pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan wilayah Anda
-* Jalankan `aws sts get-caller-identity` untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; `AWS_PROFILE` yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin
+* Jalankan `/login` untuk masuk lagi. Mencoba lagi tanpa masuk menunjukkan pesan yang sama pada setiap permintaan.
+* Dalam mode non-interaktif, jalankan `claude` di lingkungan yang sama, selesaikan `/login`, kemudian jalankan kembali perintah Anda. Untuk otomasi yang tidak dapat masuk secara interaktif, autentikasi dengan `ANTHROPIC_API_KEY` atau [hasilkan token berumur panjang dengan `claude setup-token`](/docs/id/authentication#generate-a-long-lived-token).
+* Jika masuk terus gagal, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
-
- Penyelesaian kredensial rantai default AWS habis waktu
+
+ Login Claude tidak diterima
-Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, jadi Claude Code menghentikan penyelesaian dan gagal permintaan. Kegagalan adalah penyelesaian kredensial lokal: permintaan tidak pernah mencapai [Amazon Bedrock](/docs/id/amazon-bedrock), [Claude Platform on AWS](/docs/id/claude-platform-on-aws), atau [endpoint Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint). Claude Code menghapus [cache kredensial](/docs/id/amazon-bedrock#credential-caching-and-resolution-timeout) dan mencoba ulang sebelum kesalahan ini muncul, jadi pada saat Anda melihatnya rantai telah macet pada upaya berulang.
+Anda mencoba memulai [sesi cloud](/docs/id/claude-code-on-the-web), dan server menolak untuk membuatnya dengan 401: itu tidak menerima login Claude yang dikirim mesin ini, biasanya karena login kedaluwarsa atau dicabut.
+
+Bagian pertama dari baris adalah alasan server sendiri ketika memberikan satu. Jika tidak, baris berbunyi:
```text theme={null}
-API Error: AWS default-chain credential resolve timed out
+Claude login not accepted · Run /login, then try again
```
-Penyebab umum adalah perintah `credential_process` di profil AWS Anda yang menunggu input yang tidak dapat diterima, dan kontainer atau VM yang layanan metadata instans (IMDS) tidak pernah menjawab probe rantai. Sebelum v2.1.207, rantai yang macet membiarkan permintaan menunggu tanpa batas waktu daripada gagal dengan pesan ini.
-
**Yang harus dilakukan:**
-* Jalankan `aws sts get-caller-identity` di shell yang sama dengan `AWS_PROFILE` yang sama. Jika juga hang, perbaiki profil; perintah `credential_process` yang meminta secara interaktif adalah penyebab umum.
-* Selesaikan langkah masuk sebelum memulai Claude Code, misalnya `aws sso login --profile myprofile`, sehingga rantai diselesaikan dari cache SSO lokal daripada menunggu alur browser
-* Jika rantai Anda menjalankan masuk interaktif yang secara sah memerlukan lebih dari 60 detik, seperti SSO dengan MFA melalui wrapper seperti `aws-vault`, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)
-
-
- Kesalahan jaringan dan koneksi
-
-
-Kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya, atau sesuatu antara Claude Code dan API mengubah respons dalam perjalanannya kembali. Biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.
+* Jalankan `/login`, selesaikan masuk, kemudian mulai sesi lagi
-
- Tidak dapat terhubung ke API
+
+ Kebijakan administrator memerlukan masuk Cloud gateway
-Koneksi TCP ke API gagal atau tidak pernah selesai.
+Pengaturan [terkelola](/docs/id/managed-settings) administrator di mesin ini menetapkan [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) ke `"gateway"` atau menetapkan [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl). Kecuali Anda memilih penyedia cloud melalui variabel seperti `CLAUDE_CODE_USE_BEDROCK`, Claude Code kemudian hanya menerima masuk [gateway aplikasi Claude](/docs/id/claude-apps-gateway). Anda melihat salah satu dari dua pesan:
```text theme={null}
-Unable to connect to API. Check your internet connection
-Unable to connect to API (ECONNREFUSED)
-Unable to connect to API (ECONNRESET)
-Unable to connect to API (ETIMEDOUT)
-fetch failed
-Request timed out. Check your internet connection and proxy settings
+Not signed in to the Cloud gateway — run /login.
```
-Penyebab umum termasuk tidak ada akses internet, VPN yang memblokir `api.anthropic.com`, atau proxy perusahaan yang diperlukan tetapi tidak dikonfigurasi.
+Permintaan model gagal dengan pesan ini ketika sesi tidak memiliki masuk gateway, misalnya karena Anda belum menjalankan `/login` sejak kebijakan mencapai mesin.
+
+Jika Anda juga memiliki kredensial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` yang dikonfigurasi dan pengaturan terkelola menetapkan `forceLoginMethod`, Claude Code keluar saat startup sebagai gantinya dengan pesan yang dimulai:
+
+```text theme={null}
+Administrator policy requires a Cloud gateway sign-in on this machine; the
+Anthropic-issued credential configured here (ANTHROPIC_API_KEY,
+ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.
+```
**Yang harus dilakukan:**
-* Konfirmasi Anda dapat menjangkau host API dari shell yang sama dengan menjalankan `curl -I https://api.anthropic.com`. Di Windows PowerShell gunakan `curl.exe -I https://api.anthropic.com` sehingga alias `Invoke-WebRequest` bawaan tidak digunakan.
-* Jika Anda berada di belakang proxy perusahaan, atur `HTTPS_PROXY` sebelum meluncurkan Claude Code dan lihat [Konfigurasi jaringan](/docs/id/network-config)
-* Jika Anda merutekan melalui gateway LLM atau relay, atur [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) ke alamatnya. Lihat [Hubungkan Claude Code ke gateway LLM](/docs/id/llm-gateway-connect) untuk pengaturan.
-* Pastikan firewall Anda memungkinkan host yang tercantum dalam [Persyaratan akses jaringan](/docs/id/network-config#network-access-requirements)
-* Kegagalan intermiten [diulang secara otomatis](#automatic-retries); kegagalan persisten menunjukkan masalah jaringan lokal
+* Jalankan `/login` dan selesaikan masuk di layar **Cloud gateway**
+* Untuk pesan startup, hapus pengaturan `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` yang Anda konfigurasi, kemudian mulai `claude` dan jalankan `/login`
+* Jika Anda percaya mesin tidak boleh memerlukan gateway, minta administrator yang mengelolanya untuk menghapus `forceLoginMethod` dan `forceLoginGatewayUrl` dari pengaturan terkelolanya
-Jika `curl` berhasil tetapi Claude Code masih gagal, penyebabnya biasanya sesuatu antara runtime dan jaringan daripada jaringan itu sendiri:
+Pada v2.1.265, regresi juga menunjukkan pesan pertama dalam beberapa konfigurasi gateway LLM dan proxy yang autentikasi dengan kunci API, `apiKeyHelper`, atau header khusus, bahkan tanpa persyaratan administrator di mesin. Perbarui ke v2.1.266 atau lebih baru. Anda tidak perlu mengubah konfigurasi Anda.
-* Di Linux dan WSL, periksa `/etc/resolv.conf` untuk nameserver yang tidak dapat dijangkau. WSL khususnya dapat mewarisi resolver yang rusak dari host.
-* Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka tunnel atau aturan routing. Periksa `ifconfig` untuk antarmuka `utun` yang sudah usang dan hapus ekstensi jaringan VPN di System Settings.
-* Docker Desktop dan runtime container serupa dapat mengintersepsi lalu lintas keluar. Tutup mereka dan coba lagi untuk mengesampingkan ini.
+Sebelum v2.1.261, pada mesin yang menetapkan `forceLoginMethod` ke `"gateway"`, Claude Code menggunakan login yang disimpan sisa daripada gagal permintaan model, dan melaporkan kredensial lingkungan yang dikonfigurasi dengan `This machine's managed settings require a first-party login` daripada pesan startup. Sebelum v2.1.265, mesin yang pengaturan terkelolanya hanya menetapkan `forceLoginGatewayUrl` tidak memerlukan masuk gateway, dan Claude Code menggunakan kredensial sisa di sana.
-
- Bedrock streaming response memiliki content-type yang tidak terduga
+
+ Akun Anda ditahan
-Gateway atau proxy antara Claude Code dan [Amazon Bedrock](/docs/id/amazon-bedrock) mengubah badan respons streaming atau header `Content-Type`-nya. Amazon Bedrock melakukan streaming respons sebagai `application/vnd.amazon.eventstream`, dan Claude Code menolak respons streaming yang berhasil yang melaporkan content-type berbeda daripada mendekode badan yang tidak dapat dibacanya. Permintaan tidak diulang.
+Akun Claude di balik login Anda telah ditangguhkan. Claude Code menunjukkan pesan pertama ketika mencoba memperbarui login yang disimpan dan mempelajari tentang penahan, dan yang kedua ketika masuk yang Anda selesaikan di browser melaporkannya:
```text theme={null}
-Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
+Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
+Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
```
-Sebelum v2.1.208, konfigurasi yang sama muncul sebagai `API Error: Truncated event message received` setelah seluruh respons telah di-buffer.
+Masuk lagi dengan akun yang sama tidak menghapus pesan, karena penahan ada di akun daripada login. Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstruktur adalah `account_on_hold`. Sebelum v2.1.235, Claude Code melaporkan akun yang ditahan sebagai [Login kedaluwarsa · Silakan jalankan /login](#login-expired), yang langkah pemulihan tidak dapat menghapus penahan.
**Yang harus dilakukan:**
-* Konfigurasikan gateway untuk melewatkan badan respons `InvokeModelWithResponseStream` dan header `Content-Type`-nya tanpa diubah. Perantara yang memancarkan kembali aliran sebagai server-sent events adalah penyebab umum.
-* Jika gateway hanya menulis ulang header dan melewatkan badan biner tanpa diubah, atur [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/id/env-vars) untuk melewati pemeriksaan sampai gateway diperbaiki. Lihat [Streaming errors behind a gateway or proxy](/docs/id/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
+* Buka tautan dalam pesan untuk melihat detail penahan atau mengajukan banding
+* Jika Anda memiliki akun Claude lain atau kunci API yang tidak terpengaruh oleh penahan, Anda dapat terus bekerja saat penahan diselesaikan: jalankan `/login` dengan akun itu, atau atur kunci dengan `ANTHROPIC_API_KEY`
-
- Kesalahan sertifikat SSL
+
+ Login profil Anthropic kedaluwarsa
-Proxy atau perangkat keamanan di jaringan Anda mengintersepsi lalu lintas TLS dengan sertifikatnya sendiri, dan Claude Code tidak mempercayainya.
+Claude Code mengautentikasi melalui profil kredensial Anthropic yang kredensial login yang disimpan telah kedaluwarsa, dan profil tidak menyimpan kredensial penyegaran yang dapat digunakan Claude Code untuk memperbarui. Claude Code menghentikan setiap permintaan secara lokal tanpa mencoba lagi, karena percobaan lagi akan membaca kredensial yang sama yang kedaluwarsa.
```text theme={null}
-Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
-Unable to connect to API: Self-signed certificate detected
+Anthropic profile login expired · Re-authenticate your Anthropic profile
+Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
```
-Mulai dari v2.1.199, kegagalan validasi sertifikat tidak diulang, jadi kesalahan ini muncul pada percobaan pertama daripada setelah [anggaran retry](#automatic-retries) penuh. Versi sebelumnya menghabiskan beberapa menit untuk mencoba ulang sebelum menampilkannya. Kondisi TLS sementara, seperti timeout handshake, masih mencoba ulang.
+Ini muncul hanya ketika kredensial aktif berasal dari profil kredensial Anthropic, yang Anda pilih dengan variabel lingkungan `ANTHROPIC_PROFILE`, yang Claude Code temukan sebagai profil aktif di direktori konfigurasi Anthropic Anda, atau yang Claude Code tulis ketika Anda [masuk tanpa kunci API](/docs/id/authentication#sign-in-without-an-api-key). Sesi yang autentikasi dengan opsi claude.ai `/login`, kunci API, token pembawa seperti `ANTHROPIC_AUTH_TOKEN`, atau penyedia pihak ketiga tidak pernah melihat pesan ini.
-Selama `/login` dan pemeriksaan konektivitas startup, kegagalan yang sama dilaporkan dengan kode OpenSSL dan perbaikan inline:
+Pada mesin yang [menawarkan masuk tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login`, pilih akun Anthropic Console, dan masuk lagi untuk memperbarui profil yang ditulis oleh masuk Console tanpa kunci atau CLI Platform Claude `ant auth login`. Claude Code mengganti kredensial yang kedaluwarsa dalam profil itu. Untuk profil federasi atau yang dibuat alat lain, `/login` tidak memperbarui kredensial. Bentuk mana yang Anda lihat tergantung pada apakah Anda memilih profil atau Claude Code menemukannya:
-```text theme={null}
-SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
-```
+* Ketika Anda menetapkan `ANTHROPIC_PROFILE` secara eksplisit, pesan berakhir dengan `Re-authenticate your Anthropic profile`.
+* Ketika Claude Code menemukan profil dari direktori konfigurasi Anda, pesan menawarkan `/login`, karena Claude Code memberikan prioritas `/login` yang berfungsi atas profil yang ditemukan dan kemudian autentikasi dengan akun claude.ai atau Console Anda sebagai gantinya. Sebelum v2.1.234, Claude Code menunjukkan bentuk `Re-authenticate your Anthropic profile` dalam kasus ini juga.
**Yang harus dilakukan:**
-* Ekspor bundle CA organisasi Anda dan arahkan Claude Code ke sana dengan `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
-* Lihat [Konfigurasi jaringan](/docs/id/network-config#custom-ca-certificates) untuk instruksi pengaturan lengkap
-* Jangan atur `NODE_TLS_REJECT_UNAUTHORIZED=0`, yang menonaktifkan validasi sertifikat sepenuhnya
+* Masuk ke profil lagi, kemudian coba lagi: pada mesin yang [menawarkan masuk tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login` dan pilih akun Anthropic Console untuk profil yang ditulis oleh masuk Console tanpa kunci atau CLI Platform Claude `ant auth login`; untuk profil lain, gunakan alat yang membuatnya
+* Jika administrator menyediakan kredensial profil, minta mereka untuk mengeluarkan yang baru
+* Jalankan `/status` untuk mengonfirmasi sumber kredensial aktif dan nama profil
+* Untuk berhenti menggunakan profil, batalkan pengaturan `ANTHROPIC_PROFILE` jika Anda menetapkannya, kemudian autentikasi dengan cara lain, seperti `/login` atau `ANTHROPIC_API_KEY`
-
- Host tidak diizinkan dalam sesi cloud
+
+ Persyaratan cakupan OAuth
-Permintaan HTTP keluar dari sesi cloud atau routine diblokir oleh kebijakan jaringan lingkungan.
+Token yang disimpan mendahului cakupan izin yang dibutuhkan fitur yang lebih baru. Anda melihat ini paling sering dari `/usage` dan indikator penggunaan baris status:
```text theme={null}
-HTTP 403
-x-deny-reason: host_not_allowed
+OAuth token does not meet scope requirement: user:profile
```
-Anda juga dapat melihat sertifikat TLS yang tidak cocok dengan sertifikat asli tujuan. Lingkungan cloud merutekan lalu lintas keluar melalui proxy yang memberlakukan kebijakan jaringan, jadi sertifikat yang tidak cocok berarti proxy mengakhiri koneksi, bukan tujuan.
-
-Ini bukan masalah jaringan sisi klien. Sesi cloud dan [routines](/docs/id/routines) berjalan di dalam lingkungan sandbox yang lalu lintas keluarnya disaring ke daftar izin lingkungan. Lingkungan **Default** menggunakan akses **Trusted**, yang memungkinkan [daftar izin default](/docs/id/claude-code-on-the-web#default-allowed-domains) dari registri paket, API penyedia cloud, registri container, dan domain pengembangan umum tetapi memblokir semuanya.
-
**Yang harus dilakukan:**
-* Buka routine untuk diedit, atau mulai sesi cloud. Pilih ikon cloud yang menampilkan nama lingkungan Anda, seperti **Default**, untuk membuka pemilih. Arahkan ke lingkungan Anda dan klik ikon pengaturan.
-* Dalam dialog **Update cloud environment**, ubah **Network access** dari **Trusted** ke **Custom**, kemudian tambahkan domain yang diblokir ke **Allowed domains**. Masukkan satu domain per baris. Centang **Also include default list of common package managers** untuk menyimpan [daftar izin default](/docs/id/claude-code-on-the-web#default-allowed-domains) bersama domain kustom Anda. Pilih **Full** sebagai gantinya jika Anda menginginkan akses tanpa batas.
-* Klik **Save changes**. Jalankan berikutnya menggunakan daftar izin yang diperbarui.
-
-Lihat [Network access](/docs/id/claude-code-on-the-web#network-access) untuk tingkat akses dan daftar izin default. Sesi CLI lokal tidak terpengaruh oleh kebijakan ini.
+* Jalankan `/login` untuk mendapatkan token baru dengan cakupan saat ini. Anda tidak perlu keluar terlebih dahulu.
-
- Tidak dapat terhubung kembali ke sesi Remote Control Anda
+
+ claude.ai menolak token sesi
+Permintaan [konektor claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai) gagal karena claude.ai menolak token dari login Claude Code Anda, biasanya login yang kedaluwarsa dan tidak dapat disegarkan. Token yang ditolak adalah login Anda, bukan otorisasi konektor sendiri di claude.ai, jadi mengotorisasi konektor lagi tidak menyelesaikannya. Dalam `/mcp`, konektor menunjukkan sebagai `connected · session token rejected` dan tampilan detailnya berbunyi:
+
```text theme={null}
-Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
+claude.ai rejected the session token. Run /login, then reconnect.
```
-Melanjutkan dengan `claude --resume` atau `claude --continue` terhubung kembali ke sesi [Remote Control](/docs/id/remote-control) yang dicatat dalam percakapan itu. Pesan ini berarti reconnection gagal karena alasan yang mungkin bersifat sementara, seperti gangguan jaringan atau kesalahan server, jadi Claude Code tidak dapat mengkonfirmasi apakah sesi remote masih ada. Sesi lokal Anda terus berjalan tanpa Remote Control.
-
**Yang harus dilakukan:**
-* Jalankan `/remote-control` untuk mencoba ulang koneksi
-* Mulai Claude Code tanpa `--resume` untuk membuat sesi Remote Control baru
-* Untuk pesan startup Remote Control lainnya, lihat [Troubleshoot Remote Control](/docs/id/remote-control#troubleshooting)
+* Jalankan `/login` untuk masuk lagi
+* Hubungkan kembali konektor dari `/mcp`, atau jalankan `/mcp reconnect `. Menghubungkan kembali sebelum Anda masuk lagi meninggalkan konektor dalam keadaan yang sama. Opsi **Reconnect** panel `/mcp` melaporkan `your claude.ai session token was rejected`; bentuk `/mcp reconnect ` yang diketik melaporkan reconnect yang berhasil meskipun token masih ditolak.
-Anda tidak akan melihat pesan ini ketika server mengkonfirmasi sesi sebelumnya tidak lagi ada; Claude Code membuat yang baru dalam hal itu. Sebelum v2.1.200, kegagalan reconnection apa pun membuat sesi Remote Control baru, yang meninggalkan sesi ekstra dalam daftar sesi di claude.ai/code.
+Sebelum v2.1.222, Claude Code menandai konektor sebagai memerlukan autentikasi sebagai gantinya, yang menunjukkan Anda pada alur otorisasi konektor meskipun menyelesaikannya tidak menyelesaikan keadaan.
-
- Kesalahan permintaan
-
+
+ Server MCP memerlukan Anda untuk masuk lagi
+
-Kesalahan ini berkaitan dengan konten permintaan Anda. Sebagian besar kembali dari API setelah menolak permintaan; beberapa diproduksi secara lokal oleh Claude Code sebelum permintaan apa pun dikirim.
+Server [MCP](/docs/id/mcp) jarak jauh menolak kredensial pada panggilan alat di tengah sesi, biasanya karena masuk atau token kedaluwarsa atau karena token kekurangan izin yang dibutuhkan alat. Panggilan alat gagal, dan `/mcp` menandai server sebagai [memerlukan autentikasi](/docs/id/mcp#authenticate-with-remote-mcp-servers).
-
- Prompt terlalu panjang
-
+Untuk server yang Anda masuki dari Claude Code, termasuk konektor claude.ai, masuk kedaluwarsa atau dicabut:
+
+```text theme={null}
+MCP server "" needs you to sign in again (run /mcp to re-authenticate)
+```
+
+Jalankan `/mcp`, pilih server, dan masuk lagi dari menunya.
-Percakapan ditambah file terlampir melebihi jendela konteks model.
+Untuk server yang dikonfigurasi dengan skrip [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), Claude Code sudah menjalankan kembali pembantu dan mencoba lagi panggilan sekali sebelum menunjukkan ini:
```text theme={null}
-Prompt is too long
+MCP server "" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
```
-**Yang harus dilakukan:**
+Periksa bahwa pembantu mengembalikan kredensial yang diterima server, kemudian hubungkan kembali dari `/mcp`, yang menjalankan pembantu lagi.
-* Jalankan `/compact` untuk merangkum giliran sebelumnya dan membebaskan ruang, atau `/clear` untuk memulai dari awal
-* Jalankan `/context` untuk melihat rincian apa yang mengonsumsi jendela: prompt sistem, alat, file memori, dan pesan
-* Nonaktifkan server MCP yang tidak Anda gunakan dengan `/mcp disable ` untuk menghapus definisi alat mereka dari konteks
-* Pangkas file memori `CLAUDE.md` yang besar, atau pindahkan instruksi ke [aturan yang dibatasi jalur](/docs/id/memory#path-specific-rules) yang dimuat hanya ketika relevan
-* Subagen mewarisi setiap definisi alat MCP dari sesi induk, yang dapat mengisi jendela konteks mereka sebelum giliran pertama. Nonaktifkan server MCP yang tidak Anda gunakan sebelum menelurkan subagen.
-* Auto-compact diaktifkan secara default dan biasanya mencegah kesalahan ini. Jika Anda telah menetapkan [`DISABLE_AUTO_COMPACT`](/docs/id/env-vars), aktifkan kembali atau jalankan `/compact` secara manual sebelum jendela penuh.
+Untuk server dengan header `Authorization` statis dalam konfigurasinya:
-Lihat [Jelajahi jendela konteks](/docs/id/context-window) untuk tampilan interaktif tentang bagaimana konteks terisi.
+```text theme={null}
+MCP server "" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
+```
-
- Kesalahan selama pemadatan: Percakapan terlalu panjang
-
+Perbarui nilai header tempat server dikonfigurasi, kemudian hubungkan kembali dari `/mcp`.
+
+Sebelum v2.1.273, kasus masuk yang kedaluwarsa, `headersHelper`, dan header `Authorization` semuanya menunjukkan `MCP server "" requires re-authorization (token expired)`.
-`/compact` itu sendiri gagal karena tidak ada cukup konteks gratis untuk menampung ringkasan yang dihasilkannya.
+Server juga dapat menolak panggilan alat dengan HTTP 403 `insufficient_scope` untuk meminta Anda mengotorisasi cakupan, kadang-kadang yang sudah tercantum dalam token Anda. Pesan menamai cakupan itu:
```text theme={null}
-Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
+MCP server "" needs additional permissions (scope: "") — run /mcp to re-authenticate
```
-Ini dapat terjadi ketika jendela sudah penuh pada saat auto-compact dipicu, atau ketika Anda menjalankan `/compact` setelah melihat `Prompt is too long`.
+Jalankan `/mcp`, pilih server, dan autentikasi lagi dari menunya.
-**Yang harus dilakukan:**
+Ketika konfigurasi server tidak menetapkan [`oauth.scopes`](/docs/id/mcp#restrict-oauth-scopes) atau [`authServerMetadataUrl`](/docs/id/mcp#override-oauth-metadata-discovery), Claude Code meminta cakupan yang dinamai server. Dengan pengaturan apa pun, Claude Code meminta cakupan pengaturan itu sebagai gantinya. Jika Anda menyematkan `oauth.scopes`, tambahkan cakupan yang hilang ke daftar itu sebelum Anda autentikasi lagi.
-* Tekan Esc dua kali untuk membuka daftar pesan dan mundur beberapa giliran. Ini menghilangkan pesan terbaru dari konteks. Kemudian jalankan `/compact` lagi.
-* Jika mundur tidak membebaskan cukup ruang, jalankan `/clear` untuk memulai sesi baru. Percakapan sebelumnya Anda disimpan dan dapat dibuka kembali dengan `/resume`.
+Sebelum v2.1.274, kasus ini menunjukkan pesan `needs you to sign in again`, dan sebelum v2.1.273 itu menunjukkan `requires re-authorization (token expired)` seperti kasus lainnya.
-
- Permintaan terlalu besar
+
+ Ketidakcocokan penerbit dalam respons otorisasi
-Badan permintaan mentah melebihi batas byte API sebelum tokenisasi, biasanya karena file atau lampiran besar yang ditempel.
+Selama [masuk OAuth MCP](/docs/id/mcp#authenticate-with-remote-mcp-servers), server otorisasi dialihkan kembali ke Claude Code dengan parameter `iss` yang tidak menamai penerbit yang diharapkan Claude Code dari metadata OAuth server. Penerbit yang salah pada langkah ini adalah bagaimana serangan pencampuran server otorisasi terlihat, jadi Claude Code gagal masuk daripada menukar kode otorisasi. Claude Code menunjukkan kesalahan dalam menu server `/mcp` setelah masuk browser:
```text theme={null}
-Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
+Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
```
-Ini adalah batas ukuran pada permintaan HTTP, terpisah dari [batas jendela konteks](#prompt-is-too-long).
+`expected` adalah penerbit dari metadata OAuth server, dan `received` adalah nilai `iss` yang dibawa pengalihan. Masuk yang pengalihannya tidak membawa parameter `iss` melewati pemeriksaan, kecuali metadata server menetapkan `authorization_response_iss_parameter_supported`, dalam hal ini Claude Code gagal masuk.
**Yang harus dilakukan:**
-* Tekan Esc dua kali dan mundur melewati giliran yang menambahkan konten yang terlalu besar
-* Referensikan file besar berdasarkan jalur alih-alih menempel konten mereka, sehingga Claude dapat membacanya dalam potongan
-* Untuk gambar, lihat [Gambar terlalu besar](#image-was-too-large) di bawah
+* Coba masuk lagi dari `/mcp`
+* Jika kesalahan berulang, laporkan ke operator server. Perbaikannya adalah sisi server: server otorisasi harus mengembalikan penerbit yang sama dalam parameter `iss` yang diiklankan dalam metadata-nya
+* Untuk terhubung saat server sedang diperbaiki, mulai Claude Code dengan [`MCP_SDK_GENERATION=v1`](/docs/id/env-vars), yang [runtime](/docs/id/mcp#mcp-client-runtimes)-nya tidak menjalankan pemeriksaan ini. Ini menghapus perlindungan terhadap serangan pencampuran, jadi lebih suka perbaikan sisi server
-
- Gambar terlalu besar
+Sebelum v2.1.232, Claude Code menggunakan runtime v2 hanya dalam peluncuran bertahap atau ketika Anda menetapkan `MCP_SDK_GENERATION=v2`.
+
+
+ Kredensial AWS kedaluwarsa atau tidak valid
-Gambar yang ditempel atau dilampirkan melebihi batas ukuran atau dimensi API.
+Token sesi AWS Anda kedaluwarsa atau ditolak. Pesan ini muncul pada 401 dari [Claude Platform di AWS](/docs/id/claude-platform-on-aws) atau [titik akhir Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), yang merupakan cara penyedia itu melaporkan token keamanan yang kedaluwarsa.
+
+Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `AWS credentials expired or invalid` terkemuka:
```text theme={null}
-Image was too large. Double press esc to go back and try again with a smaller image.
-API Error: 400 ... image dimensions exceed max allowed size
+AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
```
-Claude Code mengganti gambar yang tidak dapat diproses dengan placeholder teks dan mencoba lagi, sehingga pesan berikutnya berhasil. Pada versi sebelum 2.1.142, gambar yang ditempel dapat tetap berada dalam percakapan dan mengulangi kesalahan yang sama pada setiap pesan berikutnya. Untuk pulih pada versi tersebut, tekan Esc dua kali dan mundur melewati giliran tempat gambar ditambahkan.
+Sebelum v2.1.273, pesan ini muncul hanya ketika `awsAuthRefresh` dikonfigurasi.
**Yang harus dilakukan:**
-* Ubah ukuran gambar sebelum menempel. API menerima gambar hingga 8000 piksel di tepi terpanjang untuk satu gambar, atau 2000 piksel ketika banyak gambar berada dalam konteks.
-* Ambil tangkapan layar yang lebih ketat dari wilayah yang relevan alih-alih layar penuh
+* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
+* Jika [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) diatur, jalankan perintah yang dinamai dalam pesan, seperti `aws sso login --profile myprofile`, di terminal lain dan selesaikan masuk browser, kemudian coba lagi. Jika tidak, segarkan kredensial AWS yang Anda gunakan sendiri: masuk SSO, kunci akses, kunci API, atau token proxy Anda
+* Dengan `awsAuthRefresh` diatur dalam sesi interaktif, Anda dapat menjalankan `/login`, pilih **3rd-party platform**, kemudian pilih **Claude Platform on AWS · refresh credentials** di bawah **Using 3rd-party platforms** untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat [Konfigurasi kredensial AWS](/docs/id/claude-platform-on-aws#1-configure-aws-credentials)
+* Jika kesalahan berulang setelah perintah penyegaran berhasil, konfirmasi identitas valid di luar Claude Code dengan `aws sts get-caller-identity` di shell dan profil yang sama
-
- Tidak dapat mengubah ukuran gambar
+
+ Autentikasi AWS gagal
-Claude Code tidak dapat mengurangi skala gambar yang dilampirkan sebelum mengirimnya ke API.
+Penyedia AWS Anda mengembalikan 403, atau [Amazon Bedrock](/docs/id/amazon-bedrock) mengembalikan 401.
+
+Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara itu melaporkan penolakan otorisasi, seperti `AccessDeniedException` dari izin IAM yang hilang. Claude Code tidak dapat membedakan kedua penyebab itu.
+
+401 dari Amazon Bedrock juga mendarat di sini daripada di bawah [Kredensial AWS kedaluwarsa atau tidak valid](#aws-credentials-expired-or-invalid), karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari titik akhir itu biasanya berasal dari sesuatu yang lain dalam jalur permintaan, seperti proxy perusahaan.
+
+Penyegaran kredensial memperbaiki token yang kedaluwarsa dan tidak dapat memperbaiki penyebab lain, jadi pesan menawarkan keduanya:
+
+```text theme={null}
+AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
+```
+
+Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `AWS authentication failed` terkemuka.
+
+Ketika 403 adalah jawaban Amazon Bedrock bahwa Anda tidak memiliki akses ke model dengan ID model yang ditentukan, petunjuk sebagai gantinya memberi tahu Anda untuk mengaktifkan model untuk akun dan wilayah Anda di konsol Amazon Bedrock.
+
+Sebelum v2.1.273, pesan ini muncul hanya ketika `awsAuthRefresh` dikonfigurasi.
+
+**Yang harus dilakukan:**
+
+* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
+* Segarkan kredensial AWS Anda jika kredensial yang kedaluwarsa adalah penyebabnya: jalankan perintah [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) yang dinamai dalam pesan ketika satu diatur, atau segarkan masuk SSO, kunci akses, kunci API, atau token proxy Anda sendiri
+* Jika kredensial Anda saat ini, konfirmasi izin IAM dalam [Konfigurasi IAM](/docs/id/amazon-bedrock#iam-configuration) dilampirkan ke identitas yang Anda gunakan dan model yang dipilih diaktifkan untuk akun dan wilayah Anda
+* Jalankan `aws sts get-caller-identity` untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; profil `AWS_PROFILE` yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin
+
+
+ Kredensial Google Cloud kedaluwarsa atau tidak valid
+
+
+Kredensial Google Cloud Anda untuk [Platform Agen Google Cloud](/docs/id/google-vertex-ai) kedaluwarsa atau ditolak: permintaan mengembalikan 401, yang merupakan cara Platform Agen melaporkan kedaluwarsa kredensial.
+
+Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Google Cloud credentials expired or invalid` terkemuka:
+
+```text theme={null}
+Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
+```
+
+**Yang harus dilakukan:**
+
+* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
+* Jika Anda autentikasi dengan kredensial default aplikasi, jalankan perintah [`gcpAuthRefresh`](/docs/id/google-vertex-ai#advanced-credential-configuration) yang dinamai dalam pesan, atau `gcloud auth application-default login`, dan selesaikan masuk, kemudian coba lagi
+* Jika Anda merutekan melalui [gateway LLM](/docs/id/llm-gateway) dengan `CLAUDE_CODE_SKIP_VERTEX_AUTH` diatur, segarkan token gateway dalam `ANTHROPIC_AUTH_TOKEN` atau `ANTHROPIC_CUSTOM_HEADERS`, kemudian coba lagi
+* Jika Anda autentikasi dengan file kunci akun layanan, konfirmasi `GOOGLE_APPLICATION_CREDENTIALS` menunjuk ke kunci yang valid. Lihat [Konfigurasi kredensial GCP](/docs/id/google-vertex-ai#3-configure-gcp-credentials)
+* Jika kesalahan berulang setelah penyegaran, konfirmasi identitas bekerja di luar Claude Code dengan `gcloud auth application-default print-access-token` di shell yang sama
+
+Sebelum v2.1.273, 401 dari Platform Agen menunjukkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.
+
+
+ Autentikasi Google Cloud gagal
+
+
+[Platform Agen Google Cloud](/docs/id/google-vertex-ai) mengembalikan 403, yang digunakan untuk penolakan otorisasi daripada kredensial yang kedaluwarsa. Biasanya identitas yang Anda autentikasi dengan hilang izin IAM, atau model tidak diaktifkan untuk proyek Anda.
+
+Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Google Cloud authentication failed` terkemuka:
+
+```text theme={null}
+Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
+```
+
+**Yang harus dilakukan:**
+
+* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
+* Konfirmkan peran dalam [Konfigurasi IAM](/docs/id/google-vertex-ai#iam-configuration) diberikan kepada identitas yang Anda autentikasi dengan
+* Konfirmkan model diaktifkan untuk proyek Anda. Lihat [Minta akses model](/docs/id/google-vertex-ai#2-request-model-access)
+
+Sebelum v2.1.273, 403 dari Platform Agen menunjukkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.
+
+
+ Autentikasi Microsoft Foundry gagal
+
+
+[Microsoft Foundry](/docs/id/microsoft-foundry) mengembalikan 401 atau 403: kredensial Azure pada permintaan ditolak, atau identitas di baliknya tidak memiliki akses ke sumber daya Foundry. `/login` tidak dapat membuat kredensial Azure. Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Microsoft Foundry authentication failed` terkemuka:
+
+```text theme={null}
+Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
+```
+
+**Yang harus dilakukan:**
+
+* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
+* Segarkan kredensial yang Anda konfigurasi dalam [Konfigurasi kredensial Azure](/docs/id/microsoft-foundry#2-configure-azure-credentials): putar `ANTHROPIC_FOUNDRY_API_KEY`, buat `ANTHROPIC_FOUNDRY_AUTH_TOKEN` segar, atau jalankan `az login` sehingga rantai kredensial Microsoft Entra default dapat masuk lagi
+* Jika kredensial saat ini, konfirmkan identitas memiliki akses ke sumber daya Foundry. Lihat [Konfigurasi RBAC Azure](/docs/id/microsoft-foundry#azure-rbac-configuration)
+
+Sebelum v2.1.273, 401 atau 403 dari Microsoft Foundry menunjukkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Azure.
+
+
+ Tidak dapat memuat kredensial AWS atau Google Cloud
+
+
+Claude Code tidak dapat memperoleh kredensial yang dapat digunakan dari rantai penyedia kredensial AWS atau dari kredensial default aplikasi Google Anda di mesin tempat itu berjalan, jadi tidak ada permintaan yang mencapai penyedia cloud Anda. Claude Code menghapus kredensial yang disimpan dalam cache dan mencoba lagi dua kali sebelum menunjukkan pesan ini. Detail setelah `·` menamai penyebab spesifik, seperti sesi SSO yang kedaluwarsa, kredensial default aplikasi yang hilang dilaporkan sebagai `Could not load the default credentials`, atau masuk yang dicabut dilaporkan sebagai `invalid_grant`:
+
+```text theme={null}
+API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
+API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
+```
+
+Dalam [mode non-interaktif](/docs/id/headless) dengan `-p` dan dalam [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstruktur adalah `cloud_credential_error`. Sebelum v2.1.267, pesan hanya menunjukkan teks detail setelah `API Error:`, dan kode terstruktur adalah `server_error` atau `unknown`.
+
+**Yang harus dilakukan:**
+
+* Jalankan perintah masuk penyedia Anda, seperti `aws sso login --profile myprofile` atau `gcloud auth application-default login`, kemudian coba lagi. [Kredensial Bedrock, Platform Agen, atau Foundry tidak memuat](/docs/id/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) menunjukkan cara mengonfirmasi kredensial di luar Claude Code
+* Jika detail membaca `AWS default-chain credential resolve timed out`, rantai tergantung daripada gagal, jadi ikuti [Resolusi kredensial rantai default AWS habis waktu](#aws-default-chain-credential-resolve-timed-out) sebagai gantinya
+
+
+ Resolusi kredensial rantai default AWS habis waktu
+
+
+Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, jadi Claude Code menghentikan resolusi dan gagal permintaan. Waktu habis ini adalah satu penyebab [Tidak dapat memuat kredensial AWS atau Google Cloud](#could-not-load-aws-or-google-cloud-credentials). Kegagalan adalah resolusi kredensial lokal: permintaan tidak pernah mencapai [Amazon Bedrock](/docs/id/amazon-bedrock), [Claude Platform di AWS](/docs/id/claude-platform-on-aws), atau [titik akhir Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint). Claude Code menghapus [cache kredensial](/docs/id/amazon-bedrock#credential-caching-and-resolution-timeout) dan mencoba lagi sebelum kesalahan ini muncul, jadi pada saat Anda melihatnya rantai telah macet pada upaya berulang.
+
+```text theme={null}
+API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
+```
+
+Penyebab umum adalah perintah `credential_process` dalam profil AWS Anda yang menunggu input yang tidak dapat diterima, dan kontainer atau VM yang layanan metadata instans (IMDS) tidak pernah menjawab probe rantai.
+
+Sebelum v2.1.267, pesan membaca `API Error: AWS default-chain credential resolve timed out`.
+Sebelum v2.1.207, rantai yang macet meninggalkan permintaan menunggu tanpa batas daripada gagal.
+
+**Yang harus dilakukan:**
+
+* Jalankan `aws sts get-caller-identity` di shell yang sama dengan `AWS_PROFILE` yang sama. Jika juga tergantung, perbaiki profil; perintah `credential_process` yang meminta secara interaktif adalah penyebab umum.
+* Selesaikan langkah masuk sebelum memulai Claude Code, misalnya `aws sso login --profile myprofile`, sehingga rantai diselesaikan dari cache SSO lokal daripada menunggu alur browser
+* Jika rantai Anda menjalankan masuk interaktif yang secara sah memerlukan lebih dari 60 detik, seperti SSO dengan MFA melalui pembungkus seperti `aws-vault`, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)
+
+
+ Verifikasi pengaturan Bedrock habis waktu menunggu AWS
+
+
+Panggilan ke AWS selama [wizard pengaturan Bedrock](/docs/id/amazon-bedrock#sign-in-with-bedrock), seperti pencarian kredensial atau pemeriksaan identitas, tidak selesai dalam batas 60 detik. Wizard berhenti menunggu dan gagal langkah verifikasi:
+
+```text theme={null}
+Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
+```
+
+Angka mencerminkan batas Anda: 60 detik secara default, atau nilai yang Anda atur dalam [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars).
+
+Penyebab umum adalah jaringan atau proxy yang macet permintaan ke AWS, termasuk penyegaran token SSO, dan pembantu kredensial masih menunggu input yang tidak dapat Anda lihat. Naikkan batas hanya ketika pembantu secara sah memerlukan lebih banyak waktu.
+
+Permintaan tunggal yang macet ke AWS juga dapat gagal pada waktu habis per-permintaan sendiri, yang menunjukkan pesan yang lebih pendek pada langkah yang sama:
+
+```text theme={null}
+A request to AWS timed out. Check your network and proxy settings, then try again.
+```
+
+Ketika waktu habis yang sama terjadi pada langkah pin model, wizard menandai model sebagai `unreachable` daripada menunjukkan pesan apa pun.
+
+**Yang harus dilakukan:**
+
+* Jalankan `aws sts get-caller-identity` di shell yang sama. Jika juga tergantung, macet ada di luar Claude Code, di jaringan Anda, proxy Anda, atau pembantu kredensial dalam profil AWS Anda; perbaiki itu terlebih dahulu.
+* Selesaikan masuk interaktif apa pun sebelum membuka wizard, misalnya `aws sso login --profile myprofile`
+* Jika pembantu kredensial dalam profil AWS Anda secara sah memerlukan lebih lama dari 60 detik untuk meminta Anda, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)
+
+
+ Sesi gateway cloud kedaluwarsa
+
+
+Anda masuk melalui [gateway aplikasi Claude](/docs/id/claude-apps-gateway), dan sesi gateway yang disimpan di mesin ini telah kedaluwarsa dan tidak dapat diperbarui, atau gateway tidak lagi menerimanya, misalnya setelah [rahasia JWT gateway diganti](/docs/id/claude-apps-gateway-deploy#jwt-secret-rotation). Jika Anda melihat baris ini ketika memulai `claude` secara interaktif, sesi telah dibuka keluar dari gateway:
+
+```text theme={null}
+Cloud gateway session expired — run /login to reconnect.
+```
+
+Baris yang sama dapat muncul di tengah sesi ketika kredensial gateway kedaluwarsa dan Claude Code tidak dapat memperbarui.
+
+Dalam jalankan [non-interaktif](/docs/id/headless), sesi latar belakang atau sesi yang tidak diawasi lainnya, atau subperintah `claude` selain `claude auth`, Claude Code keluar dengan pesan ini sebagai gantinya ketika gateway tidak lagi menerima sesi:
+
+```text theme={null}
+Cloud gateway no longer accepts this session. Start `claude` and sign in again with /login.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `/login` dalam sesi dan selesaikan masuk browser
+* Untuk peluncuran non-interaktif, mulai `claude` di lingkungan yang sama, jalankan `/login`, kemudian jalankan kembali perintah Anda
+
+
+ Gateway menolak permintaan
+
+
+Anda masuk melalui [gateway aplikasi Claude](/docs/id/claude-apps-gateway), dan permintaan mengembalikan 403: gateway, atau upstream di baliknya, menolaknya. Masuk lagi tidak mengubah penolakan, jadi pesan menunjuk ke administrator gateway Anda:
+
+```text theme={null}
+Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
+```
+
+**Yang harus dilakukan:**
+
+* Minta administrator gateway Anda untuk mencari permintaan. Ekor `API Error:` membawa penolakan yang dikembalikan gateway
+* Untuk administrator: aturan [kontrol akses](/docs/id/claude-apps-gateway-config#http-tuning) pada gateway mengembalikan 403 yang dicatat [log audit](/docs/id/claude-apps-gateway-deploy#logs) dengan alasannya, dan penolakan otorisasi upstream melewati per [Pesan kesalahan Upstream](/docs/id/claude-apps-gateway-config#upstream-error-messages)
+
+Sebelum v2.1.273, 403 pada sesi gateway menunjukkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, dan masuk lagi tidak menghapus penolakan.
+
+
+ Kesalahan jaringan dan koneksi
+
+
+Sebagian besar kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya, atau sesuatu antara Claude Code dan API mengubah respons dalam perjalanannya kembali; jika entri juga memiliki penyebab lokal, seperti penulisan arsip yang gagal, isinya akan mengatakan demikian. Mereka biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.
+
+
+ Unable to connect to API
+
+
+Koneksi TCP ke API gagal atau tidak pernah selesai. Untuk kode kesalahan koneksi umum, nama pesan menunjukkan jenis kegagalan dan menyimpan kode dalam tanda kurung:
+
+```text theme={null}
+Unable to connect to API. Check your internet connection
+Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
+Can't reach the API server — check your internet or DNS (ENOTFOUND)
+No internet route — check your connection or VPN (EHOSTUNREACH)
+Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
+Connection dropped (ECONNRESET)
+fetch failed
+Request timed out. Check your internet connection and proxy settings
+```
+
+Kode yang Claude Code tidak kenali muncul sebagai `Unable to connect to API` diikuti oleh kode dalam tanda kurung. Beberapa pesan ini dapat menampilkan lebih dari satu kode: `Connection refused` dapat menampilkan `ConnectionRefused` atau `ECONNREFUSED`, misalnya, dan `Can't reach the API server` dapat menampilkan `ENOTFOUND` atau `FailedToOpenSocket`.
+
+Sebelum v2.1.227, setiap pesan berkode ini berbunyi `Unable to connect to API` diikuti oleh kode, misalnya `Unable to connect to API (ECONNREFUSED)`.
+
+Penyebab umum termasuk tidak ada akses internet, VPN yang memblokir `api.anthropic.com`, atau proxy perusahaan yang diperlukan yang tidak dikonfigurasi.
+
+**Yang harus dilakukan:**
+
+* Konfirmasi Anda dapat menjangkau host API dari shell yang sama dengan menjalankan `curl -I https://api.anthropic.com`. Di Windows PowerShell gunakan `curl.exe -I https://api.anthropic.com` sehingga alias `Invoke-WebRequest` bawaan tidak digunakan.
+* Jika Anda berada di belakang proxy perusahaan, atur `HTTPS_PROXY` sebelum meluncurkan Claude Code dan lihat [Konfigurasi jaringan](/docs/id/network-config)
+* Jika Anda merutekan melalui gateway LLM atau relay, atur [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) ke alamatnya. Lihat [Hubungkan Claude Code ke gateway LLM](/docs/id/llm-gateway-connect) untuk pengaturan.
+* Pastikan firewall Anda memungkinkan host yang tercantum dalam [Persyaratan akses jaringan](/docs/id/network-config#network-access-requirements)
+* Kegagalan intermiten [diulang secara otomatis](#automatic-retries); kegagalan persisten menunjukkan masalah jaringan lokal
+
+Jika `curl` berhasil tetapi Claude Code masih gagal, penyebabnya biasanya sesuatu antara runtime dan jaringan daripada jaringan itu sendiri:
+
+* Di Linux dan WSL, periksa `/etc/resolv.conf` untuk nameserver yang tidak dapat dijangkau. WSL khususnya dapat mewarisi resolver yang rusak dari host.
+* Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka terowongan atau aturan perutean. Periksa `ifconfig` untuk antarmuka `utun` yang basi dan hapus ekstensi jaringan VPN di Pengaturan Sistem.
+* Docker Desktop dan runtime kontainer serupa dapat mencegat lalu lintas keluar. Keluar dari mereka dan coba lagi untuk mengesampingkan ini.
+
+
+ Unable to connect to Anthropic services
+
+
+Selama pengaturan pertama kali, Claude Code memeriksa bahwa dapat menjangkau `api.anthropic.com` dan `platform.claude.com` sebelum menampilkan langkah masuk. Ketika salah satu pemeriksaan gagal, Claude Code mencetak alasannya dan keluar.
+
+```text theme={null}
+Unable to connect to Anthropic services
+Failed to connect to api.anthropic.com: ECONNREFUSED
+Connection to api.anthropic.com timed out after 10 seconds
+A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.
+```
+
+Claude Code mengirim pemeriksaan melalui [konfigurasi proxy](/docs/id/network-config) yang sama dengan permintaan API dan memberikan setiap probe 10 detik. Ketika probe yang gagal melewati proxy, pesan menamai variabel lingkungan yang mengonfigurasinya, seperti `HTTPS_PROXY`. Sebelum v2.1.222, pemeriksaan menggunakan transport proxy yang berbeda tanpa batas waktu: di belakang URL proxy dengan skema `https://`, dapat macet pada `Checking connectivity...` tanpa batas dan kemudian gagal meskipun permintaan API melalui proxy yang sama berhasil.
+
+Claude Code melewati pemeriksaan ini ketika [file pengaturan terkelola, kebijakan MDM, atau pembantu kebijakan](/docs/id/managed-settings) menetapkan [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) ke `"gateway"`, atau menetapkan [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl) tanpa `forceLoginMethod`. Dengan salah satu konfigurasi, Claude Code membuka langkah masuk di layar **Cloud gateway** daripada metode masuk Anthropic. Claude Code juga melewati pemeriksaan ketika sumber pengaturan terkelola di mesin ada tetapi tidak dapat dibaca, karena sumber itu mungkin menyimpan konfigurasi gateway. Sebelum v2.1.247, Claude Code menjalankan pemeriksaan di bawah konfigurasi ini juga, dan keluar dengan kesalahan ini ketika titik akhir Anthropic tidak dapat dijangkau.
+
+**Yang harus dilakukan:**
+
+* Jika pesan menamai variabel proxy, periksa bahwa nilainya menunjuk ke proxy yang tepat dan minta tim jaringan Anda untuk memungkinkan koneksi HTTPS melaluinya ke host dalam pesan. Lihat [Konfigurasi jaringan](/docs/id/network-config).
+* Kerjakan pemeriksaan dalam [Unable to connect to API](#unable-to-connect-to-api). Tes `curl` dan panduan firewall di sana berlaku untuk pemeriksaan ini juga.
+* Jika organisasi Anda masuk melalui [cloud gateway](/docs/id/claude-apps-gateway) dan kesalahan ini muncul pada run pertama, perbarui ke Claude Code v2.1.247 atau lebih baru.
+* Jika jaringan Anda terbuka dan kegagalan berlanjut, Claude Code mungkin tidak [tersedia di negara Anda](https://www.anthropic.com/supported-countries)
+
+
+ Socket is closed
+
+
+`Socket is closed` berarti koneksi yang membawa respons streaming ditutup sementara respons masih tiba. Penyebab paling umum adalah proxy perusahaan di Windows yang menjatuhkan terowongan yang sudah terbentuk di tengah respons.
+
+Tergantung seberapa jauh respons telah berkembang, Claude Code mengulang permintaan, menyimpan apa yang Claude hasilkan, atau mengakhiri giliran. Lihat [Pengulangan otomatis](#automatic-retries).
+
+Sebelum v2.1.214, Claude Code tidak mengulang kegagalan ini, dan giliran berhenti dengan kesalahan yang berisi `Socket is closed`.
+
+**Yang harus dilakukan:**
+
+* Jika Anda melihat kesalahan ini, perbarui ke v2.1.214 atau lebih baru dengan `claude update`, kemudian kirim pesan Anda lagi
+* Jika giliran terus gagal di belakang proxy yang sama setelah memperbarui, kerjakan [Unable to connect to API](#unable-to-connect-to-api) dan periksa pengaturan proxy dalam [Konfigurasi jaringan](/docs/id/network-config)
+
+
+
+Claude Code menampilkan kesalahan ini ketika pengulangan non-streaming dari permintaan streaming yang gagal mendapatkan status kesuksesan HTTP tetapi isi bukan pesan API Claude: biasanya halaman kesalahan HTML atau masuk, isi kosong, atau JSON dalam format lain. Proxy, gateway, atau halaman masuk jaringan yang menjawab di tempat API adalah sumber biasa. Claude Code tidak mengulang permintaan, dan giliran berakhir dengan kesalahan ini.
+
+```text theme={null}
+API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.
+```
+
+Setelah pembukaan itu, pesan melaporkan apa yang kembali dan permintaan mana yang gagal:
+
+* Klausa `Response:` dengan tipe konten, jenis isi, seperti `body is an HTML page` atau `empty body`, ukurannya dalam byte, dan apakah respons membawa id permintaan Anthropic. Ketika respons menamai server yang dapat dikenali, seperti `nginx` atau `cloudflare`, atau membawa header perantara, seperti `cf-ray` atau `via`, klausa mencantumkan yang itu juga.
+* Kalimat yang menamai id permintaan streaming yang gagal dan kegagalan yang memicu pengulangan. Ketika aliran telah dibuka sebelum kegagalan, ia juga melaporkan berapa banyak peristiwa aliran yang tiba dan, jika ada, berapa lama aliran telah diam ketika upaya gagal.
+
+Sebelum v2.1.234, pesan berakhir setelah `intercepting the request`.
+
+Sebelum v2.1.271, balasan yang membawa pesan API yang valid di bawah tipe konten non-JSON seperti `text/plain` juga mengakhiri giliran dengan kesalahan ini. Beberapa gateway LLM menggunakan tipe konten itu untuk balasan non-streaming.
+
+**Yang harus dilakukan:**
+
+* Baca klausa `Response:` untuk melihat sistem mana yang menjawab. Isi HTML, tidak ada id permintaan Anthropic, atau server bernama seperti `nginx` atau `cloudflare` berarti sesuatu antara Claude Code dan API menjawab di tempatnya
+* Jika Anda merutekan melalui [gateway LLM](/docs/id/llm-gateway-connect#troubleshoot-gateway-errors), uji rute dengan permintaan langsung dan perbaiki hop yang mengembalikan respons non-API
+* Di jaringan dengan halaman masuk, seperti Wi-Fi tamu, selesaikan masuk di browser, kemudian coba lagi
+* Jika hanya rute non-streaming melalui gateway Anda yang rusak, atur [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](/docs/id/env-vars#variables) sehingga permintaan yang gagal di tengah aliran masuk ke jalur pengulangan normal daripada fallback ini, kecuali ketika titik akhir streaming itu sendiri mengembalikan `404`, di mana Claude Code masih jatuh kembali
+
+
+ Streaming response ended before any complete data was received
+
+
+Respons streaming dari penyedia model Anda selesai tanpa memberikan data yang dapat digunakan, jadi Claude Code mengirim ulang permintaan tanpa streaming untuk menyelesaikan giliran. Claude Code menampilkan peringatan sekali per sesi, hanya dalam sesi interaktif. Sebelum v2.1.239, Claude Code diam-diam mengulang tanpa streaming.
+
+```text theme={null}
+Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.
+```
+
+Claude Code mengirim setiap permintaan yang terpengaruh dua kali: upaya streaming kosong dan pengulangan. Penyebab biasa adalah proxy atau gateway yang mengonsumsi atau mengubah isi respons streaming dalam perjalanannya kembali.
+
+**Yang harus dilakukan:**
+
+* Konfigurasikan proxy atau gateway apa pun antara Claude Code dan penyedia model Anda untuk melewatkan isi respons streaming dan headernya tanpa dimodifikasi
+* Di [Amazon Bedrock](/docs/id/amazon-bedrock), lihat [Kesalahan streaming di belakang gateway atau proxy](/docs/id/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) untuk persyaratan header dan isi
+
+
+ Bedrock streaming response has an unexpected content-type
+
+
+Gateway atau proxy antara Claude Code dan [Amazon Bedrock](/docs/id/amazon-bedrock) mengubah isi respons streaming atau header `Content-Type` nya. Amazon Bedrock melakukan streaming respons sebagai `application/vnd.amazon.eventstream`. Daripada mendekode isi yang tidak dapat dibaca, Claude Code menolak respons streaming yang berhasil yang melaporkan tipe konten yang berbeda. Claude Code tidak mengulang permintaan.
+
+```text theme={null}
+Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
+```
+
+Sebelum v2.1.208, kesalahan konfigurasi yang sama muncul sebagai `API Error: Truncated event message received` setelah seluruh respons telah di-buffer.
+
+**Yang harus dilakukan:**
+
+* Konfigurasikan gateway untuk melewatkan isi respons `InvokeModelWithResponseStream` dan header `Content-Type` nya tanpa dimodifikasi. Perantara yang memancarkan ulang aliran sebagai peristiwa yang dikirim server adalah penyebab umum.
+* Menetapkan [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/id/env-vars) menyembunyikan kesalahan ini, tetapi Claude Code tidak mendekode isi biner di bawah header yang ditulis ulang, jadi permintaan itu jatuh kembali ke jalur non-streaming yang lebih lambat. Lihat [Kesalahan streaming di belakang gateway atau proxy](/docs/id/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
+
+
+ SSL certificate errors
+
+
+Proxy atau perangkat keamanan di jaringan Anda mencegat lalu lintas TLS dengan sertifikat mereka sendiri, dan Claude Code tidak mempercayainya.
+
+```text theme={null}
+Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
+Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
+```
+
+Sebelum v2.1.273, kedua pesan berakhir di `Check your proxy or corporate SSL certificates`, tanpa kode OpenSSL atau petunjuk `NODE_EXTRA_CA_CERTS`.
+
+Mulai dari v2.1.199, kegagalan validasi sertifikat tidak diulang, jadi kesalahan ini muncul pada upaya pertama daripada setelah [anggaran pengulangan](#automatic-retries) penuh. Versi sebelumnya menghabiskan beberapa menit mengulang sebelum menampilkannya. Kondisi TLS sementara, seperti batas waktu jabat tangan, masih mengulang.
+
+Selama `/login` dan pemeriksaan konektivitas startup, kegagalan yang sama menghasilkan pesan yang berbeda:
+
+```text theme={null}
+SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.
+```
+
+Di [Amazon Bedrock](/docs/id/amazon-bedrock), permintaan yang Claude Code sendiri kirim ke AWS, seperti panggilan kredensial peran STS dan SSO, penemuan model, dan pemeriksaan wizard pengaturan, bergantung pada konfigurasi sertifikat yang sama. Lihat [Kesalahan sertifikat di belakang proxy yang memeriksa TLS](/docs/id/amazon-bedrock#certificate-errors-behind-a-tls-inspecting-proxy).
+
+**Yang harus dilakukan:**
+
+* Ekspor bundel CA organisasi Anda dan arahkan Claude Code ke sana dengan `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
+* Lihat [Konfigurasi jaringan](/docs/id/network-config#custom-ca-certificates) untuk instruksi pengaturan lengkap
+* Jangan atur `NODE_TLS_REJECT_UNAUTHORIZED=0`, yang menonaktifkan validasi sertifikat sepenuhnya
+
+
+ Host not allowed in a cloud session
+
+
+Permintaan HTTP keluar dari sesi cloud atau rutinitas diblokir oleh kebijakan jaringan lingkungan.
+
+```text theme={null}
+HTTP 403
+x-deny-reason: host_not_allowed
+```
+
+Anda juga dapat melihat sertifikat TLS yang tidak cocok dengan sertifikat asli tujuan. Sesi cloud merutekan lalu lintas keluar melalui proxy yang memberlakukan kebijakan jaringan, jadi sertifikat yang tidak cocok berarti proxy mengakhiri koneksi, bukan tujuan.
+
+Ini bukan masalah jaringan sisi klien. Sesi cloud dan [rutinitas](/docs/id/routines) berjalan di dalam VM yang di-sandbox yang lalu lintas keluarnya melalui jaringan sesi disaring ke [daftar izin lingkungan cloud](/docs/id/cloud-environments); [operasi GitHub](/docs/id/cloud-environments#github-proxy) dan lalu lintas konektor MCP menggunakan saluran terpisah, itulah mengapa mereka dapat terus bekerja sementara host lain diblokir. Lingkungan **Default** menggunakan akses **Trusted**, yang memungkinkan [daftar izin default](/docs/id/cloud-environments#default-allowed-domains) dari registri paket, API penyedia cloud, registri kontainer, dan domain pengembangan umum dan memblokir domain lain di jalur itu.
+
+**Yang harus dilakukan:**
+
+Langkah-langkah ini mengubah salah satu lingkungan Anda sendiri. [Lingkungan bersama organisasi](/docs/id/cloud-environments#organization-shared-environments) terbuka hanya-baca di pemilih, jadi minta Pemilik untuk mengubah akses jaringannya dari halaman **Cloud environments** dalam [pengaturan admin](https://claude.ai/admin-settings).
+
+* Buka rutinitas untuk pengeditan, atau mulai sesi cloud. Pilih ikon cloud yang menampilkan nama lingkungan Anda, seperti **Default**, untuk membuka pemilih. Arahkan ke lingkungan Anda dan klik ikon pengaturan.
+* Dalam dialog **Update cloud environment**, ubah **Network access** dari **Trusted** ke **Custom**, kemudian tambahkan domain yang diblokir ke **Allowed domains**. Masukkan satu domain per baris. Periksa **Also include default list of common package managers** untuk menyimpan [daftar izin default](/docs/id/cloud-environments#default-allowed-domains) bersama domain kustom Anda. Pilih **Full** sebagai gantinya jika Anda menginginkan akses tanpa batas.
+* Klik **Save changes**. Jalankan berikutnya menggunakan daftar izin yang diperbarui.
+
+Lihat [Akses jaringan](/docs/id/cloud-environments#network-access) untuk tingkat akses dan daftar izin default. Sesi CLI lokal tidak terpengaruh oleh kebijakan ini.
+
+
+ The proxy refused the connection
+
+
+Anda melihat pesan ini ketika Claude membaca [artefak](/docs/id/artifacts) melalui proxy yang Anda atur dalam `HTTPS_PROXY` atau [variabel proxy](/docs/id/network-config#environment-variables) terkait. Konten artefak berasal dari `*.frame.claudeusercontent.com`, jadi Claude Code terlebih dahulu mengirim proxy permintaan `CONNECT` yang memintanya membuka terowongan ke host itu. Ketika proxy menolak, tidak ada yang mencapai host, dan pesan membawa status HTTP proxy:
+
+```text theme={null}
+artifact content fetch failed (proxy refused the connection: HTTP 407)
+artifact content fetch failed (proxy refused the connection: HTTP 403)
+the proxy refused the connection to the artifact's content host (HTTP 502)
+```
+
+Status adalah jawaban proxy terhadap `CONNECT`. Host tidak pernah menjawab, jadi setiap status menunjuk ke perbaikan yang berbeda:
+
+* `HTTP 407`: proxy memerlukan kredensial yang tidak didapatkan. Masukkan mereka dalam URL proxy, seperti yang ditunjukkan [Autentikasi Dasar](/docs/id/network-config#basic-authentication).
+* `HTTP 403`: proxy menolak untuk menggali terowongan ke `*.frame.claudeusercontent.com`. Minta siapa pun yang menjalankan proxy untuk memungkinkan host itu, yang [Persyaratan akses jaringan](/docs/id/network-config#network-access-requirements) cantumkan.
+* Status apa pun yang lain, seperti `HTTP 502`: proxy tidak membuka terowongan karena alasannya sendiri, seperti gagal menjangkau host. Cari status dalam log proxy.
+* `unreadable reply` sebagai pengganti status: apa pun yang ada di alamat proxy tidak menjawab dengan baris status HTTP. Periksa bahwa alamatnya adalah proxy HTTP.
+
+**Yang harus dilakukan:**
+
+* Periksa alamat dan kredensial dalam variabel proxy, seperti yang dijelaskan [Konfigurasi Proxy](/docs/id/network-config#proxy-configuration), kemudian jalankan `curl -x http://proxy.example.com:8080 -I https://api.anthropic.com` dari shell tempat Anda memulai Claude Code, menggunakan URL proxy Anda sendiri. Di Windows PowerShell, jalankan `curl.exe`. Jika probe ini gagal dengan cara yang sama, perbaiki pengaturan proxy terlebih dahulu. Jika berhasil, penolakan khusus untuk host artefak.
+* Jika jaringan Anda membiarkan Claude Code menjangkau host artefak secara langsung, tambahkan `.frame.claudeusercontent.com` ke [`NO_PROXY`](/docs/id/network-config#environment-variables). Simpan entri itu sempit: entri `.claudeusercontent.com` yang lebih luas juga melewati proxy untuk `bridge.claudeusercontent.com`, yang organisasi dengan [IP allowlisting](/docs/id/network-config#organization-ip-allowlists-and-proxy-egress) perlu menyimpan di proxy.
+
+Sebelum v2.1.238, Claude Code melaporkan terowongan yang ditolak sebagai kesalahan jaringan generik.
+
+
+ The cloud environments service returned an empty or unexpected response
+
+
+Claude Code meminta daftar [cloud environments](/docs/id/cloud-environments) Anda di beberapa titik, seperti ketika Anda membuat sesi cloud dari CLI atau menjalankan [`/remote-env`](/docs/id/cloud-environments#select-an-environment-from-the-cli). Ketika tidak dapat membaca jawaban server, menampilkan salah satu pesan ini:
+
+```text theme={null}
+The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
+The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
+The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.
+```
+
+Server menerima permintaan tetapi menjawab dengan isi yang bukan daftar lingkungan: kosong, bukan JSON, atau JSON tanpa daftar. Ini biasanya menyertai gangguan sisi layanan dan menghapus sendiri. Tergantung pada permukaan yang meminta daftar, Claude Code dapat menambahkan awalan, seperti `couldn't list environments:` dalam dialog `/remote-env`.
+
+**Yang harus dilakukan:**
+
+* Coba lagi tindakan. Claude Code meminta daftar lagi setiap kali
+* Jika pesan terus muncul, periksa [status.claude.com](https://status.claude.com) untuk insiden aktif
+
+Sebelum v2.1.236, Claude Code menampilkan TypeError JavaScript mentah daripada pesan-pesan ini.
+
+
+ Couldn't reconnect to your Remote Control session
+
+
+```text theme={null}
+Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
+```
+
+Melanjutkan dengan `claude --resume` atau `claude --continue` menghubungkan kembali ke sesi [Remote Control](/docs/id/remote-control) yang dicatat dalam percakapan itu. Pesan ini berarti koneksi kembali gagal karena alasan yang mungkin sementara, seperti gangguan jaringan atau kesalahan server, jadi Claude Code tidak dapat mengkonfirmasi apakah sesi jarak jauh masih ada. Sesi lokal Anda terus berjalan tanpa Remote Control.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/remote-control` untuk mencoba lagi koneksi
+* Mulai sesi baru dengan `claude --remote-control` untuk membuat sesi Remote Control baru
+* Untuk pesan startup Remote Control lainnya, lihat [Troubleshoot Remote Control](/docs/id/remote-control#troubleshooting)
+
+Jika server melaporkan sebaliknya bahwa sesi sebelumnya hilang, Anda tidak melihat pesan ini. Claude Code memulai sesi baru di tempatnya atau menampilkan [`Previous session is unavailable — run /remote-control to start a new one`](/docs/id/remote-control#previous-session-is-unavailable), tergantung pada [catatan koneksi kembali percakapan](/docs/id/remote-control#resume-outcomes). Dari v2.1.227 hingga v2.1.231, Claude Code menampilkan pesan yang dimulai dengan `Remote Control could not resume the previous session under the current login` sebagai gantinya, dan [versi sebelumnya berperilaku berbeda lagi](/docs/id/remote-control#reconnect-history).
+
+
+ Sessions ended while this machine was offline
+
+
+Claude Code menampilkan pesan ini di terminal yang menjalankan [`claude remote-control`](/docs/id/remote-control#start-a-remote-control-session) setelah mesin Anda offline cukup lama sehingga server membersihkan lingkungan Remote Control yang mesin Anda layani. Sesi di lingkungan itu berakhir, dan Anda tidak dapat melanjutkannya. Hitungannya adalah jumlah sesi yang berakhir.
+
+```text theme={null}
+2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.
+```
+
+**Yang harus dilakukan:**
+
+* Ketika Claude Code mencantumkan worktrees yang disimpan di bawah pesan ini, ambil pekerjaan yang tidak dikomit dari mereka
+* Jalankan `claude remote-control` untuk memulai lingkungan segar
+
+
+ Couldn't share the transcript
+
+
+Setelah Anda setuju untuk berbagi transkrip sesi Anda dari prompt survei, seperti [survei kualitas sesi](/docs/id/data-usage#session-quality-surveys), Claude Code mengunggahnya ke Anthropic, atau menyimpan arsip lokal sebagai gantinya di penyedia pihak ketiga, di sesi [Claude apps gateway](/docs/id/claude-apps-gateway), dan ketika tidak ada kredensial Anthropic yang tersedia. Pesan ini berarti berbagi tidak selesai.
+
+```text theme={null}
+Couldn't share the transcript.
+```
+
+Unggahan harus sesuai dengan batas 8 MiB. Dalam sesi yang panjang, Claude Code secara progresif menjatuhkan bagian dari berbagi, pengaturan model permintaan terakhir terlebih dahulu, kemudian percakapan terstruktur dan transkrip subagen, dan menampilkan pesan ini hanya ketika tidak ada versi yang dikurangi yang dapat dikirim atau kesalahan jaringan atau server menghentikan unggahan. Ketika Claude Code menyimpan arsip lokal sebagai gantinya, pesan berarti tidak dapat menulis arsip.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/feedback` untuk mengirim transkrip dengan deskripsi apa yang terjadi. Lihat [Report an error](#report-an-error) jika `/feedback` tidak tersedia di lingkungan Anda
+* Jika permintaan lain juga gagal, periksa koneksi jaringan Anda dan lihat [Unable to connect to API](#unable-to-connect-to-api)
+
+
+ Kesalahan permintaan
+
+
+Kesalahan ini berkaitan dengan konten permintaan Anda. Sebagian besar kembali dari API setelah menolak permintaan; beberapa diproduksi secara lokal oleh Claude Code sebelum permintaan dikirim.
+
+
+ Prompt terlalu panjang
+
+
+Percakapan ditambah file yang dilampirkan melebihi jendela konteks model.
+
+```text theme={null}
+Prompt is too long
+```
+
+Dalam sesi interaktif, Claude Code menampilkan kesalahan ini sebagai:
+
+```text theme={null}
+Context limit reached · /compact or /clear to continue
+```
+
+Baris hanya menyebutkan `/clear` ketika [`DISABLE_COMPACT`](/docs/id/env-vars) diatur. Bentuk kesalahan yang lebih panjang, seperti bentuk kegagalan pemadatan di bawah, tetap mempertahankan pesan `Prompt is too long ·`. Dalam output `-p` dan transkrip, teksnya tetap `Prompt is too long`.
+
+Ketika Anda mematikan auto-compact di [pengaturan pengguna](/docs/id/settings-reference#autocompactenabled) Anda, baris juga mengatakan demikian:
+
+```text theme={null}
+Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on
+```
+
+Tombol **Auto-compact** di `/config` menulis `autoCompactEnabled` ke pengaturan pengguna. Petunjuk muncul hanya ketika perubahan `/config` akan berlaku. Misalnya, tidak muncul ketika [`DISABLE_AUTO_COMPACT`](/docs/id/env-vars) atau [`DISABLE_COMPACT`](/docs/id/env-vars) mematikan auto-compact. Juga tidak muncul ketika cakupan prioritas lebih tinggi, seperti pengaturan proyek atau terkelola, menetapkan `autoCompactEnabled` ke `false`. Sebelum v2.1.235, baris tidak membawa petunjuk auto-compact.
+
+Amazon Bedrock melaporkan kondisi ini sebagai `Input is too long for requested model.`, yang Claude Code tangani dengan cara yang sama. Sebelum v2.1.217, Claude Code tidak mengenali pesan Bedrock, jadi auto-compact tidak pernah dipicu dan `/compact` gagal dengan kesalahan yang sama.
+
+Gateway [aplikasi Claude](/docs/id/claude-apps-gateway-config#upstream-error-messages) melaporkan kondisi ini sebagai `capability_rejected: prompt_too_long` ketika upstream cloud menolak permintaan dalam bentuk kesalahan penyedia sendiri. Claude Code memperlakukan token sama dengan `Prompt is too long`. Sebelum v2.1.228, Claude Code tidak mengenali token, jadi auto-compact tidak dipicu.
+
+Ketika pemadatan otomatis berjalan pada giliran ini dan gagal pada kesalahan yang mendasar, seperti model yang tidak tersedia atau kegagalan autentikasi, pesan menyebutkan kesalahan itu setelah pemisah:
+
+```text theme={null}
+Prompt is too long · automatic compaction failed:
+```
+
+Selesaikan kesalahan yang dinamai terlebih dahulu; `/compact` gagal pada kesalahan yang sama sampai Anda melakukannya. Sebelum v2.1.229, pemadatan otomatis yang gagal menampilkan `Prompt is too long` tanpa penyebabnya.
+
+Ketika pemadatan otomatis berjalan pada kesalahan ini, biasanya merangkum pertukaran tertua Anda dan menyimpan yang terbaru. Sebagai upaya terakhir, Claude Code merangkum secara berbeda:
+
+* Ketika tidak dapat merangkum seluruh pertukaran, Claude Code menyimpan prompt terbaru Anda kata demi kata dan merangkum semuanya sebelumnya.
+* Dalam hal itu, ketika percakapan tidak berakhir dengan prompt Anda, Claude Code merangkum seluruh percakapan sebagai gantinya.
+
+Claude Code melewati pemulihan ini ketika konten yang akan dibawanya tidak menyimpan balasan model dan kurang dari sekitar 1.000 token teks Anda sendiri, seperti pengiriman ulang singkat setelah tempel berukuran besar. Jalankan `/clear` untuk memulai segar. Sebelum v2.1.269, pemadatan gagal setiap kali tidak dapat merangkum seluruh pertukaran, jadi sesi dalam keadaan itu mencapai kesalahan ini lagi pada setiap giliran.
+
+Percakapan pertukaran tunggal tidak memiliki giliran sebelumnya untuk dirangkum. Ketika pemadatan otomatis akan berjalan pada satu, Claude Code melewati upaya dan menjelaskan apa yang mengisi permintaan sebagai gantinya. Ketika API tidak melaporkan jumlah token dalam kesalahannya, pesan berbunyi:
+
+```text theme={null}
+Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.
+```
+
+Ketika API melaporkan jumlah token dalam kesalahannya, Claude Code membandingkannya dengan estimasi sendiri tentang ukuran percakapan untuk mengetahui mana yang paling banyak dari permintaan: konten percakapan sendiri, atau prompt sistem, definisi alat, dan konten lampiran yang Claude Code kirim dengannya. Ketika konten percakapan sendiri paling banyak dari permintaan, pesan berbunyi:
+
+```text theme={null}
+Prompt is too long · the request is ~ tokens (limit ) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).
+```
+
+Ketika sebagian besar permintaan berada di luar percakapan, pesan berbunyi:
+
+```text theme={null}
+Prompt is too long · the request is ~ tokens (limit ) but this conversation is only ~ tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.
+```
+
+Sebelum v2.1.162, Claude Code mencoba pemadatan bagaimanapun dan menampilkan `Prompt is too long` telanjang ketika gagal.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/compact` untuk merangkum giliran sebelumnya dan membebaskan ruang, atau `/clear` untuk memulai segar. Jika `/compact` menjawab `Not enough messages to compact.`, percakapan adalah pertukaran tunggal tanpa apa pun sebelumnya untuk dirangkum, jadi ruang diambil oleh prompt itu dan apa yang Claude Code kirim dengan setiap permintaan: jalankan `/clear` dan kirim ulang dengan teks tempel lebih sedikit atau lampiran lebih kecil, atau kurangi definisi alat dan file memori menggunakan langkah-langkah di bawah
+* Jalankan `/context` untuk melihat rincian apa yang mengonsumsi jendela: prompt sistem, alat, file memori, dan pesan
+* Nonaktifkan server MCP yang tidak Anda gunakan dengan `/mcp disable ` untuk menghapus definisi alat mereka dari konteks
+* Pangkas file memori `CLAUDE.md` besar, atau pindahkan instruksi ke [aturan bersifat jalur](/docs/id/memory#path-specific-rules) yang dimuat hanya ketika relevan
+* Subagen mewarisi setiap definisi alat MCP dari sesi induk, yang dapat mengisi jendela konteks mereka sebelum giliran pertama. Nonaktifkan server MCP yang tidak Anda gunakan sebelum menelurkan subagen.
+* Auto-compact aktif secara default dan biasanya mencegah kesalahan ini. Jika Anda mematikannya di `/config` atau dengan [`DISABLE_AUTO_COMPACT`](/docs/id/env-vars), aktifkan kembali. Jika Anda tetap mematikannya, jalankan `/compact` sendiri sebelum jendela penuh.
+
+Lihat [Jelajahi jendela konteks](/docs/id/context-window) untuk tampilan interaktif tentang bagaimana konteks terisi.
+
+
+ Konteks melebihi batas token
+
+
+`/context` menampilkan peringatan ini di bagian atas outputnya ketika percakapan telah melampaui jendela konteks model. Permintaan gagal dengan [`Prompt is too long`](#prompt-is-too-long) sampai Anda membebaskan ruang. Sesi interaktif menampilkan kesalahan itu sebagai baris `Context limit reached`.
+
+```text theme={null}
+Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
+```
+
+Ketika batas yang Anda lampaui adalah jendela pemadatan, seperti batas 200K pada model konteks 1M, peringatan berbunyi berbeda. Jendela pemadatan dapat duduk di bawah jendela konteks model, jadi permintaan melewatinya masih dapat berhasil.
+
+```text theme={null}
+Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
+```
+
+Kedua bentuk menyebutkan `/clear` bukan `/compact` ketika Anda telah menetapkan [`DISABLE_COMPACT`](/docs/id/env-vars).
+
+**Yang harus dilakukan:**
+
+* Dalam percakapan multi-giliran, jalankan `/compact` untuk merangkum giliran sebelumnya dan membebaskan ruang. Untuk memulai segar sebagai gantinya, jalankan `/clear`
+* Untuk lebih banyak cara mengurangi penggunaan, lihat [Prompt is too long](#prompt-is-too-long)
+
+Sebelum v2.1.216, `/context` menampilkan penggunaan di atas 100% tanpa baris peringatan yang menjelaskan apa artinya atau cara pulih.
+
+
+ Kesalahan selama pemadatan: Percakapan terlalu panjang
+
+
+`/compact` sendiri gagal karena tidak ada cukup konteks bebas untuk menampung ringkasan yang dihasilkannya.
+
+```text theme={null}
+Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
+```
+
+Ini dapat terjadi ketika jendela sudah penuh pada saat auto-compact dipicu, atau ketika Anda menjalankan `/compact` setelah melihat [`Prompt is too long`](#prompt-is-too-long). Dalam sesi interaktif, kesalahan itu adalah baris `Context limit reached`.
+
+**Yang harus dilakukan:**
+
+* Tekan Esc dua kali untuk membuka daftar pesan dan mundur beberapa giliran. Ini menghilangkan pesan terbaru dari konteks. Kemudian jalankan `/compact` lagi.
+* Jika mundur tidak membebaskan cukup ruang, jalankan `/clear` untuk memulai sesi segar. Percakapan sebelumnya Anda disimpan dan dapat dibuka kembali dengan `/resume`.
+
+Pesan ini dan kegagalan `/compact` lainnya ditampilkan dalam gaya kesalahan. Sebelum v2.1.216, mereka dirender dalam gaya redup yang sama dengan output perintah yang berhasil, jadi Anda dapat membaca pemadatan yang gagal sebagai kesuksesan.
+
+
+ Permintaan terlalu besar
+
+
+Badan permintaan mentah melebihi batas 32MB API sebelum tokenisasi, biasanya karena konten tempel besar, hasil alat, atau lampiran. Batas ini terpisah dari [jendela konteks](#prompt-is-too-long).
+
+```text theme={null}
+Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.
+```
+
+Ketika permintaan langsung ke API Claude dan API sendiri menolaknya, Claude Code mengukur percakapan dan merumuskan pesan berdasarkan apakah pemulihan dapat bekerja. Melalui proxy, gateway, atau penyedia cloud Anda mendapatkan pesan umum. Bentuk yang diukur:
+
+* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: gambar atau dokumen mendorong permintaan melampaui batas. Claude Code mencoba ulang dengan mereka dihilangkan.
+* `Request too large for the API's 32MB request limit`: pesan saja sudah melampaui batas, jadi pesan mengatakan `compacting cannot make it fit` dan Claude Code tidak mencoba ulang. Dalam [mode non-interaktif](/docs/id/headless), pesan memberi tahu Anda untuk mengurangi input atau memulai sesi baru sebagai gantinya.
+
+Sebelum v2.1.212, percakapan dengan cukup gambar terakumulasi gagal pada setiap giliran dengan `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` Sebelum v2.1.229, Claude Code menampilkan saran lampiran untuk setiap penolakan, bahkan ketika pemadatan tidak dapat membantu.
+
+**Yang harus dilakukan:**
+
+* Jika pesan mengatakan `compacting cannot make it fit`, tekan Esc dua kali untuk mundur melampaui giliran yang menambahkan konten besar, atau jalankan `/clear` untuk memulai segar
+* Jika tidak, jalankan `/compact`, yang menghilangkan gambar dan lampiran terakumulasi
+* Referensikan file besar berdasarkan jalur bukan menempel konten mereka, jadi Claude dapat membacanya dalam potongan
+* Untuk gambar, lihat [Image was too large](#image-was-too-large) di bawah
+
+
+ Gambar terlalu besar
+
+
+Gambar yang ditempel atau dilampirkan melebihi batas ukuran atau dimensi API.
+
+```text theme={null}
+Image was too large. Double press esc to go back and try again with a smaller image.
+API Error: 400 ... image dimensions exceed max allowed size
+```
+
+Claude Code mengganti gambar yang tidak dapat diproses dengan placeholder teks dan mencoba ulang, jadi pesan berikutnya berhasil. Pada versi sebelum 2.1.142, gambar yang ditempel dapat tetap berada dalam percakapan dan mengulangi kesalahan yang sama pada setiap pesan berikutnya. Untuk pulih pada versi tersebut, tekan Esc dua kali dan mundur melampaui giliran tempat gambar ditambahkan.
+
+**Yang harus dilakukan:**
+
+* Ubah ukuran gambar sebelum menempel. API menerima gambar hingga 8000 piksel di tepi terpanjang untuk satu gambar, atau 2000 piksel ketika banyak gambar berada dalam konteks.
+* Ambil tangkapan layar yang lebih ketat dari wilayah yang relevan bukan layar penuh
+
+
+ Tidak dapat mengubah ukuran gambar
+
+
+Claude Code tidak dapat mengurangi skala gambar yang dilampirkan sebelum mengirimnya ke API.
+
+```text theme={null}
+Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
+Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
+Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
+Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
+Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
+Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
+Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.
+```
+
+Claude Code biasanya mengubah ukuran gambar besar secara otomatis. Kesalahan ini berarti gambar tidak dapat didekode atau diubah ukurannya agar sesuai dengan batas API.
+
+**Yang harus dilakukan:**
+
+* Jika pesan meminta Anda mengonversi gambar, konversikan ke PNG, JPEG, GIF, atau WebP dan lampirkan lagi. Claude Code dapat memverifikasi dimensi untuk format ini dari header file, tanpa mendekode gambar.
+* Jika pesan melaporkan batas dimensi atau ukuran, ubah ukuran atau kompres ulang gambar di bawah batas itu sebelum melampirkan.
+* Jika pesan menyebutkan penyebab, seperti JPEG CMYK, WebP animasi, atau file yang mungkin rusak, simpan ulang gambar dalam format yang disarankan pesan dan lampirkan lagi.
+
+
+ Kesalahan PDF
+
+
+PDF yang Anda lampirkan tidak dapat diproses. Pesan ditampilkan di sini dalam bentuk non-interaktif mereka; dalam sesi interaktif mereka malah meminta Anda untuk tekan esc dua kali dan coba lagi.
+
+```text theme={null}
+PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
+PDF is password protected. Try using a CLI tool to extract or convert the PDF.
+The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
+```
+
+**Yang harus dilakukan:**
+
+* Untuk PDF berukuran besar, minta Claude membaca rentang halaman dengan alat Read bukan melampirkan seluruh file, atau ekstrak teks dengan alat seperti `pdftotext` dan referensikan file output berdasarkan jalur
+* Untuk PDF yang dilindungi atau tidak valid, hapus kata sandi atau ekspor ulang file dari aplikasi sumbernya, kemudian coba lagi
+
+
+
+Proxy atau gateway LLM antara Claude Code dan API menghilangkan header permintaan `anthropic-beta`, jadi API menolak bidang yang bergantung padanya.
+
+```text theme={null}
+API Error: 400 ... Extra inputs are not permitted ... context_management
+API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
+```
+
+Claude Code mengirim bidang khusus beta seperti `context_management` dan `effort` bersama header `anthropic-beta` yang mengaktifkannya. Ketika gateway meneruskan badan tetapi menghilangkan header, API melihat bidang yang tidak dikenalinya.
+
+**Yang harus dilakukan:**
+
+* Konfigurasikan gateway Anda untuk meneruskan header `anthropic-beta`. Lihat [feature pass-through](/docs/id/llm-gateway-protocol#feature-pass-through) untuk apa yang harus diteruskan gateway.
+* Sebagai fallback, atur [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/id/env-vars) sebelum meluncurkan. [Disable pre-release capabilities](/docs/id/llm-gateway-protocol#disable-pre-release-capabilities) mencakup cakupan yang tepat.
+
+
+
+Alat dalam permintaan mendeklarasikan `input_schema` yang gagal validasi JSON Schema API, jadi API menolak seluruh permintaan. Angka setelah `tools.` adalah posisi alat yang gagal dalam daftar alat permintaan, bukan nama yang dapat Anda cari.
+
+```text theme={null}
+API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
+API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'
+```
+
+Bentuk pertama berarti skema bukan JSON Schema draft 2020-12 yang valid. Bentuk kedua berarti nama properti tingkat atas tidak cocok dengan pola yang dikutip pesan.
+
+Claude Code [mengecualikan alat MCP yang skema input-nya akan gagal validasi ini](/docs/id/mcp#tools-with-invalid-input-schemas) ketika memuat alat server, jadi permintaan biasanya tidak pernah menyertakan satu.
+
+Pada [deployment di mana pengambilan flag dimatikan](/docs/id/env-vars#features-that-need-feature-flag-fetching), atau pada mesin yang flagnya tidak pernah tiba, Claude Code mencatat dalam log server alat mana yang akan ditolak tetapi mengirimnya bagaimanapun, jadi kesalahan ini masih dapat terjadi.
+
+Kesalahan juga dapat terjadi untuk alat yang skemanya mendeklarasikan dialek JSON Schema selain draft 2020-12 di `$schema`. Claude Code tidak memeriksa skema tersebut terhadap meta-skema JSON Schema, meskipun pemeriksaan nama properti tingkat atas masih berlaku.
+
+Sebelum v2.1.216, tidak ada deployment yang menjalankan pemeriksaan pengecualian.
+
+**Yang harus dilakukan:**
+
+* Jika versi Claude Code Anda lebih awal dari v2.1.216, jalankan `claude update`.
+* Hapus atau [nonaktifkan](/docs/id/mcp#disable-a-server-without-removing-it) server MCP yang mendeklarasikan skema tidak valid. Kesalahan hanya menyebutkan alat berdasarkan posisi. Pada v2.1.216 atau lebih baru, periksa log setiap server untuk baris yang menyebutkan alat yang skema input-nya akan ditolak. Jika tidak ada log yang menyebutkan satu, nonaktifkan server satu per satu.
+* Jika Anda memelihara server, perbaiki `input_schema` alat. Skema harus berupa JSON Schema yang valid, dan nama properti tingkat atas harus 1 hingga 64 karakter panjang dan hanya menggunakan huruf ASCII dan digit, `_`, `.`, dan `-`. Lihat [Tools with invalid input schemas](/docs/id/mcp#tools-with-invalid-input-schemas).
+
+
+ Ada masalah dengan model yang dipilih
+
+
+Nama model yang dikonfigurasi tidak dikenali atau akun Anda tidak memiliki akses ke model tersebut. Mulai dari v2.1.160 petunjuk trailing, ditampilkan di sini dalam bentuk interaktifnya, bervariasi menurut permukaan.
+
+```text theme={null}
+There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.
+```
+
+**Yang harus dilakukan:**
+
+* **CLI Interaktif**: jalankan `/model` untuk memilih dari model yang tersedia untuk akun Anda.
+* **Mode non-interaktif (`-p`)**: teruskan `--model` dengan alias atau ID yang valid, atau atur [`ANTHROPIC_MODEL`](/docs/id/env-vars). Teks kesalahan menampilkan `Run --model` di permukaan ini.
+* **Agent SDK**: teks kesalahan menghilangkan petunjuk karena model diatur secara terprogram. Atur [`model` pada `Options`](/docs/id/agent-sdk/typescript#options) di TypeScript atau [`ClaudeAgentOptions(model=...)`](/docs/id/agent-sdk/python#claudeagentoptions) di Python, dan tangani kesalahan terstruktur `model_not_found` untuk menampilkan pemilih ulang atau pemilih model Anda sendiri.
+* Gunakan alias seperti `sonnet` atau `opus` bukan ID versi lengkap. Alias menyelesaikan ke default yang dipertahankan sehingga tidak menjadi usang. Lihat [Model configuration](/docs/id/model-config).
+* Jika model yang salah terus kembali di CLI, ID usang diatur di suatu tempat. Periksa tempat Anda dapat mengatur model dalam [urutan prioritas](/docs/id/model-config#setting-your-model) dan hapus nilai usang.
+* Model yang baru diluncurkan dapat tersedia di API Anthropic sebelum Amazon Bedrock, Platform Agent Google Cloud, atau Foundry Microsoft menawarkannya. Jika Anda menyematkan ID model baru pada salah satu penyedia tersebut dan melihat kesalahan ini, periksa katalog model penyedia Anda untuk ketersediaan di wilayah Anda, dan pertahankan versi sebelumnya yang disematkan sampai yang baru muncul di sana.
+* Claude Code melaporkan login claude.ai yang kedaluwarsa sebagai [Login expired](#login-expired), bukan sebagai kesalahan ini. Sebelum v2.1.206, login yang kedaluwarsa yang tidak lagi dapat disegarkan gagal di setiap model dengan kesalahan ini; jalankan `/login` jika Anda melihat itu pada versi yang lebih lama.
+* Untuk deployment Platform Agent Google Cloud, lihat [Troubleshooting Platform Agent Google Cloud](/docs/id/google-vertex-ai#troubleshooting).
+
+
+ Model bukan ID model yang dikenali
+
+
+String model yang Anda teruskan ke sakelar model bukan alias model, ID model yang diketahui versi Claude Code ini, atau ID yang dimulai dengan `claude-`. Penyebab biasanya adalah kesalahan ketik di ID, nama tampilan seperti `Sonnet 5` di mana ID `claude-sonnet-5` diharapkan, atau alias yang hanya dikenali versi Claude Code yang lebih baru. Claude Code menolak sakelar segera. Sebelum v2.1.200, Claude Code menyimpan string dan gagal pada permintaan berikutnya dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model).
+
+```text theme={null}
+Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
+```
+
+Petunjuk trailing menyebutkan alias atau ID model yang paling cocok. Ketika tidak ada yang cukup dekat, itu berbunyi `Run /model to see available models.` sebagai gantinya.
+
+Claude Code menghasilkan kesalahan ini secara lokal pada saat sakelar diminta, sebelum permintaan API apa pun dibuat. Ini berlaku ketika model diatur melalui metode [Agent SDK](/docs/id/agent-sdk/typescript) `setModel()`, oleh aplikasi seperti [Desktop app](/docs/id/desktop) yang menjalankan CLI Claude Code untuk Anda, atau ketika Anda memilih model dari perangkat yang terhubung melalui [Remote Control](/docs/id/remote-control). Sebelum v2.1.260, pemeriksaan tidak mencakup pilihan Remote Control, jadi Claude Code menerapkan pilihan dan permintaan berikutnya gagal dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model).
+
+**Yang harus dilakukan:**
+
+* Jalankan `/model` tanpa argumen untuk membuka pemilih dan pilih dari model yang tersedia untuk akun Anda, kemudian teruskan alias atau ID yang ditampilkan di sana
+* Jika Anda menggunakan alias yang didukung versi Claude Code yang lebih baru, jalankan `claude update`. ID lengkap yang dimulai dengan `claude-` melewati pemeriksaan lokal ini bahkan ketika model lebih baru dari versi Claude Code Anda. Server masih dapat memerlukan versi minimum untuk model itu; lihat [Claude Code does not support this model](#claude-code-does-not-support-this-model).
+* Model yang disimpan sebelum v2.1.200 tidak diperbaiki oleh pemeriksaan ini. Jika nilai usang terus kembali, hapus dari lokasi yang tercantum di bawah [Setting your model](/docs/id/model-config#setting-your-model).
+* Pemeriksaan hanya berjalan di API Anthropic. Pada penyedia atau gateway lain apa pun, termasuk `ANTHROPIC_BASE_URL` kustom, penyedia menentukan nama model, jadi Claude Code menerima string apa pun dan meneruskannya. Claude Code masih dapat menulis [baris diagnostik model yang tidak dikenali](#unrecognized-model-id-on-a-request) pada waktu permintaan, di setiap penyedia.
+
+
+ Model tidak ditemukan
+
+
+Anda memilih model dengan `/model ` dan Claude Code tidak dapat mengkonfirmasi bahwa model dengan nama itu ada. Ketika nama bukan [alias model](/docs/id/model-config#model-aliases) atau ejaan lain yang Claude Code terima secara lokal, `/model` memverifikasinya dengan permintaan API minimal, dan kesalahan ini biasanya adalah jawaban endpoint API Anda. Nama yang tidak dapat menjadi ID model sama sekali, seperti yang berisi spasi, mendapatkan pesan yang sama.
+
+```text theme={null}
+Model 'claude-opus-9' not found
+```
+
+Pada penyedia dengan ID model khusus penyedia, pesan dapat menambahkan saran `Try '...' instead` yang menyebutkan ID penyedia Anda untuk model fallback.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/model` tanpa argumen dan pilih dari model yang tersedia untuk akun Anda, atau gunakan [alias model](/docs/id/model-config#model-aliases) seperti `sonnet`, yang menyelesaikan ke default yang dipertahankan
+* Jika Anda mengetik ID lengkap, periksa terhadap katalog model penyedia Anda. Model yang baru diluncurkan dapat tersedia di API Anthropic sebelum penyedia atau wilayah Anda menawarkannya.
+* Sebelum v2.1.265, `/model` juga menolak ejaan alias `opusplan[1m]` dengan kesalahan ini. Pada versi tersebut, perbarui Claude Code, atau atur model di [settings](/docs/id/model-config#setting-your-model) atau dengan `--model` sebagai gantinya.
+
+
+ Claude Opus tidak tersedia dengan paket Claude Pro
+
+
+Paket langganan aktif Anda tidak menyertakan model yang Anda pilih.
+
+```text theme={null}
+Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `/model` dan pilih model yang disertakan paket Anda
+* Jika Anda baru-baru ini meningkatkan paket dan masih melihat ini, jalankan `/logout` kemudian `/login`. Token yang disimpan mencerminkan paket Anda pada saat Anda masuk, jadi meningkatkan di claude.ai tidak berlaku dalam sesi yang ada sampai Anda autentikasi ulang.
+* Lihat [claude.com/pricing](https://claude.com/pricing) untuk model mana yang disertakan setiap paket
+
+
+ Claude Code tidak mendukung model ini
+
+
+API menolak permintaan dengan 400 karena versi Claude Code Anda di bawah minimum yang diperlukan. Baik model yang Anda pilih memerlukan versi yang lebih baru, yang diperiksa server per model, atau kebijakan organisasi Anda memerlukan satu. 400 membawa kode kesalahan `claude_code_version_too_old`, dan pesan mengatakan minimum mana yang berlaku.
+
+```text theme={null}
+API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.
+```
+
+Pesan kebijakan organisasi berbunyi:
+
+```text theme={null}
+API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `claude update`, atau perbarui aplikasi desktop Claude, kemudian mulai sesi baru
+* Untuk pesan per-model, Anda dapat terus bekerja dalam sesi saat ini dengan beralih ke model lain dengan `/model`
+* Untuk pesan kebijakan organisasi, perbarui sebelum Anda melanjutkan
+
+
+ Model dibatasi oleh pengaturan organisasi Anda
+
+
+Admin organisasi Anda telah menonaktifkan model ini di konsol admin claude.ai, atau dikecualikan oleh daftar izin [`availableModels`](/docs/id/model-config#restrict-model-selection) dalam pengaturan terkelola. Ketika model yang dibatasi diatur dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model`, Claude Code mengganti model yang diizinkan dan melanjutkan. Mengetik `/model ` untuk model yang dibatasi ditolak dengan `Run /model to choose a different model.` dan sesi menyimpan model saat ini. Pemberitahuan substitusi juga dapat muncul di tengah sesi setelah admin menonaktifkan model yang sedang dijalankan sesi di konsol admin claude.ai.
+
+```text theme={null}
+Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
+```
+
+Pemberitahuan dengan awalan nama agen, skill, atau perintah berarti pembatasan diterapkan pada [model yang diminta subagen](/docs/id/sub-agents#choose-a-model): subagen berjalan pada model yang diganti dan model sesi Anda tidak berubah. Sebelum v2.1.223, Claude Code menampilkan pemberitahuan hanya untuk subagen yang diluncurkan dengan alat Agent.
+
+Claude Code memperlakukan alias keluarga model, salah satu dari `opus`, `sonnet`, `haiku`, atau `fable`, sebagai permintaan untuk keluarga itu bukan untuk versi terbarunya. Di API Anthropic dan di [Claude Platform on AWS](/docs/id/claude-platform-on-aws), alias keluarga yang dibatasi menyelesaikan ke versi terbaru keluarga yang diizinkan organisasi Anda dan daftar izin `availableModels`, dan pemberitahuan substitusi menyebutkan versi itu. Claude Code menolak `/model ` hanya ketika setiap versi keluarga dibatasi. Sebelum v2.1.205, alias keluarga diganti atau ditolak berdasarkan versi terbarunya saja, bahkan ketika versi yang lebih lama dari keluarga yang sama diizinkan.
+
+**Yang harus dilakukan:**
+
+* Jalankan `/model` untuk memilih dari model yang diizinkan organisasi Anda. Model yang dibatasi disembunyikan dari pemilih.
+* Jika model yang dibatasi diatur di `--model`, `ANTHROPIC_MODEL`, bidang `model` file pengaturan, atau frontmatter `model` dari [subagen](/docs/id/sub-agents#choose-a-model), skill, atau perintah, hapus atau perbarui nilai itu sehingga pemberitahuan tidak berulang
+* Jika Anda memerlukan akses ke model yang dibatasi, minta admin organisasi Anda untuk mengaktifkannya. Lihat [Organization model restrictions](/docs/id/model-config#organization-model-restrictions).
+
+
+ Sakelar model diblokir oleh hook PreModelSwitch
+
+
+Hook [PreModelSwitch](/docs/id/hooks#premodelswitch) tidak menyetujui sakelar model yang Anda atau klien minta, jadi sesi menyimpan model saat ini. Ketika sakelar berasal dari host [Agent SDK](/docs/id/agent-sdk/overview) atau [Remote Control](/docs/id/remote-control) bukan perintah yang Anda ketik, pesan berbunyi `Model switch blocked by a PreModelSwitch hook` tanpa menyebutkan model target.
+
+```text theme={null}
+Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
+```
+
+Alasan setelah titik dua mengatakan apa yang menolak sakelar:
+
+* **Alasan yang ditulis hook**: hook PreModelSwitch menyediakan alasan itu ketika [menolak sakelar atau meminta konfirmasi](/docs/id/hooks#premodelswitch-decision-control). Tangani apa yang dimintanya, atau pilih model yang diizinkan hook Anda.
+* **`PreModelSwitch hook did not respond before its timeout`**: hook yang tidak menjawab sebelum [timeout](/docs/id/hooks#timeouts)-nya memblokir sakelar. Perbaiki perintah yang menggantung atau naikkan `timeout` hook itu, kemudian sakelar lagi.
+* **`confirmation required, and this session cannot ask`**: hook menjawab `ask` tanpa alasan, dan permintaan kontrol tidak memiliki cara untuk menampilkan prompt konfirmasi. Perintah `/model` dalam run [`-p`](/docs/id/headless) melaporkan kondisi yang sama dengan `(run /model interactively to confirm)` setelah alasan. Buat sakelar dari sesi interaktif, atau ubah keputusan hook untuk model ini.
+* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code tidak dapat mengetahui hook PreModelSwitch mana yang [plugin terkelola](/docs/id/settings-reference#enabledplugins) organisasi Anda berikan, misalnya karena plugin terkelola gagal dimuat. Salah satu hook itu mungkin memblokir sakelar, jadi Claude Code menolak bukan menerapkan sakelar yang tidak diperiksa. Awal alasan menyebutkan apa yang gagal. Claude Code memeriksa ulang pada setiap upaya sakelar, jadi kegagalan yang sejak itu telah dihapus berhenti memblokir; jika terus gagal, jalankan `claude --debug` dan sakelar lagi untuk menangkap detail, kemudian perbaiki plugin atau minta admin Anda memperbaikinya.
+* **`a PreModelSwitch hook failed before answering`** atau **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: jalankan hook berakhir tanpa putusan, dan Claude Code tidak memperlakukan itu sebagai persetujuan. Jalankan `claude --debug` untuk melihat apa yang gagal, kemudian sakelar lagi.
+
+Sebelum v2.1.260, penolakan plugin terkelola berbunyi `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code mencoba ulang pemuatan plugin sekali kemudian menolak sakelar kemudian dalam sesi, bahkan ketika organisasi Anda tidak mengelola plugin apa pun. Mulai ulang sesi untuk menjalankan pemuatan plugin lagi pada versi tersebut.
+
+
+ Tidak dapat menyimpannya sebagai default Anda
+
+
+Anda memilih model untuk disimpan sebagai default Anda, misalnya dengan `/model ` atau `Enter` di pemilih `/model`, dan Claude Code tidak dapat menulis pilihan ke file pengaturan pengguna Anda, `~/.claude/settings.json`. Sakelar itu sendiri diterapkan, jadi sesi saat ini berjalan pada model yang Anda pilih, tetapi default Anda tidak berubah dan sesi berikutnya dimulai pada nilai lama.
+
+```text theme={null}
+Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
+```
+
+Alasan setelah jalur file mengatakan apa yang gagal:
+
+* **`can't be written ()`**: penulisan gagal dengan kode kesalahan sistem operasi dalam tanda kurung, seperti `EROFS` ketika file, atau file yang ditautkannya, duduk di sistem file yang menolak penulisan. Buat file dapat ditulis dan sakelar lagi. Jika alat lain menghasilkan file, atur kunci `model` di alat itu sebagai gantinya; lihat [A change you made in Claude Code is lost in new sessions](/docs/id/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
+* **`isn't valid JSON`**: file di disk tidak diurai, dan Claude Code meninggalkannya tidak tersentuh bukan menimpa konten yang tidak dapat dibaca kembali. Perbaiki kesalahan sintaks, kemudian sakelar lagi; lihat [Fix a broken settings file](/docs/id/settings#fix-a-broken-settings-file).
+
+Pemberitahuan yang berakhir `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)` berarti penulisan belum selesai setelah tiga detik. Ini berlanjut di latar belakang, jadi default mungkin masih disimpan; periksa model mana yang dimulai sesi berikutnya Anda, atau jalankan `/model ` lagi.
+
+Sebelum v2.1.265, pemberitahuan mengatakan model itu `saved as your default for new sessions` bahkan ketika penulisan gagal.
+
+
+ thinking.type.enabled tidak didukung untuk model ini
+
+
+Versi Claude Code Anda lebih lama dari minimum untuk model yang dipilih. CLI mengirim konfigurasi pemikiran 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
+* Jika Anda tidak dapat meningkatkan, jalankan `/model` dan pilih Opus 4.6 atau Sonnet 4.6 sebagai gantinya
+* Jika Anda mencapai 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
+
+
+ Effort tidak tersedia dengan pemikiran dimatikan
+
+
+Anda mematikan [extended thinking](/docs/id/model-config#extended-thinking) dan menjalankan pada [effort level](/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)
+```
+
+**Yang harus dilakukan:**
+
+* [Turunkan effort level](/docs/id/model-config#set-the-effort-level) ke `high` atau di bawahnya.
+* Nyalakan pemikiran 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 effort level yang Anda atur, jadi Opus 5 menolak setiap permintaan di atas `high` dengan pemikiran dimatikan. Claude Code sekarang mengirim effort `high` sebagai gantinya ke model yang diketahuinya menolak kombinasi, seperti Opus 5, jadi pada v2.1.251 atau lebih baru kesalahan ini mencapai Anda hanya dari model yang Claude Code tidak tahu menolaknya.
+
+
+ Anggaran pemikiran melebihi batas output
+
+
+Anggaran 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
+```
+
+Claude Code menyesuaikan nilai-nilai ini secara otomatis di API Anthropic. Anda biasanya melihat kesalahan ini di Amazon Bedrock atau Platform Agent Google Cloud ketika [`MAX_THINKING_TOKENS`](/docs/id/env-vars) diatur lebih tinggi dari batas output penyedia, atau ketika mode rencana menaikkan anggaran pemikiran.
+
+**Yang harus dilakukan:**
+
+* Turunkan `MAX_THINKING_TOKENS`, atau naikkan [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/id/env-vars) di atas anggaran pemikiran
+* Lihat [Extended thinking](/docs/id/model-config#extended-thinking) untuk bagaimana anggaran berinteraksi dengan panjang output
+
+
+
+Riwayat percakapan mencapai API dalam keadaan tidak konsisten, biasanya setelah panggilan alat dihentikan atau giliran diedit di tengah aliran.
+
+```text theme={null}
+API Error: 400 due to tool use concurrency issues. 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
+```
+
+Ketiga varian berarti hal yang sama: urutan blok `tool_use`, `tool_result`, dan `thinking` dalam riwayat tidak lagi cocok dengan apa yang diharapkan API.
+
+**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 alat 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.
+
+
+ Konten alat yang tidak didukung dihapus
+
+
+Ketika Claude Code terhubung langsung ke API Anthropic dan memuat atau melihat pratinjau sesi yang disimpan, ia menghapus konten alat yang API Anthropic tidak terima dan meninggalkan baris ini di mana konten yang dihapus duduk di antara dua blok pemikiran:
+
+```text theme={null}
+[Unsupported tool content removed]
+```
+
+Konten seperti itu mencapai file sesi ketika sesuatu selain API Anthropic menjawab dalam format API, biasanya proxy pihak ketiga yang diatur melalui [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) yang menerjemahkan panggilan alat penyedia lain. Claude Code menghapusnya hanya ketika sesi terhubung langsung ke API Anthropic, dan memuat riwayat yang disimpan seperti adanya ketika sesi berjalan melalui proxy atau di penyedia lain. Sebelum v2.1.246, Claude Code mengirim penggunaan alat 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.
+
+
+ Penolakan Kebijakan Penggunaan
+
+
+API menolak untuk merespons karena konten dalam percakapan memicu pemeriksaan [Kebijakan Penggunaan](https://www.anthropic.com/legal/aup). Pesan menyertakan ID Permintaan yang dapat Anda kutip untuk mendukung jika Anda percaya 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 pemicu. Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Platform Agent Google Cloud](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), pesan ini juga mencakup permintaan yang langkah-langkah keselamatan model tandai sebagai topik keamanan siber. Lihat [Safety measures flagged a cybersecurity topic](#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, kemudian rephrase 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 ulang dengan prompt yang diucapkan ulang 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. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude
+```
+
+Pesan 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.
+
+Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Platform Agent Google Cloud](/docs/id/google-vertex-ai), dan [Microsoft Foundry](/docs/id/microsoft-foundry), bendera keamanan siber menghasilkan pesan [Penolakan Kebijakan Penggunaan](#usage-policy-refusal) sebagai gantinya.
+
+Penjaga itu sendiri adalah server-side dan mendahului v2.1.203; rilis klien sejak itu hanya mengubah pesan wording.
+Dari v2.1.203 melalui v2.1.218, pesan 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, dan sesi interaktif ditambahkan `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.`
+Sebelum v2.1.203, itu 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.
+
+**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 bendera, kemudian ambil pendekatan berbeda. Lihat [Checkpointing](/docs/id/checkpointing).
+
+
+ Kesalahan instalasi
+
+
+Kesalahan ini muncul saat menginstal atau memperbarui Claude Code, dari [skrip instalasi](/docs/id/setup#install-claude-code), `claude install`, atau `claude update`. Untuk masalah `command not found`, PATH, izin, dan TLS selama pengaturan, lihat [Troubleshoot installation and login](/docs/id/troubleshoot-install).
+
+
+ Installation was killed before it could finish
+
+
+Skrip instalasi melaporkan ketika langkah `claude install` dihentikan oleh sinyal. Di Linux, kode keluar 137 berarti proses menerima SIGKILL, dan pada host dengan memori rendah itu biasanya pembunuh out-of-memory (OOM) kernel. Skrip mencetak penjelasan ini dan keluar dengan kode 137:
+
+```text theme={null}
+Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
+Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
+```
+
+Untuk sinyal fatal lainnya, dan untuk kode keluar 137 di macOS, skrip mencetak `Installation was killed before it could finish (exit code )` dengan kode keluar aktual dan menghilangkan penjelasan out-of-memory. Pesan berasal dari skrip instalasi yang digunakan macOS dan Linux, yang juga mencakup instalasi di dalam WSL; skrip instalasi Windows asli tidak pernah mencetaknya. Sebelum v2.1.200, skrip keluar hanya dengan baris `Killed` shell yang kosong.
+
+**Yang harus dilakukan:**
+
+* Hentikan proses lain untuk membebaskan memori, kemudian jalankan kembali penginstal
+* Tambahkan ruang swap atau pindah ke instans yang lebih besar. Lihat [Install killed on low-memory Linux servers](/docs/id/troubleshoot-install#install-killed-on-low-memory-linux-servers) untuk perintah file swap.
+
+
+ The connection dropped while downloading the update
+
+
+Koneksi ke server unduhan ditutup saat `claude install`, `claude update`, atau [automatic updater](/docs/id/setup#auto-updates) mengambil biner Claude Code, dan pengulangan tidak berhasil. Claude Code mencoba ulang unduhan ketika koneksi putus, transfer macet, atau file yang diunduh gagal checksumnya, hingga tiga percobaan total. Kesalahan HTTP yang selesai, seperti 404, tidak dicoba ulang karena server sudah menjawab. Sebelum v2.1.202, koneksi yang putus tunggal gagal mengunduh segera dengan kesalahan kosong `aborted` alih-alih mencoba ulang.
+
+```text theme={null}
+The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
+```
+
+Teks dalam tanda kurung menyebutkan percobaan mana yang gagal dan kesalahan jaringan yang mendasarinya. `claude update` mendahului pesan dengan `Error: Failed to install native update` di stderr.
+
+Unduhan yang tetap terhubung tetapi tidak selesai dalam 10 menit gagal dengan `Download timed out: exceeded the total deadline` sebagai gantinya. Claude Code tidak mencoba ulang unduhan yang habis waktu, karena koneksi yang terlalu lambat untuk selesai dalam batas waktu tidak akan selesai pada pengulangan segera. Langkah-langkah di bawah berlaku untuk kedua pesan.
+
+Penyebab umum adalah proxy atau gateway yang menutup transfer panjang sebelum selesai. Biner Claude Code adalah unduhan besar, jadi batas koneksi proxy yang tidak pernah mempengaruhi lalu lintas API normal masih dapat mengganggu.
+
+**Yang harus dilakukan:**
+
+* Jalankan `claude update` lagi. Pada jaringan yang sehat, unduhan biasanya berhasil pada run berikutnya. Untuk pesan yang habis waktu, jalankan lagi dari jaringan yang lebih cepat atau kurang dibatasi.
+* Jika jaringan Anda memerlukan proxy, atur `HTTPS_PROXY` sebelum menjalankan penginstal atau `claude update`. Lihat [Check network connectivity](/docs/id/troubleshoot-install#check-network-connectivity).
+* Jika proxy korporat terus menutup transfer, minta tim jaringan Anda untuk mengizinkan unduhan lengkap dari `downloads.claude.ai`. Lihat [Network access requirements](/docs/id/network-config#network-access-requirements).
+* Jalankan `claude doctor` dari shell Anda untuk diagnostik instalasi
+
+
+ Kesalahan baris perintah
+
+
+Kesalahan ini berasal dari 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 mereka berjalan. Mereka juga berasal dari `/tui`, yang meluncurkan kembali CLI.
+
+
+ Konflik antara --bg dan --print
+
+
+Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru. Anda menggabungkan `--bg` dengan `-p` atau `--print` dalam invokasi `claude` yang sama. `--bg` memulai [sesi latar belakang](/docs/id/agent-view#from-your-shell) yang kemudian Anda lampirkan dengan `claude agents`, sementara `--print` berjalan [non-interaktif](/docs/id/headless) dan tidak pernah memulai sesi interaktif yang `claude agents` lampirkan. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah bisa dilampirkan.
+
+```text theme={null}
+--bg dan --print berkonflik: --print tidak pernah memulai sesi interaktif yang `claude agents` lampirkan, jadi pekerjaan tidak akan dapat dilampirkan. Prompt adalah posisional — lepaskan --print: `claude --bg ''`.
+```
+
+**Yang harus dilakukan:**
+
+* Lepaskan `-p` atau `--print`. `--bg` mengambil prompt sebagai argumen posisionalnya, jadi `claude --bg ""` adalah perintah lengkapnya. Lihat [Dispatch new agents from your shell](/docs/id/agent-view#from-your-shell).
+* Untuk menjalankan prompt secara non-interaktif dan mencetak hasilnya alih-alih membuat sesi latar belakang, lepaskan `--bg` dan jalankan `claude -p ""`
+
+
+ Konfigurasi --agents tidak valid
+
+
+Nilai yang Anda berikan ke `--agents` tidak valid, jadi `claude` keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda melewatkan `--safe-mode`, `--resume`, atau `--continue`, atau mengatur [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars#variables), Claude Code tidak memeriksa nilainya dan memulai sesi. Sebelum v2.1.242, Claude Code memulai sesi bagaimanapun dan menghilangkan definisi yang tidak bisa dimuat.
+
+```text theme={null}
+Error: Invalid --agents configuration:
+
+```
+
+Apa yang mengikuti baris pertama tergantung pada bagaimana nilainya gagal. Claude Code menjalankan pemeriksaan ini secara berurutan dan berhenti di yang pertama gagal. Jika nilai Anda memiliki dua jenis masalah, Anda hanya melihat yang kedua setelah Anda memperbaiki yang pertama:
+
+1. Ketika nilai tidak diuraikan sebagai JSON, Claude Code mencetak satu baris `invalid JSON:` yang membawa pesan parser JSON sendiri
+2. Ketika diuraikan tetapi definisi agen tidak cocok dengan skema untuk [subagen yang ditentukan CLI](/docs/id/sub-agents#choose-the-subagent-scope), Claude Code mencetak satu baris per masalah
+3. Ketika nama agen dimulai dengan `-`, Claude Code mencetak `: agent names must not start with '-'`
+
+Ketika ada lebih dari 20 baris masalah, Claude Code mencetak 20 yang pertama dan mengganti sisanya dengan `…and N more`.
+
+**Yang harus dilakukan:**
+
+* Perbaiki setiap masalah yang daftar pesan, kemudian jalankan perintah lagi. Lihat [bidang yang diambil subagen yang ditentukan 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 untuk membuat [sesi cloud](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) darinya, karena sesi baru akan berjalan di luar proses terbatas dan tidak akan memberlakukan mode terbatas. Claude Code menolak di klien, sebelum menghubungi server, jadi tidak ada sesi cloud yang dibuat:
+
+```text theme={null}
+Cloud sessions cannot be created from a --restricted session: they would not enforce it.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan tugas secara lokal dalam sesi terbatas
+* Jika Anda mengontrol bagaimana 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 yang tidak dikenal.
+
+
+ Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda
+
+
+Kebijakan `allow_remote_sessions` organisasi Anda mati, jadi [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 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 itu mengembalikan [`Unknown command`](#unknown-command) sebagai gantinya.
+
+Ini adalah kebijakan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI.
+
+Jika Claude Code belum memuat kebijakan organisasi Anda atau tidak dapat mengambilnya, perintah itu menjawab `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` sebagai gantinya.
+
+**Yang harus 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)
+* Jika pesan mengatakan tidak dapat memverifikasi kebijakan, periksa koneksi jaringan Anda, kemudian mulai ulang Claude Code dan coba 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 kompilasi JSON Schema, jadi `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan skema apa pun 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"`, valid: Claude Code menerima `format` sebagai anotasi dan tidak memberlakukannya.
+
+Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: menolak nilai yang tidak dapat diuraikan JSON dengan `Error: --json-schema is not valid JSON`, dan JSON yang valid tetapi bukan objek dengan `Error: --json-schema must be a JSON object`.
+
+**Yang harus dilakukan:**
+
+* Perbaiki bagian skema yang diagnostik sebutkan, kemudian jalankan kembali perintah
+* Jika diagnostik adalah `schema too large`, kurangi nesting skema dan penggunaan kembali `$ref`
+* Lihat [Get structured output](/docs/id/headless#get-structured-output) untuk skema kerja dan perintah
+
+
+ File pengaturan melebihi batas 2MiB
+
+
+File yang Anda berikan ke [`--settings`](/docs/id/cli-reference#cli-flags) lebih besar dari 2 MiB, jadi `claude` keluar dengan kode 1 saat startup alih-alih memuatnya. File pengaturan adalah dokumen JSON kecil, jadi file sebesar ini biasanya berarti jalur menunjuk ke file yang salah. Sebelum v2.1.214, Claude Code membaca file tanpa pemeriksaan ukuran, dan file multi-gigabyte atau file perangkat seperti `/dev/zero` menumbuhkan memori tanpa batas.
+
+```text theme={null}
+Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
+```
+
+Claude Code menolak jalur `--settings` yang bukan file biasa dengan cara yang sama: perangkat, FIFO, atau soket melaporkan `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` diikuti oleh jalur, dan direktori melaporkan alasan `EISDIR`.
+
+**Yang harus dilakukan:**
+
+* Arahkan `--settings` ke file pengaturan JSON biasa di bawah 2 MiB. Lihat [Settings](/docs/id/settings) untuk formatnya.
+
+
+ Direktori saat ini tidak lagi ada
+
+
+Anda memulai `claude` dari direktori yang dihapus atau dipindahkan setelah shell Anda memasukkannya, misalnya worktree atau direktori temp yang shell lain hapus. Claude Code tidak dapat membaca direktori kerjanya, jadi keluar dengan kode 1 sebelum memulai sesi, dalam mode interaktif dan [non-interaktif](/docs/id/headless) sama-sama. Sebelum v2.1.239, Claude Code mogok dengan sumber bundle minified 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 izin, pesan menyebutkan kode kesalahan sebagai gantinya: `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 itu. Perintah lain yang membaca folder itu gagal dengan cara yang sama: `ls` di sana melaporkan `Operation not permitted`, bahkan dengan `sudo`.
+
+**Yang harus dilakukan:**
+
+* Ubah ke direktori yang ada, seperti direktori home atau proyek Anda, kemudian jalankan `claude` lagi
+* Jika direktori dibuat kembali di jalur yang sama, shell Anda masih memegang yang dihapus. Jalankan `cd "$PWD"` atau tinggalkan dan masuki kembali direktori, kemudian jalankan `claude` lagi
+* Untuk `EPERM` di macOS, keluar dari aplikasi terminal Anda dengan Cmd+Q, buka lagi, kembali ke folder itu, dan jalankan `claude`. Jika `ls` di folder itu masih gagal, buka **System Settings > Privacy & Security > Files and Folders**, aktifkan folder untuk aplikasi terminal Anda, kemudian buka kembali terminal
+
+
+ Direktori tidak dapat diselesaikan ke lokasi nyata
+
+
+Anda menjalankan `/add-dir` untuk subdirektori direktori kerja Anda, dan Claude Code tidak dapat menyelesaikan direktori ke lokasi nyatanya.
+
+Anda sudah memiliki akses file ke subdirektori direktori kerja, jadi `/add-dir` hanya memuat skills, commands, dan agents-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi nyata direktori, dengan symlink apa pun yang diselesaikan, berada di dalam direktori kerja. Ketika Claude Code tidak dapat menyelesaikan lokasi itu, 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 harus dilakukan:**
+
+* Periksa bahwa jalur menyebutkan direktori nyata di dalam direktori kerja, kemudian jalankan `/add-dir` lagi
+* Pesan tidak mengubah akses file Anda; hanya melaporkan bahwa konten `.claude/` direktori tidak dimuat
+
+Sebelum v2.1.261, pesan ini juga muncul untuk setiap `/add-dir ` ketika direktori kerja berada di automount `/net/`, di mana Claude Code menolak untuk menyelesaikan jalur dengan desain; direktori baik-baik saja dan mencoba kembali tidak bisa 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. Perintah tidak menampilkan dialog kepercayaan workspace itu sendiri, jadi keluar dengan kode 1 dan menyebutkan perbaikannya:
+
+```text theme={null}
+Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
+```
+
+Di direktori home Anda pesan berbeda, karena dialog kepercayaan workspace tidak pernah menyimpan kepercayaan untuk direktori home, jadi 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).
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `claude` di direktori, terima [dialog kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust), kemudian jalankan `claude remote-control` lagi
+* Di direktori home Anda, ubah ke direktori proyek dan mulai Remote Control di sana
+
+
+ Tidak dibawa ke sesi yang Remote Control mulai
+
+
+Anda memulai [Remote Control](/docs/id/remote-control) dengan flag `claude` global sebelum verba `remote-control`, yang akan membatasi atau mengonfigurasi sesi yang Remote Control mulai, seperti `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools`, atau `--mcp-config`. Flag yang ditempatkan sebelum verba tidak pernah mencapai sesi itu. Claude Code menolak untuk memulai sebagai gantinya, menyebutkan flag:
+
+```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 dijatuhkan, seperti `--verbose`, `--model`, atau `--session-id` yang disuntikkan wrapper atau `--plugin-dir`: mengabaikannya dan Remote Control dimulai.
+
+Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai aman, jadi flag yang ditambahkan dalam rilis yang lebih baru dapat muncul dalam pesan ini sampai rilis yang lebih baru menandainya aman.
+
+**Yang harus dilakukan:**
+
+* Hapus flag dari sebelum verba dan berikan [opsi Remote Control sendiri](/docs/id/remote-control#start-a-remote-control-session) setelahnya; `claude remote-control --help` mencantumnya
+* Ketika flag yang ditolak adalah `--permission-mode`, jalankan `claude remote-control --permission-mode ` untuk mengatur mode izin untuk sesi yang Remote Control mulai
+
+Sebelum v2.1.248, `claude remote-control` tidak menerima flag-nya sendiri ketika flag global datang terlebih dahulu, dan perintah gagal dengan kesalahan `unknown option`.
+
+
+ claude import belum tersedia dalam build ini
+
+
+Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands), dan Claude Code menemukan alur impor dimatikan, jadi perintah keluar dengan kode 1 alih-alih memulai impor. Sebelum v2.1.222, build dengan alur impor mati 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 flag fitur yang diambilnya dari Anthropic dan disimpan di disk. Pesan ini berarti nilai yang disimpan mati. Penyebabnya biasanya salah satu dari berikut:
+
+* Anda belum memulai sesi sejak instalasi, jadi Claude Code belum mengambil flag. `claude import` pertama dapat mencetak ini bahkan ketika fitur tersedia untuk Anda.
+* Anda menggunakan Claude Code melalui Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform di AWS, atau melalui [gateway aplikasi Claude](/docs/id/claude-apps-gateway#availability-and-limitations). Claude Code tidak mengambil flag fitur dalam sesi ini, jadi `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 flag fitur, jadi `claude import` tetap tidak tersedia.
+
+**Yang harus dilakukan:**
+
+* Pada instalasi segar, mulai `claude`, tunggu sesi dimuat, keluar, dan jalankan `claude import` lagi
+* Di mana pengambilan flag fitur tetap mati, atur konfigurasi sendiri: tambahkan server MCP dengan [`claude mcp add`](/docs/id/mcp#installing-mcp-servers), dan buat [`CLAUDE.md` files](/docs/id/memory#how-claude-md-files-load), [skills dan commands](/docs/id/skills#where-skills-live), dan [subagents](/docs/id/sub-agents#choose-the-subagent-scope) yang ingin Anda bawa. Pesan juga menyebutkan `~/.claude/settings.json`. Dari konfigurasi yang `claude import` bawa, file itu 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) sementara Claude Code tidak dapat menguraikan `~/.claude.json`, file tempat menyimpan login dan status per-proyek Anda. Subperintah membaca file itu untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang ditampilkan sesi interaktif, jadi 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.
+
+```text theme={null}
+Could not read Claude Code config — run `claude` with no arguments to recover it.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `claude` tanpa argumen. Claude Code mendeteksi file yang tidak valid dan menawarkan untuk mengatur ulangnya. Kemudian jalankan `claude import` lagi.
+* Untuk menyimpan edit manual yang Anda buat, perbaiki sintaks JSON di `~/.claude.json` di editor sebagai gantinya, kemudian jalankan kembali `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 masih mengimpor server yang dipilih lainnya dan mencetak satu baris per server yang tidak dapat ditambahkan. Sebelum v2.1.205, server pertama yang gagal menghentikan impor dan tidak ada server yang dipilih ditambahkan.
+
+```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 memungkinkan karakter dalam nama server, seperti spasi dan titik, yang `claude mcp` batasi ke huruf, angka, tanda hubung, dan garis bawah. Alasan lain termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh [kebijakan MCP](/docs/id/managed-mcp) organisasi Anda.
+
+**Yang harus dilakukan:**
+
+* Ubah nama server di `claude_desktop_config.json` untuk hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, kemudian jalankan `claude mcp add-from-claude-desktop` lagi
+* Tambahkan server itu langsung dengan `claude mcp add` atau `claude mcp add-json` di bawah nama yang valid. Lihat [Import MCP servers from Claude Desktop](/docs/id/mcp#import-mcp-servers-from-claude-desktop).
+
+
+ Tidak dapat menambahkan server MCP ke cakupan yang dikelola
+
+
+Anda menjalankan `claude mcp add` atau `claude mcp add-json` dengan `--scope managed`. Cakupan itu menyimpan server yang organisasi Anda sediakan melalui pengaturan yang dikelola [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers). Claude Code membacanya dari pengaturan yang dikelola saja, jadi perintah tidak dapat menulis server ke cakupan itu.
+
+```text theme={null}
+Cannot add MCP server to scope: managed
+```
+
+**Yang harus dilakukan:**
+
+* Tambahkan server ke cakupan yang dapat Anda tulis: `local`, `user`, atau `project`. Tanpa `--scope`, perintah menggunakan `local`. Lihat [MCP installation scopes](/docs/id/mcp#mcp-installation-scopes)
+* Untuk menyediakan server kepada setiap pengguna di organisasi Anda, tambahkan ke [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) dalam pengaturan yang dikelola yang Anda sebarkan
+
+
+ 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`, menemukan bahwa file di direktori saat ini bukan file biasa atau lebih besar dari 2 MiB, jadi 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` membiarkan perintah menunggu selamanya tanpa output, dan symlink ke file perangkat seperti `/dev/zero` menumbuhkan memori sampai proses dibunuh.
+
+**Yang harus dilakukan:**
+
+* Periksa apa yang duduk di `.mcp.json` di direktori saat ini. Ganti dengan file JSON biasa dalam [format cakupan proyek](/docs/id/mcp#project-scope), atau hapus, kemudian jalankan perintah lagi.
+
+
+ Server adalah Anthropic-hosted dan tidak mendukung OAuth lokal
+
+
+Anda memulai sign-in untuk server MCP yang URL-nya menunjuk ke host konektor yang dihosting Anthropic yang mengautentikasi melalui penyedia identitas pihak ketiga. Host ini termasuk `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com`, dan `gcal.mcp.claude.com`. Claude Code menolak untuk memulai alur OAuth lokal untuk host ini dari panel `/mcp` dan `claude mcp login`, karena [sign-in mereka 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.
+```
+
+Claude Code mencocokkan host ini berdasarkan URL, jadi pesan muncul ketika server yang Anda tambahkan dengan `claude mcp add` atau di `.mcp.json` menunjuk ke salah satunya.
+
+**Yang harus dilakukan:**
+
+* Hapus entri Anda dengan `claude mcp remove `, sehingga tidak dapat 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 MCP yang [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication)-nya memasok header `Authorization` menjawab koneksi dengan HTTP 401 atau 403, jadi Claude Code melaporkan koneksi sebagai gagal. Karena helper memasok header `Authorization`, Claude Code [tidak kembali ke OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers) untuk server:
+
+```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 kembali helper pada setiap upaya koneksi, jadi retry setelah penolakan sementara, seperti perlombaan rotasi token, dapat berhasil dengan kredensial segar.
+
+**Yang harus dilakukan:**
+
+* Jalankan perintah `headersHelper` sendiri dengan cara Claude Code menjalankannya: dari [direktori Claude Code menjalankannya](/docs/id/mcp#where-the-helper-runs), dengan [variabel lingkungan Claude Code mengaturnya](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), dan tanpa [variabel kredensial Claude Code menghapusnya](/docs/id/mcp#which-variables-a-helper-can-read) untuk server dari `.mcp.json` proyek, plugin, atau file agen proyek. Periksa bahwa itu mencetak nilai `Authorization` yang titik akhir server terima
+* 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 memasok header `Authorization`. Penemuan itu dapat gagal dengan `Incompatible auth server: does not support dynamic client registration` alih-alih melaporkan kredensial yang ditolak.
+
+
+
+Alat yang Anda berikan ke [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) tidak ada di antara alat MCP yang terhubung ketika run pertama kali memerlukan keputusan izin, baik karena server-nya tidak pernah terhubung atau karena tidak ada server yang terhubung yang mengekspos alat dengan nama itu. Claude Code masih mengirimkan prompt Anda: run [non-interaktif](/docs/id/headless) keluar dengan kesalahan ini, dan kode keluar 1, pada panggilan alat pertama yang memerlukan persetujuan, jadi tidak menghasilkan jawaban meskipun permintaan dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per-server 30 detik yang ditetapkan oleh [`MCP_TIMEOUT`](/docs/id/env-vars) untuk server itu terhubung. Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, jadi server yang lambat dimulai tetapi sehat menghasilkan kesalahan ini juga.
+
+```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 alat MCP yang terhubung ketika tunggu berakhir.
+
+**Yang harus dilakukan:**
+
+* Periksa bahwa server dimulai dan tetap terhubung: jalankan `claude mcp list` di direktori yang sama dan konfirmasi server terdaftar sebagai terhubung
+* Konfirmkan nama alat cocok dengan nama `mcp____` yang server ekspos
+* Jika server memerlukan lebih lama 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 pendengar lokal untuk menerima callback sign-in. Jika port yang pendengar itu butuhkan dipegang oleh proses lain, sign-in gagal dengan pesan ini. Ini sebagian besar terjadi dengan [port callback tetap](/docs/id/mcp#use-a-fixed-oauth-callback-port) yang ditetapkan 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 :` sebagai gantinya.
+
+**Yang harus dilakukan:**
+
+* Jalankan perintah dari pesan untuk menemukan proses yang memegang port, dan hentikan atau tunggu selesai
+* Jika program lain memerlukan port itu secara permanen, daftarkan URI pengalihan berbeda dengan server dan atur port-nya dengan `MCP_OAUTH_CALLBACK_PORT` atau `--callback-port`, mana pun yang Anda gunakan
+* Kemudian mulai sign-in lagi, misalnya dengan memilih server di `/mcp`
+
+
+ Tidak ada port yang tersedia untuk pengalihan OAuth
+
+
+Ketika Anda masuk ke server MCP jarak jauh dengan [OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers), Claude Code memulai pendengar lokal untuk menerima callback sign-in. Sign-in gagal dengan pesan ini ketika Claude Code tidak dapat mengikat port lokal untuk itu. Sesuatu di mesin mencegah mendengarkan di `127.0.0.1`, misalnya perangkat lunak keamanan atau kebijakan sandbox yang menolak pendengar lokal.
+
+```text theme={null}
+No available ports for OAuth redirect
+```
+
+Sebelum v2.1.268, Claude Code tidak kembali ke port yang ditugaskan sistem operasi, jadi pesan juga muncul ketika hanya port yang dipilih sendiri tidak dapat diikat. Itu dapat terjadi pada host Windows di mana Hyper-V memesan rentang port yang mencakup port yang Claude Code pilih dari.
+
+**Yang harus 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
+* Kemudian mulai sign-in lagi, misalnya dengan memilih server di `/mcp`
+
+
+ /security-review gagal tanpa origin/HEAD
+
+
+[`/security-review`](/docs/id/commands#all-commands) membangun konteks review dengan membedakan cabang Anda terhadap `origin/HEAD`, ref lokal yang mencatat cabang mana yang default di remote `origin` Anda. Ketika ref itu 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 dapat mengutip `git log` atau `git diff` berbeda sebagai gantinya. Git membuat `origin/HEAD` hanya ketika remote mengiklankan cabang default dan refspec fetch Anda mencakupnya, yang `git clone` penuh dari remote dengan commit lakukan. Ref hilang dalam setup ini:
+
+* Checkout single-branch atau CI, yang mengambil refspec terlalu sempit
+* Remote yang server-side HEAD menunjuk ke cabang yang tidak ada yang dorong
+* Repository tanpa remote `origin`, atau yang tidak pernah Anda ambil
+
+Claude Code menampilkan kesalahan yang sama untuk skill apa pun yang [menyuntikkan konteks dinamis](/docs/id/skills#when-an-injected-command-fails), dan perintah yang disuntikkan gagal membatalkan invokasi skill itu. Dua string saudara api sebelum perintah berjalan sama sekali:
+
+* `Shell command permission check failed for pattern "..."`: pemeriksaan izin perintah tidak mengizinkannya. [Permission checks on injected commands](/docs/id/skills#permission-checks-on-injected-commands) mencakup hasil mana yang membatalkan dalam setiap mode izin dan cara pra-menyetujui perintah dengan `allowed-tools`
+* ``Skill requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill menuntut bash di mesin tanpanya. Instal Git untuk Windows atau ubah frontmatter ke `shell: powershell`. Lihat [How injected commands run](/docs/id/skills#how-injected-commands-run)
+
+**Yang harus dilakukan:**
+
+* Buat ref dengan menyebutkan cabang default remote Anda: `git remote set-head origin `. Ini berfungsi kapan pun ref pelacakan lokal `origin/` ada. Jika tidak, seperti dalam klon single-branch, ambil cabang terlebih dahulu: jalankan `git remote set-branches --add origin `, kemudian `git fetch origin`, kemudian jalankan kembali perintah set-head. Jalankan kembali `/security-review`.
+* Jika Anda lebih suka tidak menyebutkan cabang, jalankan `git fetch origin` dan kemudian `git remote set-head origin --auto`, yang menanyakan remote cabang mana yang default-nya. Gagal dengan `error: Cannot determine remote HEAD` ketika remote tidak mengiklankan cabang default, karena kosong atau HEAD-nya menunjuk ke cabang yang tidak ada yang dorong; sebutkan cabang secara eksplisit sebagai gantinya. Gagal dengan `error: Not a valid ref` ketika klon Anda tidak mengambil cabang itu; perluas refspec seperti di atas terlebih dahulu.
+* Jika repository tidak memiliki remote, tambahkan dengan `git remote add origin ` dan ambil sebelum membuat ref. Jika remote kosong, dorong cabang Anda terlebih dahulu dengan `git push -u origin HEAD` dan sebutkan cabang itu dalam perintah set-head; `origin/HEAD` kemudian menunjuk ke cabang yang baru saja Anda dorong, jadi `/security-review` melihat diff kosong sampai cabang menyimpang darinya.
+
+
+
+`claude` telanjang memerlukan stdout menjadi terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal nyata, seperti PowerShell ISE dan beberapa panel output IDE, `claude` berjalan [non-interaktif](/docs/id/headless) sebagai gantinya. Itu adalah mode yang sama dengan `claude -p`, yang memerlukan prompt, jadi pesan menyebutkan `--print` bahkan ketika Anda tidak melewatkan flag. Melewatkan `-p`/`--print` tanpa prompt dan tidak ada yang disalurkan di 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 harus dilakukan:**
+
+* Untuk penggunaan interaktif, jalankan `claude` di terminal nyata: Windows Terminal atau konsol PowerShell daripada ISE, dan terminal terintegrasi IDE Anda daripada panel output
+* Untuk penggunaan satu kali, berikan prompt: `claude -p "your question"`, atau salurkan dengan `echo "your question" | claude -p`
+
+
+
+Dalam [mode non-interaktif](/docs/id/headless), Claude Code menolak prompt yang terdiri sepenuhnya dari spasi, tab, atau baris baru alih-alih mengirimnya, karena API menolak pesan tanpa teks yang terlihat. Pesan mana yang Anda lihat tergantung di mana prompt kosong berasal:
+
+* **Argumen prompt atau stdin yang disalurkan 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 berjalan**: Claude Code mengakhiri giliran tanpa memanggil model dan sesi tetap dapat digunakan. Penolakan tiba sebagai pesan informatif 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 whitespace-only ke API, yang menolak permintaan dengan kesalahan 400.
+
+**Yang harus dilakukan:**
+
+* Sertakan teks yang terlihat dalam prompt. Jika skrip membangun prompt dari variabel atau file, periksa bahwa sumber tidak kosong sebelum memanggil Claude Code.
+
+
+
+Program Anda mengirim lebih dari 268.435.456 karakter di stdin tanpa baris baru ke run `claude -p --input-format stream-json`, jadi Claude Code mencetak kesalahan ini ke stderr dan keluar dengan kode 1 alih-alih membuffer input lebih lanjut. Pesan menyatakan anggaran itu sebagai `256M`. Sebelum v2.1.257, Claude Code membuffer input seperti itu tanpa batas, menumbuhkan memori sampai proses mogok atau dibunuh.
+
+```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 produsen bukan produsen stream-json sama sekali, seperti file biner atau output log biasa yang disalurkan secara tidak sengaja. Pesan tunggal di atas anggaran gagal pemeriksaan yang sama.
+
+**Yang harus dilakukan:**
+
+* Periksa apa yang disalurkan ke stdin. Dengan [`--input-format stream-json`](/docs/id/cli-reference#cli-flags), setiap pesan harus satu baris JSON yang diakhiri baris baru
+* Untuk mengirim teks biasa sebagai gantinya, lepaskan `--input-format stream-json`; `claude -p` membaca prompt teks biasa dari stdin secara default
+
+
+ Perintah tidak dikenal
+
+
+Dalam sesi terminal interaktif, Anda mengirimkan nama `/` yang tidak cocok dengan perintah apa pun dalam sesi ini, jadi Claude Code melaporkan nama alih-alih menjalankan apa pun:
+
+```text theme={null}
+Unknown command: /hepl. Did you mean /help?
+```
+
+Claude Code menyarankan nama perintah atau alias terdekat yang menu daftar dalam sesi ini. Ketika tidak ada yang dekat, pesan berakhir setelah nama. Penyebabnya biasanya salah satu dari berikut:
+
+* Typo, seperti `/hepl` untuk `/help`. [How the command menu matches what you type](/docs/id/commands#how-the-command-menu-matches-what-you-type) mencakup memilih kecocokan dekat sebelum Anda kirimkan
+* Perintah yang ada tetapi tidak tersedia dalam sesi ini karena persyaratan tidak terpenuhi, seperti platform, rencana, 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) memandu dua kasus umum. Beberapa perintah menjawab dengan pesan mereka 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) atau [server MCP](/docs/id/mcp#use-mcp-prompts-as-commands) yang tidak diinstal atau terhubung dalam sesi ini
+
+Claude Code menjawab nama `/` yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Dalam setiap sesi lain, mengirimkan prompt ke Claude sebagai pesan normal sebagai gantinya, dengan catatan bahwa perintah tidak berjalan dan daftar perintah Claude dapat jalankan dalam sesi. Sesi itu termasuk:
+
+* run `-p`
+* Aplikasi [Agent SDK](/docs/id/agent-sdk/overview)
+* Tab Kode dari [Desktop app](/docs/id/desktop)
+* Panel chat dari [VS Code extension](/docs/id/vs-code)
+* [Sesi cloud](/docs/id/claude-code-on-the-web) dan [routines](/docs/id/routines)
+
+Untuk perintah bawaan yang tidak dapat berjalan dalam salah satu sesi itu, Claude Code masih menjawab bahwa perintah tidak tersedia alih-alih mengirimnya ke Claude. Sebelum v2.1.274, hanya sesi cloud dan routines yang mengirimkan nama yang tidak cocok ke Claude. Sebelum v2.1.273, mereka menjawab `Unknown command` juga.
+
+Claude Code tidak memperlakukan setiap prompt yang dimulai dengan `/` sebagai perintah. Mengirimkan prompt ke Claude sebagai pesan normal ketika kata pertama setelah `/` dimulai dengan tanda baca, seperti `/--` yang membuka komentar doc Lean, atau adalah jalur seperti `/var/log/syslog`.
+
+Sebelum v2.1.236, jika Anda menekan `Enter` sementara menu perintah mencantumkan kecocokan dekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan itu, jadi typo seperti `/hepl` menjalankan `/help` alih-alih menghasilkan pesan ini.
+
+**Yang harus dilakukan:**
+
+* Jalankan nama yang disarankan, atau ketik `/` diikuti bagian dari nama untuk melihat apa yang tersedia dalam sesi ini
+* Jika Claude Code melaporkan perintah yang didokumentasikan sebagai tidak dikenal, periksa barisnya dalam [referensi perintah](/docs/id/commands) untuk persyaratan yang disebutkan
+
+
+ Diff terlalu besar untuk ultrareview
+
+
+Diff antara cabang Anda dan cabang dasar, termasuk perubahan yang tidak berkomitmen dan staged, melebihi batas ukuran untuk [ultrareview](/docs/id/ultrareview), jadi `/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 berkontribusi paling banyak baris yang berubah. Sebelum v2.1.216, pesan menampilkan hanya 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.
+```
+
+Meninjau pull request menerapkan batas yang sama; bentuk pesan itu dimulai `PR # is too large for ultrareview` dan menyebutkan file dan jumlah baris PR.
+
+**Yang harus dilakukan:**
+
+* Berikan cabang dasar yang lebih dekat ke pekerjaan Anda, seperti `/code-review ultra develop`, jadi review mencakup hanya diff terhadap cabang itu
+* Pisahkan perubahan menjadi cabang yang lebih kecil dan tinjau masing-masing. File yang pesan sebutkan berkontribusi paling banyak baris yang berubah, jadi mulai dengan memindahkan itu ke cabang mereka sendiri.
+
+
+ Tidak dapat menemukan merge-base dengan cabang dasar
+
+
+`/code-review ultra` dan subperintah `claude ultrareview` meninjau diff antara cabang Anda dan cabang dasar, yang memerlukan komitmen yang keduanya bagikan. Ketika `git merge-base` tidak menemukan apa pun, Claude Code menolak review sebelum sesi cloud dimulai. Pada klon Claude Code dapat verifikasi lengkap, dengan setidaknya satu cabang, itu kembali ke [meninjau setiap file yang dilacak](/docs/id/ultrareview#diff-limits-and-fallbacks) alih-alih menolak. Anda melihat penolakan ini ketika cabang dasar tidak dapat ditemukan sama sekali, ketika Claude Code tidak dapat memverifikasi bahwa klon Anda lengkap, atau di repository langka di mana diff seluruh pohon tidak mungkin, 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 tergantung pada apa yang Claude Code amati:
+
+* **Anda tidak melewatkan cabang dasar**: Claude Code dibandingkan terhadap cabang default repository dan menyarankan melewatkan dasar Anda secara eksplisit, seperti dalam contoh di atas
+* **Anda melewatkan cabang dasar yang sudah ada di klon Anda**: petunjuk membaca ``Make sure exists locally or on origin (try `git fetch origin `)``
+* **Anda melewatkan cabang dasar yang tidak ada di klon Anda**: Claude Code mengambilnya dari origin sebelum membandingkan. Petunjuk membaca `` 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 mengatakan apakah klon Anda dangkal, itu menyarankan `git fetch --unshallow origin` sebagai gantinya. Sebelum v2.1.221, petunjuk menyarankan `git fetch --unshallow origin` untuk setiap cabang dasar yang diambil, dan pada klon lengkap perintah itu gagal dengan `fatal: --unshallow on a complete repository does not make sense`.
+
+**Yang harus dilakukan:**
+
+* Jika cabang lain adalah dasar nyata Anda, berikan secara eksplisit: `/code-review ultra `
+* Jika klon Anda mungkin tidak memiliki riwayat penuh, jalankan `git fetch --unshallow origin` dan jalankan kembali review
+
+
+ Checkout Anda tidak memiliki cabang
+
+
+Checkout dapat memiliki komitmen tetapi tidak ada cabang: jika Anda menjalankan `git init` diikuti `git fetch ` dan `git checkout FETCH_HEAD`, Anda mendapatkan HEAD terlepas dengan tidak ada refs. Claude Code mengemas repository Anda sebagai bundel git untuk mengunggahnya untuk [ultrareview](/docs/id/ultrareview), dan tidak dapat membundel repository yang tidak memiliki cabang atau refs lainnya, jadi `/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 meninjau setiap file yang dilacak dalam checkout ini, dan unggahan gagal.
+
+**Yang harus dilakukan:**
+
+* Buat cabang di komitmen saat ini Anda dengan `git checkout -b `, kemudian jalankan kembali 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 server apakah [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) dapat menjangkau repository PR. Tidak ada akun yang terhubung, atau koneksi kedaluwarsa, jadi klon cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan 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 harus 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 kembali review satu menit setelah terhubung
+
+Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.
+
+
+ Akun GitHub yang terhubung Anda tidak dapat melihat repository
+
+
+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 repository PR, jadi klon cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan 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 harus dilakukan:**
+
+* Jika CLI `gh` lokal Anda dapat membaca repository, jalankan `/web-setup` untuk menghubungkan login itu ke akun Claude Anda
+* Jalankan kembali review setelah perubahan
+
+Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.
+
+
+ Preflight GitHub App gagal secara sementara
+
+
+Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repository lokal, dan dua langkah gagal bersama-sama. Claude Code tidak dapat membangun atau mengunggah bundel repository Anda. Sebelum unggahan, itu memeriksa apakah layanan cloud dapat mengklon repository dari GitHub, dan daripada jawaban pasti, pemeriksaan itu berakhir dalam kesalahan yang retry dapat bersihkan, seperti kesalahan jaringan, timeout, atau kesalahan server sementara. Pesan lengkap dimulai dengan apa yang menghentikan bundel, misalnya `Could not upload repo bundle ()`, dan berakhir 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 harus dilakukan:**
+
+* Jalankan kembali perintah setelah beberapa saat. Ketika pemeriksaan GitHub lulus, Claude Code dapat memulai sesi dari klon GitHub, jadi unggahan yang gagal tidak lagi memblokir peluncuran
+* Jika retry terus gagal, awal pesan menyebutkan apa yang menghentikan unggahan. Ketika penyebab itu adalah sesuatu yang dapat Anda perbaiki, perbaiki sehingga sesi dapat dimulai dari repository lokal Anda sebagai gantinya
+
+Sebelum v2.1.251, Claude Code mengakhiri pesan dengan `Please set up GitHub on https://claude.ai/code` bahkan ketika pemeriksaan GitHub gagal hanya secara sementara, dan saran setup tidak dapat membersihkan kegagalan sementara.
+
+
+ GitHub tidak terhubung ke akun Claude Anda
+
+
+Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repository lokal Anda, misalnya dengan `/autofix-pr`. Tidak ada akun GitHub yang terhubung ke akun Claude Anda, atau koneksi kedaluwarsa, jadi 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 setup yang menyebutkan repository; catatan tidak memblokir pembuatan routine.
+
+**Yang harus 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 [GitHub authentication options](/docs/id/claude-code-on-the-web#github-authentication-options) untuk bagaimana keduanya berbeda.
+* Jalankan kembali perintah satu menit setelah terhubung
+
+Sebelum v2.1.268, Claude Code melaporkan ini sebagai kegagalan sementara pemeriksaan Claude GitHub App dan menyarankan retry atau menginstal aplikasi; tidak satupun menghubungkan akun GitHub.
+
+
+ Otorisasi single sign-on diperlukan
+
+
+Anda menjalankan [`/install-github-app`](/docs/id/github-actions#quick-setup) dan memilih repository yang organisasinya memberlakukan SAML single sign-on. Sebelum setup, Claude Code memeriksa akses Anda ke repository dengan CLI GitHub, dan GitHub menolak pemeriksaan itu karena token `gh` Anda belum diotorisasi untuk organisasi itu. Wizard menampilkan peringatan dengan 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 harus dilakukan:**
+
+* Otorisasi kembali login GitHub CLI Anda dengan cakupan `repo` dan `workflow` dengan menjalankan `gh auth refresh -h github.com -s repo,workflow`, dan otorisasi organisasi ketika GitHub meminta single sign-on
+* Jika Anda mengautentikasi dengan token akses pribadi di `GH_TOKEN`, buka [github.com/settings/tokens](https://github.com/settings/tokens), pilih **Configure SSO** pada token, dan otorisasi organisasi
+* Jalankan `/install-github-app` lagi
+
+Sebelum v2.1.273, Claude Code menampilkan peringatan `Admin permissions required` untuk kondisi ini sebagai gantinya.
+
+
+ Gagal melanjutkan percakapan
+
+
+Claude Code tidak dapat membaca atau memproses transkrip yang disimpan untuk sesi yang Anda pilih dari [pemilih `claude --resume`](/docs/id/sessions#use-the-session-picker), jadi mengakhiri proses daripada melanjutkan dalam keadaan sebagian dimuat. Pesan mencakup perintah untuk retry:
+
+```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. Pemilih `/resume` di dalam sesi yang berjalan melaporkan `Failed to resume conversation` dalam percakapan sebagai gantinya, dan sesi saat ini Anda terus berjalan. Sebelum v2.1.216, resume yang gagal dari pemilih `claude --resume` tetap di spinner `Resuming conversation…` tanpa batas waktu alih-alih menampilkan pesan ini.
+
+**Yang harus dilakukan:**
+
+* Jalankan `claude --resume ` dengan ID sesi dari pesan untuk retry
+* Jika retry gagal lagi, jalankan `claude` untuk memulai sesi baru
+
+
+ Tidak ada percakapan yang ditemukan dengan ID sesi
+
+
+Anda melewatkan ID sesi ke `claude --resume ` dan tidak ada transkrip yang disimpan cocok:
+
+```text theme={null}
+No conversation found with session ID:
+```
+
+Claude Code keluar dengan kode 1 setelah menampilkan pesan. Claude Code [mencari proyek saat ini terlebih dahulu, kemudian setiap proyek lain di mesin ini](/docs/id/sessions#resume-a-session) untuk ID. Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan worktree git-nya, jadi resume dari direktori tempat sesi terakhir bekerja.
+
+Penyebab umum:
+
+* **ID yang salah ketik**: untuk run non-interaktif, ID adalah bidang `session_id` dari output [`--output-format json`](/docs/id/headless#get-structured-output)
+* **Transkrip yang dihapus**: 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 resume sesi di mesin tempat itu berjalan
+* **Salinan duplikat**: jika Anda menyalin direktori proyek di bawah `~/.claude/projects` sehingga dua transkrip membawa ID yang sama, Claude Code melaporkan pesan ini daripada resume satu salinan secara sewenang-wenang
+
+**Yang harus dilakukan:**
+
+* Untuk sesi interaktif, buka [pemilih sesi](/docs/id/sessions#use-the-session-picker) dengan `claude --resume` dan tekan `Ctrl+A` untuk memperluas ke setiap proyek di mesin ini, kemudian pilih sesi
+* Sesi yang dibuat dengan `claude -p` atau [Agent SDK](/docs/id/agent-sdk/overview) tidak muncul dalam pemilih, jadi periksa kembali ID terhadap `session_id` yang run asli Anda cetak
+
+
+ Tidak dapat mengganti renderer dalam sesi ini
+
+
+Ketika Anda mengganti renderer, Claude Code memulai ulang prosesnya. Anda menjalankan [`/tui`](/docs/id/fullscreen#enable-fullscreen-rendering) dalam sesi Claude Code menolak untuk memulai ulang, jadi tidak mengganti dan menyimpan apa pun. Pesan mana yang Anda lihat memberi tahu Anda penyebabnya:
+
+* `Cannot switch renderers while work is running in the background`: Anda memiliki pekerjaan latar belakang yang berjalan yang restart akan meninggalkan, seperti shell latar belakang atau subagen. Tunggu pekerjaan selesai atau hentikan dengan [`/tasks`](/docs/id/commands), kemudian jalankan `/tui fullscreen` atau `/tui default` lagi
+* `Cannot switch renderers in this session`: sesi memiliki pembatasan Claude Code tidak dapat lulus ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code memulai ulang bagaimanapun dan sesi yang diluncurkan kembali berjalan tanpanya
+
+Dalam pesan pembatasan, bagian dalam tanda kurung menyebutkan pembatasan Claude Code temukan:
+
+```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 pesan dapat tunjukkan dalam tanda kurung:
+
+* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Anda memulai sesi dengan flag Claude Code tidak lulus kembali ke proses yang dimulai ulang. Flag ini termasuk [`--system-prompt`](/docs/id/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, daftar 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`: [pembaruan izin](/docs/id/hooks#permission-update-entries) dari hook atau pemanggil SDK menambahkan aturan deny atau ask dengan tujuan `session`. Aturan allow yang scoped sesi tidak memicu penolakan. Restart menjatuhkan mereka, dan Claude Code meminta lagi sebagai gantinya
+* `ask-before-running rules with no command-line form`: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan ask bersama aturan Claude Code lulus kembali 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 jalur direktori mid-session. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama
+
+**Yang harus dilakukan:**
+
+* Dalam sesi yang dimulai tanpa pembatasan itu, jalankan `/tui fullscreen`, atau `/tui default` untuk beralih kembali. Claude Code menyimpan pengaturan [`tui`](/docs/id/settings-reference#tui) di sana
+
+
+ /terminal-setup meninggalkan 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 ke `keymap.json` Zed Anda, jadi meninggalkannya seperti apa adanya.
+
+Setiap pesan menyebutkan jalur ke keymap Anda dan berakhir dengan blok keybinding untuk ditambahkan 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, misalnya karena izin file
+* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: file dibaca dengan baik tetapi tidak diuraikan sebagai array blok keybinding, bahkan dengan komentar `//` dan trailing comma yang diizinkan
+* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code tidak dapat menyalin file ke backup `.bak` di sebelahnya, jadi tidak mengubah apa pun
+* `Couldn't update your Zed keymap, so it was left unchanged.`: hasil yang digabung tidak memverifikasi sebagai keymap yang valid membawa keybinding, jadi Claude Code membuangnya alih-alih menulis. Blok keybinding dengan kunci yang diduplikasi dapat menyebabkan ini
+
+**Yang harus dilakukan:**
+
+* Salin blok dari pesan ke array tingkat atas di `keymap.json` Anda di jalur yang pesan sebutkan
+* Untuk `isn't a readable list of keybindings`, perbaiki kesalahan sintaks, atau buat nilai tingkat atas file menjadi array, kemudian jalankan `/terminal-setup` lagi
+
+Sebelum v2.1.247, `/terminal-setup` tidak dapat menguraikan keymap Zed yang menggunakan komentar `//` atau trailing comma, dan mengganti seluruh file dengan hanya keybinding-nya sendiri sambil melaporkan keybinding sebagai diinstal. Untuk mengembalikan keymap yang versi sebelumnya ganti, gunakan file backup `.bak` yang dijelaskan di bawah [Enter multiline prompts](/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 mengirimkan laporan penggunaan skill melalui Remote Control dan menjawab dengan pesan ini sebagai gantinya:
+
+```text theme={null}
+Skill usage reports are not available on this connection.
+```
+
+**Yang harus dilakukan:**
+
+* Jalankan `/skill-doctor` di terminal di 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 mobile atau web melalui [Remote Control](/docs/id/remote-control), atau perintah tiba dalam pesan yang disalurkan ke sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code mencantumkan dan memilih hanya [gaya bawaan](/docs/id/output-styles#built-in-output-styles) di atasnya, dan menambahkan pemberitahuan ini kapan pun perintah mencantumkan gaya atau tidak mengenali nama yang Anda berikan. Nama [gaya kustom](/docs/id/output-styles#create-a-custom-output-style) mendapat jawaban 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 harus 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