4 4
5# Справочник по ошибкам5# Справочник по ошибкам
6 6
7> Найдите сообщения об ошибках runtime Claude Code, узнайте, что они означают и как их исправить.7> Найдите сообщения об ошибках Claude Code с объяснением их значения и способов исправления.
8 8
9На этой странице перечислены ошибки runtime, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких как `command not found` или сбои TLS во время установки, см. [Troubleshoot installation and login](/docs/ru/troubleshoot-install).9На этой странице перечислены ошибки времени выполнения, которые отображает Claude Code, и способы восстановления после каждой из них, а также что проверить, когда ответы кажутся неправильными без ошибки. Для ошибок установки, таких как `command not found` или сбои TLS во время установки, см. [Устранение неполадок при установке и входе](/docs/ru/troubleshoot-install).
10 10
11Эти ошибки и команды восстановления применяются во всех интерфейсах: CLI, [Desktop app](/docs/ru/desktop) и [Claude Code on the web](/docs/ru/claude-code-on-the-web), поскольку все три используют один и тот же Claude Code CLI. Для проблем, специфичных для конкретного интерфейса, см. раздел troubleshooting на странице этого интерфейса.11За исключением [ошибок Wrapper и IDE](#wrapper-and-ide-errors), которые выводит запускающая программа, а не сам Claude Code, эти ошибки и команды восстановления применяются во всех интерфейсах: CLI, [приложении Desktop](/docs/ru/desktop) и [Claude Code в веб-версии](/docs/ru/claude-code-on-the-web), поскольку все три используют один и тот же Claude Code CLI. Для других проблем, специфичных для конкретного интерфейса, см. раздел устранения неполадок на странице этого интерфейса.
12 12
13<Note>13<Note>
14 Claude Code вызывает Claude API для получения ответов модели, поэтому большинство ошибок runtime соответствуют базовому коду ошибки API. На этой странице описано, что каждая ошибка означает в Claude Code и как восстановиться. Для определений кодов состояния HTTP в исходном виде см. [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).14 Claude Code вызывает Claude API для получения ответов модели, поэтому большинство ошибок времени выполнения соответствуют базовому коду ошибки API. На этой странице описано, что означает каждая ошибка в Claude Code и как восстановиться. Для определений кодов состояния HTTP в исходном виде см. [справочник по ошибкам платформы Claude](https://platform.claude.com/docs/en/api/errors).
15</Note>15</Note>
16 16
17<h2 id="find-your-error">17<h2 id="find-your-error">
18 Найдите вашу ошибку18 Найдите вашу ошибку
19</h2>19</h2>
20 20
21Сопоставьте сообщение, которое вы видите в терминале, с разделом ниже.21Сопоставьте сообщение, которое вы видите, с разделом ниже.
22 22
23| Сообщение | Раздел |23| Сообщение | Раздел |
24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |24| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Server errors](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Server errors](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api), если сообщение упоминает вашу интернет-соединение |27| `Request timed out` | [Server errors](#request-timed-out), или [Network](#unable-to-connect-to-api) если сообщение упоминает вашу интернет-соединение |
28| `API Error: No response from API` | [Server errors](#no-response-from-api) |
28| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |29| `Server error mid-response. The response above may be incomplete.` | [Server errors](#the-response-above-may-be-incomplete) |
30| `Connection lost mid-response` / `Your computer went to sleep mid-response` / `The response stopped arriving` | [Server errors](#the-response-above-may-be-incomplete) |
29| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |31| `Connection closed mid-response` / `Response stalled mid-stream` | [Server errors](#the-response-above-may-be-incomplete) |
32| `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) |
33| `Connection closed while thinking` / `Response stalled while thinking` | [Automatic retries](#automatic-retries) |
34| `Connection lost while your computer was asleep` | [Automatic retries](#automatic-retries) |
30| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |35| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
31| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |36| `Auto mode could not evaluate this action and is blocking it for safety` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
32| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |37| `Auto mode classifier transcript exceeded context window` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
38| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [Server errors](#auto-mode-cannot-determine-the-safety-of-an-action) |
33| `Agent terminated early due to an API error` | [Server errors](#agent-terminated-early-due-to-an-api-error) |39| `Agent terminated early due to an API error` | [Server errors](#agent-terminated-early-due-to-an-api-error) |
34| `You've hit your session limit` / `You've hit your weekly limit` | [Usage limits](#youve-hit-your-session-limit) |40| `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) |
35| `Usage credits required for 1M context` | [Usage limits](#usage-credits-required-for-1m-context) |41| `Usage credits required for 1M context` | [Usage limits](#usage-credits-required-for-1m-context) |
42| `the prompt to confirm went unanswered — nothing was sent` | [Usage limits](#the-prompt-to-confirm-went-unanswered) |
36| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |43| `Server is temporarily limiting requests` | [Usage limits](#server-is-temporarily-limiting-requests) |
37| `Request rejected (429)` | [Usage limits](#request-rejected-429) |44| `Request rejected (429)` | [Usage limits](#request-rejected-429) |
38| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |45| `Credit balance is too low` | [Usage limits](#credit-balance-is-too-low) |
46| `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) |
47| `Could not update your spend limit` | [Usage limits](#could-not-update-your-spend-limit) |
48| `spend limit reached` / `spend limit unavailable` | [Usage limits](#spend-limit-reached) |
39| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |49| `Not logged in · Please run /login` | [Authentication](#not-logged-in) |
40| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |50| `Could not resolve authentication method` | [Authentication](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Authentication](#invalid-api-key) |51| `Invalid API key` | [Authentication](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |52| `Your apiKeyHelper script is failing` | [Authentication](#your-apikeyhelper-script-is-failing) |
53| `Invalid auth token · Fix external auth token` | [Authentication](#invalid-request-header-value) |
54| `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
55| `Invalid request header from the environment · Fix the environment variable` | [Authentication](#invalid-request-header-value) |
43| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |56| `This organization has been disabled` | [Authentication](#this-organization-has-been-disabled) |
44| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |57| `Your organization has disabled API key authentication` | [Authentication](#your-organization-has-disabled-api-key-authentication) |
45| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |58| `Your organization has disabled Claude subscription access` | [Authentication](#your-organization-has-disabled-claude-subscription-access) |
46| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |59| `Routines are disabled by your organization's policy` | [Authentication](#routines-are-disabled-by-your-organizations-policy) |
47| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |60| `Remote Control is only available when using Claude via api.anthropic.com` | [Authentication](#remote-control-requires-the-anthropic-api) |
61| `OAuth token refresh failed — run /login to re-authenticate` | [Authentication](#remote-control-couldnt-refresh-your-login) |
62| `JWT refresh failed: no OAuth token — run /login` | [Authentication](#remote-control-couldnt-refresh-your-login) |
63| `Claude.ai login expired` | [Authentication](#remote-control-couldnt-refresh-your-login) |
64| `Claude.ai login was rejected — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
65| `OAuth token unavailable — run /login to restore Remote Control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
66| `Signed out of Claude — run /login, then /remote-control` | [Authentication](#remote-control-couldnt-refresh-your-login) |
67| `signed-in claude.ai account or organization changed on this machine` | [Authentication](#remote-control-stopped-because-the-signed-in-account-changed) |
68| `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) |
69| `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) |
48| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |70| `OAuth token revoked` / `OAuth token has expired` | [Authentication](#oauth-token-revoked-or-expired) |
71| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
49| `Login expired · Please run /login` | [Authentication](#login-expired) |72| `Login expired · Please run /login` | [Authentication](#login-expired) |
73| `Not signed in to the Cloud gateway — run /login.` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
74| `Administrator policy requires a Cloud gateway sign-in on this machine` | [Authentication](#administrator-policy-requires-a-cloud-gateway-sign-in) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |75| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Authentication](#login-expired) |
76| `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) |
77| `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) |
78| `Anthropic profile login expired · Re-authenticate your Anthropic profile` | [Authentication](#anthropic-profile-login-expired) |
79| `Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile` | [Authentication](#anthropic-profile-login-expired) |
51| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |80| `does not meet scope requirement user:profile` | [Authentication](#oauth-scope-requirement) |
81| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
82| `Issuer mismatch in authorization response (RFC 9207)` | [Authentication](#issuer-mismatch-in-authorization-response) |
83| `Cloud gateway session expired — run /login to reconnect.` | [Authentication](#cloud-gateway-session-expired) |
84| `Cloud gateway <url> no longer accepts this session` | [Authentication](#cloud-gateway-session-expired) |
52| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |85| `AWS credentials expired or invalid` | [Authentication](#aws-credentials-expired-or-invalid) |
53| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |86| `AWS authentication failed` | [Authentication](#aws-authentication-failed) |
87| `Could not load AWS credentials` / `Could not load Google Cloud credentials` | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
54| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |88| `AWS default-chain credential resolve timed out` | [Authentication](#aws-default-chain-credential-resolve-timed-out) |
89| `Timed out after 60s waiting for AWS` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
90| `A request to AWS timed out. Check your network and proxy settings, then try again.` | [Authentication](#bedrock-setup-verification-timed-out-waiting-for-aws) |
91| `Could not load the default credentials` on Google Cloud's Agent Platform | [Authentication](#could-not-load-aws-or-google-cloud-credentials) |
55| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |92| `Unable to connect to API` | [Network](#unable-to-connect-to-api) |
56| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), или [Network](#unable-to-connect-to-api), если это продолжается |93| `Connection refused —` / `Can't reach the API server —` / `No internet route —` / `Couldn't connect through your proxy` / `Connection dropped`, each ending with an error code in parentheses | [Network](#unable-to-connect-to-api) |
94| `Unable to connect to Anthropic services` during setup | [Network](#unable-to-connect-to-anthropic-services) |
95| `Socket is closed` | [Network](#socket-is-closed) |
96| `Waiting for API response · will retry in` | [Automatic retries](#automatic-retries), или [Network](#unable-to-connect-to-api) если это продолжается |
97| `API returned an empty or malformed response` | [Network](#api-returned-an-empty-or-malformed-response) |
98| `Streaming response ended before any complete data was received` | [Network](#streaming-response-ended-before-any-complete-data-was-received) |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |99| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Network](#bedrock-streaming-response-has-an-unexpected-content-type) |
58| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |100| `SSL certificate verification failed` | [Network](#ssl-certificate-errors) |
59| `SSL certificate error (...)` during login or startup | [Network](#ssl-certificate-errors) |101| `SSL certificate error (...)` during login or startup | [Network](#ssl-certificate-errors) |
102| `unable to get local issuer certificate` | [Network](#ssl-certificate-errors) |
60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |103| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Network](#host-not-allowed-in-a-cloud-session) |
104| `proxy refused the connection` | [Network](#the-proxy-refused-the-connection) |
105| `403` with `This GraphQL query is not enabled for this session` in a cloud session | [GitHub proxy](/docs/ru/cloud-environments#github-proxy) |
106| `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) |
61| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |107| `Couldn't reconnect to your Remote Control session` | [Network](#couldnt-reconnect-to-your-remote-control-session) |
62| `Prompt is too long` | [Request errors](#prompt-is-too-long) |108| `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) |
109| `Couldn't share the transcript.` | [Network](#couldnt-share-the-transcript) |
110| `Prompt is too long` / `Input is too long for requested model` | [Request errors](#prompt-is-too-long) |
111| `Prompt is too long · automatic compaction failed:` | [Request errors](#prompt-is-too-long) |
112| `Prompt is too long · this conversation is a single exchange` / `A single-exchange conversation cannot be compacted` | [Request errors](#prompt-is-too-long) |
113| `Context limit reached · /compact or /clear to continue` | [Request errors](#prompt-is-too-long) |
114| `Context limit reached · /clear to continue` | [Request errors](#prompt-is-too-long) |
115| `capability_rejected: prompt_too_long` on a Claude apps gateway session | [Request errors](#prompt-is-too-long) |
116| `upstream rejected the request` / `request too large for this upstream` on a Claude apps gateway session | [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages) |
117| `upstream rate limit exceeded` on a Claude apps gateway session | [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages) |
118| `all upstreams failed (N attempted)` on a Claude apps gateway session | [Upstream error messages](/docs/ru/claude-apps-gateway-config#upstream-error-messages) |
119| `Claude Code may not be enabled for your organization` after a Claude apps gateway sign-in | [Claude apps gateway troubleshooting](/docs/ru/claude-apps-gateway-deploy#troubleshooting) |
120| `Context exceeds the ...-token limit by ... tokens` in `/context` output | [Request errors](#context-exceeds-the-token-limit) |
63| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |121| `Error during compaction: Conversation too long` | [Request errors](#error-during-compaction-conversation-too-long) |
64| `Request too large` | [Request errors](#request-too-large) |122| `Request too large` | [Request errors](#request-too-large) |
123| `Request too large for the API's 32MB request limit` | [Request errors](#request-too-large) |
65| `Image was too large` | [Request errors](#image-was-too-large) |124| `Image was too large` | [Request errors](#image-was-too-large) |
66| `Unable to resize image` | [Request errors](#unable-to-resize-image) |125| `Unable to resize image` | [Request errors](#unable-to-resize-image) |
67| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |126| `PDF too large` / `PDF is password protected` | [Request errors](#pdf-errors) |
68| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |127| `Extra inputs are not permitted` | [Request errors](#extra-inputs-are-not-permitted) |
128| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [Request errors](#tool-input-schema-is-invalid) |
69| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |129| `There's an issue with the selected model` | [Request errors](#theres-an-issue-with-the-selected-model) |
70| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |130| `Model ... is not a recognized model id` | [Request errors](#model-is-not-a-recognized-model-id) |
131| `Model ... not found` | [Request errors](#model-not-found) |
71| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |132| `Claude Opus is not available with the Claude Pro plan` | [Request errors](#claude-opus-is-not-available-with-the-claude-pro-plan) |
133| `Claude Code ... does not support this model; version ... or newer is required` | [Request errors](#claude-code-does-not-support-this-model) |
134| `Claude Code ... is older than the minimum version required by your organization's policy` | [Request errors](#claude-code-does-not-support-this-model) |
72| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |135| `Model ... is restricted by your organization's settings` | [Request errors](#model-is-restricted-by-your-organizations-settings) |
136| `Model switch ... blocked by a PreModelSwitch hook` | [Request errors](#model-switch-was-blocked-by-a-premodelswitch-hook) |
137| `couldn't save it as your default` / `couldn't confirm it was saved as your default` | [Request errors](#couldnt-save-it-as-your-default) |
73| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |138| `thinking.type.enabled is not supported for this model` | [Request errors](#thinking-type-enabled-is-not-supported-for-this-model) |
139| `Effort '<level>' isn't available with thinking turned off on this model` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
140| `effort '<level>' is not supported when thinking is disabled` | [Request errors](#effort-isnt-available-with-thinking-turned-off) |
74| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |141| `max_tokens must be greater than thinking.budget_tokens` | [Request errors](#thinking-budget-exceeds-output-limit) |
75| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |142| `API Error: 400 due to tool use concurrency issues` | [Request errors](#tool-use-or-thinking-block-mismatch) |
143| `[Unsupported tool content removed]` | [Request errors](#unsupported-tool-content-removed) |
144| `server_tool_use.name: Input should be` on every turn of a resumed session | [Request errors](#unsupported-tool-content-removed) |
145| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
76| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |146| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
147| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
77| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |148| `<model> has safety measures that flagged this message for a cybersecurity topic` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
78| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |149| `Installation was killed before it could finish (exit code 137)` | [Installation errors](#installation-was-killed-before-it-could-finish) |
79| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |150| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
80| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |151| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
81| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |152| `--bg and --print conflict` | [Command-line errors](#command-line-errors) |
153| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
82| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |154| `Error: --json-schema is not a valid JSON Schema` | [Command-line errors](#command-line-errors) |
155| `Error: Invalid --agents configuration:` | [Command-line errors](#invalid-agents-configuration) |
156| `Error: Settings file exceeds the 2MiB limit` | [Command-line errors](#settings-file-exceeds-the-2mib-limit) |
157| `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) |
158| `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) |
159| `Error: Workspace not trusted` when starting Remote Control | [Command-line errors](#workspace-not-trusted-when-starting-remote-control) |
160| `` `<flag>` 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) |
161| `` `claude import` is not yet available in this build `` | [Command-line errors](#claude-import-is-not-yet-available-in-this-build) |
162| `Could not read Claude Code config` | [Command-line errors](#could-not-read-claude-code-config) |
83| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |163| `Could not import <server>: <reason>` | [Command-line errors](#could-not-import-a-server-from-claude-desktop) |
164| `Cannot add MCP server to scope: managed` | [Command-line errors](#cannot-add-mcp-server-to-the-managed-scope) |
165| `is Anthropic-hosted and doesn't support local OAuth` | [Command-line errors](#anthropic-hosted-and-doesnt-support-local-oauth) |
166| `Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes` | [Command-line errors](#cant-read-mcp-json) |
167| `Server rejected the Authorization header minted by the configured headersHelper` | [Command-line errors](#server-rejected-the-authorization-header-minted-by-the-configured-headershelper) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |168| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Command-line errors](#mcp-permission-prompt-tool-not-found) |
169| `OAuth callback port <port> is already in use — another process may be holding it` | [Command-line errors](#oauth-callback-port-is-already-in-use) |
170| `Shell command failed for pattern "..."`, from `/security-review` or any skill that injects dynamic context | [Command-line errors](#security-review-fails-without-origin-head) |
171| `Shell command permission check failed for pattern "..."`, from a skill that injects dynamic context | [Command-line errors](#security-review-fails-without-origin-head) |
172| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Command-line errors](#security-review-fails-without-origin-head) |
173| `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) |
174| `Error: Input contained only whitespace` | [Command-line errors](#input-contained-only-whitespace) |
175| `Blank prompt — the message was only whitespace, so nothing was sent to the model.` | [Command-line errors](#input-contained-only-whitespace) |
176| `Error: stream-json input carried over 256M characters with no newline` | [Command-line errors](#stream-json-input-carried-over-256m-characters-with-no-newline) |
177| `Unknown command: /<name>`, with or without a `Did you mean` suggestion | [Command-line errors](#unknown-command) |
178| `Diff is too large for ultrareview` / `PR #<N> is too large for ultrareview` | [Command-line errors](#diff-is-too-large-for-ultrareview) |
179| `Could not find merge-base with <branch>` | [Command-line errors](#could-not-find-merge-base-with-the-base-branch) |
180| `Your checkout has no branches (detached HEAD only)` | [Command-line errors](#your-checkout-has-no-branches) |
181| `Ultrareview clones <owner>/<repo> 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) |
182| `Your connected GitHub account can't see <owner>/<repo>` | [Command-line errors](#your-connected-github-account-cant-see-the-repository) |
183| `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) |
184| `Failed to resume the conversation` | [Command-line errors](#failed-to-resume-the-conversation) |
185| `No conversation found with session ID: <session-id>` | [Command-line errors](#no-conversation-found-with-the-session-id) |
186| `Cannot switch renderers in this session` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
187| `Cannot switch renderers while work is running in the background` | [Command-line errors](#cannot-switch-renderers-in-this-session) |
188| `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) |
189| `Your Zed keymap isn't a readable list of keybindings` | [Command-line errors](#terminal-setup-left-your-zed-keymap-unchanged) |
190| `Skill usage reports are not available on this connection.` | [Command-line errors](#skill-usage-reports-are-not-available-on-this-connection) |
191| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
85| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |192| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |193| `references ${user_config.*} in a shell-form command` | [Plugin errors](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |194| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |195| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
196| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
197| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
198| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
199| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
200| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
201| `Failed to load marketplace configuration` | [Plugin errors](#failed-to-load-marketplace-configuration) |
202| `Marketplace configuration file is corrupted` | [Plugin errors](#failed-to-load-marketplace-configuration) |
89| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |203| `would be spawned with zero tools — refusing` | [Tool errors](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |204| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
205| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
206| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
207| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
208| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
209| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
210| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
211| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
212| `Refusing to send: reply target is a symlink` / `Refusing to send: cannot vet reply target` | [Tool errors](#refusing-to-send-a-cross-session-message) |
213| `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) |
214| `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) |
215| `Refusing to send: connected endpoint is a different process with the expected pid` | [Tool errors](#refusing-to-send-a-cross-session-message) |
216| `Refusing to read <path>: its symlink resolution changed after permission was checked` / `Refusing to search <path>: its symlink resolution changed after permission was checked` | [Tool errors](#refusing-after-a-symlink-changed) |
217| `Refusing to write <path>: its parent-directory symlink resolution changed after permission was checked` / `Refusing to write <path>: it is a symbolic link. Write to the link's target path instead` | [Tool errors](#refusing-after-a-symlink-changed) |
218| `Refusing to search <path>: a path one of its Read deny rules is written through changed while the search was being prepared` / `Refusing to search <path>: it could not be opened` | [Tool errors](#refusing-after-a-symlink-changed) |
219| `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) |
220| `task output swap refused (tasks dir moved or linked)` | [Tool errors](#task-output-swap-refused) |
221| `Command killed: its output file was replaced or could no longer be verified` | [Tool errors](#task-output-swap-refused) |
222| `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) |
223| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
224| `Can't open MCP settings while no terminal is attached to this background session` | [Background session errors](#commands-refused-in-a-background-session) |
91| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |225| `Can't open MCP settings in a background session` | [Background session errors](#commands-refused-in-a-background-session) |
226| `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) |
227| `blocked because the path is network-shaped` | [Background session errors](#write-or-command-blocked-because-the-path-names-a-network-location) |
228| `This session has no saved transcript` | [Background session errors](#this-session-has-no-saved-transcript) |
229| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
230| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
231| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
232| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
233| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
234| `terminal host process died — press Enter to restart` / `This session's terminal host process died` | [Background session errors](#terminal-host-process-died) |
235| `Session isn't responding` / `Press enter again to restart this session — it isn't responding` | [Background session errors](#session-isnt-responding) |
236| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
237| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |238| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
239| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
240| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
241| `exited before it became reachable` | [Background session errors](#background-service-exited-before-it-became-reachable) |
242| `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) |
243| `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) |
244| `Claude Code process exited with code N` | [Wrapper and IDE errors](#claude-code-process-exited-with-code-n) |
245| `Could not locate the Claude CLI on PATH` | [Wrapper and IDE errors](#could-not-locate-the-claude-cli-on-path) |
246| `Restored the code, but skipped N files` | [Rewind warnings and errors](#restored-the-code-but-skipped-files) |
247| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind warnings and errors](#no-files-were-restored) |
248| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |
249| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |
250| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |
251| `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) |
252| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |
253| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |
93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |254| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Configuration warnings](#workspace-has-not-been-trusted) |
255| `is a network path, which cannot be added as a working directory` | [Configuration warnings](#working-directory-is-a-network-path) |
256| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |
257| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |
258| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |
259| `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) |
260| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |
261| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |
262| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
263| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
264| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
265| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
266| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
267| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
268| `Stale sandbox mask files left by a killed session` | [Configuration warnings](#stale-sandbox-mask-files-left-by-a-killed-session) |
94| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |269| Responses seem lower quality than usual | [Response quality](#responses-seem-lower-quality-than-usual) |
95 270
96<h2 id="automatic-retries">271<h2 id="automatic-retries">
97 Automatic retries272 Автоматические повторные попытки
98</h2>273</h2>
99 274
100Claude Code повторяет попытки при временных сбоях перед отображением ошибки. Ошибки сервера, перегруженные ответы, тайм-ауты запросов, временные дроссели 429 и разорванные соединения повторяются до 10 раз с экспоненциальной задержкой. Начиная с версии 2.1.198, это охватывает соединения, которые разрываются в середине ответа перед любым видимым выводом: Claude Code повторно отправляет запрос с той же задержкой и ход продолжается вместо остановки с ошибкой соединения. Начиная с версии 2.1.199, временные дроссели 429, которые не содержат заголовки квоты вашего плана, также повторяются, когда вы вошли с подписью claude.ai; более ранние версии повторяли их только для входов по ключу API и Enterprise.275Claude Code повторяет временные сбои до 10 раз с экспоненциальной задержкой перед отображением ошибки. Он не всегда повторяет сбой, который происходит в середине ответа Claude. Когда вы видите одну из ошибок на этой странице, Claude Code уже выполнил все применимые повторные попытки для этого сбоя; списки ниже указывают, какие сбои получают полный бюджет, какие получают меньший, а какие не получают никакого.
101 276
102Некоторые классы сбоев не повторяются, потому что повторная попытка не может быть успешной:277Claude Code повторяет эти сбои:
103 278
104* Начиная с версии 2.1.199, сбой проверки сертификата TLS, такой как прокси, проверяющий TLS, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истекший сертификат, завершается ошибкой при первой попытке, поэтому исправление появляется немедленно вместо полного бюджета повторных попыток. См. [SSL certificate errors](#ssl-certificate-errors). Временные условия TLS, такие как тайм-аут рукопожатия, все еще повторяются.279* Ошибки сервера, перегруженные ответы и тайм-ауты запросов, которые приходят до того, как какая-либо часть ответа Claude начнёт передаваться потоком.
105* Начиная с версии 2.1.199, ошибка сервера, которая поступает после того, как Claude уже передал видимый вывод, сохраняет частичный ответ и добавляет [incomplete-response notice](#the-response-above-may-be-incomplete) вместо повторной попытки, так как повторный запрос может выполнить те же вызовы инструментов дважды. Более ранние версии отбрасывали частичный вывод и сообщали о ходе как об ошибке.280* Разорванные соединения. Когда соединение разрывается в середине запроса до того, как Claude завершит какую-либо часть своего ответа, включая его размышление, Claude Code повторно отправляет запрос с той же задержкой и ход продолжается, даже если некоторый текст уже начал передаваться потоком. Когда оно разрывается после того, как Claude завершил размышление, но до того, как он начал какой-либо текст или вызов инструмента, Claude Code вместо этого повторно отправляет запрос до двух раз в быстрой последовательности и завершает ход с `Connection lost before a response was produced`, если соединение продолжает разрываться в этот момент.
106* [Amazon Bedrock streaming response with an unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type) завершается ошибкой при первой попытке, потому что шлюз или прокси, переписывающий ответ, переписал бы повторную попытку таким же образом. Требуется Claude Code версии 2.1.208 или позже.281* Соединение, которое Claude Code обнаружил, было разорвано тем, что ваш компьютер перешёл в режим сна в середине запроса. Claude Code считает это разорванным соединением в соответствии с приведёнными выше правилами; как только метка повторной попытки назовёт конкретную причину, она будет читаться как `Connection lost while your computer was asleep`, и если ход завершается после того, как Claude завершил размышление, но до любого текста или вызова инструмента, сообщение читается как `Your computer went to sleep before a response was produced`.
282* Застопорившийся поток ответа, когда заголовки ответа прибыли, но ни одна часть ответа Claude не прибыла, или когда Claude завершил размышление, но не начал какой-либо текст или вызов инструмента: Claude Code прерывает застопорившееся соединение и повторно отправляет запрос максимум один раз, вне бюджета из 10 попыток выше. Если ответ застопорится во второй раз после того, как Claude завершил размышление, но до любого текста или вызова инструмента, Claude Code завершает ход с `The response stalled before a response was produced`.
283* Потоковый запрос, на который API никогда не отвечает заголовками ответа, на соединении, где [первый байт дедлайна работает](/docs/ru/network-config#streaming-idle-watchdogs): Claude Code прерывает его в дедлайне и повторно отправляет его максимум один раз за запрос модели, в пределах бюджета повторных попыток, затем завершает ход с [No response from API](#no-response-from-api), если эта попытка также остаётся без ответа. На других соединениях запрос ждёт `API_TIMEOUT_MS`. Когда вы устанавливаете `CLAUDE_CODE_RETRY_WATCHDOG`, ограничение на одну повторную попытку не применяется.
284* Временные дроссели 429, но не лимит расходов шлюза `429`, который не является дросселем; см. [Spend limit reached](#spend-limit-reached).
285 * Когда вы вошли с подпиской claude.ai, это включает дроссели 429, которые не содержат заголовков квоты вашего плана. До v2.1.199 Claude Code повторял эти дроссели только для API ключа и входов Enterprise.
286* Запрос отклонен, потому что входные данные плюс `max_tokens` превышают лимит контекста. Повторная отправка его без изменений приведёт к тому же результату, поэтому Claude Code повторяет с уменьшенным `max_tokens` и прекращает повторные попытки и вместо этого выполняет компактирование в двух случаях:
287 * Когда никакое сокращение не может поместиться, например когда сам разговор почти заполняет окно контекста.
288 * Когда повторная попытка не может больше сокращать `max_tokens`. До v2.1.218 Claude Code мог повторно отправить уменьшенный запрос, который всё ещё не подходил, например когда бюджет расширенного размышления превышал оставшийся контекст, пока не закончился бюджет повторных попыток.
289* Истёкшие или отсутствующие учётные данные Google Cloud на [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai), или учётные данные AWS, которые не загружаются на вашей машине. Claude Code отбрасывает свои кэшированные учётные данные и повторяет попытку до двух раз, затем сообщает об ошибке, чтобы вы могли повторно пройти аутентификацию сразу же, как описано в разделе [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). До v2.1.228 Claude Code повторял неудачные учётные данные Google Cloud через полный бюджет повторных попыток перед отображением ошибки.
290* `401` или `403` из Anthropic API, напрямую или через [LLM gateway](/docs/ru/llm-gateway), пока скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) предоставляет учётные данные. Claude Code повторно запускает скрипт и повторяет попытку с его свежим выводом, в пределах полного бюджета повторных попыток. Когда сам скрипт не работает при повторном запуске, Claude Code вместо этого показывает [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).
107 291
108Во время повторных попыток спиннер показывает обратный отсчет `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину первой попытки для сбоев, на которые вы можете действовать немедленно: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок она читается как `API error` вначале. Начиная с версии 2.1.198, она переключается на конкретную причину третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.292До v2.1.227 `Connection lost before a response was produced` читалось как `Connection closed while thinking, before producing a response` и `The response stalled before a response was produced` читалось как `Response stalled while thinking, before producing a response`.
109 293
110Начиная с версии 2.1.198, обычная подсказка спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой — это перегрузка 529, строка ниже обратного отсчета также указывает, где проверить статус сервиса: `status.claude.com` на Anthropic API, или хост провайдера или шлюза, указанный в сообщении, на других конфигурациях.294Claude Code не повторяет эти сбои:
111 295
112Если данные не поступают на поток ответов в течение 20 секунд, пока запрос все еще ожидает, спиннер показывает `Waiting for API response · will retry in … · check your network` перед началом любой повторной попытки. Запрос еще не завершился с ошибкой: обратный отсчет продолжается до момента, когда Claude Code прерывает зависшее соединение и повторяет попытку, поэтому баннер исчезает самостоятельно, когда данные возобновляются или повторная попытка успешна. Начиная с версии 2.1.185 пороговое значение составляет 20 секунд; в более ранних версиях баннер отображается через 10 секунд с другой формулировкой. Если он появляется при каждой попытке, рассматривайте это как [проблему с сетью](#unable-to-connect-to-api).296* Сбой проверки сертификата TLS, такой как TLS-инспектирующий прокси, отсутствующий пакет `NODE_EXTRA_CA_CERTS` или истёкший сертификат. Claude Code сообщает об ошибке при первой попытке, чтобы вы могли сразу же исправить настройку сертификата; см. [SSL certificate errors](#ssl-certificate-errors). Claude Code по-прежнему повторяет временные условия TLS, такие как тайм-аут рукопожатия. До v2.1.199 Claude Code повторял сбои сертификатов через полный бюджет повторных попыток перед отображением ошибки.
297* Ошибка сервера, разорванное соединение или застопорившийся поток, который приходит после того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своего размышления, но до завершения ответа. Claude Code не повторно запускает запрос, потому что это может выполнить одни и те же вызовы инструментов дважды. Он сохраняет то, что Claude завершил, запускает любые вызовы инструментов, которые Claude завершил, и продолжает ход из их результатов. Для того, что вы видите в интерактивном сеансе и в неинтерактивном, прочитайте [The response above may be incomplete](#the-response-above-may-be-incomplete). До v2.1.199 Claude Code отбрасывал частичный вывод и сообщал об всём ходе как об ошибке, когда ошибка сервера приходила в середине потока.
298* Сбой, который приходит после того, как Claude завершил ответ: повторная попытка не требуется, поэтому Claude Code сохраняет полный ответ и завершает ход нормально.
299* [Amazon Bedrock streaming response with an unexpected content-type](#bedrock-streaming-response-has-an-unexpected-content-type), потому что шлюз или прокси, переписывающие ответ, переписали бы повторную попытку таким же образом. Требуется Claude Code v2.1.208 или позже.
300* Неполная повторная попытка потокового запроса, который получает статус успеха, но [no Claude API message in the body](#api-returned-an-empty-or-malformed-response). Claude Code завершает ход с этой ошибкой.
301* Запрос, который проверка политики вашей организации отклонила, который отображается как строка `API Error:`, содержащая сообщение об отказе. Администраторы вашей организации настроили проверку с помощью [Inference hooks](https://platform.claude.com/docs/en/manage-claude/inference-hooks), функции Claude Enterprise, и сообщение заканчивается инструкциями, которые они настроили, или по умолчанию говорит вам связаться с ними. Claude Code не повторно отправляет отклонённый запрос на ту же модель или на [fallback model](/docs/ru/model-config#fallback-model-chains), потому что отказ касается содержимого запроса, а не модели. До v2.1.239 Claude Code мог повторно отправить отклонённый запрос без потока или на настроенную резервную модель перед отображением отказа.
113 302
114Когда вы видите одну из ошибок на этой странице, эти повторные попытки уже исчерпаны, если только она не принадлежит к классу, который не повторяется, такому как сбой проверки сертификата. Вы можете настроить поведение с помощью этих переменных окружения:303<h3 id="what-you-see-while-claude-code-retries-or-waits">
304 Что вы видите, пока Claude Code повторяет или ждёт
305</h3>
306
307Во время повторной попытки спиннер показывает обратный отсчёт `Retrying in Ns · attempt x/y` после метки ошибки. Метка называет конкретную причину с первой попытки для сбоев, на которые вы можете действовать сразу же: сеть отключена, рукопожатие TLS не удалось, или вы достигли лимита скорости. Для других ошибок сначала читается `API error`. Начиная с v2.1.198 он переключается на конкретную причину с третьей попытки, или при последней попытке, когда `CLAUDE_CODE_MAX_RETRIES` позволяет менее трёх; более ранние версии переключаются только при последней попытке.
308
309Начиная с v2.1.198 обычный совет спиннера подавляется во время повторных попыток. После того как причина ошибки раскрыта, если сбой является перегрузкой 529, строка ниже обратного отсчёта также называет, где проверить статус услуги: `status.claude.com` на Anthropic API, или хост поставщика или шлюза, названный в сообщении на других конфигурациях.
310
311Если никакие данные не поступают в поток ответа в течение 20 секунд, пока запрос всё ещё ожидается, спиннер показывает `Waiting for API response · will retry in … · check your network` перед началом любой повторной попытки. Запрос ещё не завершился: обратный отсчёт работает до точки, где Claude Code прерывает застопорившееся соединение. После прерывания то, что вы видите, зависит от того, как далеко продвинулся ответ:
312
313* До того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своего размышления, Claude Code повторяет запрос или завершает ход с ошибкой. [Automatic retries](#automatic-retries) говорит, какие застои он повторяет и сколько раз.
314* После того, как Claude завершил блок текста или вызов инструмента, или начал один после завершения своего размышления, но до того, как Claude завершил ответ, Claude Code сохраняет то, что Claude завершил, продолжает ход из любых вызовов инструментов, которые Claude завершил, и показывает [The response above may be incomplete](#the-response-above-may-be-incomplete). В неинтерактивном сеансе и для ответа подагента в любом сеансе Claude Code может сначала предложить Claude продолжить ответ; эта запись говорит, когда это происходит и когда вы всё ещё видите уведомление там.
315* После того, как Claude завершил ответ, Claude Code завершает ход нормально.
316
317Баннер очищается сам по себе, как только данные возобновляются или повторная попытка успешна. Если он появляется при каждой попытке, рассматривайте это как [network issue](#unable-to-connect-to-api). До v2.1.185 баннер появлялся через 10 секунд с другой формулировкой.
318
319Пока Claude консультируется с [advisor](/docs/ru/advisor), баннер появляется через 90 секунд без данных вместо 20, потому что длительный обзор советника может не отправлять ничего более 20 секунд. До v2.1.214 порог в 20 секунд применялся и во время вызовов советника, поэтому баннер появлялся во время обзоров советника даже когда ничего не было неправильно.
320
321<h3 id="tune-retry-behavior">
322 Настройка поведения повторных попыток
323</h3>
324
325Вы можете настроить поведение повторных попыток с помощью этих переменных окружения:
115 326
116| Переменная | По умолчанию | Эффект |327| Переменная | По умолчанию | Эффект |
117| :------------------------------------------- | :------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |328| :---------------------------------------------------- | :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
118| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество попыток повтора. Ограничено 15 начиная с версии 2.1.186; начиная с версии 2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |329| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество попыток повторной попытки. Ограничено 15 начиная с v2.1.186; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |
119| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сеансах, таких как задания CI, чтобы повторять попытки при ошибках емкости `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Начиная с версии 2.1.199, это также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |330| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите на `1` в автоматических сеансах, таких как задания CI, чтобы повторять ошибки пропускной способности `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code отказывает сразу же при `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже при одном из [gateway spend cap](#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 сторож повторял эти бесконечно. На v2.1.199 или позже он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, тайм-ауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |
120| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. |331| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Тайм-аут для каждого запроса в миллисекундах. Повысьте его для медленных сетей или прокси. Он также ограничивает, как долго Claude Code ждёт заголовков ответа, описано в [No response from API](#no-response-from-api). |
332| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ru/env-vars) | не установлено | Дедлайн в миллисекундах для первого байта ответа потокового запроса. Требуется Claude Code v2.1.242 или позже. Для того, как Claude Code выбирает дедлайн, когда это не установлено, см. [No response from API](#no-response-from-api). |
121 333
122<h2 id="server-errors">334<h2 id="server-errors">
123 Ошибки сервера335 Ошибки сервера
124</h2>336</h2>
125 337
126Эти ошибки поступают от поставщика услуг вывода, а не от вашей учетной записи или запроса. На Anthropic API это означает инфраструктуру Anthropic. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или пользовательском шлюзе это означает инфраструктуру этого поставщика.338Большинство этих ошибок поступают от поставщика вывода: сервиса Anthropic на Anthropic API и сервиса за конечной точкой этого поставщика на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или пользовательском шлюзе. [Auto mode cannot determine the safety of an action](#auto-mode-cannot-determine-the-safety-of-an-action) и [Agent terminated early due to an API error](#agent-terminated-early-due-to-an-api-error) также охватывают причины на вашей стороне, такие как учетная запись Amazon Bedrock, которая не может вызвать модель классификатора, или подагент, который достиг лимита использования.
127 339
128<h3 id="api-error-500-internal-server-error">340<h3 id="api-error-500-internal-server-error">
129 API Error: 500 Internal server error341 API Error: 500 Internal server error
135API 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.347API 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.
136```348```
137 349
138Завершающее предложение указывает, где проверить состояние службы, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают страницу состояния этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает хост шлюза.350Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.
139 351
140Это указывает на неожиданный сбой внутри API. Это не вызвано вашим запросом, параметрами или учетной записью.352Это указывает на неожиданный сбой внутри API. Это не вызвано вашим приглашением, настройками или учетной записью.
141 353
142**Что делать:**354**Что делать:**
143 355
144* Проверьте [status.claude.com](https://status.claude.com) или страницу состояния поставщика, указанную в сообщении, на предмет активных инцидентов356* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет активных инцидентов
145* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в беседе, поэтому для длинного запроса вы можете ввести `try again` вместо вставки всего текста.357* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного приглашения вы можете ввести `try again` вместо вставки всего текста.
146* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла провести расследование с деталями вашего запроса. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.358* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла расследовать детали вашего запроса. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.
147 359
148<h3 id="api-error-repeated-529-overloaded-errors">360<h3 id="api-error-repeated-529-overloaded-errors">
149 API Error: Repeated 529 Overloaded errors361 API Error: Repeated 529 Overloaded errors
161 373
162**Что делать:**374**Что делать:**
163 375
164* Проверьте [status.claude.com](https://status.claude.com) или страницу состояния поставщика, указанную в сообщении, на предмет уведомлений о емкости376* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет уведомлений о емкости
165* Повторите попытку через несколько минут377* Повторите попытку через несколько минут
166* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.378* Запустите `/model` и переключитесь на другую модель, чтобы продолжить работу, так как емкость отслеживается для каждой модели. Claude Code предлагает вам это сделать, когда одна модель испытывает особенно высокую нагрузку, например `Opus is experiencing high load, please use /model to switch to Sonnet`.
167 379
180**Что делать:**392**Что делать:**
181 393
182* Повторите запрос394* Повторите запрос
183* Для долгосрочных задач разбейте работу на более мелкие запросы395* Для долгосрочных задач разбейте работу на более мелкие приглашения
184* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)396* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в [Automatic retries](#automatic-retries)
185* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже397* Если тайм-ауты частые и ваша сеть в остальном здорова, см. [Network and connection errors](#network-and-connection-errors) ниже
186 398
399<h3 id="no-response-from-api">
400 No response from API
401</h3>
402
403Claude Code отправил потоковый запрос, и API не вернул заголовки ответа в срок для первого байта, поэтому Claude Code прервал запрос вместо ожидания полного тайм-аута запроса `API_TIMEOUT_MS`, 10 минут по умолчанию. Claude Code отправляет запрос снова максимум один раз, если [retry budget](#tune-retry-behavior) позволяет. Когда повторная попытка также остается без ответа, ход завершается этим сообщением, которое показывает, как долго ждала каждая попытка. Когда вы устанавливаете [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars), ограничение на одну повторную попытку не применяется и Claude Code повторяет попытки в соответствии с бюджетом, описанным в [Tune retry behavior](#tune-retry-behavior).
404
405```text theme={null}
406API 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.
407```
408
409Claude Code устанавливает ожидание заголовков ответа первой попытки и повторной попытки отдельно:
410
411* **Первая попытка**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ru/env-vars) когда вы устанавливаете его на 1 или более, ограничено между 10 секундами и 30 минутами. В противном случае Claude Code использует тайм-аут байт-уровня watchdog, указанный в [Streaming idle watchdogs](/docs/ru/network-config#streaming-idle-watchdogs), поэтому переменные, которые изменяют этот тайм-аут, изменяют это ожидание тоже. В любом случае Claude Code добавляет одну секунду на каждые 32 КБ тела запроса.
412* **Повторная попытка**: на одну секунду меньше `API_TIMEOUT_MS`, чуть менее 10 минут по умолчанию, чтобы повторная попытка могла пережить прокси или шлюз, который держит ответ до завершения генерации. На Amazon Bedrock повторная попытка использует тот же срок, что и первая попытка, и сообщение показывает одну длительность вместо двух.
413
414Ни одно ожидание не превышает одну секунду меньше положительного `API_TIMEOUT_MS`, и положительный `API_TIMEOUT_MS` менее 11 секунд отключает срок. Байт-уровневый watchdog начинается только после получения заголовков ответа, поэтому ответ, который перестает отправлять байты после этого, следует [stalled-stream rules](#automatic-retries) вместо этого срока.
415
416**Что делать:**
417
418* Отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в разговоре, поэтому для длинного приглашения вы можете ввести `try again` вместо вставки всего текста.
419* Если это повторяется, рассматривайте это как [network or proxy problem](#unable-to-connect-to-api). Прокси, который принимает соединение и никогда не пересылает запрос, производит эту ошибку при каждой попытке.
420* Если прокси или шлюз в вашей сети держит ответы до их завершения, увеличьте `API_TIMEOUT_MS`, чтобы повторная попытка ждала дольше. На Amazon Bedrock также увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`.
421* Если первая попытка продолжает истекать по времени, а повторная попытка затем успешна, увеличьте `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`, чтобы первая попытка также ждала достаточно долго.
422
423До v2.1.242 Claude Code ждал полного тайм-аута запроса `API_TIMEOUT_MS`, 10 минут по умолчанию, перед отказом от потокового запроса без ответа. До v2.1.261 повторная попытка ждала тот же срок, что и первая попытка, и сообщение не показывало длительности.
424
187<h3 id="the-response-above-may-be-incomplete">425<h3 id="the-response-above-may-be-incomplete">
188 The response above may be incomplete426 The response above may be incomplete
189</h3>427</h3>
190 428
191Потоковый ответ не удался после того, как Claude уже произвел видимый результат. Повторная отправка запроса может привести к двойному выполнению одних и тех же вызовов инструментов, поэтому Claude Code сохраняет то, что уже было передано, и добавляет это уведомление вместо отказа от хода. Какой вариант вы видите, указывает на причину:429Потоковый запрос не удался, пока ответ был еще в процессе, после того как Claude завершил блок текста или вызов инструмента, или начал один после завершения своего мышления. Повторная отправка запроса может запустить одни и те же вызовы инструментов дважды, поэтому Claude Code сохраняет выходные данные, которые Claude завершил, и добавляет это уведомление вместо отказа от хода. Какой вариант вы видите, указывает на причину:
192 430
193```text theme={null}431```text theme={null}
194API Error: Server error mid-response. The response above may be incomplete.432API Error: Server error mid-response. The response above may be incomplete.
195API Error: Connection closed mid-response. The response above may be incomplete.433API Error: Connection lost mid-response. The response above may be incomplete.
196API Error: Response stalled mid-stream. The response above may be incomplete.434API Error: Your computer went to sleep mid-response. The response above may be incomplete.
435API Error: The response stopped arriving. The response above may be incomplete.
197```436```
198 437
199* `Server error mid-response`: ошибка перегрузки или 5xx сервера в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбрасывал частичный результат и сообщал весь ход как ошибку.438* `Server error mid-response`: ошибка сервера перегрузки или 5xx в середине потока. Этот вариант требует Claude Code v2.1.199 или позже; до этого этот случай отбросил частичный выход и сообщил весь ход как ошибку.
200* `Connection closed mid-response`: соединение разорвалось.439* `Connection lost mid-response`: соединение разорвалось.
201* `Response stalled mid-stream`: поток перестал отправлять данные.440* `Your computer went to sleep mid-response`: Claude Code обнаружил, что ваш компьютер перешел в режим сна во время потоковой передачи ответа. После пробуждения компьютера Claude Code рассматривает соединение как разорванное и прекращает чтение из него.
441* `The response stopped arriving`: соединение оставалось открытым, но перестало доставлять данные, поэтому потоковый idle watchdog прервал его. До v2.1.222 Claude Code также мог сообщить об этом сбое на [gateway](/docs/ru/gateways) соединениях, достигнутых через `ANTHROPIC_BASE_URL` или `ANTHROPIC_AWS_BASE_URL`, пока пинги keep-alive сервера все еще поступали, потому что он считал только проанализированные события ответа там; обновление останавливает эти ложные тайм-ауты на этих маршрутах. Шлюзы, достигнутые через URL базы поставщика, такой как `ANTHROPIC_BEDROCK_BASE_URL`, не обернуты байт-уровневым watchdog; см. [Streaming idle watchdogs](/docs/ru/network-config#streaming-idle-watchdogs).
442
443До v2.1.227 `Connection lost mid-response` читалось как `Connection closed mid-response` и `The response stopped arriving` читалось как `Response stalled mid-stream`.
444
445В четырех случаях Claude Code обрабатывает сбой без отображения этого уведомления сразу:
446
447* Ранее в ответе Claude Code либо повторяет попытку сбоя, либо завершает ход с другой ошибкой. См. [Automatic retries](#automatic-retries).
448* Когда один из этих сбоев поступает после того, как Claude завершил ответ, Claude Code сохраняет полный ответ и завершает ход нормально, без этого уведомления. До v2.1.222 Claude Code показывал это уведомление, когда соединение разорвалось или застопорилось после завершения ответа, и сообщал ход как ошибку, даже если ответ был полным.
449* В [non-interactive session](/docs/ru/headless), такой как запуск `-p`, запуск [Agent SDK](/docs/ru/agent-sdk/overview) или [cloud session](/docs/ru/claude-code-on-the-web), вам не нужно отправлять `continue` самостоятельно, когда обрезанный ответ находится в основном разговоре и содержит текст, но не вызовы инструментов: Claude Code сохраняет частичный выход и предлагает Claude продолжить с того места, где он остановился, до трех раз подряд. Вы видите это уведомление для такого ответа только после того, как Claude Code исчерпал эти продолжения. До v2.1.246 Claude Code завершал неинтерактивный ход с этим уведомлением при первом обрезании.
450* В [subagent](/docs/ru/sub-agents#api-errors-in-subagents), независимо от того, интерактивна ли сессия или нет: когда его обрезанный ответ содержит текст, но не вызовы инструментов, Claude Code предлагает подагенту продолжить. Уведомление становится последним сообщением подагента только после того, как эти продолжения исчерпаны. До v2.1.257 подагент показывал это уведомление при первом обрезании.
202 451
203**Что делать:**452**Что делать:**
204 453
205* Прочитайте ответ, который был передан. Ничего не потеряно, но последние предложения или вызовы инструментов могут отсутствовать.454* В интерактивной сессии прочитайте ответ, который остается на экране: Claude Code сохраняет каждый блок, который Claude завершил перед ошибкой, но отбрасывает прерванный финальный блок, когда ход заканчивается, поэтому финальные предложения или вызовы инструментов могут отсутствовать. Ответьте с `continue`, чтобы Claude продолжил с его последнего завершенного блока.
206* Ответьте `continue`, чтобы Claude продолжил с того места, где остановился455* В [non-interactive mode](/docs/ru/headless) (`-p`):
207* Если одна и та же ошибка появляется до какого-либо видимого результата, Claude Code повторяет запрос вместо его завершения. См. [Automatic retries](#automatic-retries).456 * С выходом текста по умолчанию Claude Code печатает последний завершенный блок текста, который он все еще держит с более ранней части хода, за которым следует это сообщение. Когда он не держит ничего, Claude Code печатает только это сообщение, например, потому что Claude Code сжал разговор в середине хода и очистил этот текст. До v2.1.219 Claude Code печатал только это сообщение в выходе текста `-p` и отбрасывал ответ, который он уже произвел.
457 * С `--output-format json` или `stream-json` Claude Code сообщает об этом сообщении в поле `result`.
458 * Чтобы продолжить ход после стабилизации соединения, возобновите сессию и отправьте `continue`, как описано в [Continue conversations](/docs/ru/headless#continue-conversations).
208 459
209<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">460<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">
210 Auto mode cannot determine the safety of an action461 Auto mode cannot determine the safety of an action
211</h3>462</h3>
212 463
213Модель, которую [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрила действие автоматически. Сообщение, которое вы видите, зависит от того, почему классификатор не сработал.464Модель, которую [auto mode](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode) использует для классификации действий, не смогла принять решение, поэтому auto mode не одобрил действие автоматически. Сообщение, которое вы видите, зависит от того, как классификатор не удался.
214 465
215Чтения, поиски и редактирования в вашем рабочем каталоге пропускают классификатор, поэтому они продолжают работать во всех этих случаях.466Чтения, поиски и редактирования внутри вашего рабочего каталога пропускают классификатор, поэтому они продолжают работать во всех этих случаях.
216 467
217Когда модель классификатора перегружена:468Когда модель классификатора недоступна:
218 469
219```text theme={null}470```text theme={null}
220<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.471<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
221```472```
222 473
474Когда Claude Code может определить категорию сбоя, он называет категорию в скобках после `temporarily unavailable`, например `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Категории: `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)` и `(connection failed)`. Ограничение скорости, перегрузка и ошибки сервера являются временными, и повторная попытка работает. Если `(timed out)` или `(connection failed)` повторяется, проверьте ваше соединение; см. [Unable to connect to API](#unable-to-connect-to-api). До v2.1.229 сообщение никогда не называло категорию и читалось как `Wait briefly and then try this action again`.
475
476Когда ни одна категория не подходит, сообщение появляется без категории в скобках; более одного сбоя производит эту форму. На [Amazon Bedrock](/docs/ru/amazon-bedrock), включая [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), это также появляется, когда ваша учетная запись AWS не может вызвать модель, указанную в сообщении, и этот сбой повторяется при каждой повторной попытке, пока вашей учетной записи не будет предоставлен доступ к модели.
477
223**Что делать:**478**Что делать:**
224 479
225* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно480* Повторите попытку через несколько секунд; Claude видит то же сообщение и обычно повторяет попытку самостоятельно. Временный сбой не связан с [auto mode eligibility](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять настройки
226* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже481* Если повторные попытки продолжают не удаваться, продолжайте с задачами только для чтения и вернитесь к заблокированному действию позже
227* Это временно и не связано с [auto mode eligibility](/docs/ru/permission-modes#eliminate-prompts-with-auto-mode); вам не нужно менять параметры482* На Amazon Bedrock, если сообщение возвращается при каждой повторной попытке, проверьте, что ваша учетная запись может вызвать модель, которую оно называет: для стандартных моделей Amazon Bedrock подтвердите, что ваша [IAM policy](/docs/ru/amazon-bedrock#iam-configuration) позволяет вызывать ее; для ID моделей Mantle [свяжитесь с вашей командой учетной записи AWS](/docs/ru/amazon-bedrock#mantle-endpoint-errors)
483
484Когда запрос классификатора не удается, потому что ваш OAuth токен истек или был повернут другой сессией, Claude Code обновляет токен и повторяет запрос один раз, поэтому обычное истечение токена не появляется как это сообщение. До v2.1.216 истекший или повернутый токен не удавался при каждом запросе классификатора, и auto mode отрицал каждое проверенное действие с этим сообщением, пока токен не был обновлен.
228 485
229Когда классификатор вернул непарсируемый ответ:486Когда классификатор вернул непарсируемый ответ:
230 487
237* Повторите действие; это обычно успешно при следующей попытке494* Повторите действие; это обычно успешно при следующей попытке
238* Запустите `claude --debug` и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки495* Запустите `claude --debug` и повторите действие, чтобы увидеть основной ответ классификатора в журнале отладки
239 496
240Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого беседы:497Когда отдельная проверка безопасности API заблокировала запрос классификатора из-за более раннего содержимого разговора:
241 498
242```text theme={null}499```text theme={null}
243Auto 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 details500Auto 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
244```501```
245 502
503Claude Code отрицает действие, но говорит Claude, что это не суждение о том, что действие небезопасно, и продолжить с другими задачами, а не повторять попытку. Эти отказы не учитываются в [auto mode's pause thresholds](/docs/ru/permission-modes#when-auto-mode-falls-back). В [non-interactive](/docs/ru/headless) запуске `-p` Claude Code не останавливает запуск. То, что получает Claude, зависит от того, где оно запросило действие:
504
505* К [background subagent](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в запуске `-p` без `--input-format stream-json` Claude Code возвращает результат ошибки, содержащий `Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode`
506* Везде, включая интерактивные сессии и основной разговор запуска `-p`, Claude Code возвращает это отрицание Claude
507
508До v2.1.225 Claude Code считал эти отказы в направлении пороговых значений паузы и возвращал то же самое отклонение, что и подлинный блок классификатора.
509
246**Что делать:**510**Что делать:**
247 511
248* Это не решение о вашем действии. Содержимое, уже находящееся в вашей беседе, вызвало фильтр безопасности на API, когда auto mode отправил беседу классификатору512* Это не решение о вашем действии. Содержимое, уже находящееся в вашем разговоре, вызвало фильтр безопасности на API, когда auto mode отправил разговор классификатору
249* Повторная попытка не поможет; то же содержимое беседы снова вызовет фильтр513* Повторная попытка не поможет; то же содержимое разговора снова вызовет фильтр
250* Переключитесь на другой [permission mode](/docs/ru/permission-modes), чтобы вы могли одобрить действие при появлении запроса, или начните новую беседу без содержимого, вызывающего проблему514* В интерактивной сессии переключитесь на другой [permission mode](/docs/ru/permission-modes), чтобы вы могли одобрить действие при появлении запроса
515* Начните свежий разговор без содержимого, вызывающего срабатывание
251 516
252Когда беседа выросла больше, чем контекстное окно классификатора:517Когда разговор вырос больше, чем контекстное окно классификатора:
253 518
254```text theme={null}519```text theme={null}
255Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)520Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
256```521```
257 522
258В интерактивном сеансе auto mode возвращается к обычному запросу разрешения для этого действия, чтобы вы могли одобрить или отклонить его вручную. В [non-interactive mode](/docs/ru/headless) запуск прерывается, потому что стенограмма только растет и повторная попытка не может быть успешной.523То, что происходит с действием, зависит от того, где Claude его запросил:
524
525* В интерактивной сессии auto mode возвращается к обычному приглашению разрешения для этого действия, чтобы вы могли одобрить или отрицать его вручную
526* К [background subagent](/docs/ru/sub-agents#run-subagents-in-foreground-or-background) в [non-interactive](/docs/ru/headless) запуске `-p` без `--input-format stream-json` Claude Code возвращает результат ошибки, содержащий `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, и запуск продолжается
527* В другом месте в запуске `-p` без [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags) нет приглашения для возврата, поэтому действие не выполняется и запуск продолжается
259 528
260**Что делать:**529**Что делать:**
261 530
262* Одобрите или отклоните действие в появившемся запросе531* В интерактивной сессии одобрите или отрицайте действие в появившемся приглашении
263* Запустите `/compact`, чтобы уменьшить размер беседы, чтобы последующие действия снова поместились в окне классификатора532* В интерактивной сессии запустите `/compact`, чтобы уменьшить размер разговора, чтобы последующие действия снова подходили в окно классификатора
264 533
265<h3 id="agent-terminated-early-due-to-an-api-error">534<h3 id="agent-terminated-early-due-to-an-api-error">
266 Agent terminated early due to an API error535 Agent terminated early due to an API error
267</h3>536</h3>
268 537
269Запрос API [subagent](/docs/ru/sub-agents) не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера закончились, поэтому subagent остановился до завершения своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude как если бы это был результат subagent.538Запрос API [subagent](/docs/ru/sub-agents) не удался окончательно, например, потому что был достигнут лимит использования или повторные попытки для ошибки сервера исчерпаны, поэтому подагент остановился перед завершением своей задачи. Это сообщение требует Claude Code v2.1.199 или позже; до этого текст ошибки API был возвращен Claude, как если бы это был результат подагента.
270 539
271```text theme={null}540```text theme={null}
272Agent terminated early due to an API error: <error detail>541Agent terminated early due to an API error: <error detail>
274 543
275**Что делать:**544**Что делать:**
276 545
277* Сопоставьте деталь ошибки после двоеточия с ее собственным разделом на этой странице, например [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела546* Сопоставьте деталь ошибки после двоеточия с его собственным разделом на этой странице, такой как [Usage limits](#usage-limits) или [Server errors](#server-errors), и следуйте шагам этого раздела
278* После того как основная ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/docs/ru/sub-agents#resume-subagents)547* После того как основная ошибка исчезнет, попросите Claude повторить задачу или [resume the subagent](/docs/ru/sub-agents#resume-subagents)
279 548
280Когда ограничение скорости, перегрузка или ошибка сервера прерывает foreground subagent, который уже произвел текстовый результат, Claude получает этот частичный результат, отмеченный как неполный, вместо этой ошибки. Subagent, единственным результатом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. [API errors in subagents](/docs/ru/sub-agents#api-errors-in-subagents).549Когда ограничение скорости, перегрузка или ошибка сервера прерывает подагент переднего плана, который уже произвел текстовый выход, Claude получает этот частичный выход, отмеченный как неполный, вместо этой ошибки. Подагент, единственным выходом которого были вызовы инструментов, также получает эту ошибку; в v2.1.199 эта форма возвращала пустой частичный результат вместо этого. См. [API errors in subagents](/docs/ru/sub-agents#api-errors-in-subagents).
281 550
282<h2 id="usage-limits">551<h2 id="usage-limits">
283 Ограничения использования552 Ограничения использования
284</h2>553</h2>
285 554
286Эти ошибки означают, что достигнута квота, связанная с вашей учетной записью или планом. Они отличаются от [ошибок сервера](#server-errors), которые влияют на всех.555Большинство ошибок в этом разделе означают, что достигнута квота, привязанная к вашей учётной записи или плану. Три работают по-другому: [`Server is temporarily limiting requests`](#server-is-temporarily-limiting-requests) — это серверное ограничение скорости, не связанное с квотой вашего плана, [`Usage credits required for 1M context`](#usage-credits-required-for-1m-context) — это проверка прав доступа, а не исчерпанная квота, и [`The prompt to confirm went unanswered`](#the-prompt-to-confirm-went-unanswered) означает, что подтверждающий запрос на использование кредитов закрыт без ответа, независимо от того, была ли достигнута квота.
287 556
288<h3 id="youve-hit-your-session-limit">557<h3 id="youve-hit-your-session-limit">
289 Вы достигли лимита сеанса558 You've hit your session limit
290</h3>559</h3>
291 560
292Планы подписки включают скользящий лимит использования. Когда он исчерпывается, вы видите одно из этих сообщений:561Планы подписки включают скользящий лимит использования. Когда он заканчивается, вы видите одно из этих сообщений:
293 562
294```text theme={null}563```text theme={null}
295You've hit your session limit · resets 3:45pm564You've hit your session limit · resets 3:45pm
296You've hit your weekly limit · resets Mon 12:00am565You've hit your weekly limit · resets Mon 12:00am
297You've hit your Opus limit · resets 3:45pm566You've hit your Opus limit · resets 3:45pm
567You've hit your Sonnet limit · resets 3:45pm
298```568```
299 569
300Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сеанса и недельного использования являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимит Opus применяется только к запросам Opus, поэтому переключение на другую модель с помощью `/model` позволяет вам продолжить работу.570Claude Code блокирует дальнейшие запросы до времени сброса, указанного в сообщении. Лимиты сеанса и недели являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Лимиты Opus и Sonnet применяются только к запросам к этому семейству моделей, поэтому переключение на модель вне семейства с помощью `/model` позволяет вам продолжить работу.
571
572В интерактивном сеансе, вошедшем с подпиской claude.ai, Claude Code также может ждать в открытом сеансе и продолжить прерванную задачу вскоре после сброса. Пока он ждёт, строка в нижней части сеанса читает `Usage limit reached · continuing automatically at 3:45pm · esc to cancel`. Нажмите `Esc` при пустом приглашении, чтобы отменить ожидание. См. [Wait for a usage limit to reset](/docs/ru/interactive-mode#wait-for-a-usage-limit-to-reset) для информации о том, что вы видите, как начать или отменить ожидание и как отключить автоматическое продолжение. До версии v2.1.234 Claude Code не предлагал это ожидание.
301 573
302Использование учитывается в отношении лимитов сеанса и недельного использования одновременно. Одиночный всплеск интенсивной активности, такой как крупный fanout рабочего процесса, может исчерпать недельный лимит до того, как окно сеанса сбросится.574Использование учитывается одновременно в лимитах сеанса и недели. Один всплеск интенсивной деятельности, такой как большой fanout рабочего процесса, может исчерпать недельный лимит до сброса окна сеанса.
303 575
304**Что делать:**576**Что делать:**
305 577
306* Дождитесь времени сброса, указанного в ошибке578* Дождитесь времени сброса, указанного в ошибке
307* Для лимита Opus запустите `/model` и переключитесь на другую модель, чтобы продолжить работу579* На вкладке Code в [Desktop app](/docs/ru/desktop) карточка session-limit предлагает флажок **Auto-continue when limits reset**. Карточка weekly-limit этого не предлагает. Когда он отмечен, Desktop app повторяет прерванный ход после сброса и показывает время повтора на карточке. Флажок Desktop и параметр **Continue automatically at usage limit** в CLI в `/config` являются отдельными, поэтому отключайте каждый отдельно.
308* Запустите `/usage` для просмотра лимитов вашего плана и времени их сброса580* Для лимита Opus или Sonnet запустите `/model` и переключитесь на модель вне этого семейства, чтобы продолжить работу. Каждая модель имеет свой собственный кэш подсказок, поэтому следующий запрос повторно читает весь разговор без попаданий в кэш; см. [Switching models](/docs/ru/prompt-caching#switching-models)
309* Запустите `/usage-credits` для покупки дополнительного использования на Pro и Max, или для запроса у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о выставлении счетов.581* Запустите `/usage`, чтобы увидеть лимиты вашего плана и когда они сбрасываются
310* Для обновления вашего плана на более высокие базовые лимиты см. [claude.com/pricing](https://claude.com/pricing)582* Запустите `/usage-credits`, чтобы купить дополнительное использование на Pro и Max, или запросить его у администратора на Team и Enterprise. См. [usage credits for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) для информации о том, как это выставляется счётом.
583* Чтобы обновить ваш план для более высоких базовых лимитов, см. [claude.com/pricing](https://claude.com/pricing)
311 584
312Чтобы отслеживать оставшийся лимит перед его исчерпанием, добавьте поля `rate_limits` в [пользовательскую строку состояния](/docs/ru/statusline#rate-limit-usage), или в приложении Desktop нажмите на [кольцо использования](/docs/ru/desktop#check-usage) рядом с выбором модели.585Перед тем как окно закончится, Claude Code может предупредить вас, что вы использовали большую часть его, с сообщением, таким как `You've used 85% of your session limit · resets 3:45pm`. Чтобы непрерывно отслеживать оставшийся лимит, добавьте поля `rate_limits` в [custom status line](/docs/ru/statusline#rate-limit-usage), или в Desktop app нажмите [usage ring](/docs/ru/desktop#check-usage) рядом с выбором модели.
313 586
314<h3 id="usage-credits-required-for-1m-context">587<h3 id="usage-credits-required-for-1m-context">
315 Требуются кредиты использования для контекста 1M588 Usage credits required for 1M context
316</h3>589</h3>
317 590
318Выбранная модель использует расширенное окно контекста на 1M токенов, и ваш план включает его только через кредиты использования.591Выбранная модель использует расширенное окно контекста с расширением 1M-токена, и ваш план включает его только через кредиты использования.
319 592
320```text theme={null}593```text theme={null}
321API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context594API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context
322```595```
323 596
324Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недельного использования имеют оставшуюся емкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования.597Это проверка прав доступа, а не исчерпание квоты. Она срабатывает даже когда ваши лимиты сеанса и недели имеют оставшуюся ёмкость. См. [Extended context](/docs/ru/model-config#extended-context) для информации о том, какие планы включают контекст 1M напрямую и какие требуют кредитов использования. Claude Code выполняет эту проверку, когда вы выбираете модель с помощью `/model`, и только при прямом подключении к API Anthropic; если вы указываете `ANTHROPIC_BASE_URL` на [LLM gateway](/docs/ru/llm-gateway), `/model` позволяет выбрать `[1m]` и шлюз решает, будет ли запрос успешным.
325 598
326Когда эта ошибка появляется в середине разговора, потому что контекст вырос более 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом уровне впоследствии, поэтому никаких действий не требуется. На версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведенные ниже шаги применяются, когда вы явно выбрали модель `[1m]`.599Когда эта ошибка появляется в середине разговора, потому что контекст вырос более чем на 200K токенов, Claude Code автоматически сжимает разговор обратно под стандартный лимит контекста и сохраняет сеанс на этом лимите впоследствии, поэтому никаких действий не требуется. В версиях до v2.1.172 ошибка повторялась при каждом последующем запросе, включая `/compact`; запустите `/clear` на этих версиях для восстановления. Приведённые ниже шаги применяются, когда вы явно выбрали модель `[1m]`.
327 600
328**Что делать:**601**Что делать:**
329 602
330* Запустите `/model` и выберите вариант без суффикса `[1m]` для возврата к стандартному окну контекста603* Запустите `/model` и выберите вариант без суффикса `[1m]`, чтобы вернуться к стандартному окну контекста
331* Запустите `/usage-credits` для включения тарифицированного выставления счетов для варианта 1M на Pro и Max, или для запроса у администратора на Team и Enterprise604* Где сообщение называет `/usage-credits`, запустите его, чтобы включить поэтапное выставление счётов для варианта 1M на Pro и Max, или запросить кредиты использования у администратора на Team и Enterprise
332* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) для проверки мест конфигурации в порядке приоритета.605* Если ошибка сохраняется после `/model`, ID модели 1M может быть установлен в другом месте. См. [Setting your model](/docs/ru/model-config#setting-your-model) для проверки мест конфигурации в порядке приоритета.
333* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)606* Чтобы полностью удалить варианты 1M из выбора модели, установите [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars)
334 607
608<h3 id="the-prompt-to-confirm-went-unanswered">
609 The prompt to confirm went unanswered
610</h3>
611
612Если ваша учётная запись требует [Fable usage-credits consent](/docs/ru/model-config#fable-and-usage-credits), Claude Code просит вас подтвердить перед запросом Fable, который будет выставлять счёт за кредиты использования. Когда никто не отвечает на этот запрос согласия в сеансе, который может не иметь никого у его терминала, Claude Code закрывает запрос и завершает ход одним из этих сообщений:
613
614```text theme={null}
615Fable 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
616Fable 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
617```
618
619Сообщения называют модель Fable сеанса, поэтому на Fable 5 они читают `continuing on Fable 5` и `Fable 5 now uses usage credits`. До версии v2.1.257 первое сообщение начиналось с `Fable 5 limit reached`.
620
621Это происходит в сеансах [Remote Control](/docs/ru/remote-control), [background sessions](/docs/ru/agent-view) и сеансах товарищей [agent team](/docs/ru/agent-teams). Claude Code показывает запрос согласия только в собственном интерактивном представлении сеанса: терминале, где он работает, или для фонового сеанса, в [agents view](/docs/ru/agent-view) после подключения. Клиент Remote Control не может его отобразить. Claude Code закрывает запрос в крайний срок [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry), пять минут по умолчанию, или как только появляется новый запрос, пока никто не печатает на этом терминале, например запрос, отправленный из клиента Remote Control. Печать на терминале, где работает сеанс, отменяет крайний срок, и Claude Code ждёт вашего ответа. В присоединённом представлении фонового сеанса печать не отменяет крайний срок, и новый запрос всё ещё закрывает запрос согласия, поэтому ответьте перед тем, как это произойдёт. Claude Code ничего не отправляет и сохраняет вашу модель, поэтому когда вы отправляете следующий запрос, Claude Code снова показывает запрос согласия.
622
623**Что делать:**
624
625* На терминале, где работает сеанс, отправьте другой запрос и ответьте на запрос согласия, когда он появится снова. Для фонового сеанса сначала подключитесь к нему из [agents view](/docs/ru/agent-view). Повторная отправка из клиента Remote Control показывает это сообщение снова, потому что клиент не может отобразить запрос.
626* Запустите `/model`, чтобы переключиться на модель, которая не выставляет счёт за кредиты использования
627* Чтобы дать себе больше времени для доступа к этому терминалу, установите [`dialogExpiry`](/docs/ru/settings-reference#dialogexpiry) на более длительное значение или `"never"`
628
629До версии v2.1.236 это сообщение не появлялось: пока был подключен клиент Remote Control, Claude Code ждал 60 секунд ответа, а затем продолжал ход на вашей модели по умолчанию.
630
335<h3 id="server-is-temporarily-limiting-requests">631<h3 id="server-is-temporarily-limiting-requests">
336 Сервер временно ограничивает запросы632 Server is temporarily limiting requests
337</h3>633</h3>
338 634
339API применил кратковременное дросселирование, которое не связано с квотой вашего плана.635API применил кратковременное ограничение скорости, которое не связано с квотой вашего плана.
340 636
341```text theme={null}637```text theme={null}
342API Error: Server is temporarily limiting requests (not your usage limit)638API Error: Server is temporarily limiting requests (not your usage limit)
343```639```
344 640
345Claude Code различает это от вашего лимита плана по отсутствию унифицированных заголовков квоты, которые несет реальный ответ лимита. Начиная с v2.1.199 это [автоматически повторяется](#automatic-retries) с отступом перед отображением, независимо от способа аутентификации. На более ранних версиях сеанс, подписанный на подписку claude.ai, не прошел ход при первом возникновении; только API ключ и аутентификация Enterprise повторили попытку.641Claude Code различает их от лимита вашего плана по отсутствию унифицированных заголовков квоты, которые несёт реальный ответ лимита. Начиная с версии v2.1.199 это [retried automatically](#automatic-retries) с backoff перед отображением, независимо от того, как вы аутентифицируетесь. В более ранних версиях сеанс, вошедший с подпиской claude.ai, не прошёл ход при первом возникновении; только API key и Enterprise sign-ins повторили попытку.
346 642
347**Что делать:**643**Что делать:**
348 644
349* Подождите немного и попробуйте снова645* Подождите немного и попробуйте снова
350* Проверьте [status.claude.com](https://status.claude.com) если проблема сохраняется646* Проверьте [status.claude.com](https://status.claude.com), если это сохраняется
351 647
352<h3 id="request-rejected-429">648<h3 id="request-rejected-429">
353 Запрос отклонен (429)649 Request rejected (429)
354</h3>650</h3>
355 651
356Вы достигли лимита скорости, настроенного для вашего API ключа, проекта Amazon Bedrock или проекта Google Cloud.652Вы достигли лимита скорости, настроенного для вашего API key, проекта Amazon Bedrock или проекта Google Cloud.
357 653
358```text theme={null}654```text theme={null}
359API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.655API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
360```656```
361 657
362Завершающее предложение указывает, где проверить здоровье сервиса и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry указывают на страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` указывает на хост шлюза.658Завершающее предложение называет, где проверить здоровье сервиса, и варьируется в зависимости от поставщика. Конфигурации Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry называют страницу статуса этого поставщика вместо страницы статуса Anthropic. Пользовательский `ANTHROPIC_BASE_URL` называет хост шлюза.
363 659
364**Что делать:**660**Что делать:**
365 661
366* Запустите `/status` и подтвердите, что активные учетные данные - это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через ключ низкого уровня вместо вашей подписки.662* Запустите `/status` и подтвердите, что активные учётные данные — это те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может маршрутизировать запросы через низкоуровневый ключ вместо вашей подписки.
367* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо663* Проверьте консоль вашего поставщика для активных лимитов и запросите более высокий уровень, если необходимо
368* Для API ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить ограничения расходов для каждого рабочего пространства664* Для API keys Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits) для информации о том, как работают уровни и как установить ограничения на рабочее пространство
369* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/ru/env-vars), избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с `/model` для высокообъемных скриптовых запусков665* Снизьте параллелизм: понизьте [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/ru/env-vars), избегайте запуска множества параллельных подагентов, или переключитесь на меньшую модель с помощью `/model` для высокообъёмных скриптовых запусков
666
667<h3 id="youve-hit-your-monthly-spend-limit">
668 You've hit your monthly spend limit
669</h3>
670
671Включённое использование вашего плана не может покрыть этот запрос, и [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), которые в противном случае оплатили бы его, достигли лимита расходов. Это происходит, когда одно из окон использования вашего плана закончилось, или когда запрос — это запрос, который оплачивают только кредиты использования, такой как запрос к модели, которая [bills to usage credits](/docs/ru/model-config#fable-and-usage-credits). Сообщение называет, чей лимит вас заблокировал. Текст после `·` говорит, как увеличить этот лимит, и варьируется в зависимости от вашего плана и того, управляете ли вы выставлением счётов:
672
673```text theme={null}
674You've hit your monthly spend limit · raise it at claude.ai/settings/usage
675You've hit your individual spend limit · ask your admin for a higher limit
676You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
677You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
678You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings
679```
680
681`team's shared budget` — это объединённый бюджет, который администратор назначил группе, к которой вы принадлежите; сообщение не называет группу. `channel's monthly spend limit` — это бюджет одного канала Slack, в котором работает сеанс, поэтому ваша организация может иметь бюджет вне его.
682
683Когда одно из окон вашего плана — это то, что закончилось, сообщение также говорит, когда это окно сбрасывается, например `· your session limit resets 3:45pm`, и доступ возвращается тогда без того, чтобы кто-либо повышал лимит. В организациях с выставлением счётов на основе использования сообщение говорит `usage limit` вместо `spend limit`, как в `You've hit your individual usage limit`.
684
685До версии v2.1.239 сообщение не называло время сброса окна плана. До версии v2.1.268 объединённый бюджет группы производил сообщение `individual spend limit` вместо `team's shared budget`.
686
687Если вы подключаетесь через шлюз приложений Claude и видите строчное `spend limit reached`, это ограничение вашего оператора шлюза; см. [Spend limit reached](#spend-limit-reached).
688
689**Что делать:**
690
691* На Pro и Max увеличьте ваш ежемесячный лимит расходов в [**Settings > Usage**](https://claude.ai/settings/usage) на claude.ai, или запустите `/usage-credits`
692* На Team и Enterprise увеличьте лимит в [**Admin settings > Usage**](https://claude.ai/admin-settings/usage), если вы управляете выставлением счётов, или попросите администратора. `/usage-credits` отправляет этот запрос вашему администратору для вас
693* Для лимита канала попросите владельца организации или менеджера канала повысить его на claude.ai. См. [Per-channel limits](https://claude.com/docs/claude-tag/admins/set-spend-limit#per-channel-limits) в документации Claude Tag
694* Если сообщение называет время сброса для окна вашего плана, вы можете вместо этого дождаться его
695* Запустите `/usage`, чтобы увидеть окна вашего плана и когда каждое сбрасывается
696
697<h3 id="spend-limit-reached">
698 Spend limit reached
699</h3>
700
701Вы подключаетесь через [Claude apps gateway](/docs/ru/claude-apps-gateway) и прошли [spend cap](/docs/ru/claude-apps-gateway-spend-limits), который установил ваш оператор шлюза. Шлюз блокирует ваши запросы до сброса названного периода или пока оператор не повысит ограничение. Он отмечает каждый заблокированный ответ `429` как `x-should-retry: false`, поэтому Claude Code показывает это сообщение без повторных попыток.
702
703```text theme={null}
704spend limit reached (daily; resets 2026-08-09 00:00 UTC)
705```
706
707Сообщение называет период ограничения и время сброса, и когда оператор настроил `blocked_message`, его инструкции следуют за ним. До версии v2.1.225 сообщение читалось только `spend limit reached`; шлюз на более старой версии всё ещё отправляет эту более короткую форму.
708
709**Что делать:**
710
711* Дождитесь времени сброса, которое называет сообщение, или следуйте инструкциям оператора, если сообщение их содержит
712* Попросите вашего оператора шлюза повысить ограничение, если вы его часто достигаете
713
714Связанное сообщение, `spend limit unavailable`, означает, что шлюз не смог прочитать свои записи расходов и заблокировал запрос в качестве меры предосторожности, а не из-за вашего ограничения. Обычно это очищается само по себе; если это сохраняется, сообщите вашему оператору шлюза.
370 715
371<h3 id="credit-balance-is-too-low">716<h3 id="credit-balance-is-too-low">
372 Баланс кредитов слишком низкий717 Credit balance is too low
373</h3>718</h3>
374 719
375Ваша организация Console исчерпала предоплаченные кредиты.720Ваша организация Console исчерпала предоплаченные кредиты, или Claude Code отправляет ваши запросы с помощью Console API key, когда вы имели в виду использовать вашу подписку.
376 721
377```text theme={null}722```text theme={null}
378Credit balance is too low723Credit balance is too low
380 725
381**Что делать:**726**Что делать:**
382 727
383* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся до того, как он упадет до нуля728* Если у вас есть план Pro, Max, Team или Enterprise и вы видите это, запустите `/status` и проверьте строку `API key`. Одобренный `ANTHROPIC_API_KEY` в вашей среде маршрутизирует запросы через этот ключ вместо вашей подписки. Отмените его в текущей оболочке и удалите из профиля оболочки, затем перезапустите `claude`. Запустите `/login`, если вы ещё не вошли с вашей подпиской.
384* Переключитесь на аутентификацию подписки с `/login` если у вас есть план Pro, Max, Team или Enterprise729* Добавьте кредиты на [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) и рассмотрите возможность включения автоматической перезагрузки там, чтобы баланс пополнялся перед тем, как он упадёт до нуля
385* Установите ограничения расходов для каждого рабочего пространства в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/docs/ru/costs).730* Установите ограничения расходов на рабочее пространство в Console, чтобы предотвратить истощение баланса организации одним проектом. См. [Manage costs effectively](/docs/ru/costs).
731
732<h3 id="could-not-update-your-spend-limit">
733 Could not update your spend limit
734</h3>
735
736Сервер отклонил изменение лимита расходов, которое вы сделали из подсказки, которая появляется, когда вы достигаете лимита расходов.
737
738```text theme={null}
739Could not update your spend limit: <reason from the server>
740```
741
742Когда сервер объясняет отклонение, сообщение заканчивается этой причиной, и повторная попытка того же значения снова не удаётся. Когда отказ не имеет предоставленной сервером причины, такой как разорванное соединение, сообщение читает `Could not update your spend limit. Press Enter to retry.` и повторная попытка может быть успешной. До версии v2.1.216 Claude Code показывал общую форму для каждого отказа.
743
744**Что делать:**
745
746* Если сообщение включает причину, выберите лимит, который её удовлетворяет, например меньшую сумму
747* Если сообщение показывает только общую форму, повторите попытку; отказ может быть временным
748* Если изменение продолжает не удаваться, сделайте его из ваших [claude.ai billing settings](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) в браузере вместо этого
386 749
387<h2 id="authentication-errors">750<h2 id="authentication-errors">
388 Ошибки аутентификации751 Ошибки аутентификации
394 Not logged in757 Not logged in
395</h3>758</h3>
396 759
397Для этого сеанса нет действительных учетных данных.760Для этого сеанса нет доступных действительных учетных данных.
398 761
399```text theme={null}762```text theme={null}
400Not logged in · Please run /login763Not logged in · Please run /login
403**Что делать:**766**Что делать:**
404 767
405* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console768* Запустите `/login` для аутентификации с помощью вашей подписки Claude или учетной записи Console
406* Если вы ожидали, что переменная окружения будет вас аутентифицировать, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`769* Если вы ожидали, что переменная окружения будет аутентифицировать вас, убедитесь, что `ANTHROPIC_API_KEY` установлена и экспортирована в оболочке, где вы запустили `claude`
407* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/docs/ru/settings#available-settings), который получает ключ при запуске770* Для CI или автоматизации, где интерактивный вход невозможен, настройте скрипт [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), который получает ключ при запуске
408* См. [Authentication precedence](/docs/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные использует Claude Code, когда присутствует несколько771* См. [Authentication precedence](/docs/ru/authentication#authentication-precedence), чтобы понять, какие учетные данные Claude Code использует, когда присутствует несколько
409 772
410Если вам предлагается войти повторно, см. [Not logged in or token expired](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) для исправления системных часов и macOS Keychain.773Если вам предлагается войти повторно, см. [Not logged in or token expired](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired) для проверки системных часов и шагов восстановления хранилища учетных данных macOS.
411 774
412<h3 id="could-not-resolve-authentication-method">775<h3 id="could-not-resolve-authentication-method">
413 Could not resolve authentication method776 Could not resolve authentication method
414</h3>777</h3>
415 778
416Сеанс достиг клиента API без каких-либо учетных данных. Это появляется в [background sessions](/docs/ru/agent-view), облачных сеансах и контекстах Agent SDK, где проверка интерактивного входа не выполняется перед первым запросом.779Сеанс достиг клиента API без каких-либо учетных данных. [Background sessions](/docs/ru/agent-view) и облачные сеансы показывают это сообщение, когда рабочий процесс запускается без учетных данных. Интерактивные, `-p` и запуски Agent SDK сообщают о том же состоянии, что и [Not logged in](#not-logged-in), и записывают эту строку только в журнал отладки, поэтому если вы нашли ее там, следуйте этой записи вместо этого.
417 780
418```text theme={null}781```text theme={null}
419Could 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 omitted782Could 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
420```783```
421 784
422До версии 2.1.174 фоновый или облачный сеанс, назначенный неактивному предварительно инициализированному рабочему процессу, мог завершиться ошибкой таким образом, даже если были настроены действительные учетные данные. Обновитесь для восстановления. В текущих версиях ошибка означает, что рабочему процессу не было доступно никаких учетных данных.785В текущих версиях ошибка означает, что рабочему процессу не были доступны учетные данные. До v2.1.174 фоновый сеанс, назначенный неактивному предварительно инициализированному рабочему процессу, мог завершиться ошибкой таким образом, даже если были настроены действительные учетные данные. До v2.1.176 облачный сеанс, который был неактивен перед тем, как быть заявленным, тоже мог. Обновитесь для восстановления.
423 786
424**Что делать:**787**Что делать:**
425 788
426* Обновитесь до версии 2.1.174 или более поздней, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены789* Обновитесь до v2.1.176 или более поздней версии, если это появляется в фоновом или облачном сеансе и ваши учетные данные уже настроены
427* Убедитесь, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или учетные данные вашего облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке790* Убедитесь, что `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` или ваши учетные данные облачного провайдера установлены в окружении, которое запускает рабочий процесс, а не только в вашей интерактивной оболочке
428* Для Agent SDK см. [authentication setup](/docs/ru/agent-sdk/overview#get-started)791* Для Agent SDK см. [authentication setup in the quickstart](/docs/ru/agent-sdk/quickstart#setup)
429* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается792* Запустите `/status` в интерактивном сеансе в том же окружении, чтобы подтвердить, какой источник учетных данных разрешается
430 793
431<h3 id="invalid-api-key">794<h3 id="invalid-api-key">
432 Invalid API key795 Invalid API key
433</h3>796</h3>
434 797
435Переменная окружения `ANTHROPIC_API_KEY` или скрипт `apiKeyHelper` вернули ключ, который API отклонил.798Переменная окружения `ANTHROPIC_API_KEY` или скрипт `apiKeyHelper` вернули ключ, который API отклонил, или Claude Code заблокировал ключ из `ANTHROPIC_API_KEY` перед его отправкой.
436 799
437```text theme={null}800```text theme={null}
438Invalid API key · Fix external API key801Invalid API key · Fix external API key
439```802```
440 803
804Когда сообщение продолжается после `Fix external API key` с описанием, таким как `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API никогда не видел ключ. Claude Code обнаружил символ, который HTTP-заголовки не могут передавать, и остановил запрос перед его отправкой. См. [Invalid request header value](#invalid-request-header-value) для того, как прочитать описание и исправить значение.
805
441**Что делать:**806**Что делать:**
442 807
443* Проверьте опечатки и убедитесь, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)808* Проверьте опечатки и убедитесь, что ключ не был отозван в [Console](https://platform.claude.com/settings/keys)
444* Запустите `env | grep ANTHROPIC` в той же оболочке. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.809* В той же оболочке запустите `env | grep ANTHROPIC`, или в PowerShell `Get-ChildItem Env:ANTHROPIC*`. Такие инструменты, как direnv, плагины dotenv shell и терминалы IDE, могут загружать устаревший ключ из файла `.env` в вашем проекте без явной установки.
445* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки810* Отмените установку `ANTHROPIC_API_KEY` и запустите `/login` для использования аутентификации подписки вместо этого
446* Если ключ поступает из скрипта [`apiKeyHelper`](/docs/ru/settings#available-settings), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout811* Если ключ поступает из скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper), запустите скрипт напрямую, чтобы подтвердить, что он выводит действительный ключ на stdout
447* Запустите `/status`, чтобы подтвердить, какой источник учетных данных на самом деле использует Claude Code812* Запустите `/status`, чтобы подтвердить, какой источник учетных данных Claude Code фактически использует
448 813
449<h3 id="your-apikeyhelper-script-is-failing">814<h3 id="your-apikeyhelper-script-is-failing">
450 Your apiKeyHelper script is failing815 Your apiKeyHelper script is failing
451</h3>816</h3>
452 817
453Команда, настроенная в параметре [`apiKeyHelper`](/docs/ru/settings#available-settings), завершилась с ошибкой, истекла по времени или ничего не вывела на stdout. Без ключа из скрипта запрос достигает API с заполнителем учетных данных, и API отклоняет его с `401`.818Claude Code запустил команду в вашей настройке [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) и не получил ключ обратно. Без него запрос достигает API с заполнительными учетными данными, и API отклоняет его с `401`. Панель `Authentication` в терминале показывает, что произошло одно из следующих:
819
820* Команда завершилась с ошибкой или истекло время ожидания
821* Команда ничего не вывела на stdout
822* Команда вывела что-то, кроме ключа, например баннер входа или строку журнала. Панель показывает `returned output that cannot be used as an API key` и говорит, что не так, без повторения вывода. До v2.1.227 Claude Code отправлял все, что выводила команда, после обрезки окружающих пробелов.
454 823
455```text theme={null}824```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output825Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```826```
458 827
459Claude Code повторно запускает скрипт и повторяет попытку запроса до двух раз перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. До версии 2.1.208 Claude Code тратил весь [retry budget](#automatic-retries) на повторную отправку запроса с заполнителем учетных данных, а затем сообщал об общей ошибке аутентификации `401` вместо сбоя скрипта.828В [non-interactive mode](/docs/ru/headless) stderr также содержит конкретную причину с префиксом `apiKeyHelper failed:`.
829
830Claude Code повторно запускает скрипт и повторяет попытку запроса еще два раза перед отображением этого сообщения, поэтому сбой проявляется в течение трех попыток. До v2.1.208 Claude Code потратил полный [retry budget](#automatic-retries) на повторную отправку запроса с заполнительными учетными данными, а затем сообщил об общей ошибке аутентификации `401` вместо сбоя скрипта.
831
832Запуск `/login` не помогает здесь: вывод помощника [takes precedence](/docs/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.
833
834**Что делать:**
835
836* Запустите команду, настроенную в `apiKeyHelper`, напрямую в вашей оболочке, чтобы воспроизвести сбой
837* Если команда сообщает об истекшем сеансе, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в свой SSO или хранилище секретов
838* Исправьте команду так, чтобы она выводила только ключ на stdout как один токен печатаемого ASCII до 16 384 символов и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей установки.
839* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Authentication` в терминале. До v2.1.212 панель была озаглавлена `Cloud authentication`.
840
841<h3 id="invalid-request-header-value">
842 Invalid request header value
843</h3>
844
845Значение, которое Claude Code собирался отправить как заголовок запроса, содержит символ, который HTTP-заголовки не могут передавать: разрыв строки, байт NUL или символ выше `U+00FF`, такой как фигурная кавычка или нулевой пробел. Claude Code останавливает запрос перед отправкой чего-либо и называет переменную или параметр для исправления. Обычная причина — учетные данные, вставленные из документа или чата, которые содержали невидимый символ или случайный разрыв строки.
846
847Claude Code запускает эту проверку при отправке запросов к Claude API напрямую или через [LLM gateway](/docs/ru/llm-gateway). На поставщике облачных услуг третьей стороны, таком как [Amazon Bedrock](/docs/ru/amazon-bedrock), Claude Code не запускает ее перед отправкой.
848
849```text theme={null}
850Invalid auth token · Fix external auth token
851Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
852Invalid request header from the environment · Fix the environment variable
853```
854
855Первая часть сообщения зависит от того, откуда поступило плохое значение:
856
857* `Invalid auth token`: токен-носитель из [`ANTHROPIC_AUTH_TOKEN`](/docs/ru/env-vars) или [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars)
858* `Invalid ANTHROPIC_CUSTOM_HEADERS`: имя или значение заголовка, которое вы установили в [`ANTHROPIC_CUSTOM_HEADERS`](/docs/ru/env-vars). Описание подсчитывает, какая пара `Name: Value` виновата, например `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, без повторения имени или значения, так как вы выбрали оба.
859* `Invalid request header from the environment`: значение, которое Claude Code копирует в заголовок запроса из другой переменной окружения, такой как `CLAUDE_AGENT_SDK_CLIENT_APP`. Описание называет переменную для исправления.
460 860
461Запуск `/login` здесь не помогает: вывод помощника [имеет приоритет](/docs/ru/authentication#authentication-precedence) над сохраненным входом, пока параметр присутствует.861Claude Code сообщает о плохом `ANTHROPIC_API_KEY`, перехваченном этой проверкой, как [Invalid API key](#invalid-api-key), с тем же завершающим описанием. Он сообщает о плохих сохраненных учетных данных `/login` как [Not logged in](#not-logged-in) вместо этого; запустите `/login`, чтобы сохранить свежие. Вывод скрипта [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) никогда не достигает этой проверки: Claude Code проверяет его при запуске скрипта, и вывод, который HTTP-заголовок не может передавать, завершается ошибкой [Your apiKeyHelper script is failing](#your-apikeyhelper-script-is-failing).
862
863После второго `·` сообщение описывает проблему, как в этом полном примере:
864
865```text theme={null}
866Invalid 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).
867```
868
869Позиции считают символы, начиная с одного. Описание построено из фиксированных фраз и подсчетов символов, поэтому оно никогда не включает само значение. Оно называет оскорбительный символ только тогда, когда это хорошо известный невидимый или типографский символ, такой как метка порядка байтов, нулевой пробел или фигурная кавычка, и сообщает обо всем остальном как `a non-ASCII character`.
462 870
463**Что делать:**871**Что делать:**
464 872
465* Запустите команду, настроенную в `apiKeyHelper`, непосредственно в вашей оболочке, чтобы воспроизвести сбой873* Переустановите переменную или параметр, который называет сообщение, переписав символы вокруг указанной позиции, а не вставляя из того же источника снова
466* Если команда сообщает об истекшей сессии, повторно аутентифицируйтесь у вашего поставщика учетных данных, например, снова войдя в ваш SSO или хранилище секретов874* Для `ANTHROPIC_CUSTOM_HEADERS` держите одну пару `Name: Value` на строку и переписывайте пару, которую считает сообщение
467* Исправьте команду так, чтобы она выводила ключ на stdout и выходила с кодом 0. См. [rotate credentials with apiKeyHelper](/docs/ru/llm-gateway-connect#rotate-credentials-with-apikeyhelper) для рабочей настройки.875* Запустите `/status`, чтобы подтвердить, какой источник учетных данных активен
468* Запустите `/status`, чтобы подтвердить, что `apiKeyHelper` является активным источником учетных данных. Каждый раз, когда команда не выполняется, ее код выхода и вывод ошибки появляются в панели `Cloud authentication` в терминале.
469 876
470<h3 id="this-organization-has-been-disabled">877<h3 id="this-organization-has-been-disabled">
471 This organization has been disabled878 This organization has been disabled
472</h3>879</h3>
473 880
474Устаревший `ANTHROPIC_API_KEY` из отключенной организации Console переопределяет вашу подписку входа.881Claude Code использует устаревший `ANTHROPIC_API_KEY` из отключенной организации Console. Когда у вас есть сохраненный вход подписки, ключ переопределяет его.
475 882
476```text theme={null}883```text theme={null}
477Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials884Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
885Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
478API Error: 400 ... This organization has been disabled.886API Error: 400 ... This organization has been disabled.
479```887```
480 888
481Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже если у вас есть рабочая подписка Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется, когда он присутствует.889Подсказка после `·` зависит от ваших сохраненных учетных данных: первая форма появляется, когда сохраненный `/login` может взять верх после отмены установки ключа, а вторая — когда ключ является вашим единственным учетным данным.
890
891Переменные окружения имеют приоритет над `/login`, поэтому ключ, экспортированный в профиль вашей оболочки или загруженный из файла `.env`, используется даже при наличии рабочей подписки Pro или Max. В неинтерактивном режиме (`-p`) ключ всегда используется при наличии.
482 892
483**Что делать:**893**Что делать:**
484 894
485* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`895* Отмените установку `ANTHROPIC_API_KEY` в текущей оболочке и удалите его из профиля вашей оболочки, затем перезапустите `claude`
896* Если сообщение говорит `Update or unset`, у вас нет сохраненного входа для отката. Отмените установку ключа и запустите `/login`, или замените ключ на ключ из активной организации Console.
486* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка897* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка
487* Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим `/login`. Свяжитесь с поддержкой или войдите с другой учетной записью.898* Если переменная окружения не установлена и ошибка сохраняется, отключенная организация — это та, которая связана с вашим `/login`. Свяжитесь с поддержкой или войдите с другой учетной записью.
488 899
490 Your organization has disabled API key authentication901 Your organization has disabled API key authentication
491</h3>902</h3>
492 903
493Это сообщение требует Claude Code версии 2.1.169 или более поздней. Администратор организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:904Это сообщение требует Claude Code v2.1.169 или более поздней версии. Администратор организации Console отключил аутентификацию по ключу API, поэтому API отклоняет ключ, который отправляет Claude Code. Подсказка восстановления после `·` варьируется в зависимости от того, откуда поступил ключ:
494 905
495```text theme={null}906```text theme={null}
496Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account907Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
503 914
504**Что делать:**915**Что делать:**
505 916
506* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите его из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`917* Если сообщение называет `ANTHROPIC_API_KEY`, отмените его установку в текущей оболочке и удалите из профиля вашей оболочки или файла `.env`, затем перезапустите `claude`
507* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/docs/ru/settings#available-settings) из вашего `settings.json`918* Если сообщение называет `apiKeyHelper`, удалите параметр [`apiKeyHelper`](/docs/ru/settings-reference#apikeyhelper) из вашего `settings.json`
508* Запустите `/login` для входа с помощью вашей учетной записи claude.ai919* Запустите `/login` для входа с вашей учетной записью claude.ai
509* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API920* Запустите `/status` после этого, чтобы подтвердить, что активные учетные данные — это ваша подписка, а не ключ API
510* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console921* Если вам нужна аутентификация по ключу API для автоматизации, попросите администратора вашей организации повторно включить ее в Console
511 922
513 Your organization has disabled Claude subscription access924 Your organization has disabled Claude subscription access
514</h3>925</h3>
515 926
516Ваша организация Claude не позволяет входить в Claude Code с помощью подписки. Повторный запуск `/login` с той же учетной записью возвращает ту же ошибку.927Ваша организация Claude не позволяет входить в Claude Code с входом подписки. Повторный запуск `/login` с той же учетной записью возвращает ту же ошибку.
517 928
518```text theme={null}929```text theme={null}
519Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access930Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
521 932
522Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.933Это параметр организации на стороне сервера, поэтому его нельзя переопределить из локальных параметров, переменных окружения или флагов CLI.
523 934
524Agent SDK и неинтерактивный режим `-p` представляют это как код ошибки `oauth_org_not_allowed`.935Agent SDK и режим неинтерактивности `-p` представляют это как код ошибки `oauth_org_not_allowed`.
525 936
526**Что делать:**937**Что делать:**
527 938
528* Попросите администратора включить доступ Claude Code для вашей организации939* Попросите администратора включить доступ Claude Code для вашей организации
529* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/docs/ru/authentication#claude-console-authentication) для настройки.940* Аутентифицируйтесь с помощью ключа API Console вместо вашей подписки. См. [Claude Console authentication](/docs/ru/authentication#claude-console-authentication) для установки.
530* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [Anthropic support](https://support.claude.com)941* Если вы администратор и не видите опцию для включения доступа, свяжитесь с [Anthropic support](https://support.claude.com)
531 942
532<h3 id="routines-are-disabled-by-your-organizations-policy">943<h3 id="routines-are-disabled-by-your-organizations-policy">
533 Routines are disabled by your organization's policy944 Routines are disabled by your organization's policy
534</h3>945</h3>
535 946
536Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, включая из `/schedule` и пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code.947Владелец в вашей организации Team или Enterprise отключил routines на уровне организации. Ошибка появляется при попытке создать или запустить routine, например из пользовательского интерфейса [Routines](/docs/ru/routines) на claude.ai/code. На Claude Code v2.1.227 или более поздней версии тот же параметр также [hides `/schedule`](/docs/ru/routines#troubleshooting) в CLI.
537 948
538```text theme={null}949```text theme={null}
539Routines are disabled by your organization's policy.950Routines are disabled by your organization's policy.
550 Remote Control requires the Anthropic API961 Remote Control requires the Anthropic API
551</h3>962</h3>
552 963
553Сеанс не взаимодействует с Anthropic API напрямую, поэтому нет бэкенда claude.ai для [Remote Control](/docs/ru/remote-control) для сопряжения.964Сеанс не разговаривает с Anthropic API напрямую, поэтому нет бэкенда claude.ai для [Remote Control](/docs/ru/remote-control) для сопряжения.
554 965
555```text theme={null}966```text theme={null}
556Remote Control is only available when using Claude via api.anthropic.com.967Remote 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.
557```968```
558 969
559Это появляется на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry. Начиная с версии 2.1.196, это также появляется, когда [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже если вы входите с claude.ai.970Второе предложение объясняет, что направило сеанс от Anthropic API; до v2.1.219 сообщение было только первым предложением. В зависимости от причины сообщение называет:
971
972* Переменную поставщика `CLAUDE_CODE_USE_*`, такую как `CLAUDE_CODE_USE_BEDROCK` для [Amazon Bedrock](/docs/ru/amazon-bedrock) или `CLAUDE_CODE_USE_VERTEX` для [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai)
973* [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), указывающий на хост, отличный от `api.anthropic.com`, такой как [LLM gateway](/docs/ru/llm-gateway) или прокси, даже при входе с claude.ai; до v2.1.196 пользовательский базовый URL не блокировал Remote Control
974* Вход в корпоративный [cloud gateway](/docs/ru/claude-apps-gateway) через `/login`, который не поддерживает Remote Control и не имеет переменной для отмены установки
560 975
561**Что делать:**976**Что делать:**
562 977
563* Отмените установку `ANTHROPIC_BASE_URL` и перезагрузите сеанс, или запустите Remote Control из сеанса, который взаимодействует с Anthropic API напрямую978* Отмените установку переменной, которую называет сообщение, такой как `CLAUDE_CODE_USE_BEDROCK` или `ANTHROPIC_BASE_URL`, и перезапустите сеанс, или запустите Remote Control из сеанса, который разговаривает с Anthropic API напрямую
979* Если переменная не установлена в вашей оболочке, проверьте ключ `env` в ваших [settings files](/docs/ru/settings#where-settings-live), который применяет переменные окружения к каждому сеансу
564* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)980* Для этого и других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)
565 981
566<h3 id="oauth-token-revoked-or-expired">982<h3 id="remote-control-couldnt-refresh-your-login">
567 OAuth token revoked or expired983 Remote Control couldn't refresh your login
568</h3>984</h3>
569 985
570Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.986Claude Code запускает живое соединение [Remote Control](/docs/ru/remote-control) на краткосрочных учетных данных, которые он получает и обновляет, используя ваш сохраненный вход claude.ai. Когда claude.ai перестает принимать этот вход, или Claude Code больше не имеет сохраненного входа, Claude Code останавливает Remote Control и просит вас войти снова. Любой сбой может произойти, пока Claude Code все еще подключается или позже, когда он обновляет учетные данные.
571 987
572Оба сообщения сообщают об отклонении, которое API вернул для запроса, отправленного Claude Code. Когда сохраненный вход уже был очищен после неудачного обновления, вы видите [Login expired](#login-expired) вместо этого.988Когда Claude Code просит службу входа обновить ваш сохраненный вход и не получает ответ, он продолжает запускать Remote Control и пытается обновление снова, пока учетные данные текущего соединения все еще действительны. Обновление не получает ответ, когда Claude Code не может достичь службы входа, запрос истекает, или служба завершается ошибкой без отклонения вашего входа. Если служба входа все еще не отвечает, когда эти учетные данные истекают, Claude Code останавливает Remote Control и сообщает `OAuth token refresh failed`.
989
990Когда Claude Code останавливает Remote Control, он показывает причину в предупреждении и в строке стенограммы, которая начинается с `Remote Control disconnected`. Ваш локальный сеанс продолжает работать без Remote Control. Этот раздел охватывает эти строки:
573 991
574```text theme={null}992```text theme={null}
575OAuth token revoked · Please run /login993Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
576OAuth token has expired · Please run /login994Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
577API Error: 401 ... authentication_error995Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
996Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
997Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
998Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
999Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
578```1000```
579 1001
1002Claude Code называет причину в середине сообщения:
1003
1004* `Claude.ai login expired` и `Claude.ai login was rejected`: claude.ai больше не принимает ваш сохраненный токен входа, потому что он истек или был отозван
1005* `OAuth token unavailable`: Claude Code не имел сохраненного токена входа, когда учетные данные соединения пришли на обновление
1006* `OAuth token refresh failed`: claude.ai отклонил ваш сохраненный токен входа, пока Claude Code переподключался, и обновление токена не произвело новый
1007* `JWT refresh failed: no OAuth token`: Claude Code не нашел сохраненный токен входа для обновления
1008* `Signed out of Claude`: вы вышли на этой машине, например, запустив `/logout` в другом терминале, поэтому Claude Code больше не имеет сохраненного входа для обновления соединения
1009
580**Что делать:**1010**Что делать:**
581 1011
582* Запустите `/login` для повторного входа1012* Запустите `/login` для входа снова
583* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`1013* Запустите `/remote-control` для переподключения сеанса. Сообщения, заканчивающиеся `run /login to restore Remote Control`, не нуждаются в этом шаге: Claude Code переподключается автоматически после входа.
584* Для повторных запросов на вход при запусках см. проверки системных часов и macOS Keychain в [Troubleshooting](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired)
585* Для других сбоев, включая `403 Forbidden` и проблемы с браузером OAuth, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)
586 1014
587<h3 id="login-expired">1015До v2.1.224 `OAuth token refresh failed — run /login to re-authenticate` читалось как `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, и `JWT refresh failed: no OAuth token — run /login` читалось как `no OAuth token available for recovery (code <N>)`. Сообщения `Claude.ai login expired`, `Claude.ai login was rejected` и `OAuth token unavailable` были добавлены в v2.1.225.
588 Login expired1016
1017До v2.1.238 Claude Code сообщал о случаях, которые теперь говорят `Signed out of Claude`, как `JWT refresh failed: no OAuth token — run /login`, и останавливал Remote Control с `Claude.ai login expired — run /login to restore Remote Control` как только одно обновление входа не получило ответ.
1018
1019<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1020 Remote Control stopped because the signed-in account changed
589</h3>1021</h3>
590 1022
591Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистила сохраненные учетные данные. После этого каждый запрос останавливается локально перед тем, как достичь API, потому что только `/login` может создать новые учетные данные. До версии 2.1.206 Claude Code отправляла запрос в любом случае с любыми учетными данными, оставшимися в окружении, и каждая модель затем не выполнялась с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.1023Claude Code показывает эту строку во время сеанса [Remote Control](/docs/ru/remote-control), когда вы входите в другую учетную запись claude.ai или организацию на этой машине. Вы сделали переключение вне сеанса Claude Code, например, запустив `/login` в другом терминале.
1024
1025Сеанс Remote Control, который вы запустили, пока были подписаны через `/login`, принадлежит учетной записи claude.ai и организации, которые были подписаны в то время.
592 1026
593```text theme={null}1027```text theme={null}
594Login expired · Please run /login1028Remote 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
595```1029```
596 1030
597В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `authentication_failed`:1031Claude Code останавливает сеанс Remote Control как только claude.ai подтверждает, что учетная запись или организация изменилась. Ваш локальный сеанс продолжает работать без Remote Control.
1032
1033**Что делать:**
1034
1035* Запустите `/remote-control` для запуска нового сеанса Remote Control под текущей учетной записью или организацией
1036* Для переключения назад запустите `/login` и войдите в предыдущую учетную запись или организацию снова. Затем запустите `/remote-control`.
1037
1038До v2.1.234 Claude Code не замечал, когда вы переключались на другую учетную запись или организацию вне сеанса Claude Code. Claude Code держал сеанс Remote Control подключенным до более позднего запроса к серверу Remote Control, который завершился ошибкой `Remote Control server rejected the request (HTTP 404)`. Этот сбой мог произойти часами после переключения.
1039
1040<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1041 Remote Control stopped because the app running the session signed out or switched accounts
1042</h3>
1043
1044Когда приложение Claude desktop или IDE размещает ваш сеанс, Claude Code получает свой токен входа из этого приложения, а не из `/login`. Когда claude.ai отклоняет этот токен, Claude Code просит приложение о новом. Если приложение отвечает, что оно вышло, или что оно теперь подписано на другую учетную запись Claude, Claude Code заканчивает сеанс [Remote Control](/docs/ru/remote-control) и отправляет приложению одну из этих строк:
598 1045
599```text theme={null}1046```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed1047Remote Control stopped — the app running this session is now signed in to a different Claude account
1048Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
601```1049```
602 1050
603Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают о 401, который вернул API. Claude Code сама создает `Login expired` для входа, который она уже не смогла обновить, поэтому она не отправляет запрос.1051Ваш локальный сеанс продолжает работать без Remote Control.
604
605Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.
606 1052
607**Что делать:**1053**Что делать:**
608 1054
609* Запустите `/login` для повторного входа. Повторная попытка без входа показывает то же сообщение при каждом запросе.1055* Если приложение вышло, войдите в него снова, затем включите Remote Control снова в приложении
610* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем повторно запустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).1056* Если приложение переключило учетные записи, Claude Code не может продолжить завершенный сеанс под новой учетной записью. Запустите новый сеанс Remote Control под этой учетной записью.
611* Если вход продолжает не выполняться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)
612 1057
613<h3 id="oauth-scope-requirement">1058До v2.1.238 Claude Code отправлял приложению сообщения `run /login`, перечисленные в [Remote Control couldn't refresh your login](#remote-control-couldnt-refresh-your-login) в обоих случаях.
614 OAuth scope requirement1059
1060<h3 id="oauth-token-revoked-or-expired">
1061 OAuth token revoked or expired
615</h3>1062</h3>
616 1063
617Сохраненный токен предшествует области разрешений, которая требуется более новой функции. Вы видите это чаще всего из `/usage` и индикатора использования в строке состояния:1064Ваш сохраненный вход больше не действителен. Отозванный токен означает, что вы вышли везде или администратор удалил доступ; истекший токен означает, что автоматическое обновление не удалось в середине сеанса.
1065
1066Оба сообщения сообщают об отклонении, которое API вернул для запроса, который отправил Claude Code. Когда сохраненный вход уже был очищен после неудачного обновления, вы видите [Login expired](#login-expired) вместо этого. Если вы аутентифицируетесь с долгоживущим токеном в [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars), вы видите те же сообщения, когда этот токен истекает или отзывается.
618 1067
619```text theme={null}1068```text theme={null}
620OAuth token does not meet scope requirement: user:profile1069OAuth token revoked · Please run /login
1070Please run /login · API Error: 401 OAuth token has expired ...
621```1071```
622 1072
623**Что делать:**1073**Что делать:**
624 1074
625* Запустите `/login` для получения нового токена с текущими областями. Вам не нужно предварительно выходить.1075* Запустите `/login` для входа снова
1076* Если ошибка возвращается в том же сеансе после повторной аутентификации, сначала запустите `/logout` для полной очистки сохраненного токена, затем `/login`
1077* Если вы аутентифицируетесь с переменной окружения `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code продолжает отправлять установленное вами значение после того, как запрос завершится ошибкой 401, а не переключаться на токен сохраненного входа. [`/status`](/docs/ru/commands) показывает это учетное данное как строку `Auth token`, читающую `CLAUDE_CODE_OAUTH_TOKEN`. Создайте свежий токен с помощью [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) и перезапустите с ним, или отмените установку переменной и запустите `/login`. До v2.1.225 Claude Code мог заменить значение переменной в середине сеанса краткосрочным токеном доступа из сохраненного входа, и сеанс снова завершился ошибками 401 после истечения этого токена.
1078* Для повторных запросов на вход при запусках см. проверки системных часов и шаги восстановления хранилища учетных данных macOS в [Troubleshooting](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired)
1079* Для других сбоев, включая `403 Forbidden` и проблемы браузера OAuth, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)
626 1080
627<h3 id="aws-credentials-expired-or-invalid">1081<h3 id="api-error-401-invalid-authentication-credentials">
628 AWS credentials expired or invalid1082 API Error: 401 Invalid authentication credentials
629</h3>1083</h3>
630 1084
631Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое уже запустил Claude Code, не создало учетные данные, которые API принимает. Это появляется при 401 от [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти провайдеры сообщают об истекшем токене безопасности.1085API распознал формат вашего учетного данного, но отклонил учетную запись или организацию позади него. Anthropic возвращает это сообщение, когда учетное данное было недавно отозвано, когда организация была отключена или удалила ваш доступ, или когда сама учетная запись была деактивирована, поэтому истекший токен не является причиной. Учетное данное может быть вашим сохраненным входом или одобренным `ANTHROPIC_API_KEY`, и исправление отличается, поэтому начните с запуска `/status`, чтобы увидеть, какой активен.
632
633Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS credentials expired or invalid`:
634 1086
635```text theme={null}1087```text theme={null}
636AWS 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 ...1088Please run /login · API Error: 401 Invalid authentication credentials
637```1089```
638 1090
639Без настроенного `awsAuthRefresh`, тот же 401 показывает вместо этого общее сообщение `Please run /login`, которое не может обновить учетные данные AWS.
640
641**Что делать:**1091**Что делать:**
642 1092
643* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку1093* Если `/status` показывает строку `API key`, которая не отмечена как не используется, одобренный [`ANTHROPIC_API_KEY`](/docs/ru/authentication#authentication-precedence) является активным учетным данным и имеет приоритет над вашим входом, поэтому `/login` не заменяет его. Поверните ключ в Claude Console, или вернитесь к вашей подписке, запустив `unset ANTHROPIC_API_KEY`, или в PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
644* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** в разделе **Using 3rd-party platforms** для запуска той же команды без перезагрузки Claude Code. См. [Configure AWS credentials](/docs/ru/claude-platform-on-aws#1-configure-aws-credentials)1094* Если `/status` показывает только ваш вход, запустите `/login` один раз. Если учетное данное было отозвано, свежий вход заменяет его.
645* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле1095* Если то же сообщение возвращается для той же учетной записи входа, учетная запись или организация больше не активны. Проверьте учетную запись и организацию, которые сообщает `/status`, и попросите администратора вашей организации восстановить доступ.
1096* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM gateway](/docs/ru/llm-gateway), текст после `401` — это сообщение вашего шлюза, а не Anthropic, и `/login` не изменяет его. Исправьте учетное данное, которое ожидает ваш шлюз.
646 1097
647<h3 id="aws-authentication-failed">1098<h3 id="login-expired">
648 AWS authentication failed1099 Login expired
649</h3>1100</h3>
650 1101
651Это сообщение требует Claude Code версии 2.1.198 или более поздней и появляется только когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш провайдер AWS вернул 403, или [Amazon Bedrock](/docs/ru/amazon-bedrock) вернул 401.1102Claude Code попытался обновить ваш сохраненный вход claude.ai или Claude Console, и служба OAuth отклонила сохраненный токен обновления, поэтому Claude Code очистил сохраненные учетные данные. После этого каждый запрос модели останавливается локально с этим сообщением перед тем, как достичь API, потому что только `/login` может создать новые учетные данные.
652 1103
653Claude Code не может определить, какую причину вы получили. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из-за отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.1104До v2.1.206 Claude Code отправлял запрос модели в любом случае с любым оставшимся учетным данным в окружении, и каждая модель затем завершалась ошибкой [There's an issue with the selected model](#theres-an-issue-with-the-selected-model) или 401 вместо запроса на вход.
654 1105
655401 от Amazon Bedrock также попадает сюда, а не в [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 от этой конечной точки обычно поступает из чего-то другого в пути запроса, такого как корпоративный прокси.1106```text theme={null}
1107Login expired · Please run /login
1108```
656 1109
657Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:1110В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) сообщение читается следующим образом, и код структурированной ошибки — `authentication_failed`:
658 1111
659```text theme={null}1112```text theme={null}
660AWS 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 ...1113Failed to authenticate: OAuth session expired and could not be refreshed
661```1114```
662 1115
663Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это начальная `AWS authentication failed`.1116Это не то же состояние, что [OAuth token revoked or expired](#oauth-token-revoked-or-expired). Эти сообщения сообщают об отклонении, которое API вернул. Claude Code сам производит `Login expired` для входа, который уже не удалось обновить, поэтому он не отправляет запрос. Когда обновление не удается, потому что сама учетная запись приостановлена, а не потому, что вход устарел, Claude Code показывает [Your account is on hold](#your-account-is-on-hold) вместо этого.
1117
1118Сеансы, аутентифицированные с помощью ключа API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) или поставщика третьей стороны, не используют сохраненный вход и никогда не видят это сообщение.
1119
1120Вы можете проверить это состояние перед тем, как запрос завершится ошибкой: [`/status`](/docs/ru/commands) показывает строку `Login`, читающую `Expired — log in again`, плюс организацию и электронную почту, которые она сохранила для истекшего входа. Строка появляется только, когда сохраненный вход является вашим активным учетным данным и больше не может быть обновлен. Сеансы, аутентифицированные другим способом, не показывают строку, даже если истекший вход остается сохраненным. До v2.1.210 `/status` не давал никакого указания в этом состоянии, что вход когда-либо существовал, потому что очищенное учетное данное оставило ему нечего сообщать.
664 1121
665**Что делать:**1122**Что делать:**
666 1123
667* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если причиной является истекшие учетные данные1124* Запустите `/login` для входа снова. Повторная попытка без входа показывает то же сообщение на каждом запросе.
668* Если ваши учетные данные актуальны, подтвердите, что разрешения IAM в [IAM configuration](/docs/ru/amazon-bedrock#iam-configuration) присоединены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона1125* В неинтерактивном режиме запустите `claude` в том же окружении, завершите `/login`, затем перезапустите вашу команду. Для автоматизации, которая не может войти интерактивно, аутентифицируйтесь с помощью `ANTHROPIC_API_KEY` или [generate a long-lived token with `claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token).
669* Запустите `aws sts get-caller-identity` для подтверждения того, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений1126* Если вход продолжает не удаваться, см. [Login and authentication](/docs/ru/troubleshoot-install#login-and-authentication)
670 1127
671<h3 id="aws-default-chain-credential-resolve-timed-out">1128<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
672 AWS default-chain credential resolve timed out1129 Administrator policy requires a Cloud gateway sign-in
673</h3>1130</h3>
674 1131
675Цепь поставщика учетных данных AWS по умолчанию не создала учетные данные в течение 60 секунд, поэтому Claude Code остановила разрешение и не выполнила запрос. Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.1132Параметр [managed settings](/docs/ru/managed-settings) администратора на этой машине установил [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"` или установил [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl). Если вы не выбираете поставщика облачных услуг через переменную, такую как `CLAUDE_CODE_USE_BEDROCK`, Claude Code затем принимает только вход [Claude apps gateway](/docs/ru/claude-apps-gateway). Вы видите одно из двух сообщений:
676 1133
677```text theme={null}1134```text theme={null}
678API Error: AWS default-chain credential resolve timed out1135Not signed in to the Cloud gateway — run /login.
679```1136```
680 1137
681Частые причины — это команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или виртуальная машина, служба метаданных экземпляра (IMDS) которых никогда не отвечает на зонд цепи. До версии 2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы не выполняться с этим сообщением.1138Запросы модели завершаются ошибкой с этим сообщением, когда сеанс не имеет входа шлюза, например, потому что вы не запустили `/login` с момента достижения политики машины.
1139
1140Если у вас также есть учетное данное `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, настроенное, и параметры управления установили `forceLoginMethod`, Claude Code выходит при запуске вместо этого с сообщением, которое начинается:
1141
1142```text theme={null}
1143Administrator policy requires a Cloud gateway sign-in on this machine; the
1144Anthropic-issued credential configured here (ANTHROPIC_API_KEY,
1145ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.
1146```
682 1147
683**Что делать:**1148**Что делать:**
684 1149
685* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.1150* Запустите `/login` и завершите вход на экране **Cloud gateway**
686* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, чтобы цепь разрешилась из локального кэша SSO вместо ожидания потока браузера1151* Для сообщения при запуске удалите параметр `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` или `apiKeyHelper`, который вы настроили, затем запустите `claude` и запустите `/login`
687* Если ваша цепь запускает интерактивный вход, который законно требует более 60 секунд, такой как SSO с MFA через оболочку, как `aws-vault`, повысьте лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)1152* Если вы считаете, что машина не должна требовать шлюз, попросите администратора, который управляет ею, удалить `forceLoginMethod` и `forceLoginGatewayUrl` из его параметров управления
688 1153
689<h2 id="network-and-connection-errors">1154На v2.1.265 регрессия также показала первое сообщение в некоторых конфигурациях LLM-gateway и прокси, которые аутентифицируются с помощью ключа API, `apiKeyHelper` или пользовательских заголовков, даже без требования администратора на машине. Обновитесь до v2.1.266 или более поздней версии. Вам не нужно менять вашу конфигурацию.
690 Ошибки сети и подключения
691</h2>
692 1155
693Эти ошибки означают, что сетевой запрос от Claude Code не смог достичь пункта назначения, или что-то между Claude Code и API изменило ответ на пути обратно. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.1156До v2.1.261 на машинах, которые установили `forceLoginMethod` на `"gateway"`, Claude Code использовал оставшийся сохраненный вход вместо того, чтобы завершить запросы модели ошибкой, и сообщал о настроенном учетном данном окружения с `This machine's managed settings require a first-party login` вместо сообщения при запуске. До v2.1.265 машина, чьи параметры управления установили только `forceLoginGatewayUrl`, не требовала входа шлюза, и Claude Code использовал оставшееся учетное данное там.
694 1157
695<h3 id="unable-to-connect-to-api">1158<h3 id="your-account-is-on-hold">
696 Unable to connect to API1159 Your account is on hold
697</h3>1160</h3>
698 1161
699TCP-соединение с API не удалось или никогда не завершилось.1162Учетная запись Claude позади вашего входа была приостановлена. Claude Code показывает первое сообщение, когда он пытается обновить ваш сохраненный вход и узнает о задержке, и второе, когда завершенный вами вход в браузер сообщает об этом:
700 1163
701```text theme={null}1164```text theme={null}
702Unable to connect to API. Check your internet connection1165Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
703Unable to connect to API (ECONNREFUSED)1166Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
704Unable to connect to API (ECONNRESET)
705Unable to connect to API (ETIMEDOUT)
706fetch failed
707Request timed out. Check your internet connection and proxy settings
708```1167```
709 1168
710Распространённые причины включают отсутствие доступа в Интернет, VPN, который блокирует `api.anthropic.com`, или требуемый корпоративный прокси, который не настроен.1169Повторный вход с той же учетной записью не очищает сообщение, потому что задержка находится на учетной записи, а не на входе. В [non-interactive mode](/docs/ru/headless) (`-p`) и [Agent SDK](/docs/ru/agent-sdk/overview) код структурированной ошибки — `account_on_hold`. До v2.1.235 Claude Code сообщал о задержанной учетной записи как [Login expired · Please run /login](#login-expired), чьи шаги восстановления не могут очистить задержку.
711 1170
712**Что делать:**1171**Что делать:**
713 1172
714* Убедитесь, что вы можете достичь хоста API из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.1173* Откройте ссылку в сообщении, чтобы просмотреть детали задержки или обжаловать ее
715* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Конфигурация сети](/docs/ru/network-config)1174* Если у вас есть другая учетная запись Claude или ключ API, на который не влияет задержка, вы можете продолжить работу, пока задержка разрешается: запустите `/login` с этой учетной записью, или установите ключ с помощью `ANTHROPIC_API_KEY`
716* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) на его адрес. См. [Подключение Claude Code к шлюзу LLM](/docs/ru/llm-gateway-connect) для настройки.
717* Убедитесь, что ваш брандмауэр разрешает хосты, указанные в [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements)
718* Перебойные сбои [автоматически повторяются](#automatic-retries); постоянные сбои указывают на локальную проблему с сетью
719
720Если `curl` работает успешно, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:
721
722* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.
723* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в Параметрах системы.
724* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.
725 1175
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">1176<h3 id="anthropic-profile-login-expired">
727 Bedrock streaming response has an unexpected content-type1177 Anthropic profile login expired
728</h3>1178</h3>
729 1179
730Шлюз или прокси между Claude Code и [Amazon Bedrock](/docs/ru/amazon-bedrock) преобразует тело потокового ответа или его заголовок `Content-Type`. Amazon Bedrock передаёт ответы потоком как `application/vnd.amazon.eventstream`, и Claude Code отклоняет успешный потоковый ответ, который сообщает о другом типе содержимого вместо декодирования тела, которое он не может прочитать. Запрос не повторяется.1180Claude Code аутентифицируется через профиль учетных данных Anthropic, чей сохраненный вход истек, и профиль не содержит учетные данные обновления, которые Claude Code может использовать для его обновления. Claude Code останавливает каждый запрос локально без повторных попыток, потому что повторная попытка прочитает то же истекшее учетное данное.
731 1181
732```text theme={null}1182```text theme={null}
733Bedrock 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.1183Anthropic profile login expired · Re-authenticate your Anthropic profile
1184Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
734```1185```
735 1186
736До версии 2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.1187Это появляется только, когда активное учетное данное поступает из профиля учетных данных Anthropic, который вы выбираете с переменной окружения `ANTHROPIC_PROFILE`, который Claude Code обнаруживает как активный профиль в вашем каталоге конфигурации Anthropic, или который Claude Code написал, когда вы [signed in without an API key](/docs/ru/authentication#sign-in-without-an-api-key). Сеансы, которые аутентифицируются с помощью опции claude.ai `/login`, ключа API, токена-носителя, такого как `ANTHROPIC_AUTH_TOKEN`, или поставщика третьей стороны, никогда не видят это сообщение.
1188
1189На машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login`, выберите учетную запись Anthropic Console и войдите снова, чтобы обновить профиль, который написал вход без ключа Console или CLI Claude Platform `ant auth login`. Claude Code заменяет истекшее учетное данные в этом профиле. Для профиля федерации или профиля, созданного другим инструментом, `/login` не обновляет учетное данные. Какую форму вы видите, зависит от того, выбрали ли вы профиль или Claude Code его обнаружил:
1190
1191* Когда вы явно установили `ANTHROPIC_PROFILE`, сообщение заканчивается с `Re-authenticate your Anthropic profile`.
1192* Когда Claude Code обнаружил профиль из вашего каталога конфигурации, сообщение предлагает `/login`, потому что Claude Code дает рабочему `/login` приоритет над обнаруженным профилем и затем аутентифицируется с вашей учетной записью claude.ai или Console вместо этого. До v2.1.234 Claude Code показал форму `Re-authenticate your Anthropic profile` в этом случае тоже.
737 1193
738**Что делать:**1194**Что делать:**
739 1195
740* Настройте шлюз для передачи тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Промежуточный узел, который повторно отправляет поток как события, отправляемые сервером, является распространённой причиной.1196* Войдите в профиль снова, затем повторите попытку: на машине, которая [offers the keyless sign-in](/docs/ru/authentication#sign-in-without-an-api-key), запустите `/login` и выберите учетную запись Anthropic Console для профиля, который написал вход без ключа Console или CLI Claude Platform `ant auth login`; для других профилей используйте инструмент, который их создал
741* Если шлюз переписывает только заголовок и передаёт двоичное тело без изменений, установите [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/ru/env-vars) для пропуска проверки до исправления шлюза. См. [Ошибки потоковой передачи за шлюзом или прокси](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).1197* Если администратор подготовил учетное данные профиля, попросите его выдать новое
1198* Запустите `/status`, чтобы подтвердить активный источник учетных данных и имя профиля
1199* Чтобы перестать использовать профиль, отмените установку `ANTHROPIC_PROFILE`, если вы его установили, затем аутентифицируйтесь другим способом, например `/login` или `ANTHROPIC_API_KEY`
742 1200
743<h3 id="ssl-certificate-errors">1201<h3 id="oauth-scope-requirement">
744 SSL certificate errors1202 OAuth scope requirement
745</h3>1203</h3>
746 1204
747Прокси или устройство безопасности в вашей сети перехватывает трафик TLS с помощью собственного сертификата, и Claude Code ему не доверяет.1205Сохраненный токен предшествует области разрешений, которая требуется более новой функции. Вы видите это чаще всего из `/usage` и индикатора использования строки состояния:
748 1206
749```text theme={null}1207```text theme={null}
750Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates1208OAuth token does not meet scope requirement: user:profile
751Unable to connect to API: Self-signed certificate detected
752```1209```
753 1210
754Начиная с версии 2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного [бюджета повторных попыток](#automatic-retries). Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как истечение времени ожидания при установлении соединения, всё ещё повторяются.1211**Что делать:**
1212
1213* Запустите `/login`, чтобы получить новый токен с текущими областями. Вам не нужно сначала выходить.
755 1214
756Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:1215<h3 id="claude-ai-rejected-the-session-token">
1216 claude.ai rejected the session token
1217</h3>
1218
1219Запрос [claude.ai connector](/docs/ru/mcp#use-mcp-servers-from-claude-ai) завершился ошибкой, потому что claude.ai отклонил токен из вашего входа Claude Code, обычно вход, который истек и не мог быть обновлен. Отклоненный токен — это ваш вход, а не собственная авторизация соединителя в claude.ai, поэтому повторная авторизация соединителя не разрешает это. В `/mcp` соединитель показывается как `connected · session token rejected` и его представление деталей читает:
757 1220
758```text theme={null}1221```text theme={null}
759SSL 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.1222claude.ai rejected the session token. Run /login, then reconnect.
760```1223```
761 1224
762**Что делать:**1225**Что делать:**
763 1226
764* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`1227* Запустите `/login` для входа снова
765* См. [Конфигурация сети](/docs/ru/network-config#custom-ca-certificates) для полных инструкций по настройке1228* Переподключите соединитель из `/mcp`, или запустите `/mcp reconnect <server>`. Переподключение перед повторным входом оставляет соединитель в том же состоянии. Опция **Reconnect** панели `/mcp` сообщает `your claude.ai session token was rejected`; введенная форма `/mcp reconnect <server>` сообщает об успешном переподключении, даже если токен все еще отклонен.
766* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата
767 1229
768<h3 id="host-not-allowed-in-a-cloud-session">1230До v2.1.222 Claude Code отметил соединитель как нуждающийся в аутентификации вместо этого, что указывал вас на поток авторизации соединителя, даже если завершение его не разрешало состояние.
769 Host not allowed in a cloud session1231
1232<h3 id="issuer-mismatch-in-authorization-response">
1233 Issuer mismatch in authorization response
770</h3>1234</h3>
771 1235
772Исходящий HTTP-запрос из облачной сессии или подпрограммы был заблокирован политикой сети среды.1236Во время [MCP OAuth sign-in](/docs/ru/mcp#authenticate-with-remote-mcp-servers) сервер авторизации перенаправил обратно в Claude Code с параметром `iss`, который не называет издателя, которого Claude Code ожидал от метаданных OAuth сервера. Неправильный издатель на этом шаге — это то, как выглядит атака смешивания сервера авторизации, поэтому Claude Code завершает вход ошибкой вместо обмена кодом авторизации. Claude Code показывает ошибку в меню сервера `/mcp` после входа в браузер:
773 1237
774```text theme={null}1238```text theme={null}
775HTTP 4031239Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
776x-deny-reason: host_not_allowed
777```1240```
778 1241
779Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачная среда маршрутизирует исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.1242`expected` — это издатель из метаданных OAuth сервера, и `received` — это значение `iss`, которое перенаправление несло. Вход, чье перенаправление не содержит параметр `iss`, проходит проверку, если только метаданные сервера не установили `authorization_response_iss_parameter_supported`, в этом случае Claude Code завершает вход ошибкой.
780
781Это не проблема сети на стороне клиента. Облачные сессии и [подпрограммы](/docs/ru/routines) работают внутри изолированной среды, исходящий трафик которой фильтруется в соответствии со списком разрешений среды. Среда **Default** использует доступ **Trusted**, который разрешает [список разрешений по умолчанию](/docs/ru/claude-code-on-the-web#default-allowed-domains) реестров пакетов, API поставщиков облачных услуг, реестров контейнеров и распространённых доменов разработки, но блокирует всё остальное.
782 1243
783**Что делать:**1244**Что делать:**
784 1245
785* Откройте подпрограмму для редактирования или запустите облачную сессию. Выберите облачный значок, показывающий имя вашей среды, например **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.1246* Попробуйте вход снова из `/mcp`
786* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [список разрешений по умолчанию](/docs/ru/claude-code-on-the-web#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.1247* Если ошибка повторяется, сообщите об этом оператору сервера. Исправление находится на стороне сервера: сервер авторизации должен вернуть того же издателя в параметре `iss`, который он объявляет в своих метаданных
787* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.1248* Для подключения, пока сервер исправляется, запустите Claude Code с [`MCP_SDK_GENERATION=v1`](/docs/ru/env-vars), чей [runtime](/docs/ru/mcp#mcp-client-runtimes) не запускает эту проверку. Это удаляет защиту от атак смешивания, поэтому предпочитайте исправление на стороне сервера
788 1249
789См. [Доступ в сеть](/docs/ru/claude-code-on-the-web#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сессии CLI не затронуты этой политикой.1250До v2.1.232 Claude Code использовал только v2 runtime в постепенном развертывании или когда вы установили `MCP_SDK_GENERATION=v2`.
790 1251
791<h3 id="couldnt-reconnect-to-your-remote-control-session">1252<h3 id="aws-credentials-expired-or-invalid">
792 Couldn't reconnect to your Remote Control session1253 AWS credentials expired or invalid
793</h3>1254</h3>
794 1255
1256Это сообщение требует Claude Code v2.1.198 или более поздней версии и появляется только, когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш токен сеанса AWS истек или был отклонен, и автоматическое обновление, которое Claude Code уже запустил, не произвело учетное данные, которое API принимает. Это появляется на 401 из [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint), что является тем, как эти поставщики сообщают об истекшем токене безопасности.
1257
1258Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это ведущая `AWS credentials expired or invalid`:
1259
795```text theme={null}1260```text theme={null}
796Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.1261AWS 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 ...
797```1262```
798 1263
799Возобновление с помощью `claude --resume` или `claude --continue` переподключается к сессии [Remote Control](/docs/ru/remote-control), записанной в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённая сессия. Ваша локальная сессия продолжает работать без Remote Control.1264Без `awsAuthRefresh`, настроенного, то же 401 показывает общее сообщение `Please run /login` вместо этого, которое не может обновить учетные данные AWS.
800 1265
801**Что делать:**1266**Что делать:**
802 1267
803* Запустите `/remote-control` для повторной попытки подключения1268* Запустите команду `awsAuthRefresh`, названную в сообщении, такую как `aws sso login --profile myprofile`, в другом терминале и завершите вход в браузер, затем повторите попытку
804* Запустите Claude Code без `--resume` для создания новой сессии Remote Control1269* В интерактивном сеансе запустите `/login`, выберите **3rd-party platform**, затем выберите **Claude Platform on AWS · refresh credentials** под **Using 3rd-party platforms**, чтобы запустить ту же команду без перезапуска Claude Code. См. [Configure AWS credentials](/docs/ru/claude-platform-on-aws#1-configure-aws-credentials)
805* Для других сообщений при запуске Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)1270* Если ошибка повторяется после успешного выполнения команды обновления, подтвердите, что идентификатор действителен вне Claude Code с помощью `aws sts get-caller-identity` в той же оболочке и профиле
806 1271
807Вы не увидите это сообщение, когда сервер подтвердит, что предыдущая сессия больше не существует; Claude Code создаст новую в этом случае. До версии 2.1.200 любой сбой переподключения создавал новую сессию Remote Control, которая оставляла дополнительные сессии в списке сессий на claude.ai/code.1272<h3 id="aws-authentication-failed">
1273 AWS authentication failed
1274</h3>
808 1275
809<h2 id="request-errors">1276Это сообщение требует Claude Code v2.1.198 или более поздней версии и появляется только, когда [`awsAuthRefresh`](/docs/ru/amazon-bedrock#advanced-credential-configuration) установлен в вашем файле параметров. Ваш поставщик AWS вернул 403, или [Amazon Bedrock](/docs/ru/amazon-bedrock) вернул 401.
810 Ошибки запроса
811</h2>
812 1277
813Эти ошибки связаны с содержимым вашего запроса. Большинство из них возвращаются API после отклонения запроса; несколько производятся локально Claude Code перед отправкой запроса.1278Claude Code не может сказать, какую причину вы попали. Amazon Bedrock сообщает об истекшем токене безопасности как 403, но 403 также является тем, как он сообщает об отказе в авторизации, такой как `AccessDeniedException` из отсутствующего разрешения IAM или модели, которая не включена для вашей учетной записи.
814 1279
815<h3 id="prompt-is-too-long">1280401 из Amazon Bedrock также приземляется здесь, а не под [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid), потому что Amazon Bedrock не сообщает об истекшем токене как 401. 401 из этой конечной точки обычно поступает из чего-то еще в пути запроса, такого как корпоративный прокси.
816 Prompt is too long
817</h3>
818 1281
819Разговор плюс прикреплённые файлы превышают контекстное окно модели.1282Обновление учетных данных исправляет истекший токен и не может исправить другие причины, поэтому сообщение предлагает оба:
820 1283
821```text theme={null}1284```text theme={null}
822Prompt is too long1285AWS 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 ...
823```1286```
824 1287
825**Что делать:**1288Подсказка действия в середине называет команду `awsAuthRefresh` из ваших параметров, поэтому она варьируется. Стабильная часть — это ведущая `AWS authentication failed`.
826 1289
827* Запустите `/compact` для суммирования предыдущих ходов и освобождения места, или `/clear` для начала заново1290**Что делать:**
828* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения
829* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <name>` для удаления их определений инструментов из контекста
830* Обрежьте большие файлы памяти `CLAUDE.md`, или переместите инструкции в [правила с областью действия пути](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости
831* Подагенты наследуют каждое определение инструмента MCP из родительской сессии, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.
832* Auto-compact включен по умолчанию и обычно предотвращает эту ошибку. Если вы установили [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), переактивируйте его или запустите `/compact` вручную перед заполнением окна.
833 1291
834Смотрите [Explore the context window](/docs/ru/context-window) для интерактивного просмотра того, как заполняется контекст.1292* Запустите команду `awsAuthRefresh`, названную в сообщении, или `aws sso login`, на случай, если истекшее учетное данные является причиной
1293* Если ваши учетные данные текущие, подтвердите разрешения IAM в [IAM configuration](/docs/ru/amazon-bedrock#iam-configuration), прикреплены к идентификатору, который вы используете, и что выбранная модель включена для вашей учетной записи и региона
1294* Запустите `aws sts get-caller-identity`, чтобы подтвердить, какой идентификатор используют ваши запросы; устаревший `AWS_PROFILE` или профиль по умолчанию — это частая причина несоответствия разрешений
835 1295
836<h3 id="error-during-compaction-conversation-too-long">1296<h3 id="could-not-load-aws-or-google-cloud-credentials">
837 Error during compaction: Conversation too long1297 Could not load AWS or Google Cloud credentials
838</h3>1298</h3>
839 1299
840`/compact` сам по себе не удался, потому что недостаточно свободного контекста для хранения создаваемого им резюме.1300Claude Code не мог получить используемые учетные данные из цепи поставщика учетных данных AWS или из ваших учетных данных приложения Google по умолчанию на машине, на которой он работает, поэтому ни один запрос не достиг вашего облачного поставщика. Claude Code очищает свои кэшированные учетные данные и повторяет попытку дважды перед отображением этого сообщения. Деталь после `·` называет конкретную причину, такую как истекший сеанс SSO, отсутствующие учетные данные приложения по умолчанию, сообщаемые как `Could not load the default credentials`, или отозванный вход, сообщаемый как `invalid_grant`:
841 1301
842```text theme={null}1302```text theme={null}
843Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.1303API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1304API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
844```1305```
845 1306
846Это может произойти, когда окно уже полно в момент срабатывания auto-compact, или когда вы запускаете `/compact` после появления `Prompt is too long`.1307В [non-interactive mode](/docs/ru/headless) с `-p` и в [Agent SDK](/docs/ru/agent-sdk/overview) код структурированной ошибки — `cloud_credential_error`. До v2.1.267 сообщение показало только текст деталей после `API Error:`, и структурированный код был `server_error` или `unknown`.
847 1308
848**Что делать:**1309**Что делать:**
849 1310
850* Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите `/compact` снова.1311* Запустите команду входа вашего поставщика, такую как `aws sso login --profile myprofile` или `gcloud auth application-default login`, затем повторите попытку. [Bedrock, Agent Platform, or Foundry credentials not loading](/docs/ru/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) показывает, как подтвердить учетные данные вне Claude Code
851* Если отступление не освобождает достаточно места, запустите `/clear` для начала новой сессии. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью `/resume`.1312* Если деталь читает `AWS default-chain credential resolve timed out`, цепь зависла, а не завершилась ошибкой, поэтому следуйте [AWS default-chain credential resolve timed out](#aws-default-chain-credential-resolve-timed-out) вместо этого
852 1313
853<h3 id="request-too-large">1314<h3 id="aws-default-chain-credential-resolve-timed-out">
854 Request too large1315 AWS default-chain credential resolve timed out
855</h3>1316</h3>
856 1317
857Тело необработанного запроса превысило лимит байтов API перед токенизацией, обычно из-за большого вставленного файла или вложения.1318Цепь поставщика учетных данных AWS по умолчанию не произвела учетные данные в течение 60 секунд, поэтому Claude Code остановил разрешение и завершил запрос ошибкой. Это время ожидания — одна из причин [Could not load AWS or Google Cloud credentials](#could-not-load-aws-or-google-cloud-credentials). Сбой — это локальное разрешение учетных данных: запрос никогда не достиг [Amazon Bedrock](/docs/ru/amazon-bedrock), [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) или [Mantle endpoint](/docs/ru/amazon-bedrock#use-the-mantle-endpoint). Claude Code очищает свой [credential cache](/docs/ru/amazon-bedrock#credential-caching-and-resolution-timeout) и повторяет попытку перед тем, как эта ошибка проявляется, поэтому к тому времени, когда вы ее видите, цепь зависла при повторных попытках.
858 1319
859```text theme={null}1320```text theme={null}
860Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.1321API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
861```1322```
862 1323
863Это ограничение размера HTTP запроса, отдельное от [лимита контекстного окна](#prompt-is-too-long).1324Частые причины — команда `credential_process` в вашем профиле AWS, которая ждет входа, который она не может получить, и контейнер или VM, чей сервис метаданных экземпляра (IMDS) никогда не отвечает на зонд цепи.
1325
1326До v2.1.267 сообщение читалось `API Error: AWS default-chain credential resolve timed out`.
1327До v2.1.207 зависшая цепь оставляла запрос ожидающим неопределенно долго вместо того, чтобы завершиться ошибкой.
864 1328
865**Что делать:**1329**Что делать:**
866 1330
867* Нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, который добавил содержимое с избыточным размером1331* Запустите `aws sts get-caller-identity` в той же оболочке с тем же `AWS_PROFILE`. Если он также зависает, исправьте профиль; команда `credential_process`, которая запрашивает интерактивно, — это частая причина.
868* Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude мог читать их по частям1332* Завершите шаг входа перед запуском Claude Code, например `aws sso login --profile myprofile`, поэтому цепь разрешается из локального кэша SSO вместо ожидания потока браузера
869* Для изображений смотрите [Image was too large](#image-was-too-large) ниже1333* Если ваша цепь запускает интерактивный вход, который законно нуждается в более чем 60 секундах, такой как SSO с MFA через оболочку, такую как `aws-vault`, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)
870 1334
871<h3 id="image-was-too-large">1335<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
872 Image was too large1336 Bedrock setup verification timed out waiting for AWS
873</h3>1337</h3>
874 1338
875Вставленное или прикреплённое изображение превышает ограничения размера или размеров API.1339Вызов AWS во время [Bedrock setup wizard](/docs/ru/amazon-bedrock#sign-in-with-bedrock) проверки учетных данных, такой как поиск учетных данных или проверка идентификатора, не завершился в течение лимита 60 секунд. Мастер перестает ждать и завершает шаг проверки ошибкой:
876 1340
877```text theme={null}1341```text theme={null}
878Image was too large. Double press esc to go back and try again with a smaller image.1342Timed 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.
879API Error: 400 ... image dimensions exceed max allowed size
880```1343```
881 1344
882Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторять одну и ту же ошибку при каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на несколько ходов назад, пройдя ход, где было добавлено изображение.1345Число отражает ваш лимит: 60 секунд по умолчанию, или значение, которое вы установили в [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars).
883 1346
884**Что делать:**1347Частые причины — сеть или прокси, которые зависают запросы к AWS, включая обновление токена SSO, и помощник учетных данных, все еще ожидающий входа, который вы не можете видеть. Поднимите лимит только, когда помощник законно нуждается в большем времени.
885 1348
886* Измените размер изображения перед вставкой. API принимает изображения размером до 8000 пикселей по самому длинному краю для одного изображения, или 2000 пикселей, когда в контексте много изображений.1349Один зависший запрос к AWS также может завершиться ошибкой на его собственном времени ожидания для каждого запроса, которое показывает более короткое сообщение на том же шаге:
887* Сделайте более плотный скриншот соответствующей области вместо полного экрана
888 1350
889<h3 id="unable-to-resize-image">1351```text theme={null}
890 Unable to resize image1352A request to AWS timed out. Check your network and proxy settings, then try again.
891</h3>1353```
892 1354
893Claude Code не смог уменьшить масштаб прикреплённого изображения перед отправкой его в API.1355Когда те же времена ожидания происходят на шаге закрепления модели, мастер отмечает модель как `unreachable` вместо отображения любого сообщения.
1356
1357**Что делать:**
1358
1359* Запустите `aws sts get-caller-identity` в той же оболочке. Если он также зависает, зависание находится вне Claude Code, в вашей сети, вашем прокси или помощнике учетных данных в вашем профиле AWS; исправьте это сначала.
1360* Завершите любой интерактивный вход перед открытием мастера, например `aws sso login --profile myprofile`
1361* Если помощник учетных данных в вашем профиле AWS законно нуждается в более чем 60 секундах для запроса, поднимите лимит в миллисекундах с помощью [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/ru/env-vars)
1362
1363<h3 id="cloud-gateway-session-expired">
1364 Cloud gateway session expired
1365</h3>
1366
1367Вы вошли через [Claude apps gateway](/docs/ru/claude-apps-gateway), и сеанс шлюза, сохраненный на этой машине, истек и не мог быть обновлен, или шлюз больше его не принимает, например, после [JWT secret is replaced](/docs/ru/claude-apps-gateway-deploy#jwt-secret-rotation) шлюза. Если вы видите эту строку при запуске `claude` интерактивно, сеанс открылся без входа в шлюз:
1368
1369```text theme={null}
1370Cloud gateway session expired — run /login to reconnect.
1371```
1372
1373Та же строка может появиться в середине сеанса, когда учетные данные шлюза истекают и Claude Code не может их обновить.
1374
1375В [non-interactive](/docs/ru/headless) запуске, фоновом или другом автоматическом сеансе, или подкоманде `claude`, отличной от `claude auth`, Claude Code выходит с этим сообщением вместо этого, когда шлюз больше не принимает сеанс:
1376
1377```text theme={null}
1378Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1379```
1380
1381**Что делать:**
1382
1383* Запустите `/login` в сеансе и завершите вход в браузер
1384* Для неинтерактивного запуска запустите `claude` в том же окружении, запустите `/login`, затем перезапустите вашу команду
1385
1386<h2 id="network-and-connection-errors">
1387 Ошибки сети и подключения
1388</h2>
1389
1390Большинство этих ошибок означают, что сетевой запрос из Claude Code не достиг пункта назначения, или что-то между Claude Code и API изменило ответ на обратном пути; если запись также содержит локальную причину, такую как ошибка записи архива, это указано в её описании. Обычно они возникают в вашей локальной сети, прокси или брандмауэре, либо в политике сети облачной среды.
1391
1392<h3 id="unable-to-connect-to-api">
1393 Unable to connect to API
1394</h3>
1395
1396TCP-соединение с API не удалось или никогда не завершилось. Для распространённых кодов ошибок подключения сообщение указывает тип сбоя и сохраняет код в скобках:
1397
1398```text theme={null}
1399Unable to connect to API. Check your internet connection
1400Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
1401Can't reach the API server — check your internet or DNS (ENOTFOUND)
1402No internet route — check your connection or VPN (EHOSTUNREACH)
1403Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
1404Connection dropped (ECONNRESET)
1405fetch failed
1406Request timed out. Check your internet connection and proxy settings
1407```
1408
1409Код, который Claude Code не распознаёт, отображается как `Unable to connect to API` с кодом в скобках. Некоторые из этих сообщений могут показывать более одного кода: `Connection refused` может показать `ConnectionRefused` или `ECONNREFUSED`, например, а `Can't reach the API server` может показать `ENOTFOUND` или `FailedToOpenSocket`.
1410
1411До версии v2.1.227 каждое из этих кодированных сообщений читалось как `Unable to connect to API` с кодом, например `Unable to connect to API (ECONNREFUSED)`.
1412
1413Распространённые причины включают отсутствие доступа в интернет, VPN, который блокирует `api.anthropic.com`, или требуемый корпоративный прокси, который не настроен.
1414
1415**Что делать:**
1416
1417* Подтвердите, что вы можете достичь хоста API из той же оболочки, запустив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы встроенный псевдоним `Invoke-WebRequest` не использовался.
1418* Если вы находитесь за корпоративным прокси, установите `HTTPS_PROXY` перед запуском Claude Code и см. [Network configuration](/docs/ru/network-config)
1419* Если вы маршрутизируете через шлюз LLM или ретранслятор, установите [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) на его адрес. См. [Connect Claude Code to an LLM gateway](/docs/ru/llm-gateway-connect) для настройки.
1420* Убедитесь, что ваш брандмауэр разрешает хосты, указанные в [Network access requirements](/docs/ru/network-config#network-access-requirements)
1421* Прерывистые сбои [повторяются автоматически](#automatic-retries); постоянные сбои указывают на локальную проблему сети
1422
1423Если `curl` успешен, но Claude Code всё ещё не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:
1424
1425* На Linux и WSL проверьте `/etc/resolv.conf` на наличие недостижимого сервера имён. WSL в частности может унаследовать неработающий распознаватель от хоста.
1426* На macOS клиент VPN, который был отключен или удален, может оставить интерфейс туннеля или правило маршрутизации. Проверьте `ifconfig` на наличие устаревших интерфейсов `utun` и удалите сетевое расширение VPN в System Settings.
1427* Docker Desktop и аналогичные среды выполнения контейнеров могут перехватывать исходящий трафик. Закройте их и повторите попытку, чтобы исключить это.
1428
1429<h3 id="unable-to-connect-to-anthropic-services">
1430 Unable to connect to Anthropic services
1431</h3>
1432
1433Во время первоначальной настройки Claude Code проверяет, что он может достичь `api.anthropic.com` и `platform.claude.com` перед отображением шага входа. Когда одна из проверок не удаётся, Claude Code выводит причину и выходит.
1434
1435```text theme={null}
1436Unable to connect to Anthropic services
1437Failed to connect to api.anthropic.com: ECONNREFUSED
1438Connection to api.anthropic.com timed out after 10 seconds
1439A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.
1440```
1441
1442Claude Code отправляет проверку через ту же [proxy configuration](/docs/ru/network-config), что и запросы API, и даёт каждому зонду 10 секунд. Когда неудачный зонд прошёл через прокси, сообщение указывает переменную окружения, которая его настроила, такую как `HTTPS_PROXY`. До версии v2.1.222 проверка использовала другой транспорт прокси без тайм-аута: за прокси URL со схемой `https://` она могла зависнуть на `Checking connectivity...` неопределённо долго, а затем не удаться, даже если запросы API через тот же прокси успешны.
1443
1444Claude Code пропускает эту проверку, когда [managed settings file, MDM policy, или policy helper](/docs/ru/managed-settings) устанавливает [`forceLoginMethod`](/docs/ru/settings-reference#forceloginmethod) на `"gateway"`, или устанавливает [`forceLoginGatewayUrl`](/docs/ru/settings-reference#forcelogingatewayurl) без `forceLoginMethod`. С любой из этих конфигураций Claude Code открывает шаг входа на экране **Cloud gateway** вместо метода входа Anthropic. Claude Code также пропускает проверку, когда источник управляемых параметров на машине существует, но не может быть прочитан, поскольку этот источник может содержать конфигурацию шлюза. До версии v2.1.247 Claude Code запускал проверку и при этой конфигурации и выходил с этой ошибкой, когда конечные точки Anthropic были недостижимы.
1445
1446**Что делать:**
1447
1448* Если сообщение указывает переменную прокси, проверьте, что её значение указывает на правильный прокси, и попросите вашу команду сети разрешить HTTPS-соединения через него к хосту в сообщении. См. [Network configuration](/docs/ru/network-config).
1449* Пройдите проверки в [Unable to connect to API](#unable-to-connect-to-api). Тест `curl` и рекомендации по брандмауэру там применяются и к этой проверке.
1450* Если ваша организация входит через [cloud gateway](/docs/ru/claude-apps-gateway) и эта ошибка появляется при первом запуске, обновитесь до Claude Code v2.1.247 или позже.
1451* Если ваша сеть открыта и сбой сохраняется, Claude Code может быть [недоступен в вашей стране](https://www.anthropic.com/supported-countries)
1452
1453<h3 id="socket-is-closed">
1454 Socket is closed
1455</h3>
1456
1457`Socket is closed` означает, что соединение, несущее потоковый ответ, было закрыто, пока ответ всё ещё поступал. Наиболее распространённая причина — корпоративный прокси на Windows, отбрасывающий установленный туннель в середине ответа.
1458
1459В зависимости от того, насколько далеко продвинулся ответ, Claude Code повторяет запрос, сохраняет то, что произвёл Claude, или завершает ход. См. [Automatic retries](#automatic-retries).
1460
1461До версии v2.1.214 Claude Code не повторял этот сбой, и ход останавливался с ошибкой, содержащей `Socket is closed`.
1462
1463**Что делать:**
1464
1465* Если вы видите эту ошибку, обновитесь до v2.1.214 или позже с помощью `claude update`, затем отправьте ваше сообщение снова
1466* Если ходы продолжают не удаваться за тем же прокси после обновления, пройдите [Unable to connect to API](#unable-to-connect-to-api) и проверьте настройку прокси в [Network configuration](/docs/ru/network-config)
1467
1468<h3 id="api-returned-an-empty-or-malformed-response">
1469 API returned an empty or malformed response
1470</h3>
1471
1472Claude Code показывает эту ошибку, когда его повторная попытка без потока неудачного потокового запроса получает статус HTTP успеха, но тело не является сообщением Claude API: обычно это HTML-ошибка или страница входа, пустое тело или JSON в другом формате. Прокси, шлюз или страница входа в сеть, отвечающие вместо API, — обычный источник. Claude Code не повторяет запрос, и ход заканчивается этой ошибкой.
1473
1474```text theme={null}
1475API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.
1476```
1477
1478После этого открытия сообщение сообщает, что вернулось и какой запрос не удался:
1479
1480* Предложение `Response:` с типом содержимого, типом тела, таким как `body is an HTML page` или `empty body`, его размером в байтах и наличием ли в ответе идентификатора запроса Anthropic. Когда ответ указывает на узнаваемый сервер, такой как `nginx` или `cloudflare`, или содержит заголовки промежуточного звена, такие как `cf-ray` или `via`, предложение также их перечисляет.
1481* Предложение, указывающее идентификатор неудачного потокового запроса и сбой, который вызвал повторную попытку. Когда поток открылся до сбоя, он также сообщает, сколько событий потока прибыло и, если какие-то прибыли, как долго поток молчал, когда попытка не удалась.
1482
1483До версии v2.1.234 сообщение заканчивалось после `intercepting the request`.
1484
1485**Что делать:**
1486
1487* Прочитайте предложение `Response:`, чтобы увидеть, какая система ответила. HTML-тело, отсутствие идентификатора запроса Anthropic или названный сервер, такой как `nginx` или `cloudflare`, означает, что что-то между Claude Code и API ответило вместо него
1488* Если вы маршрутизируете через [LLM gateway](/docs/ru/llm-gateway-connect#troubleshoot-gateway-errors), протестируйте маршрут прямым запросом и исправьте переход, который возвращает ответ, отличный от API
1489* В сети со страницей входа, такой как гостевой Wi-Fi, завершите вход в браузере, затем повторите попытку
1490* Если только маршрут без потока через ваш шлюз сломан, установите [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1`](/docs/ru/env-vars#variables), чтобы запрос, который не удаётся в середине потока, перешёл на обычный путь повторной попытки вместо этого резервного варианта, кроме случаев, когда сама конечная точка потока возвращает `404`, где Claude Code всё ещё переходит на резервный вариант
1491
1492<h3 id="streaming-response-ended-before-any-complete-data-was-received">
1493 Streaming response ended before any complete data was received
1494</h3>
1495
1496Потоковый ответ от вашего поставщика модели завершился без доставки каких-либо полезных данных, поэтому Claude Code повторно отправил запрос без потока, чтобы завершить ход. Claude Code показывает предупреждение один раз за сеанс, только в интерактивных сеансах. До версии v2.1.239 Claude Code молча повторял попытку без потока.
1497
1498```text theme={null}
1499Streaming 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.
1500```
1501
1502Claude Code отправляет каждый затронутый запрос дважды: пустую попытку потока и повторную попытку. Обычная причина — прокси или шлюз, который потребляет или преобразует тело потокового ответа на обратном пути.
1503
1504**Что делать:**
1505
1506* Настройте любой прокси или шлюз между Claude Code и вашим поставщиком модели, чтобы пропускать тела потоковых ответов и их заголовки без изменений
1507* На [Amazon Bedrock](/docs/ru/amazon-bedrock) см. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) для требований к заголовкам и телу
1508
1509<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
1510 Bedrock streaming response has an unexpected content-type
1511</h3>
1512
1513Шлюз или прокси между Claude Code и [Amazon Bedrock](/docs/ru/amazon-bedrock) преобразует тело потокового ответа или его заголовок `Content-Type`. Amazon Bedrock потоком передаёт ответы как `application/vnd.amazon.eventstream`. Вместо декодирования тела, которое он не может прочитать, Claude Code отклоняет успешный потоковый ответ, который сообщает другой тип содержимого. Claude Code не повторяет запрос.
1514
1515```text theme={null}
1516Bedrock 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.
1517```
1518
1519До версии v2.1.208 та же неправильная конфигурация проявлялась как `API Error: Truncated event message received` после того, как весь ответ был буферизирован.
1520
1521**Что делать:**
1522
1523* Настройте шлюз на пропуск тела ответа `InvokeModelWithResponseStream` и его заголовка `Content-Type` без изменений. Промежуточное звено, которое повторно излучает поток как события, отправляемые сервером, — распространённая причина.
1524* Установка [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/docs/ru/env-vars) скрывает эту ошибку, но Claude Code не декодирует двоичное тело под переписанным заголовком, поэтому эти запросы переходят на более медленный путь без потока. См. [Streaming errors behind a gateway or proxy](/docs/ru/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
1525
1526<h3 id="ssl-certificate-errors">
1527 SSL certificate errors
1528</h3>
1529
1530Прокси или устройство безопасности в вашей сети перехватывает трафик TLS со своим собственным сертификатом, и Claude Code ему не доверяет.
1531
1532```text theme={null}
1533Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
1534Unable to connect to API: Self-signed certificate detected. Check your proxy or corporate SSL certificates
1535```
1536
1537Начиная с версии v2.1.199, сбой проверки сертификата не повторяется, поэтому эта ошибка появляется при первой попытке вместо того, чтобы появиться после полного [retry budget](#automatic-retries). Более ранние версии потратили несколько минут на повторные попытки перед её отображением. Переходящие условия TLS, такие как тайм-аут рукопожатия, всё ещё повторяются.
1538
1539Во время `/login` и проверки подключения при запуске тот же сбой сообщается с кодом OpenSSL и исправлением в строке:
1540
1541```text theme={null}
1542SSL 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.
1543```
1544
1545На [Amazon Bedrock](/docs/ru/amazon-bedrock) запросы, которые Claude Code сам отправляет в AWS, такие как вызовы учётных данных роли STS и SSO, обнаружение модели и проверки мастера настройки, зависят от той же конфигурации сертификата. См. [Certificate errors behind a TLS-inspecting proxy](/docs/ru/amazon-bedrock#certificate-errors-behind-a-tls-inspecting-proxy).
1546
1547**Что делать:**
1548
1549* Экспортируйте пакет CA вашей организации и укажите Claude Code на него с помощью `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`
1550* См. [Network configuration](/docs/ru/network-config#custom-ca-certificates) для полных инструкций по настройке
1551* Не устанавливайте `NODE_TLS_REJECT_UNAUTHORIZED=0`, что полностью отключает проверку сертификата
1552
1553<h3 id="host-not-allowed-in-a-cloud-session">
1554 Host not allowed in a cloud session
1555</h3>
1556
1557Исходящий HTTP-запрос из облачного сеанса или подпрограммы был заблокирован политикой сети среды.
1558
1559```text theme={null}
1560HTTP 403
1561x-deny-reason: host_not_allowed
1562```
1563
1564Вы также можете увидеть сертификат TLS, который не соответствует реальному сертификату пункта назначения. Облачные сеансы маршрутизируют исходящий трафик через прокси, который применяет политику сети, поэтому несоответствующий сертификат означает, что прокси завершил соединение, а не пункт назначения.
1565
1566Это не проблема сети на стороне клиента. Облачные сеансы и [routines](/docs/ru/routines) работают внутри изолированной виртуальной машины, исходящий трафик которой через сеанс отфильтрован в [cloud environment's](/docs/ru/cloud-environments) список разрешений; [GitHub operations](/docs/ru/cloud-environments#github-proxy) и трафик соединителя MCP используют отдельные каналы, поэтому они могут продолжать работать, пока другие хосты заблокированы. Среда **Default** использует доступ **Trusted**, который разрешает [default allowlist](/docs/ru/cloud-environments#default-allowed-domains) реестров пакетов, API поставщиков облака, реестров контейнеров и распространённых доменов разработки и блокирует другие домены на этом пути.
1567
1568**Что делать:**
1569
1570* Откройте подпрограмму для редактирования или запустите облачный сеанс. Выберите значок облака, показывающий имя вашей среды, такое как **Default**, чтобы открыть селектор. Наведите указатель на вашу среду и нажмите значок параметров.
1571* В диалоговом окне **Update cloud environment** измените **Network access** с **Trusted** на **Custom**, затем добавьте заблокированный домен в **Allowed domains**. Введите один домен в строку. Установите флажок **Also include default list of common package managers**, чтобы сохранить [default allowlist](/docs/ru/cloud-environments#default-allowed-domains) вместе с вашими пользовательскими доменами. Выберите **Full** вместо этого, если вы хотите неограниченный доступ.
1572* Нажмите **Save changes**. Следующий запуск использует обновленный список разрешений.
1573
1574См. [Network access](/docs/ru/cloud-environments#network-access) для уровней доступа и списка разрешений по умолчанию. Локальные сеансы CLI не затронуты этой политикой.
1575
1576<h3 id="the-proxy-refused-the-connection">
1577 The proxy refused the connection
1578</h3>
1579
1580Вы видите это сообщение, когда Claude читает [artifact](/docs/ru/artifacts) через прокси, который вы установили в `HTTPS_PROXY` или связанную [proxy variable](/docs/ru/network-config#environment-variables). Содержимое артефакта поступает из `*.frame.claudeusercontent.com`, поэтому Claude Code сначала отправляет прокси запрос `CONNECT`, прося его открыть туннель к этому хосту. Когда прокси отказывает, ничего не достигает хоста, и сообщение содержит статус HTTP прокси:
1581
1582```text theme={null}
1583artifact content fetch failed (proxy refused the connection: HTTP 407)
1584artifact content fetch failed (proxy refused the connection: HTTP 403)
1585the proxy refused the connection to the artifact's content host (HTTP 502)
1586```
1587
1588Статус — это ответ прокси на `CONNECT`. Хост никогда не ответил, поэтому каждый статус указывает на другое исправление:
1589
1590* `HTTP 407`: прокси требует учётные данные, которые он не получил. Поместите их в URL прокси, как показано в [Basic authentication](/docs/ru/network-config#basic-authentication).
1591* `HTTP 403`: прокси отказывается туннелировать к `*.frame.claudeusercontent.com`. Попросите того, кто управляет прокси, разрешить этот хост, который [Network access requirements](/docs/ru/network-config#network-access-requirements) перечисляет.
1592* Любой другой статус, такой как `HTTP 502`: прокси не открыл туннель по своей причине, такой как неудача достижения хоста. Посмотрите статус в журналах прокси.
1593* `unreadable reply` вместо статуса: то, что находится по адресу прокси, не ответило строкой статуса HTTP. Проверьте, что адрес — это HTTP-прокси.
1594
1595**Что делать:**
1596
1597* Проверьте адрес и учётные данные в переменной прокси, как описано в [Proxy configuration](/docs/ru/network-config#proxy-configuration), затем запустите `curl -x http://proxy.example.com:8080 -I https://api.anthropic.com` из оболочки, в которой вы запускаете Claude Code, используя ваш собственный URL прокси. В Windows PowerShell запустите `curl.exe`. Если этот зонд не удаётся так же, сначала исправьте настройку прокси. Если он успешен, отказ специфичен для хоста артефакта.
1598* Если ваша сеть позволяет Claude Code достичь хоста артефакта напрямую, добавьте `.frame.claudeusercontent.com` в [`NO_PROXY`](/docs/ru/network-config#environment-variables). Сохраняйте запись узкой: более широкая запись `.claudeusercontent.com` также обходит прокси для `bridge.claudeusercontent.com`, который организациям с [IP allowlisting](/docs/ru/network-config#organization-ip-allowlists-and-proxy-egress) нужно сохранить на прокси.
1599
1600До версии v2.1.238 Claude Code сообщал об отказанном туннеле как об общей ошибке сети.
1601
1602<h3 id="the-cloud-environments-service-returned-an-empty-or-unexpected-response">
1603 The cloud environments service returned an empty or unexpected response
1604</h3>
1605
1606Claude Code запрашивает ваш список [cloud environments](/docs/ru/cloud-environments) в нескольких местах, например, когда вы создаёте облачный сеанс из CLI или запускаете [`/remote-env`](/docs/ru/cloud-environments#select-an-environment-from-the-cli). Когда он не может прочитать ответ сервера, он показывает одно из этих сообщений:
1607
1608```text theme={null}
1609The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
1610The 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.
1611The 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.
1612```
1613
1614Сервер принял запрос, но ответил телом, которое не является списком сред: пусто, не JSON или JSON без списка. Это обычно сопровождает сбой на стороне сервиса и очищается самостоятельно. В зависимости от поверхности, которая запросила список, Claude Code может добавить префикс, такой как `couldn't list environments:` в диалоговом окне `/remote-env`.
1615
1616**Что делать:**
1617
1618* Повторите действие. Claude Code запрашивает список снова каждый раз
1619* Если сообщение продолжает появляться, проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов
1620
1621До версии v2.1.236 Claude Code показывал необработанную ошибку JavaScript TypeError вместо этих сообщений.
1622
1623<h3 id="couldnt-reconnect-to-your-remote-control-session">
1624 Couldn't reconnect to your Remote Control session
1625</h3>
1626
1627```text theme={null}
1628Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.
1629```
1630
1631Возобновление с помощью `claude --resume` или `claude --continue` переподключается к сеансу [Remote Control](/docs/ru/remote-control), записанному в этом разговоре. Это сообщение означает, что переподключение не удалось по причине, которая может быть временной, такой как сетевой сбой или ошибка сервера, поэтому Claude Code не может подтвердить, существует ли удалённый сеанс. Ваш локальный сеанс продолжает работать без Remote Control.
1632
1633**Что делать:**
1634
1635* Запустите `/remote-control` для повторной попытки подключения
1636* Запустите новый сеанс с помощью `claude --remote-control`, чтобы создать новый сеанс Remote Control
1637* Для других сообщений запуска Remote Control см. [Troubleshoot Remote Control](/docs/ru/remote-control#troubleshooting)
1638
1639Если сервер вместо этого сообщает, что предыдущий сеанс исчез, вы не видите это сообщение. Claude Code запускает новый сеанс на его месте или показывает [`Previous session is unavailable — run /remote-control to start a new one`](/docs/ru/remote-control#previous-session-is-unavailable), в зависимости от [the conversation's reconnection record](/docs/ru/remote-control#resume-outcomes). Из версии v2.1.227 по v2.1.231 Claude Code показывал сообщение, которое начинается с `Remote Control could not resume the previous session under the current login` вместо этого, и [более ранние версии вели себя иначе](/docs/ru/remote-control#reconnect-history).
1640
1641<h3 id="sessions-ended-while-this-machine-was-offline">
1642 Sessions ended while this machine was offline
1643</h3>
1644
1645Claude Code показывает это сообщение в терминале, запускающем [`claude remote-control`](/docs/ru/remote-control#start-a-remote-control-session), после того как ваша машина была в автономном режиме достаточно долго, чтобы сервер очистил среду Remote Control, которую ваша машина обслуживала. Сеансы в этой среде закончились, и вы не можете их возобновить. Количество — это количество сеансов, которые закончились.
1646
1647```text theme={null}
16482 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.
1649```
1650
1651**Что делать:**
1652
1653* Когда Claude Code перечисляет сохранённые worktrees под этим сообщением, подберите любую незафиксированную работу из них
1654* Запустите `claude remote-control` для запуска свежей среды
1655
1656<h3 id="couldnt-share-the-transcript">
1657 Couldn't share the transcript
1658</h3>
1659
1660После того как вы согласитесь поделиться стенограммой вашего сеанса из приглашения опроса, такого как [session quality survey](/docs/ru/data-usage#session-quality-surveys), Claude Code загружает её в Anthropic или сохраняет локальный архив вместо этого на сторонних поставщиков, на сеансах [Claude apps gateway](/docs/ru/claude-apps-gateway) и когда нет доступных учётных данных Anthropic. Это сообщение означает, что общий доступ не завершился.
1661
1662```text theme={null}
1663Couldn't share the transcript.
1664```
1665
1666Загрузка должна соответствовать лимиту 8 MiB. На длинном сеансе Claude Code прогрессивно отбрасывает части общего доступа, параметры модели последнего запроса в первую очередь, затем структурированный разговор и стенограммы подагента, и показывает это сообщение только когда никакая сокращённая версия не может быть отправлена или сетевая или ошибка сервера останавливает загрузку. Когда Claude Code сохраняет локальный архив вместо этого, сообщение означает, что он не мог записать архив.
1667
1668**Что делать:**
1669
1670* Запустите `/feedback` для отправки стенограммы с описанием того, что произошло. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде
1671* Если другие запросы также не удаются, проверьте ваше сетевое соединение и см. [Unable to connect to API](#unable-to-connect-to-api)
1672
1673<h2 id="request-errors">
1674 Ошибки запроса
1675</h2>
1676
1677Эти ошибки связаны с содержимым вашего запроса. Большинство из них возвращаются API после отклонения запроса; несколько производятся локально Claude Code перед отправкой запроса.
1678
1679<h3 id="prompt-is-too-long">
1680 Prompt is too long
1681</h3>
1682
1683Разговор плюс прикреплённые файлы превышают контекстное окно модели.
1684
1685```text theme={null}
1686Prompt is too long
1687```
1688
1689В интерактивном сеансе Claude Code показывает эту ошибку как:
1690
1691```text theme={null}
1692Context limit reached · /compact или /clear для продолжения
1693```
1694
1695Строка указывает только `/clear`, когда установлена [`DISABLE_COMPACT`](/docs/ru/env-vars). Более длинные формы ошибки, такие как форма сбоя компактирования ниже, сохраняют формулировку `Prompt is too long ·`. В выводе `-p` и в расшифровке текст остаётся `Prompt is too long`.
1696
1697Когда вы отключили автоматическое компактирование в [пользовательских настройках](/docs/ru/settings-reference#autocompactenabled), строка также это указывает:
1698
1699```text theme={null}
1700Context limit reached · /compact или /clear для продолжения · auto-compact отключён · /config для его включения
1701```
1702
1703Переключатель **Auto-compact** в `/config` записывает `autoCompactEnabled` в пользовательские настройки. Подсказка появляется только когда изменение `/config` вступит в силу. Например, она не появляется, когда [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars) или [`DISABLE_COMPACT`](/docs/ru/env-vars) отключили автоматическое компактирование. Она также не появляется, когда область с более высоким приоритетом, такая как проект или управляемые настройки, установила `autoCompactEnabled` на `false`. До версии 2.1.235 строка не содержала подсказку об автоматическом компактировании.
1704
1705Amazon Bedrock сообщает об этом состоянии как `Input is too long for requested model.`, что Claude Code обрабатывает так же. До версии 2.1.217 Claude Code не распознавал формулировку Bedrock, поэтому автоматическое компактирование никогда не срабатывало на ней и `/compact` завершался с той же ошибкой.
1706
1707Шлюз [Claude apps gateway](/docs/ru/claude-apps-gateway-config#upstream-error-messages) сообщает об этом состоянии как `capability_rejected: prompt_too_long`, когда облачный вышестоящий сервер отклоняет запрос в собственной форме ошибки поставщика. Claude Code обрабатывает токен так же, как `Prompt is too long`. До версии 2.1.228 Claude Code не распознавал токен, поэтому автоматическое компактирование не срабатывало на нём.
1708
1709Когда автоматическое компактирование выполнялось на этом ходу и завершилось с ошибкой на основной ошибке, такой как недоступная модель или ошибка аутентификации, сообщение называет эту ошибку после разделителя:
1710
1711```text theme={null}
1712Prompt is too long · automatic compaction failed: <основная ошибка>
1713```
1714
1715Сначала разрешите названную ошибку; `/compact` завершается с той же ошибкой, пока вы этого не сделаете. До версии 2.1.229 неудачное автоматическое компактирование выводило `Prompt is too long` без указания причины.
1716
1717Однооборотный разговор не имеет более ранних ходов для суммирования. Когда автоматическое компактирование должно было выполниться на одном, Claude Code пропускает попытку и объясняет, что заполняет запрос. Когда API не сообщает количество токенов в своей ошибке, сообщение читается:
1718
1719```text theme={null}
1720Prompt 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.
1721```
1722
1723Когда API сообщает количество токенов в своей ошибке, Claude Code сравнивает их со своей оценкой размера разговора, чтобы определить, что занимает большую часть запроса: содержимое самого разговора или системный prompt, определения инструментов и содержимое вложений, которые Claude Code отправляет с ним. Когда содержимое самого разговора занимает большую часть запроса, сообщение читается:
1724
1725```text theme={null}
1726Prompt 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).
1727```
1728
1729Когда большая часть запроса находится вне разговора, сообщение читается:
1730
1731```text theme={null}
1732Prompt 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.
1733```
1734
1735До версии 2.1.162 Claude Code всё равно пытался выполнить компактирование и выводил простой `Prompt is too long` при его неудаче.
1736
1737**Что делать:**
1738
1739* В многооборотном разговоре запустите `/compact` для суммирования более ранних ходов и освобождения места, или `/clear` для начала заново. Однооборотный разговор не может быть компактирован, поэтому вместо этого уменьшите размер запроса
1740* Запустите `/context` для просмотра разбивки того, что потребляет окно: системный prompt, инструменты, файлы памяти и сообщения
1741* Отключите MCP серверы, которые вы не используете, с помощью `/mcp disable <имя>` для удаления их определений инструментов из контекста
1742* Обрежьте большие файлы памяти `CLAUDE.md` или переместите инструкции в [правила с областью действия пути](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости
1743* Подагенты наследуют каждое определение инструмента MCP от родительского сеанса, что может заполнить их контекстное окно до первого хода. Отключите MCP серверы, которые вы не используете, перед созданием подагентов.
1744* Автоматическое компактирование включено по умолчанию и обычно предотвращает эту ошибку. Если вы отключили его в `/config` или с помощью [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), включите его обратно. Если вы держите его отключённым, запустите `/compact` самостоятельно перед заполнением окна.
1745
1746Смотрите [Explore the context window](/docs/ru/context-window) для интерактивного просмотра того, как заполняется контекст.
1747
1748<h3 id="context-exceeds-the-token-limit">
1749 Context exceeds the token limit
1750</h3>
1751
1752`/context` показывает это предупреждение в верхней части своего вывода, когда разговор превысил контекстное окно модели. Запросы завершаются с [`Prompt is too long`](#prompt-is-too-long) до тех пор, пока вы не освободите место. Интерактивный сеанс показывает эту ошибку как строку `Context limit reached`.
1753
1754```text theme={null}
1755Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.
1756```
1757
1758Когда превышенный лимит — это окно компактирования, такое как граница 200K на моделях с контекстом 1M, предупреждение читается иначе. Окно компактирования может находиться ниже контекстного окна модели, поэтому запросы за его пределами могут всё ещё успешно выполняться.
1759
1760```text theme={null}
1761Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.
1762```
1763
1764Обе формы называют `/clear` вместо `/compact`, когда вы установили [`DISABLE_COMPACT`](/docs/ru/env-vars).
1765
1766**Что делать:**
1767
1768* В многооборотном разговоре запустите `/compact` для суммирования более ранних ходов и освобождения места. Для начала заново запустите `/clear`
1769* Для дополнительных способов снижения использования смотрите [Prompt is too long](#prompt-is-too-long)
1770
1771До версии 2.1.216 `/context` показывал использование выше 100% без строки предупреждения, объясняющей, что это означает или как восстановиться.
1772
1773<h3 id="error-during-compaction-conversation-too-long">
1774 Error during compaction: Conversation too long
1775</h3>
1776
1777`/compact` сам завершился с ошибкой, потому что недостаточно свободного контекста для хранения создаваемого им резюме.
1778
1779```text theme={null}
1780Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
1781```
1782
1783Это может произойти, когда окно уже заполнено в момент срабатывания автоматического компактирования, или когда вы запускаете `/compact` после просмотра [`Prompt is too long`](#prompt-is-too-long). В интерактивном сеансе эта ошибка — это строка `Context limit reached`.
1784
1785**Что делать:**
1786
1787* Нажмите Esc дважды, чтобы открыть список сообщений и вернуться на несколько ходов назад. Это удаляет самые последние сообщения из контекста. Затем запустите `/compact` снова.
1788* Если возврат на несколько ходов не освобождает достаточно места, запустите `/clear` для начала свежего сеанса. Ваш предыдущий разговор сохраняется и может быть переоткрыт с помощью `/resume`.
1789
1790Это сообщение и другие сбои `/compact` отображаются в стиле ошибки. До версии 2.1.216 они отображались в том же тусклом стиле, что и успешный вывод команды, поэтому вы могли прочитать неудачное компактирование как успех.
1791
1792<h3 id="request-too-large">
1793 Request too large
1794</h3>
1795
1796Тело необработанного запроса превысило лимит API в 32MB перед токенизацией, обычно из-за большого вставленного содержимого, результатов инструментов или вложений. Этот лимит отделён от [контекстного окна](#prompt-is-too-long).
1797
1798```text theme={null}
1799Request 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.
1800```
1801
1802Когда запрос прошёл прямо в Claude API и сам API отклонил его, Claude Code измеряет разговор и формулирует сообщение в зависимости от того, может ли работать восстановление. Через прокси, шлюз или поставщика облачных услуг вы получаете общее сообщение. Измеренные формы:
1803
1804* `Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).`: изображения или документы превысили лимит запроса. Claude Code повторяет попытку с их удалением.
1805* `Request too large for the API's 32MB request limit`: сами сообщения превышают лимит, поэтому сообщение говорит `compacting cannot make it fit` и Claude Code не повторяет попытку. В [неинтерактивном режиме](/docs/ru/headless) сообщение говорит вам уменьшить входные данные или начать новый сеанс.
1806
1807До версии 2.1.212 разговоры с достаточным накопленным количеством изображений завершались с ошибкой на каждом ходу с `Request too large (max 32MB). Double press esc to go back and try with a smaller file.` До версии 2.1.229 Claude Code показывал совет о вложениях для каждого отклонения, даже когда компактирование не могло помочь.
1808
1809**Что делать:**
1810
1811* Если сообщение говорит `compacting cannot make it fit`, нажмите Esc дважды, чтобы вернуться на ход, который добавил большое содержимое, или запустите `/clear` для начала заново
1812* В противном случае запустите `/compact`, который удаляет накопленные изображения и вложения
1813* Ссылайтесь на большие файлы по пути вместо вставки их содержимого, чтобы Claude мог читать их по частям
1814* Для изображений смотрите [Image was too large](#image-was-too-large) ниже
1815
1816<h3 id="image-was-too-large">
1817 Image was too large
1818</h3>
1819
1820Вставленное или прикреплённое изображение превышает лимиты размера или размеров API.
1821
1822```text theme={null}
1823Image was too large. Double press esc to go back and try again with a smaller image.
1824API Error: 400 ... image dimensions exceed max allowed size
1825```
1826
1827Claude Code заменяет необработанное изображение текстовым заполнителем и повторяет попытку, поэтому последующие сообщения успешны. В версиях до 2.1.142 вставленное изображение могло остаться в разговоре и повторить ту же ошибку на каждом последующем сообщении. Для восстановления в этих версиях нажмите Esc дважды и вернитесь на ход, где было добавлено изображение.
1828
1829**Что делать:**
1830
1831* Измените размер изображения перед вставкой. API принимает изображения до 8000 пикселей на самой длинной стороне для одного изображения или 2000 пикселей, когда в контексте много изображений.
1832* Сделайте более плотный снимок экрана соответствующей области вместо полного экрана
1833
1834<h3 id="unable-to-resize-image">
1835 Unable to resize image
1836</h3>
1837
1838Claude Code не смог уменьшить масштаб прикреплённого изображения перед отправкой его в API.
1839
1840```text theme={null}
1841Unable 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.
1842Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
1843Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
1844Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
1845Unable 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.
1846Unable 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.
1847Unable 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.
1848```
1849
1850Claude Code обычно автоматически изменяет размер больших изображений. Эти ошибки означают, что изображение не могло быть декодировано или изменено в размере, чтобы соответствовать лимитам API.
1851
1852**Что делать:**
1853
1854* Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Claude Code может проверить размеры для этих форматов из заголовка файла без декодирования изображения.
1855* Если сообщение сообщает о лимите размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.
1856* Если сообщение называет причину, такую как CMYK JPEG, анимированный WebP или возможно повреждённый файл, пересохраните изображение в формате, который предлагает сообщение, и прикрепите его снова.
1857
1858<h3 id="pdf-errors">
1859 PDF errors
1860</h3>
1861
1862Прикреплённый PDF не смог быть обработан. Сообщения показаны здесь в их неинтерактивной форме; в интерактивном сеансе они вместо этого предлагают вам дважды нажать esc и попробовать снова.
1863
1864```text theme={null}
1865PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
1866PDF is password protected. Try using a CLI tool to extract or convert the PDF.
1867The PDF file was not valid. Try converting it to text first (e.g., pdftotext).
1868```
1869
1870**Что делать:**
1871
1872* Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути
1873* Для защищённых или недействительных PDF удалите пароль или повторно экспортируйте файл из исходного приложения, затем попробуйте снова
1874
1875<h3 id="extra-inputs-are-not-permitted">
1876 Extra inputs are not permitted
1877</h3>
1878
1879Прокси или шлюз LLM между Claude Code и API удалил заголовок запроса `anthropic-beta`, поэтому API отклонил поля, которые от него зависят.
1880
1881```text theme={null}
1882API Error: 400 ... Extra inputs are not permitted ... context_management
1883API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
1884```
1885
1886Claude Code отправляет поля, доступные только в бета-версии, такие как `context_management` и `effort`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые не распознаёт.
1887
1888**Что делать:**
1889
1890* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. Смотрите [feature pass-through](/docs/ru/llm-gateway-protocol#feature-pass-through) для того, что шлюзы должны пересылать.
1891* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) перед запуском. [Disable pre-release capabilities](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities) охватывает точный объём.
1892
1893<h3 id="tool-input-schema-is-invalid">
1894 Tool input schema is invalid
1895</h3>
1896
1897Инструмент в запросе объявил `input_schema`, который не проходит валидацию JSON Schema API, поэтому API отклонил весь запрос. Число после `tools.` — это позиция неудачного инструмента в списке инструментов запроса, а не имя, которое вы можете найти.
1898
1899```text theme={null}
1900API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
1901API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'
1902```
1903
1904Первая форма означает, что схема не является действительной JSON Schema draft 2020-12. Вторая означает, что имя свойства верхнего уровня не соответствует шаблону, который называет сообщение.
1905
1906Claude Code [исключает MCP инструменты, чья схема входных данных не прошла бы эту валидацию](/docs/ru/mcp#tools-with-invalid-input-schemas) при загрузке инструментов сервера, поэтому запросы обычно никогда не включают один.
1907
1908На [развёртывании, где получение флагов отключено](/docs/ru/env-vars#features-that-need-feature-flag-fetching), или на машине, флаги которой никогда не прибывали, Claude Code записывает в журнал сервера, какой инструмент будет отклонён, но отправляет его всё равно, поэтому эта ошибка всё ещё может произойти.
1909
1910Ошибка также может произойти для инструмента, чья схема объявляет диалект JSON Schema, отличный от draft 2020-12, в `$schema`. Claude Code не проверяет эти схемы против мета-схемы JSON Schema, хотя проверка имён свойств верхнего уровня всё ещё применяется.
1911
1912До версии 2.1.216 ни одно развёртывание не выполняло проверки исключения.
1913
1914**Что делать:**
1915
1916* Если ваша версия Claude Code раньше v2.1.216, запустите `claude update`.
1917* Удалите или [отключите](/docs/ru/mcp#disable-a-server-without-removing-it) MCP сервер, который объявляет недействительную схему. Ошибка называет инструмент только по позиции. На v2.1.216 или позже проверьте журнал каждого сервера для строки, называющей инструмент, чья схема входных данных будет отклонена. Если ни один журнал не называет один, отключайте серверы по одному.
1918* Если вы поддерживаете сервер, исправьте `input_schema` инструмента. Схема должна быть действительной JSON Schema, и имена свойств верхнего уровня должны быть от 1 до 64 символов в длину и использовать только буквы ASCII и цифры, `_`, `.` и `-`. Смотрите [Tools with invalid input schemas](/docs/ru/mcp#tools-with-invalid-input-schemas).
1919
1920<h3 id="theres-an-issue-with-the-selected-model">
1921 There's an issue with the selected model
1922</h3>
1923
1924Имя настроенной модели не было распознано или ваша учётная запись не имеет доступа к ней. Начиная с v2.1.160 конечная подсказка, показанная здесь в её интерактивной форме, варьируется в зависимости от поверхности.
1925
1926```text theme={null}
1927There'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.
1928```
1929
1930**Что делать:**
1931
1932* **Интерактивный CLI**: запустите `/model` для выбора из моделей, доступных вашей учётной записи.
1933* **Неинтерактивный режим (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/docs/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.
1934* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для вывода вашего собственного повтора или выбора модели.
1935* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/docs/ru/model-config).
1936* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте места, где вы можете установить модель в [порядке приоритета](/docs/ru/model-config#setting-your-model), и удалите устаревшее значение.
1937* Недавно запущенная модель может быть доступна на Anthropic API перед Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Если вы закрепили новый ID модели на одном из этих поставщиков и видите эту ошибку, проверьте каталог моделей вашего поставщика на доступность в вашем регионе и держите предыдущую версию закреплённой до появления новой там.
1938* Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как эта ошибка. До версии 2.1.206 истёкший вход, который больше не мог быть обновлён, завершался с ошибкой на каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.
1939* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/docs/ru/google-vertex-ai#troubleshooting).
1940
1941<h3 id="model-is-not-a-recognized-model-id">
1942 Model is not a recognized model id
1943</h3>
1944
1945Строка модели, которую вы передали переключателю модели, не является псевдонимом модели, ID модели, который эта версия Claude Code знает, или ID, который начинается с `claude-`. Обычные причины — опечатка в ID, отображаемое имя, такое как `Sonnet 5`, где ожидается ID `claude-sonnet-5`, или псевдоним, который распознают только более новые версии Claude Code. Claude Code отклоняет переключение немедленно. До версии 2.1.200 Claude Code сохранял строку и завершался с ошибкой на следующем запросе с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).
1946
1947```text theme={null}
1948Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?
1949```
1950
1951Конечная подсказка называет ближайший соответствующий псевдоним или ID модели. Когда ничего не достаточно близко, она читается `Run /model to see available models.` вместо этого.
1952
1953Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()`, приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас, или когда вы выбираете модель с устройства, подключённого через [Remote Control](/docs/ru/remote-control). До версии 2.1.260 проверка не охватывала выборы Remote Control, поэтому Claude Code применял выбор и следующий запрос завершался с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).
1954
1955**Что делать:**
1956
1957* Запустите `/model` без аргумента, чтобы открыть выбор и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID
1958* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту локальную проверку даже когда модель новее вашей версии Claude Code. Сервер всё ещё может требовать минимальную версию для этой модели; смотрите [Claude Code does not support this model](#claude-code-does-not-support-this-model).
1959* Модель, сохранённая до версии 2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [Setting your model](/docs/ru/model-config#setting-your-model).
1960* Проверка выполняется только на Anthropic API. На любом другом поставщике или шлюзе, включая пользовательский `ANTHROPIC_BASE_URL`, поставщик определяет имена моделей, поэтому Claude Code принимает любую строку и передаёт её. Claude Code всё ещё может написать [неузнанную диагностическую строку ID модели](#unrecognized-model-id-on-a-request) во время запроса на каждом поставщике.
1961
1962<h3 id="model-not-found">
1963 Model not found
1964</h3>
1965
1966Вы выбрали модель с `/model <имя>` и Claude Code не смог подтвердить, что модель с этим именем существует. Когда имя не является [псевдонимом модели](/docs/ru/model-config#model-aliases) или другим написанием, которое Claude Code принимает локально, `/model` проверяет его с минимальным запросом API, и эта ошибка обычно является ответом вашей конечной точки API. Имя, которое не может быть ID модели вообще, такое как содержащее пробелы, получает то же сообщение.
1967
1968```text theme={null}
1969Model 'claude-opus-9' not found
1970```
1971
1972На поставщиках с ID моделей, специфичными для поставщика, сообщение может добавить предложение `Try '...' instead`, которое называет ID вашего поставщика для резервной модели.
1973
1974**Что делать:**
1975
1976* Запустите `/model` без аргумента и выберите из моделей, доступных вашей учётной записи, или используйте [псевдоним модели](/docs/ru/model-config#model-aliases), такой как `sonnet`, который разрешается в поддерживаемое значение по умолчанию
1977* Если вы ввели полный ID, проверьте его в каталоге моделей вашего поставщика. Недавно запущенная модель может быть доступна на Anthropic API перед тем, как ваш поставщик или регион её предложит.
1978* До версии 2.1.265 `/model` также отклонял написание псевдонима `opusplan[1m]` с этой ошибкой. В этих версиях обновите Claude Code или установите модель в [settings](/docs/ru/model-config#setting-your-model) или с помощью `--model` вместо этого.
1979
1980<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">
1981 Claude Opus is not available with the Claude Pro plan
1982</h3>
1983
1984Ваш активный план подписки не включает выбранную вами модель.
1985
1986```text theme={null}
1987Claude 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.
1988```
1989
1990**Что делать:**
1991
1992* Запустите `/model` и выберите модель, которую включает ваш план
1993* Если вы недавно обновили свой план и всё ещё видите это, запустите `/logout`, затем `/login`. Сохранённый токен отражает ваш план на момент входа, поэтому обновление в интернете не вступает в силу в существующем сеансе до повторной аутентификации.
1994* Смотрите [claude.com/pricing](https://claude.com/pricing) для того, какие модели включает каждый план
1995
1996<h3 id="claude-code-does-not-support-this-model">
1997 Claude Code does not support this model
1998</h3>
1999
2000API отклонил запрос с 400, потому что ваша версия Claude Code ниже требуемого минимума. Либо выбранная вами модель требует более новую версию, которую сервер проверяет для каждой модели, либо политика вашей организации требует одну. 400 несёт код ошибки `claude_code_version_too_old`, и сообщение говорит, какой минимум применяется.
2001
2002```text theme={null}
2003API 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.
2004```
2005
2006Формулировка политики организации читается:
2007
2008```text theme={null}
2009API 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.
2010```
2011
2012**Что делать:**
2013
2014* Запустите `claude update` или обновите Claude desktop app, затем начните новый сеанс
2015* Для формулировки для каждой модели вы можете продолжить работу в текущем сеансе, переключившись на другую модель с помощью `/model`
2016* Для формулировки политики организации обновитесь перед продолжением
2017
2018<h3 id="model-is-restricted-by-your-organizations-settings">
2019 Model is restricted by your organization's settings
2020</h3>
2021
2022Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена списком разрешений [`availableModels`](/docs/ru/model-config#restrict-model-selection) в управляемых настройках. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или настройкой `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <имя>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сеанс сохраняет свою текущую модель.
2023
2024```text theme={null}
2025Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.
2026```
2027
2028Уведомление с префиксом имени агента, навыка или команды означает, что ограничение применилось к [запрошенной модели подагента](/docs/ru/sub-agents#choose-a-model): подагент работает на подставленной модели и модель вашего сеанса не изменяется. До версии 2.1.223 Claude Code показывал уведомление только для подагентов, запущенных с помощью инструмента Agent.
2029
2030Claude Code обрабатывает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <псевдоним>` только когда каждая версия семейства ограничена. До версии 2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.
2031
2032**Что делать:**
2033
2034* Запустите `/model` для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от выбора.
2035* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL`, поле `model` файла настроек или frontmatter [подагента](/docs/ru/sub-agents#choose-a-model), навыка или команды, удалите или обновите это значение, чтобы уведомление не повторялось
2036* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации её включить. Смотрите [Organization model restrictions](/docs/ru/model-config#organization-model-restrictions).
2037
2038<h3 id="model-switch-was-blocked-by-a-premodelswitch-hook">
2039 Model switch was blocked by a PreModelSwitch hook
2040</h3>
2041
2042Хук [PreModelSwitch hook](/docs/ru/hooks#premodelswitch) не одобрил переключение модели, которое вы или клиент запросили, поэтому сеанс сохраняет свою текущую модель. Когда переключение пришло от хоста [Agent SDK](/docs/ru/agent-sdk/overview) или [Remote Control](/docs/ru/remote-control), а не от команды, которую вы ввели, сообщение читается `Model switch blocked by a PreModelSwitch hook` без названия целевой модели.
2043
2044```text theme={null}
2045Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.
2046```
2047
2048Причина после двоеточия говорит, что отклонило переключение:
2049
2050* **Причина, которую написал хук**: хук PreModelSwitch предоставил эту причину, когда он [отклонил переключение или попросил подтверждение](/docs/ru/hooks#premodelswitch-decision-control). Обратитесь к тому, что он просит, или выберите модель, которую разрешают ваши хуки.
2051* **`PreModelSwitch hook <имя> did not respond before its timeout`**: хук, который не отвечает перед его [timeout](/docs/ru/hooks#timeouts), блокирует переключение. Исправьте зависающую команду или повысьте `timeout` этого хука, затем переключитесь снова.
2052* **`confirmation required, and this session cannot ask`**: хук ответил `ask` без причины, и запрос управления не имеет способа показать подсказку подтверждения. Запрос `/model` в запуске [`-p`](/docs/ru/headless) сообщает то же состояние с `(run /model interactively to confirm)` после причины. Сделайте переключение из интерактивного сеанса или измените решение хука для этой модели.
2053* **`so organization-managed PreModelSwitch hooks could not be checked`**: Claude Code не смог определить, какие хуки PreModelSwitch предоставляют [управляемые плагины](/docs/ru/settings-reference#enabledplugins) вашей организации, например, потому что управляемый плагин не загрузился. Один из этих хуков может заблокировать переключение, поэтому Claude Code отказывает, а не применяет переключение без проверки. Начало причины называет, что не удалось. Claude Code повторно проверяет при каждой попытке переключения, поэтому сбой, который с тех пор очистился, перестаёт блокировать; если он продолжает не удаваться, запустите `claude --debug` и переключитесь снова, чтобы захватить детали, затем исправьте плагин или попросите администратора его исправить.
2054* **`a PreModelSwitch hook failed before answering`** или **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`**: запуск хука завершился без вердикта, и Claude Code не рассматривает это как одобрение. Запустите `claude --debug`, чтобы увидеть, что не удалось, затем переключитесь снова.
2055
2056До версии 2.1.260 отказ управляемого плагина читался `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code повторил загрузку плагина один раз, а затем отклонил более поздние переключения в сеансе, даже когда ваша организация не управляла никакими плагинами. Перезагрузите сеанс, чтобы запустить загрузку плагина снова в этих версиях.
2057
2058<h3 id="couldnt-save-it-as-your-default">
2059 Couldn't save it as your default
2060</h3>
2061
2062Вы выбрали модель для сохранения в качестве вашего значения по умолчанию, например, с `/model <имя>` или `Enter` в выборе `/model`, и Claude Code не смог написать выбор в файл пользовательских настроек, `~/.claude/settings.json`. Само переключение применилось, поэтому текущий сеанс работает на выбранной вами модели, но ваше значение по умолчанию не изменяется и следующий сеанс начинается со старого значения.
2063
2064```text theme={null}
2065Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)
2066```
2067
2068Причина после пути файла говорит, что не удалось:
2069
2070* **`can't be written (<код>)`**: запись не удалась с кодом ошибки операционной системы в скобках, такой как `EROFS`, когда файл или файл, на который он ссылается, находится на файловой системе, которая отказывает в записи. Сделайте файл доступным для записи и переключитесь снова. Если другой инструмент генерирует файл, установите ключ `model` в этом инструменте вместо этого; смотрите [A change you made in Claude Code is lost in new sessions](/docs/ru/settings#a-change-you-made-in-claude-code-is-lost-in-new-sessions).
2071* **`isn't valid JSON`**: файл на диске не анализируется, и Claude Code оставляет его нетронутым, а не перезаписывает содержимое, которое не может прочитать обратно. Исправьте синтаксическую ошибку, затем переключитесь снова; смотрите [Fix a broken settings file](/docs/ru/settings#fix-a-broken-settings-file).
2072
2073Уведомление, заканчивающееся `couldn't confirm it was saved as your default (~/.claude/settings.json is still being written)`, означает, что запись не завершилась после трёх секунд. Она продолжается в фоне, поэтому значение по умолчанию может всё ещё быть сохранено; проверьте, на какой модели начинается ваш следующий сеанс, или запустите `/model <имя>` снова.
2074
2075До версии 2.1.265 уведомление говорило, что модель была `saved as your default for new sessions`, даже когда запись не удалась.
2076
2077<h3 id="thinking-type-enabled-is-not-supported-for-this-model">
2078 thinking.type.enabled is not supported for this model
2079</h3>
2080
2081Ваша версия Claude Code старше минимума для выбранной модели. CLI отправил конфигурацию мышления, которую модель больше не принимает.
2082
2083```text theme={null}
2084API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
2085```
2086
2087**Что делать:**
2088
2089* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже. Opus 5 требует v2.1.219 или позже
2090* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого
2091* Если вы столкнулись с этим в [Agent SDK](/docs/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже. Opus 5 требует TypeScript SDK v0.3.219 или позже
2092
2093<h3 id="effort-isnt-available-with-thinking-turned-off">
2094 Effort isn't available with thinking turned off
2095</h3>
2096
2097Вы отключили [extended thinking](/docs/ru/model-config#extended-thinking) и работали на [уровне усилий](/docs/ru/model-config#adjust-effort-level) выше `high`. Модель не принимает эту комбинацию, поэтому API отклонил запрос.
2098
2099```text theme={null}
2100API 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)
2101```
2102
2103**Что делать:**
2104
2105* [Понизьте уровень усилий](/docs/ru/model-config#set-the-effort-level) до `high` или ниже.
2106* Включите мышление обратно, например, отменив [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) или удалив [`"alwaysThinkingEnabled": false`](/docs/ru/settings-reference#alwaysthinkingenabled) из ваших настроек.
2107
2108До версии 2.1.242 Claude Code показывал собственное сообщение API: `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.` До версии 2.1.251 Claude Code отправлял запрос на уровне усилий, который вы установили, поэтому Opus 5 отклонял каждый запрос выше `high` с отключённым мышлением. Claude Code теперь отправляет усилие `high` вместо этого моделям, которые, как он знает, отклоняют комбинацию, такие как Opus 5, поэтому на v2.1.251 или позже эта ошибка достигает вас только от модели, которую Claude Code не знает отклоняет.
2109
2110<h3 id="thinking-budget-exceeds-output-limit">
2111 Thinking budget exceeds output limit
2112</h3>
2113
2114Настроенный бюджет расширенного мышления превышает максимальную длину ответа, поэтому для фактического ответа не остаётся места.
2115
2116```text theme={null}
2117API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
2118```
2119
2120Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.
2121
2122**Что делать:**
2123
2124* Понизьте `MAX_THINKING_TOKENS` или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ru/env-vars) выше бюджета мышления
2125* Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода
2126
2127<h3 id="tool-use-or-thinking-block-mismatch">
2128 Tool use or thinking block mismatch
2129</h3>
2130
2131История разговора достигла API в несогласованном состоянии, обычно после того, как вызов инструмента был прерван или ход был отредактирован в середине потока.
2132
2133```text theme={null}
2134API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
2135API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
2136API Error: 400 ... thinking blocks ... cannot be modified
2137```
2138
2139Все три варианта означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не соответствует тому, что ожидает API.
2140
2141**Что делать:**
2142
2143* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку во время нормального использования инструмента, и `/rewind` её не очищает.
2144* Запустите `/rewind` или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.
2145
2146<h3 id="unsupported-tool-content-removed">
2147 Unsupported tool content removed
2148</h3>
2149
2150Когда Claude Code подключается непосредственно к Anthropic API и загружает или предварительно просматривает сохранённый сеанс, он удаляет содержимое инструмента, которое Anthropic API не принимает, и оставляет эту строку там, где удалённое содержимое находилось между двумя блоками мышления:
2151
2152```text theme={null}
2153[Unsupported tool content removed]
2154```
2155
2156Такое содержимое достигает файла сеанса, когда что-то другое, чем Anthropic API, ответило в формате API, обычно прокси третьей стороны, установленный через [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars), который переводит вызовы инструментов другого поставщика. Claude Code удаляет его только когда сеанс подключается непосредственно к Anthropic API и загружает сохранённую историю, как она есть, когда сеанс работает через прокси или на другом поставщике. До версии 2.1.246 Claude Code отправлял использование инструмента и его результат обратно в API, и каждый ход возобновленного сеанса завершался с ошибкой 400, такой как `messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ...`.
2157
2158**Что делать:**
2159
2160* Ничего не требуется, когда вы видите строку заполнителя. Сеанс продолжается без удалённого содержимого.
2161* Если каждый ход возобновленного сеанса завершается с ошибкой 400 вместо этого, запустите `claude update` и возобновите сеанс снова. Версии до v2.1.246 не удаляют содержимое.
2162
2163<h3 id="usage-policy-refusal">
2164 Usage Policy refusal
2165</h3>
2166
2167API отклонил ответ, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает ID запроса, который вы можете привести в поддержку, если вы считаете, что отказ неправильный.
2168
2169```text theme={null}
2170API Error: Opus 4.6 can't help with this. Start a new session to continue.
2171
2172Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup
2173```
2174
2175Сообщение называет модель, которая отклонила, или `Claude`, когда модель не записана.
2176
2177Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в том же сеансе обычно повторно вызывает тот же отказ. То же самое применяется после выхода и повторного открытия сеанса с `--continue` или `--resume`, так как расшифровка на диске всё ещё содержит вызывающее содержимое. На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
2178
2179До версии 2.1.219 сообщение читалось `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.`
2180
2181**Что делать:**
2182
2183* Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).
2184* Если вы не можете определить, какой ход вызвал это, запустите `/clear`, чтобы начать свежий разговор в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.
2185* В [неинтерактивном режиме](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новом сеансе без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с помощью `--model` также может разрешить отказ в некоторых случаях.
2186
2187<h3 id="safety-measures-flagged-a-cybersecurity-topic">
2188 Safety measures flagged a cybersecurity topic
2189</h3>
2190
2191Меры безопасности модели отметили содержимое в разговоре как тему кибербезопасности. Сообщение называет модель, которая отметила запрос:
2192
2193```text theme={null}
2194API 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
2195```
2196
2197Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности.
2198
2199На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) флаг кибербезопасности вместо этого производит сообщение [Usage Policy refusal](#usage-policy-refusal).
2200
2201Сама защита находится на стороне сервера и предшествует v2.1.203; выпуски клиентов с тех пор изменили только формулировку сообщения.
2202От v2.1.203 до v2.1.218 сообщение читалось `<модель> 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:` с последующей ссылкой на центр справки, и интерактивные сеансы добавляли `If you were not engaging in a cybersecurity topic, please send feedback via /feedback.`
2203До версии 2.1.203 оно читалось `<модель>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` с последующей ссылкой на форму исключения.
2204
2205**Что делать:**
2206
2207* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)
2208* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback`, чтобы сообщить о ложном срабатывании
2209* Чтобы продолжить работу в том же сеансе, нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к контрольной точке перед ходом, который вызвал флаг, затем возьмите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).
2210
2211<h2 id="installation-errors">
2212 Ошибки установки
2213</h2>
2214
2215Эти ошибки появляются при установке или обновлении Claude Code из [скрипта установки](/docs/ru/setup#install-claude-code), `claude install` или `claude update`. Для проблем с `command not found`, PATH, разрешениями и TLS во время установки см. [Устранение неполадок установки и входа](/docs/ru/troubleshoot-install).
2216
2217<h3 id="installation-was-killed-before-it-could-finish">
2218 Установка была прервана до завершения
2219</h3>
2220
2221Скрипт установки сообщает, когда этап `claude install` завершается сигналом. На Linux код выхода 137 означает, что процесс получил SIGKILL, а на хосте с низким объёмом памяти это обычно означает, что ядро активировало средство защиты от нехватки памяти (OOM killer). Скрипт выводит это объяснение и завершается с кодом 137:
2222
2223```text theme={null}
2224Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
2225Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
2226```
2227
2228Для любого другого фатального сигнала и для кода выхода 137 на macOS скрипт выводит `Installation was killed before it could finish (exit code <N>)` с фактическим кодом выхода и опускает объяснение о нехватке памяти. Сообщение поступает из скрипта установки, который используют macOS и Linux, и он также охватывает установки внутри WSL; встроенные скрипты установки Windows никогда его не выводят. До версии 2.1.200 скрипт завершался только с простой строкой `Killed` оболочки.
2229
2230**Что делать:**
2231
2232* Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик
2233* Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. [Установка прервана на серверах Linux с низким объёмом памяти](/docs/ru/troubleshoot-install#install-killed-on-low-memory-linux-servers) для команд файла подкачки.
2234
2235<h3 id="the-connection-dropped-while-downloading-the-update">
2236 Соединение разорвалось при загрузке обновления
2237</h3>
2238
2239Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновляющий модуль](/docs/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.
2240
2241```text theme={null}
2242The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.
2243```
2244
2245Текст в скобках указывает, какая попытка не удалась и какая была базовая ошибка сети. `claude update` предваряет сообщение с `Error: Failed to install native update` на stderr.
2246
2247Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой `Download timed out: exceeded the total deadline`. Claude Code не повторяет загрузку с истекшим временем ожидания, потому что соединение, которое слишком медленно для завершения в течение установленного срока, не завершится при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям.
2248
2249Обычная причина — прокси или шлюз, который закрывает длительную передачу до её завершения. Двоичный файл Claude Code — это большая загрузка, поэтому ограничение соединения прокси, которое никогда не влияет на обычный трафик API, всё равно может его прервать.
2250
2251**Что делать:**
2252
2253* Запустите `claude update` снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени ожидания запустите его снова из более быстрой или менее ограниченной сети.
2254* Если ваша сеть требует прокси, установите `HTTPS_PROXY` перед запуском установщика или `claude update`. См. [Проверка подключения к сети](/docs/ru/troubleshoot-install#check-network-connectivity).
2255* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements).
2256* Запустите `claude doctor` из вашей оболочки для диагностики установки
2257
2258<h2 id="command-line-errors">
2259 Ошибки командной строки
2260</h2>
2261
2262Эти ошибки поступают из командной строки `claude` и её подкоманд, из имени команды, которое вы отправляете в приглашение, и из команд, таких как `/security-review`, которые собирают контекст, запуская команды оболочки перед выполнением своего приглашения. Они также поступают из `/tui`, который перезапускает CLI.
2263
2264<h3 id="conflict-between-bg-and-print">
2265 Конфликт между --bg и --print
2266</h3>
2267
2268Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/docs/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, в то время как `--print` работает [неинтерактивно](/docs/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии 2.1.198 эта комбинация молча создавала фоновое задание, к которому невозможно было подключиться.
2269
2270```text theme={null}
2271--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
2272```
2273
2274**Что делать:**
2275
2276* Удалите `-p` или `--print`. `--bg` принимает приглашение в качестве позиционального аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/docs/ru/agent-view#from-your-shell).
2277* Чтобы запустить приглашение неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`
2278
2279<h3 id="invalid-agents-configuration">
2280 Неверная конфигурация --agents
2281</h3>
2282
2283Значение, которое вы передали в `--agents`, недействительно, поэтому `claude` выходит с кодом 1 вместо запуска сеанса. Когда вы передаёте `--safe-mode`, `--resume` или `--continue`, или устанавливаете [`CLAUDE_CODE_SAFE_MODE`](/docs/ru/env-vars#variables), Claude Code не проверяет значение и запускает сеанс. До версии 2.1.242 Claude Code запускал сеанс в любом случае и пропускал определения, которые не мог загрузить.
2284
2285```text theme={null}
2286Error: Invalid --agents configuration:
2287<what failed>
2288```
2289
2290То, что следует после первой строки, зависит от того, как значение не прошло проверку. Claude Code выполняет эти проверки по порядку и останавливается на первой, которая не пройдена. Если ваше значение имеет два вида проблем, вы видите второе только после исправления первого:
2291
22921. Когда значение не анализируется как JSON, Claude Code выводит одну строку `invalid JSON:` с собственным сообщением парсера JSON
22932. Когда оно анализируется, но определение агента не соответствует схеме для [подагентов, определённых в CLI](/docs/ru/sub-agents#choose-the-subagent-scope), Claude Code выводит одну строку на проблему
22943. Когда имя агента начинается с `-`, Claude Code выводит `<name>: agent names must not start with '-'`
2295
2296Когда строк проблем больше 20, Claude Code выводит первые 20 и заменяет остальные на `…and N more`.
2297
2298**Что делать:**
2299
2300* Исправьте каждую проблему, которую указывает сообщение, затем запустите команду снова. См. [поля, которые принимает подагент, определённый в CLI](/docs/ru/sub-agents#choose-the-subagent-scope).
2301
2302<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2303 Облачные сеансы не могут быть созданы из сеанса --restricted
2304</h3>
2305
2306Когда вы запускаете сеанс с [`--restricted`](/docs/ru/cli-reference#cli-flags), Claude Code отказывается создавать [облачные сеансы](/docs/ru/claude-code-on-the-web#from-terminal-to-web) из него, потому что новый сеанс будет работать вне ограниченного процесса и не будет применять ограниченный режим. Claude Code отказывает на клиенте, перед контактом с сервером, поэтому облачный сеанс не создаётся:
2307
2308```text theme={null}
2309Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2310```
2311
2312**Что делать:**
2313
2314* Запустите задачу локально в ограниченном сеансе
2315* Если вы контролируете способ запуска сеанса, запустите новый сеанс `claude` без `--restricted` и создайте облачный сеанс оттуда
2316
2317До версии 2.1.248 Claude Code не имел флага `--restricted`; более ранние версии отклоняют сам флаг с ошибкой неизвестного параметра.
2318
2319<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2320 Значение --json-schema не является действительной JSON Schema
2321</h3>
2322
2323Схема, которую вы передали в [`--json-schema`](/docs/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/docs/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` выходит с кодом 1 вместо запуска приглашения. До версии 2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, рассматривалась как недействительная.
2324
2325```text theme={null}
2326Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2327```
2328
2329Текст после второго двоеточия — это диагностика валидатора и указывает на ключевое слово или местоположение, которое не прошло проверку. Схемы, использующие ключевое слово `format`, такие как `"format": "email"`, действительны: Claude Code принимает `format` как аннотацию и не применяет её.
2330
2331Claude Code выполняет две проверки перед компиляцией схемы: он отклоняет значение, которое не анализируется как JSON, с `Error: --json-schema is not valid JSON`, и действительный JSON, который не является объектом, с `Error: --json-schema must be a JSON object`.
2332
2333**Что делать:**
2334
2335* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду
2336* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`
2337* См. [Get structured output](/docs/ru/headless#get-structured-output) для рабочей схемы и команды
2338
2339<h3 id="settings-file-exceeds-the-2mib-limit">
2340 Файл параметров превышает лимит 2MiB
2341</h3>
2342
2343Файл, который вы передали в [`--settings`](/docs/ru/cli-reference#cli-flags), больше 2 MiB, поэтому `claude` выходит с кодом 1 при запуске вместо загрузки. Файл параметров — это небольшой документ JSON, поэтому файл такого размера обычно означает, что путь указывает на неправильный файл. До версии 2.1.214 Claude Code читал файл без проверки размера, и файл размером в несколько гигабайт или файл устройства, такой как `/dev/zero`, увеличивал память без ограничений.
2344
2345```text theme={null}
2346Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2347```
2348
2349Claude Code отклоняет путь `--settings`, который не является обычным файлом, таким же образом: устройство, FIFO или сокет выводит `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` с последующим путём, а каталог выводит причину `EISDIR`.
2350
2351**Что делать:**
2352
2353* Укажите `--settings` на обычный файл JSON параметров размером менее 2 MiB. См. [Settings](/docs/ru/settings) для формата.
2354
2355<h3 id="the-current-directory-no-longer-exists">
2356 Текущий каталог больше не существует
2357</h3>
2358
2359Вы запустили `claude` из каталога, который был удалён или перемещён после того, как ваша оболочка вошла в него, например рабочее дерево или временный каталог, удалённый другой оболочкой. Claude Code не может прочитать свой рабочий каталог, поэтому он выходит с кодом 1 перед запуском сеанса, как в интерактивном, так и в [неинтерактивном](/docs/ru/headless) режиме. До версии 2.1.239 Claude Code падал с минифицированным исходным кодом пакета и необработанным стеком `ENOENT ... uv_cwd` на stderr вместо этого сообщения.
2360
2361```text theme={null}
2362The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2363error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.
2364```
2365
2366Причина и исправление одинаковы для обеих форм.
2367
2368Когда Claude Code не может прочитать рабочий каталог по другой причине, такой как изменение разрешений, сообщение указывает код ошибки вместо этого: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`
2369
2370На macOS `EPERM` для каталога в `~/Desktop`, `~/Documents`, `~/Downloads` или iCloud Drive обычно означает, что macOS блокирует доступ вашего приложения терминала к этой папке. Другие команды, которые читают эту папку, не работают так же: `ls` там выводит `Operation not permitted`, даже с `sudo`.
2371
2372**Что делать:**
2373
2374* Перейдите в каталог, который существует, такой как ваш домашний или проектный каталог, затем запустите `claude` снова
2375* Если каталог был пересоздан по тому же пути, ваша оболочка всё ещё содержит удалённый. Запустите `cd "$PWD"` или покиньте и повторно войдите в каталог, затем запустите `claude` снова
2376* Для `EPERM` на macOS выйдите из приложения терминала с помощью Cmd+Q, откройте его снова, вернитесь в эту папку и запустите `claude`. Если `ls` в этой папке всё ещё не работает, откройте **System Settings > Privacy & Security > Files and Folders**, включите папку для вашего приложения терминала, затем повторно откройте терминал
2377
2378<h3 id="directory-couldnt-be-resolved-to-a-real-location">
2379 Каталог не удалось разрешить в реальное местоположение
2380</h3>
2381
2382Вы запустили `/add-dir` для подкаталога вашего рабочего каталога, и Claude Code не смог разрешить каталог в его реальное местоположение.
2383
2384У вас уже есть доступ к файлам подкаталога рабочего каталога, поэтому `/add-dir` только загружает его skills, команды и агентов. Перед загрузкой Claude Code проверяет, что реальное местоположение каталога, с разрешёнными всеми символическими ссылками, находится внутри рабочего каталога. Когда Claude Code не может разрешить это местоположение, он ничего не загружает и показывает это сообщение:
2385
2386```text theme={null}
2387packages/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.
2388```
2389
2390**Что делать:**
2391
2392* Проверьте, что путь указывает на реальный каталог внутри рабочего каталога, затем запустите `/add-dir` снова
2393* Сообщение не изменяет ваш доступ к файлам; оно только сообщает, что содержимое `.claude/` каталога не было загружено
2394
2395До версии 2.1.261 это сообщение также появлялось для каждого `/add-dir <subdirectory>`, когда рабочий каталог находился на автомонтировании `/net/<host>`, где Claude Code по дизайну отказывается разрешать пути; каталог был в порядке и повторная попытка не могла помочь.
2396
2397<h3 id="workspace-not-trusted-when-starting-remote-control">
2398 Рабочее пространство не доверено при запуске Remote Control
2399</h3>
2400
2401Вы запустили сервер [Remote Control](/docs/ru/remote-control) в режиме с помощью `claude remote-control` или его псевдонима `claude rc` в каталоге, которому вы не доверяете. Команда не показывает диалог доверия рабочего пространства сама по себе, поэтому она выходит с кодом 1 и указывает исправление:
2402
2403```text theme={null}
2404Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
2405```
2406
2407В вашем домашнем каталоге сообщение отличается, потому что диалог доверия рабочего пространства никогда не сохраняет доверие для домашнего каталога, поэтому принятие его там не может удовлетворить эту проверку. До версии 2.1.214 домашний каталог показывал сообщение выше, совет которого не может быть успешным там.
2408
2409```text theme={null}
2410Error: 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).
2411```
2412
2413**Что делать:**
2414
2415* Запустите `claude` в каталоге, примите [диалог доверия рабочего пространства](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем запустите `claude remote-control` снова
2416* В вашем домашнем каталоге перейдите в проектный каталог и запустите Remote Control там
2417
2418<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
2419 Не перенесено в сеансы, которые запускает Remote Control
2420</h3>
2421
2422Вы запустили [Remote Control](/docs/ru/remote-control) с глобальным флагом `claude` перед глаголом `remote-control`, флагом, который ограничивал бы или конфигурировал сеансы, которые запускает Remote Control, такие как `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` или `--mcp-config`. Флаг, размещённый перед глаголом, никогда не достигает этих сеансов. Claude Code отказывает запускаться вместо этого, указывая флаг:
2423
2424```text theme={null}
2425Error: `--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`).
2426```
2427
2428Claude Code не отказывает глобальные флаги, которые безопасно удалить, такие как `--verbose`, `--model` или внедрённый оболочкой `--session-id` или `--plugin-dir`: он их игнорирует и Remote Control запускается.
2429
2430Claude Code также отказывает запускаться для глобального флага, который он ещё не признал безопасным, поэтому флаг, добавленный в более новом выпуске, может появиться в этом сообщении до более позднего выпуска, который его отметит как безопасный.
2431
2432**Что делать:**
2433
2434* Удалите флаг перед глаголом и передайте [собственные параметры Remote Control](/docs/ru/remote-control#start-a-remote-control-session) после него; `claude remote-control --help` их перечисляет
2435* Когда отклонённый флаг — `--permission-mode`, запустите `claude remote-control --permission-mode <mode>` для установки режима разрешений для сеансов, которые запускает Remote Control
2436
2437До версии 2.1.248 `claude remote-control` не принимал свои флаги, когда глобальный флаг шёл первым, и команда не работала с ошибкой `unknown option`.
2438
2439<h3 id="claude-import-is-not-yet-available-in-this-build">
2440 claude import ещё не доступен в этой сборке
2441</h3>
2442
2443Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands), и Claude Code обнаружил, что поток импорта отключен, поэтому команда выходит с кодом 1 вместо запуска импорта. До версии 2.1.222 сборка с отключённым потоком импорта рассматривала `import` как приглашение и запускала интерактивный сеанс вместо вывода этого сообщения.
2444
2445```text theme={null}
2446`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
2447```
2448
2449Claude Code включает `claude import` через флаг функции, который он получает от Anthropic и кэширует на диске. Это сообщение означает, что кэшированное значение отключено. Причина обычно одна из следующих:
2450
2451* Вы не запустили сеанс с момента установки, поэтому Claude Code ещё не получил флаг. Первый `claude import` может вывести это даже когда функция доступна вам.
2452* Вы используете Claude Code через Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform на AWS, или через [шлюз приложений Claude](/docs/ru/claude-apps-gateway#availability-and-limitations). Claude Code не получает флаги функций в этих сеансах, поэтому `claude import` остаётся недоступным.
2453* Вы установили `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK` или [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ru/env-vars), которые отключают получение флагов функций, поэтому `claude import` остаётся недоступным.
2454
2455**Что делать:**
2456
2457* На свежей установке запустите `claude`, дождитесь загрузки сеанса, выйдите и запустите `claude import` снова
2458* Где получение флагов функций остаётся отключённым, установите конфигурацию самостоятельно: добавьте серверы MCP с помощью [`claude mcp add`](/docs/ru/mcp#installing-mcp-servers) и создайте [`CLAUDE.md` файлы](/docs/ru/memory#how-claude-md-files-load), [skills и команды](/docs/ru/skills#where-skills-live) и [подагентов](/docs/ru/sub-agents#choose-the-subagent-scope), которые вы хотите перенести. Сообщение также указывает `~/.claude/settings.json`. Из конфигурации, которую переносит `claude import`, этот файл содержит только [режим разрешений](/docs/ru/settings-reference#permission-settings); Claude Code не читает серверы MCP из него.
2459
2460<h3 id="could-not-read-claude-code-config">
2461 Не удалось прочитать конфигурацию Claude Code
2462</h3>
2463
2464Вы запустили [`claude import`](/docs/ru/cli-reference#cli-commands), пока Claude Code не мог анализировать `~/.claude.json`, файл, где он хранит вашу учётную запись и состояние для каждого проекта. Подкоманда читает этот файл для проверки доступности, но не показывает диалог восстановления, который показывает интерактивный сеанс, поэтому она выходит с кодом 1. До версии 2.1.222 `claude import` с нечитаемым файлом конфигурации запускал интерактивный сеанс, диалог восстановления которого обрабатывал файл.
2465
2466```text theme={null}
2467Could not read Claude Code config — run `claude` with no arguments to recover it.
2468```
2469
2470**Что делать:**
2471
2472* Запустите `claude` без аргументов. Claude Code обнаруживает недействительный файл и предлагает его сбросить. Затем запустите `claude import` снова.
2473* Чтобы сохранить ручные правки, которые вы сделали, исправьте синтаксис JSON в `~/.claude.json` в редакторе вместо этого, затем повторно запустите `claude import`
2474
2475<h3 id="could-not-import-a-server-from-claude-desktop">
2476 Не удалось импортировать сервер из Claude Desktop
2477</h3>
2478
2479Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда всё ещё импортирует другие выбранные серверы и выводит одну строку на сервер, который она не смогла добавить. До версии 2.1.205 первый сервер, который не прошёл, останавливал импорт и ни один из выбранных серверов не был добавлен.
2480
2481```text theme={null}
2482Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
2483```
2484
2485Текст после имени сервера — это причина. Наиболее распространённая — проверка имени: Claude Desktop позволяет символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не проходит валидацию, и сервер, заблокированный [политикой MCP](/docs/ru/managed-mcp) вашей организации.
2486
2487**Что делать:**
2488
2489* Переименуйте сервер в `claude_desktop_config.json`, чтобы использовать только буквы, цифры, дефисы и подчёркивания, затем запустите `claude mcp add-from-claude-desktop` снова
2490* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под действительным именем. См. [Import MCP servers from Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop).
2491
2492<h3 id="cannot-add-mcp-server-to-the-managed-scope">
2493 Не удалось добавить сервер MCP в управляемую область
2494</h3>
2495
2496Вы запустили `claude mcp add` или `claude mcp add-json` с `--scope managed`. Эта область содержит серверы, которые ваша организация предоставляет через управляемый параметр [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers). Claude Code читает их только из управляемых параметров, поэтому команда не может записать сервер в эту область.
2497
2498```text theme={null}
2499Cannot add MCP server to scope: managed
2500```
2501
2502**Что делать:**
2503
2504* Добавьте сервер в область, в которую вы можете писать: `local`, `user` или `project`. Без `--scope` команда использует `local`. См. [MCP installation scopes](/docs/ru/mcp#mcp-installation-scopes)
2505* Чтобы предоставить сервер каждому пользователю в вашей организации, добавьте его в [`managedMcpServers`](/docs/ru/settings-reference#managedmcpservers) в управляемых параметрах, которые вы развёртываете
2506
2507<h3 id="cant-read-mcp-json">
2508 Не удалось прочитать .mcp.json
2509</h3>
2510
2511Команда, которая читает проект [`.mcp.json`](/docs/ru/mcp#project-scope), такая как `claude mcp add` или `claude mcp add-json` с `--scope project` или `claude mcp remove`, обнаружила, что файл в вашем текущем каталоге не является обычным файлом или больше 2 MiB, поэтому она выходит с этой ошибкой вместо чтения файла.
2512
2513```text theme={null}
2514Can'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.
2515```
2516
2517До версии 2.1.257 FIFO в `.mcp.json` оставлял команду ждущей вечно без вывода, и символическая ссылка на файл устройства, такой как `/dev/zero`, увеличивала память до тех пор, пока процесс не был убит.
2518
2519**Что делать:**
2520
2521* Проверьте, что находится в `.mcp.json` в вашем текущем каталоге. Замените его обычным файлом JSON в [формате проектной области](/docs/ru/mcp#project-scope) или удалите его, затем запустите команду снова.
2522
2523<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
2524 Сервер размещён Anthropic и не поддерживает локальный OAuth
2525</h3>
2526
2527Вы запустили вход для сервера MCP, чей URL указывает на размещённый Anthropic хост соединителя, который аутентифицируется через поставщика удостоверений третьей стороны. Эти хосты включают `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com` и `gcal.mcp.claude.com`. Claude Code отказывает запускать свой локальный поток OAuth для этих хостов как из панели `/mcp`, так и из `claude mcp login`, потому что [их вход работает только через claude.ai](/docs/ru/mcp#use-mcp-servers-from-claude-ai).
2528
2529```text theme={null}
2530"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.
2531```
2532
2533Claude Code сопоставляет эти хосты по URL, поэтому сообщение появляется, когда сервер, который вы добавили с помощью `claude mcp add` или в `.mcp.json`, указывает на один из них.
2534
2535**Что делать:**
2536
2537* Удалите вашу запись с помощью `claude mcp remove <name>`, чтобы она не могла скрыть соединитель claude.ai по тому же URL
2538* После удаления подключите сервис на [claude.ai/customize/connectors](https://claude.ai/customize/connectors), пока вы вошли в учётную запись, которую вы используете в Claude Code. После подключения [соединитель появляется в Claude Code автоматически](/docs/ru/mcp#use-mcp-servers-from-claude-ai), если ваш активный метод аутентификации — это вход по подписке claude.ai
2539
2540<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
2541 Сервер отклонил заголовок Authorization, созданный настроенным headersHelper
2542</h3>
2543
2544Сервер MCP, чей [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) предоставляет заголовок `Authorization`, ответил на соединение с HTTP 401 или 403, поэтому Claude Code сообщает о соединении как о неудачном. Потому что помощник предоставляет заголовок `Authorization`, Claude Code [не переходит на OAuth](/docs/ru/mcp#authenticate-with-remote-mcp-servers) для сервера:
2545
2546```text theme={null}
2547Server 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.
2548```
2549
2550Claude Code повторно запускает помощника при каждой попытке соединения, поэтому повторная попытка после временного отклонения, такого как гонка ротации токена, может быть успешной с новым учётным данным.
2551
2552**Что делать:**
2553
2554* Запустите команду `headersHelper` самостоятельно так, как её запускает Claude Code: из [каталога, в котором Claude Code её запускает](/docs/ru/mcp#where-the-helper-runs), с [переменными окружения, которые Claude Code для неё устанавливает](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication), и без [переменных учётных данных, которые Claude Code удаляет](/docs/ru/mcp#which-variables-a-helper-can-read) для сервера из проектного `.mcp.json`, плагина или файла проектного агента. Проверьте, что она выводит значение `Authorization`, которое принимает конечная точка сервера
2555* После исправления помощника или его источника учётных данных выберите сервер в `/mcp` и выберите **Reconnect**
2556
2557До версии 2.1.248 Claude Code запускал обнаружение OAuth для сервера, чей помощник предоставлял заголовок `Authorization`. Это обнаружение могло не пройти с `Incompatible auth server: does not support dynamic client registration` вместо сообщения об отклонённом учётном данном.
2558
2559<h3 id="mcp-permission-prompt-tool-not-found">
2560 Инструмент запроса разрешения MCP не найден
2561</h3>
2562
2563Инструмент, который вы передали в [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении разрешения, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с этим именем. Claude Code всё ещё отправляет ваше приглашение: [неинтерактивный](/docs/ru/headless) запуск выходит с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, даже хотя запрос был сделан. Перед первым приглашением Claude Code ждёт до установленного для каждого сервера времени ожидания соединения в 30 секунд, установленного [`MCP_TIMEOUT`](/docs/ru/env-vars), чтобы этот сервер подключился. До версии 2.1.206 запуск не ждал завершения соединения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.
2564
2565```text theme={null}
2566Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
2567```
2568
2569Список после `Available MCP tools:` указывает инструменты MCP, которые были подключены, когда ожидание закончилось.
2570
2571**Что делать:**
2572
2573* Проверьте, что сервер запускается и остаётся подключённым: запустите `claude mcp list` в том же каталоге и подтвердите, что сервер указан как подключённый
2574* Подтвердите, что имя инструмента соответствует имени `mcp__<server>__<tool>`, которое предоставляет сервер
2575* Если серверу требуется больше 30 секунд для запуска, увеличьте [`MCP_TIMEOUT`](/docs/ru/env-vars)
2576
2577<h3 id="oauth-callback-port-is-already-in-use">
2578 Порт обратного вызова OAuth уже используется
2579</h3>
2580
2581Когда вы входите на удалённый сервер MCP с помощью OAuth, Claude Code запускает локальный слушатель для получения обратного вызова входа. Если порт, который нужен этому слушателю, занят другим процессом, вход не удаётся с этим сообщением. Это в основном происходит с [фиксированным портом обратного вызова](/docs/ru/mcp#use-a-fixed-oauth-callback-port), установленным через переменную [`MCP_OAUTH_CALLBACK_PORT`](/docs/ru/env-vars) или `--callback-port`, так как без неё Claude Code выбирает доступный порт.
2582
2583```text theme={null}
2584OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
2585```
2586
2587На Windows предлагаемая команда — `netstat -ano | findstr :<port>` вместо этого.
2588
2589**Что делать:**
2590
2591* Запустите команду из сообщения, чтобы найти процесс, занимающий порт, и остановите его или дождитесь его завершения
2592* Если другой программе постоянно нужен этот порт, зарегистрируйте другой URI перенаправления на сервере и установите его порт с помощью `MCP_OAUTH_CALLBACK_PORT` или `--callback-port`, в зависимости от того, что вы используете
2593* Затем запустите вход снова, например выбрав сервер в `/mcp`
2594
2595<h3 id="security-review-fails-without-origin-head">
2596 /security-review не работает без origin/HEAD
2597</h3>
2598
2599[`/security-review`](/docs/ru/commands#all-commands) создаёт контекст своего обзора, сравнивая вашу ветку с `origin/HEAD`, локальной ссылкой, которая записывает, какая ветка является стандартной на вашем удалённом `origin`. Когда эта ссылка не существует, команды git, которые собирают diff, не работают и обзор останавливается перед началом.
2600
2601```text theme={null}
2602Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
2603fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
2604Use '--' to separate paths from revisions, like this:
2605'git <command> [<revision>...] -- [<file>...]'
2606```
2607
2608Цитируемая команда варьируется между запусками: обзор запускает несколько команд `git` против `origin/HEAD` одновременно и сообщает, какая не работает первой, поэтому вы можете увидеть `git log` или другой `git diff` на его месте. Git создаёт ссылку только когда стандартная ветка удалённого как объявлена удалённым, так и охвачена вашей спецификацией получения. Полный `git clone` удалённого с коммитами соответствует обоим условиям. Получение одной ветки и получение CI имеют слишком узкую спецификацию, HEAD на стороне сервера, указывающий на ветку, которую никто не отправил, не объявляет стандартную, и репозиторий без удалённого `origin` или того, из которого вы никогда не получали, не предоставляет ни того, ни другого.
2609
2610Claude Code показывает ту же ошибку для любого skill, который [внедряет динамический контекст](/docs/ru/skills#when-an-injected-command-fails). Неудачная внедрённая команда прерывает вызов этого skill. Две соседние строки срабатывают перед запуском команды вообще:
2611
2612* `Shell command permission check failed for pattern "..."`: проверка разрешения команды вернула что-то другое, чем разрешение. Внедрённые команды никогда не запрашивают, поэтому вызов прерывается без вопроса. Предварительно одобрите команды, которые не соответствуют никакому правилу, с помощью [`allowed-tools`](/docs/ru/skills#pre-approve-tools-for-a-skill). Соответствующее правило ask или deny всё ещё прерывает вызов независимо от `allowed-tools`
2613* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill требует bash на машине без него. Установите Git для Windows или измените frontmatter на `shell: powershell`. См. [How injected commands run](/docs/ru/skills#how-injected-commands-run)
2614
2615**Что делать:**
2616
2617* Создайте ссылку, назвав стандартную ветку вашего удалённого: `git remote set-head origin <default-branch>`. Это работает всякий раз, когда существует локальная отслеживаемая ссылка `origin/<default-branch>`. Если её нет, как в клонах одной ветки, сначала получите ветку: запустите `git remote set-branches --add origin <branch>`, затем `git fetch origin`, затем повторно запустите команду set-head. Повторно запустите `/security-review`.
2618* Если вы предпочитаете не называть ветку, запустите `git fetch origin` и затем `git remote set-head origin --auto`, который спрашивает удалённый, какая ветка является его стандартной. Это не работает с `error: Cannot determine remote HEAD`, когда удалённый не объявляет стандартную ветку, потому что он пуст или его HEAD указывает на ветку, которую никто не отправил; вместо этого назовите ветку явно. Это не работает с `error: Not a valid ref`, когда ваш клон не получает эту ветку; сначала расширьте спецификацию, как выше.
2619* Если репозиторий не имеет удалённого, добавьте один с помощью `git remote add origin <url>` и получите перед созданием ссылки. Если удалённый пуст, сначала отправьте вашу ветку с помощью `git push -u origin HEAD` и назовите эту ветку в команде set-head; `origin/HEAD` затем указывает на ветку, которую вы только что отправили, поэтому `/security-review` видит пустой diff, пока ветка не отличается от неё.
2620
2621<h3 id="input-must-be-provided-when-using-print">
2622 Входные данные должны быть предоставлены при использовании --print
2623</h3>
2624
2625Bare `claude` нужен stdout, чтобы быть терминалом для запуска интерактивного UI. Когда stdout перенаправлен или консоль не является реальным терминалом, такой как PowerShell ISE и некоторые панели вывода IDE, `claude` вместо этого работает [неинтерактивно](/docs/ru/headless). Это тот же режим, что и `claude -p`, который требует приглашение, поэтому сообщение указывает `--print` даже когда вы не передали флаг. Передача `-p`/`--print` без приглашения и ничего не передано на stdin выдаёт ту же ошибку везде.
2626
2627```text theme={null}
2628Error: Input must be provided either through stdin or as a prompt argument when using --print
2629```
2630
2631**Что делать:**
2632
2633* Для интерактивного использования запустите `claude` в реальном терминале: Windows Terminal или консоль PowerShell вместо ISE и интегрированный терминал вашего IDE вместо панели вывода
2634* Для одноразового использования передайте приглашение: `claude -p "your question"` или передайте его с помощью `echo "your question" | claude -p`
2635
2636<h3 id="input-contained-only-whitespace">
2637 Входные данные содержали только пробелы
2638</h3>
2639
2640В [неинтерактивном режиме](/docs/ru/headless) Claude Code отказывает приглашение, состоящее полностью из пробелов, табуляций или новых строк вместо его отправки, потому что API отклоняет сообщения без видимого текста. Какое сообщение вы видите, зависит от того, откуда пришло пустое приглашение:
2641
2642* **Аргумент приглашения или передача stdin для `claude -p`**: `claude` выходит с `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
2643* **Сообщение, отправленное работающему сеансу `--input-format stream-json` или [Agent SDK](/docs/ru/agent-sdk/overview)**: Claude Code заканчивает ход без вызова модели и сеанс остаётся пригодным. Отказ приходит как информационное сообщение и как текст результата хода: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`
2644
2645До версии 2.1.229 Claude Code отправлял сообщение только с пробелами в API, который отклонял запрос с ошибкой 400.
2646
2647**Что делать:**
2648
2649* Включите видимый текст в приглашение. Если скрипт создаёт приглашение из переменной или файла, проверьте, что источник не пуст перед вызовом Claude Code.
2650
2651<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
2652 stream-json входные данные содержали более 256M символов без новой строки
2653</h3>
2654
2655Ваша программа отправила более 268,435,456 символов на stdin без новой строки в запуск `claude -p --input-format stream-json`, поэтому Claude Code выводит эту ошибку на stderr и выходит с кодом 1 вместо буферизации дополнительного входа. Сообщение указывает этот бюджет как `256M`. До версии 2.1.257 Claude Code буферизировал такой вход без ограничений, увеличивая память до тех пор, пока процесс не падал или не был убит.
2656
2657```text theme={null}
2658Error: 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.
2659```
2660
2661Входные данные такой длины без новой строки обычно означают, что производитель вообще не является производителем stream-json, такой как двоичный файл или простой вывод журнала, случайно передаваемый. Одно сообщение сверх бюджета не проходит ту же проверку.
2662
2663**Что делать:**
2664
2665* Проверьте, что передаётся на stdin. С [`--input-format stream-json`](/docs/ru/cli-reference#cli-flags) каждое сообщение должно быть одной строкой JSON, завершённой новой строкой
2666* Чтобы вместо этого отправить простой текст, удалите `--input-format stream-json`; `claude -p` по умолчанию читает простой текстовый запрос из stdin
2667
2668<h3 id="unknown-command">
2669 Неизвестная команда
2670</h3>
2671
2672Вы отправили имя `/`, которое не соответствует никакой команде в этом сеансе, поэтому Claude Code сообщает имя вместо запуска чего-либо:
2673
2674```text theme={null}
2675Unknown command: /hepl. Did you mean /help?
2676```
2677
2678Claude Code предлагает ближайшее имя команды или псевдоним, который меню перечисляет в этом сеансе. Когда ничего не близко, сообщение заканчивается после имени. Причина обычно одна из следующих:
2679
2680* Опечатка, такая как `/hepl` для `/help`. [How the command menu matches what you type](/docs/ru/commands#how-the-command-menu-matches-what-you-type) охватывает выбор близкого совпадения перед отправкой
2681* Команда, которая существует, но недоступна в этом сеансе, потому что требование не выполнено, такое как ваша платформа, план или метод аутентификации. Записи устранения неполадок для [`/web-setup`](/docs/ru/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) и [`/schedule`](/docs/ru/routines#schedule-returns-unknown-command) проходят через два распространённых случая. Некоторые команды отвечают своим собственным сообщением, когда политика вашей организации их отключает
2682* Команда из [плагина](/docs/ru/plugins) или [сервера MCP](/docs/ru/mcp#use-mcp-prompts-as-commands), который не установлен или не подключен в этом сеансе
2683
2684Claude Code не рассматривает каждое приглашение, которое начинается с `/`, как команду. Он отправляет приглашение Claude как обычное сообщение, когда первое слово после `/` начинается с пунктуации, такой как `/--`, который открывает комментарий документа Lean, или является путём, такой как `/var/log/syslog`.
2685
2686До версии 2.1.236, если вы нажали `Enter`, пока меню команд перечисляло близкое совпадение для имени, которое вы ввели, Claude Code запускал это совпадение, поэтому опечатка, такая как `/hepl`, запускала `/help` вместо выдачи этого сообщения.
2687
2688**Что делать:**
2689
2690* Запустите предложенное имя или введите `/` с последующей частью имени, чтобы увидеть, что доступно в этом сеансе
2691* Если Claude Code сообщает задокументированную команду как неизвестную, проверьте её строку в [справочнике команд](/docs/ru/commands) для требования, которое она указывает
2692
2693<h3 id="diff-is-too-large-for-ultrareview">
2694 Diff слишком большой для ultrareview
2695</h3>
2696
2697Diff между вашей веткой и базовой веткой, включая незафиксированные и поставленные в очередь изменения, превышает ограничения размера для [ultrareview](/docs/ru/ultrareview), поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса. Отклонённый обзор не использует бесплатный запуск и не выставляет счёт за использование кредитов. Сообщение указывает действующие ограничения, размер вашего diff и файлы, которые вносят наибольшее количество изменённых строк. До версии 2.1.216 сообщение показывало только необработанную статистику diff.
2698
2699```text theme={null}
2700Diff 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 <branch>`) to narrow the scope, or split the change.
2701```
2702
2703Обзор запроса на слияние применяет те же ограничения; эта форма сообщения начинается с `PR #<N> is too large for ultrareview` и указывает количество файлов и строк PR.
2704
2705**Что делать:**
2706
2707* Передайте базовую ветку ближе к вашей работе, такую как `/code-review ultra develop`, чтобы обзор охватывал только diff против этой ветки
2708* Разделите изменение на меньшие ветки и обзорьте каждую. Файлы, которые сообщение указывает, вносят наибольшее количество изменённых строк, поэтому начните с перемещения их в свою собственную ветку.
2709
2710<h3 id="could-not-find-merge-base-with-the-base-branch">
2711 Не удалось найти merge-base с базовой веткой
2712</h3>
2713
2714`/code-review ultra` и подкоманда `claude ultrareview` обзорят diff между вашей веткой и базовой веткой, что требует коммита, который они оба разделяют. Когда `git merge-base` не находит ни одного, Claude Code отказывает обзор перед запуском облачного сеанса. На клоне, который Claude Code может проверить как полный, с по крайней мере одной веткой, он переходит на [обзор каждого отслеживаемого файла](/docs/ru/ultrareview#diff-limits-and-fallbacks) вместо отказа. Вы видите этот отказ, когда базовую ветку вообще не удалось найти, когда Claude Code не может проверить, что ваш клон полный, или в редком репозитории, где diff всего дерева невозможен, такой как формат объекта SHA-256.
2715
2716```text theme={null}
2717Could 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.
2718```
2719
2720Подсказка после первого предложения зависит от того, что Claude Code наблюдал:
2721
2722* **Вы не передали базовую ветку**: Claude Code сравнил с стандартной веткой репозитория и предлагает передать вашу базу явно, как в примере выше
2723* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка читает ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
2724* **Вы передали базовую ветку, которой не было в вашем клоне**: Claude Code получил её из origin перед сравнением. Подсказка читает ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; когда Claude Code не может сказать, полный ли ваш клон, он предлагает `git fetch --unshallow origin` вместо этого. До версии 2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, и на полном клоне эта команда не работает с `fatal: --unshallow on a complete repository does not make sense`.
2725
2726**Что делать:**
2727
2728* Если другая ветка является вашей реальной базой, передайте её явно: `/code-review ultra <branch>`
2729* Если ваш клон может не иметь полной истории, запустите `git fetch --unshallow origin` и повторно запустите обзор
2730
2731<h3 id="your-checkout-has-no-branches">
2732 Ваш checkout не имеет веток
2733</h3>
2734
2735Checkout может иметь коммиты, но не иметь веток: если вы запустите `git init`, затем `git fetch <url>` и `git checkout FETCH_HEAD`, вы получите отсоединённый HEAD без ссылок. Claude Code упаковывает ваш репозиторий как git bundle для загрузки его для [ultrareview](/docs/ru/ultrareview), и он не может упаковать репозиторий, который не имеет веток или других ссылок, поэтому `/code-review ultra` и подкоманда `claude ultrareview` отказывают обзор перед запуском облачного сеанса.
2736
2737```text theme={null}
2738Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
2739```
2740
2741До версии 2.1.221 Claude Code пытался обзорить каждый отслеживаемый файл в этом checkout, и загрузка не работала.
2742
2743**Что делать:**
2744
2745* Создайте ветку в вашем текущем коммите с помощью `git checkout -b <name>`, затем повторно запустите обзор
2746
2747<h3 id="no-github-account-is-connected-to-your-claude-account">
2748 Ни одна учётная запись GitHub не подключена к вашей учётной записи Claude
2749</h3>
2750
2751Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и перед созданием облачного сеанса Claude Code спрашивает сервер, может ли [учётная запись GitHub, подключённая к вашей учётной записи Claude](/docs/ru/ultrareview#review-a-pull-request), достичь репозитория PR. Ни одна учётная запись не подключена или соединение истекло, поэтому облачный клон не удастся и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за использование кредитов для отклонённого запуска.
2752
2753```text theme={null}
2754Ultrareview clones <owner>/<repo> 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).
2755```
2756
2757Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступна в вашем сеансе, сообщение указывает только ссылку claude.ai.
2758
2759**Что делать:**
2760
2761* Запустите `/web-setup` для подключения вашего входа GitHub CLI к вашей учётной записи Claude или подключите учётную запись на [claude.ai/connect-github](https://claude.ai/connect-github)
2762* Повторно запустите обзор через минуту после подключения
2763
2764До версии 2.1.248 Claude Code не проверял это перед запуском.
2765
2766<h3 id="your-connected-github-account-cant-see-the-repository">
2767 Ваша подключённая учётная запись GitHub не может видеть репозиторий
2768</h3>
2769
2770Вы запустили `/code-review ultra <PR#>` или `claude ultrareview <PR#>`, и [учётная запись GitHub, подключённая к вашей учётной записи Claude](/docs/ru/ultrareview#review-a-pull-request), не может прочитать репозиторий PR, поэтому облачный клон не удастся и Claude Code отказывает запуск. Claude Code не тратит бесплатный запуск и не выставляет счёт за использование кредитов для отклонённого запуска.
2771
2772```text theme={null}
2773Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> 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.
2774```
2775
2776Когда [`/web-setup`](/docs/ru/web-quickstart#connect-from-your-terminal) недоступна в вашем сеансе, сообщение указывает только установку приложения.
2777
2778**Что делать:**
2779
2780* Если ваш локальный CLI `gh` может прочитать репозиторий, запустите `/web-setup` для подключения этого входа к вашей учётной записи Claude
2781* Повторно запустите обзор после изменения
2782
2783До версии 2.1.248 Claude Code не проверял это перед запуском.
2784
2785<h3 id="the-github-app-preflight-failed-transiently">
2786 Проверка GitHub App не прошла временно
2787</h3>
2788
2789Вы запустили [облачный сеанс](/docs/ru/claude-code-on-the-web) из локального репозитория, и два шага не прошли вместе. Claude Code не смог создать или загрузить bundle вашего репозитория. Перед загрузкой он проверил, может ли облачный сервис клонировать репозиторий из GitHub, и вместо определённого ответа эта проверка закончилась ошибкой, которую повторная попытка могла бы очистить, такой как сетевая ошибка, тайм-аут или временная ошибка сервера. Полное сообщение начинается с того, что остановило bundle, например `Could not upload repo bundle (<error>)`, и заканчивается предложением проверки:
2790
2791```text theme={null}
2792Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
2793```
2794
2795**Что делать:**
2796
2797* Повторно запустите команду через момент. Когда проверка GitHub пройдёт, Claude Code может запустить сеанс из клона GitHub, поэтому неудачная загрузка больше не блокирует запуск
2798* Если повторные попытки продолжают не работать, начало сообщения указывает, что остановило загрузку. Когда эта причина — что-то, что вы можете исправить, исправьте это, чтобы сеанс мог запуститься из вашего локального репозитория вместо этого
2799
2800До версии 2.1.251 Claude Code заканчивал сообщение с `Please set up GitHub on https://claude.ai/code` даже когда проверка GitHub не прошла только временно, и совет по настройке не может очистить временный отказ.
2801
2802<h3 id="failed-to-resume-the-conversation">
2803 Не удалось возобновить разговор
2804</h3>
2805
2806Claude Code не смог прочитать или обработать сохранённую стенограмму для сеанса, который вы выбрали из [средства выбора `claude --resume`](/docs/ru/sessions#use-the-session-picker), поэтому он заканчивает процесс вместо продолжения в частично загруженном состоянии. Сообщение включает команду для повторной попытки:
2807
2808```text theme={null}
2809Failed to resume the conversation.
2810Run claude --resume <session-id> to retry, or claude to start a new session.
2811```
2812
2813Claude Code выходит с кодом 1 после показа сообщения. Средство выбора `/resume` внутри работающего сеанса сообщает `Failed to resume conversation` в разговоре вместо этого, и ваш текущий сеанс продолжает работать. До версии 2.1.216 неудачное возобновление из средства выбора `claude --resume` оставалось на спиннере `Resuming conversation…` бесконечно вместо показа этого сообщения.
2814
2815**Что делать:**
2816
2817* Запустите `claude --resume <session-id>` с ID сеанса из сообщения для повторной попытки
2818* Если повторная попытка снова не работает, запустите `claude` для запуска нового сеанса
2819
2820<h3 id="no-conversation-found-with-the-session-id">
2821 Разговор не найден с ID сеанса
2822</h3>
2823
2824Вы передали ID сеанса в `claude --resume <session-id>` и ни одна сохранённая стенограмма не совпала с ним:
2825
2826```text theme={null}
2827No conversation found with session ID: <session-id>
2828```
2829
2830Claude Code выходит с кодом 1 после показа сообщения. Claude Code [ищет текущий проект первым, затем каждый другой проект на этой машине](/docs/ru/sessions#resume-a-session) для ID. До версии 2.1.223 поиск останавливался в текущем каталоге проекта и его git worktrees, поэтому возобновляется из каталога, в котором сеанс в последний раз работал.
2831
2832Распространённые причины:
2833
2834* **Неправильно введённый ID**: для неинтерактивного запуска ID — это поле `session_id` вывода [`--output-format json`](/docs/ru/headless#get-structured-output)
2835* **Удалённая стенограмма**: Claude Code удаляет стенограммы после [периода хранения](/docs/ru/sessions#where-transcripts-are-stored), 30 дней по умолчанию, следуя [правилам очистки хранения](/docs/ru/claude-directory#cleaned-up-automatically)
2836* **Другая машина**: Claude Code хранит стенограммы локально, поэтому возобновляет сеанс на машине, где он работал
2837* **Дублирующиеся копии**: если вы скопировали каталог проекта под `~/.claude/projects`, чтобы две стенограммы имели один и тот же ID, Claude Code сообщает это сообщение вместо возобновления одной копии произвольно
2838
2839**Что делать:**
2840
2841* Для интерактивного сеанса откройте [средство выбора сеанса](/docs/ru/sessions#use-the-session-picker) с помощью `claude --resume` и нажмите `Ctrl+A` для расширения на каждый проект на этой машине, затем выберите сеанс
2842* Сеансы, созданные с помощью `claude -p` или [Agent SDK](/docs/ru/agent-sdk/overview), не появляются в средстве выбора, поэтому повторно проверьте ID против `session_id`, который выводит ваш исходный запуск
2843
2844<h3 id="cannot-switch-renderers-in-this-session">
2845 Не удалось переключить рендеры в этом сеансе
2846</h3>
2847
2848Когда вы переключаете рендеры, Claude Code перезапускает свой процесс. Вы запустили [`/tui`](/docs/ru/fullscreen#enable-fullscreen-rendering) в сеансе, который Claude Code отказывает перезапускать, поэтому он не переключается и ничего не сохраняет. Какое сообщение вы видите, говорит вам причину:
2849
2850* `Cannot switch renderers while work is running in the background`: у вас есть фоновая работа, которая перезапуск бросит, такая как фоновая оболочка или подагент. Дождитесь завершения работы или остановите её с помощью [`/tasks`](/docs/ru/commands), затем запустите `/tui fullscreen` или `/tui default` снова
2851* `Cannot switch renderers in this session`: сеанс имеет ограничения, которые Claude Code не может передать перезапущенному процессу. До версии 2.1.234 Claude Code перезапускал в любом случае и повторно запущенный сеанс работал без них
2852
2853В сообщении об ограничениях часть в скобках указывает найденные ограничения Claude Code:
2854
2855```text theme={null}
2856Cannot 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.
2857```
2858
2859Каждая причина, которую сообщение может показать в скобках:
2860
2861* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: вы запустили сеанс с флагом, который Claude Code не передаёт обратно перезапущенному процессу. Эти флаги включают [`--system-prompt`](/docs/ru/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, список [`--tools`](/docs/ru/cli-reference#cli-flags), [`--setting-sources`](/docs/ru/cli-reference#cli-flags) и [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags)
2862* `permission rules set for this session only`: [обновление разрешений](/docs/ru/hooks#permission-update-entries) из hook или вызывающего SDK добавило правила deny или ask с назначением `session`. Правила allow с областью сеанса не вызывают отказ. Перезапуск их удаляет, и Claude Code вместо этого запрашивает снова
2863* `ask-before-running rules with no command-line form`: обновление разрешений из hook или вызывающего SDK добавило правила ask наряду с правилами, которые Claude Code передаёт обратно как `--allowed-tools` и `--disallowed-tools`. Флаг для правил ask не существует
2864* `permission rules a command line cannot carry intact` и `added directories a command line cannot carry intact`: обновление разрешений добавило правило или путь каталога в середине сеанса. Командная строка перезапущенного процесса не может нести его текст как то же значение
2865
2866**Что делать:**
2867
2868* В сеансе, запущенном без этих ограничений, запустите `/tui fullscreen` или `/tui default` для переключения обратно. Claude Code сохраняет параметр [`tui`](/docs/ru/settings-reference#tui) там
2869
2870<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
2871 /terminal-setup оставил вашу раскладку клавиш Zed без изменений
2872</h3>
2873
2874Вы запустили [`/terminal-setup`](/docs/ru/terminal-config#enter-multiline-prompts) в Zed, и Claude Code не смог завершить обновление вашего `keymap.json` Zed, поэтому он оставил файл как он был.
2875
2876Каждое сообщение указывает путь к вашей раскладке и заканчивается блоком сочетания клавиш для добавления самостоятельно:
2877
2878```text theme={null}
2879Couldn't update your Zed keymap, so it was left unchanged.
2880To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
2881{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
2882```
2883
2884Первая строка сообщения указывает причину:
2885
2886* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code не смог прочитать файл, например из-за разрешений файла
2887* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: файл прочитался хорошо, но не анализируется как массив блоков сочетаний клавиш, даже с разрешёнными комментариями `//` и запятыми в конце
2888* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code не смог скопировать файл в резервную копию `.bak` рядом с ним, поэтому он ничего не изменил
2889* `Couldn't update your Zed keymap, so it was left unchanged.`: объединённый результат не проверился как действительная раскладка, несущая сочетание, поэтому Claude Code отбросил его вместо записи. Блок сочетания с дублированным ключом может вызвать это
2890
2891**Что делать:**
2892
2893* Скопируйте блок из сообщения в массив верхнего уровня в вашем `keymap.json` по пути, который указывает сообщение
2894* Для `isn't a readable list of keybindings`, исправьте ошибку синтаксиса или сделайте значение верхнего уровня файла массивом, затем запустите `/terminal-setup` снова
2895
2896До версии 2.1.247 `/terminal-setup` не мог анализировать раскладку Zed, которая использовала комментарии `//` или запятые в конце, и она заменила весь файл только своим собственным сочетанием, сообщая о сочетании как установленном. Чтобы восстановить раскладку, которую более ранняя версия заменила, используйте файл резервной копии `.bak`, описанный в разделе [Enter multiline prompts](/docs/ru/terminal-config#enter-multiline-prompts).
2897
2898<h3 id="skill-usage-reports-are-not-available-on-this-connection">
2899 Отчёты об использовании Skill недоступны на этом соединении
2900</h3>
2901
2902Вы запустили [`/skill-doctor`](/docs/ru/skills#find-unused-skills) через [Remote Control](/docs/ru/remote-control), с вашего телефона или браузера. Claude Code не отправляет отчёт об использовании skill через Remote Control и вместо этого отвечает этим сообщением:
2903
2904```text theme={null}
2905Skill usage reports are not available on this connection.
2906```
2907
2908**Что делать:**
2909
2910* Запустите `/skill-doctor` в терминале на машине, где работает сеанс, или запустите `claude -p "/skill-doctor"` там
2911
2912<h2 id="plugin-errors">
2913 Ошибки плагинов
2914</h2>
2915
2916Эти ошибки возникают из [конфигурации плагинов](/docs/ru/plugins) и [маркетплейса](/docs/ru/plugin-marketplaces). Для проблем с плагинами, которые не выдают одно из сообщений на этой странице, например маркетплейс, который не загружается, или плагин, который устанавливается, но не отображается, см. [Устранение неполадок плагинов](/docs/ru/discover-plugins#troubleshooting).
2917
2918<h3 id="plugin-eval-is-currently-in-early-access">
2919 plugin eval is currently in early access
2920</h3>
2921
2922Вы запустили [`claude plugin eval`](/docs/ru/plugin-evals) или `claude plugin eval init`, и он завершился с кодом 1 с одним из этих сообщений перед выполнением чего-либо:
2923
2924```text theme={null}
2925`plugin eval` is currently in early access
2926```
2927
2928```text theme={null}
2929`plugin eval` is currently unavailable
2930```
2931
2932Первое сообщение означает, что ваша сборка старше v2.1.269, первой версии, где команда общедоступна. Второе означает, что Anthropic отключила команду на стороне сервера; ничто на вашей машине не включит её обратно.
2933
2934**Что делать:**
2935
2936* Запустите `claude --version`, затем `claude update`, и запустите команду снова в новом сеансе. См. [требования для plugin evals](/docs/ru/plugin-evals#requirements)
2937* Если вы видите второе сообщение в текущей сборке, попробуйте снова позже после другого `claude update`
2938
2939<h3 id="marketplace-is-registered-from-an-untrusted-source">
2940 Marketplace is registered from an untrusted source
2941</h3>
2942
2943Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/docs/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии v2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.
2944
2945```text theme={null}
2946Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
2947```
2948
2949Для маркетплейса, источник которого не является репозиторием GitHub или URL-адресом Git, например локальной директорией, среднее предложение читается как `can only be used with GitHub sources from the 'anthropics' organization` вместо этого. `claude plugin marketplace add` выполняет ту же проверку и отказывает зарезервированному имени с `Failed to add marketplace:`, за которым следует то же предложение о зарезервированном имени.
2950
2951**Что делать:**
2952
2953* Если маркетплейс уже зарегистрирован, запустите `claude plugin marketplace remove <name>`, затем добавьте его снова из официального репозитория `github.com/anthropics`
2954* Если вы публикуете сторонний маркетплейс, который использовал имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его снова из вашего источника
2955* См. список зарезервированных имён в разделе [Marketplace schema](/docs/ru/plugin-marketplaces#marketplace-schema)
2956
2957<h3 id="plugin-command-references-user-config">
2958 Plugin command references user\_config in a shell command
2959</h3>
2960
2961Хук плагина, [monitor](/docs/ru/plugins-reference#monitors), или команда MCP [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) ссылается на [опцию плагина](/docs/ru/plugins-reference#user-configuration) `${user_config.KEY}`, и подставленная строка будет передана в оболочку. Настроенное значение, содержащее `$(...)`, обратные кавычки или `;`, будет выполнено как код там, поэтому Claude Code отказывается запускать компонент вместо подстановки значения. Проверка выполняется на шаблоне команды, поэтому ошибка появляется даже когда значение ещё не настроено. До версии v2.1.207 значение подставлялось в команду оболочки.
2962
2963Формулировка зависит от того, какая поверхность ссылалась на опцию. Хук в форме оболочки сообщает:
2964
2965```text theme={null}
2966Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
2967```
2968
2969Monitor сообщает:
2970
2971```text theme={null}
2972Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
2973```
2974
2975MCP `headersHelper` сообщает:
2976
2977```text theme={null}
2978headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
2979```
2980
2981**Что делать:**
2982
2983* Для хука добавьте массив `args`, чтобы он выполнялся в [exec форме](/docs/ru/hooks#exec-form-and-shell-form), где каждый `${user_config.KEY}` становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>` внутри скрипта
2984* Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации
2985* Для `headersHelper` переместите `${user_config.KEY}` в поле `headers` сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника
2986
2987<h3 id="plugin-archive-integrity-check-failed">
2988 Plugin archive integrity check failed
2989</h3>
2990
2991Запись маркетплейса плагина использует [источник `archive`](/docs/ru/plugin-marketplaces#zip-archives) с привязкой `sha256`, и дайджест загруженного файла не совпадает с привязкой. Claude Code отказывает в установке, поэтому ничего не меняется в кэше плагинов. Несоответствие имеет три возможные причины:
2992
2993* Файл по URL изменился после того, как автор вычислил привязку
2994* Автор ввёл неправильный дайджест в запись маркетплейса
2995* URL служит другой файл, чем тот, который автор привязал
2996
2997```text theme={null}
2998Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.
2999```
3000
3001**Что делать:**
3002
3003* Если вы публикуете плагин, пересчитайте дайджест точного файла, который служит URL, например с помощью `shasum -a 256 my-plugin.zip`, или `Get-FileHash -Algorithm SHA256 my-plugin.zip` в PowerShell, и обновите `sha256` в записи маркетплейса
3004* Если вы устанавливаете плагин, запустите `/plugin marketplace update <name>` для обновления каталога на случай, если запись была исправлена, затем повторите попытку установки
3005* Если дайджесты всё ещё не совпадают после обновления, спросите владельца маркетплейса, какой файл они привязали перед установкой
3006
3007<h3 id="path-escapes-plugin-directory">
3008 Path escapes plugin directory
3009</h3>
3010
3011Путь компонента плагина, объявленный в `plugin.json` плагина или в его [записи маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries), разрешается вне собственной директории плагина. Claude Code отбрасывает этот путь и загружает остальную часть плагина. Имя компонента в сообщении, такое как `commands` или `hooks`, называет поле, которое объявило путь.
3012
3013```text theme={null}
3014commands path escapes plugin directory: ./../shared.md
3015```
3016
3017В выводе команды `claude plugin` та же ошибка читается как `Path escapes plugin directory: ./../shared.md (commands)`.
3018
3019Claude Code отклоняет как путь, который указывает вне плагина в том виде, в котором он написан, например `../shared-utils`, так и символическую ссылку, которая ведёт вне плагина и не является одной из [правил символических ссылок маркетплейса](/docs/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks), которые разрешены. Для символической ссылки сообщение также указывает, где разрешается путь:
3020
3021```text theme={null}
3022commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
3023```
3024
3025На macOS и Linux Claude Code также отклоняет путь компонента, который содержит обратную косую черту где-либо в нём, даже когда путь остаётся внутри плагина. Плагин, чьи пути компонентов используют разделители в стиле Windows, загружается на Windows и вызывает это отклонение на других платформах:
3026
3027```text theme={null}
3028commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform
3029```
3030
3031До версии v2.1.251 Claude Code загружал путь `commands`, объявленный в записи маркетплейса, даже когда он указывал вне директории плагина. Claude Code уже отклонял пути, объявленные в `plugin.json`, и другие пути компонентов в записи маркетплейса.
3032
3033До версии v2.1.257 проверка смотрела только на написание пути, а не на то, где ведёт символическая ссылка.
3034
3035**Что делать:**
3036
3037* Переместите упомянутый файл внутри директории плагина и укажите на него путём с относительным путём `./`
3038* Если путь является символической ссылкой на файл вне плагина, замените символическую ссылку копией файла
3039* Если сообщение говорит, что путь содержит обратную косую черту, напишите путь с прямыми косыми чертами, например `./commands/deploy.md`
3040* Для совместного использования файлов с другими плагинами в том же маркетплейсе свяжите их с символической ссылкой внутри директории плагина, следуя [правилам символических ссылок](/docs/ru/plugins-reference#share-files-within-a-marketplace-with-symlinks)
3041
3042<h3 id="path-could-not-be-checked">
3043 Path could not be checked
3044</h3>
3045
3046Claude Code попросила операционную систему проверить, существует ли путь плагина, и получила ошибку, отличную от «не найдено», поэтому она не загружает то, что называет путь. Сколько плагина загружается, зависит от того, какой путь не удался:
3047
3048* Одна из [папок компонентов по умолчанию](/docs/ru/plugins-reference#file-locations-reference) плагина, такая как `skills/` или `commands/`: другие компоненты плагина всё ещё загружаются
3049* Собственная директория плагина: ничего из этого плагина не загружается
3050
3051Вы не видите эту ошибку для пути, который вообще не существует. В `/plugin` ошибка появляется под плагином и называет путь и код, который вернула операционная система:
3052
3053```text theme={null}
3054skills path could not be checked: /home/user/my-plugin/skills (ELOOP)
3055```
3056
3057В `claude plugin list` та же ошибка читается как `Path not found: /home/user/my-plugin/skills (skills, ELOOP)`.
3058
3059Причины, которые производят эту ошибку, включают:
3060
3061* `ELOOP`: символическая ссылка в пути указывает на себя или образует цикл
3062* `EIO` или `ESTALE`: путь находится на сетевом монтировании, которое сломано или устарело
3063* `EACCES`: один из директорий выше пути отказывает вам в разрешении на его обход
3064
3065**Что делать:**
3066
3067* Замените символическую ссылку, которая указывает на себя, на реальную папку, или удалите её
3068* Если путь находится на сетевом монтировании, переподключите общий ресурс
3069* Если код `EACCES`, восстановите ваше разрешение на выполнение в директориях выше пути
3070* Запустите `/reload-plugins` после исправления пути, или перезагрузите Claude Code, чтобы загрузить плагин или компонент
3071
3072До версии v2.1.265 Claude Code рассматривала папку компонента по умолчанию, которую она не могла проверить, как отсутствующую и загружала плагин без этого компонента, без ошибки.
3073
3074<h3 id="marketplace-entry-path-does-not-stay-inside-the-marketplace-directory">
3075 Marketplace entry path does not stay inside the marketplace directory
3076</h3>
3077
3078[Запись маркетплейса](/docs/ru/plugin-marketplaces#plugin-entries) плагина объявляет путь источника, который Claude Code не может разрешить в местоположение внутри собственной директории маркетплейса, поэтому плагин не устанавливается и не загружается. Отказ охватывает:
3079
3080* Путь записи, который является абсолютным, выходит из маркетплейса с `..`, или написан как сетевой путь
3081* Запись в маркетплейсе, полученном из удалённого источника, такого как git или URL, которая достигает своей цели через символическую ссылку, разрешающуюся вне директории маркетплейса
3082* Относительная запись в маркетплейсе, добавленном из прямого URL к его `marketplace.json`: Claude Code загружает только этот файл, поэтому локальные файлы плагинов не существуют для пути, чтобы назвать. См. [Plugins with relative paths fail in URL-based marketplaces](/docs/ru/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)
3083
3084`claude plugin install` сообщает об отказе следующим образом:
3085
3086```text theme={null}
3087Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)
3088```
3089
3090Когда запись уже установленного плагина не проходит ту же проверку, `claude plugin list` показывает плагин как `failed to load` с:
3091
3092```text theme={null}
3093Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.
3094```
3095
3096**Что делать:**
3097
3098* Если вы поддерживаете маркетплейс, напишите `source` записи как простой относительный путь, такой как `./plugins/my-plugin`, и держите любую символическую ссылку, которую он пересекает, указывающей внутри директории маркетплейса
3099* Если вы добавили маркетплейс из прямого URL, относительные записи не могут разрешиться. Попросите автора маркетплейса использовать [другой источник плагина](/docs/ru/plugin-marketplaces#plugin-sources), или добавьте маркетплейс из его репозитория git вместо этого
3100
3101<h3 id="failed-to-load-marketplace-configuration">
3102 Failed to load marketplace configuration
3103</h3>
3104
3105Claude Code хранит маркетплейсы плагинов, которые вы добавили, в файле реестра в `~/.claude/plugins/known_marketplaces.json`. Команда плагина, которой нужен реестр, такая как `claude plugin install`, не выполняется с одним из двух сообщений, когда Claude Code не может использовать файл:
3106
3107* `Failed to load marketplace configuration`: файл не является действительным JSON, или не может быть прочитан. Пустой файл не работает таким образом.
3108* `Marketplace configuration file is corrupted`: файл является действительным JSON, но его содержимое не соответствует схеме реестра.
3109
3110Отсутствующий файл не является сбоем: Claude Code рассматривает его как реестр без маркетплейсов.
3111
3112С пустым файлом `claude plugin install` сообщает:
3113
3114```text theme={null}
3115✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF
3116```
3117
3118До версии v2.1.246 `claude plugin install` не сообщал об этом сбое.
3119
3120**Что делать:**
3121
3122* Откройте `~/.claude/plugins/known_marketplaces.json` и исправьте JSON, или исправьте записи, которые сообщение называет как не соответствующие схеме реестра
3123* Если вы не можете исправить это, удалите файл или замените его содержимое на `{}`, затем повторно добавьте каждый маркетплейс с помощью `claude plugin marketplace add <source>`. Claude Code повторно регистрирует маркетплейсы, которые ваши пользовательские или управляемые параметры объявляют в [`extraKnownMarketplaces`](/docs/ru/settings-reference#extraknownmarketplaces), в следующий раз, когда вы запустите его в папке, которую вы доверили.
3124
3125<h2 id="tool-errors">
3126 Ошибки инструментов
3127</h2>
3128
3129Эти ошибки исходят от встроенных инструментов Claude. Claude самостоятельно исправляет большинство ошибок инструментов. Когда требуется изменение с вашей стороны, список **Что делать** для этой ошибки указывает, что нужно изменить.
3130
3131<h3 id="agent-would-be-spawned-with-zero-tools">
3132 Agent would be spawned with zero tools
3133</h3>
3134
3135Каждая запись в списке [`tools` подагента](/docs/ru/sub-agents#supported-frontmatter-fields) не соответствовала ни одному используемому инструменту, поэтому Claude Code отказался запускать подагента: без инструментов он не мог действовать. Сообщение группирует ваши записи по причине ошибки:
3136
3137* **Unrecognized**: запись не соответствует ни одному имени инструмента, обычно это опечатка, например `Grpe` вместо `Grep`.
3138* **Not available to subagents**: запись называет реальный инструмент, который [подагенты не могут использовать](/docs/ru/sub-agents#available-tools). Фоновые подагенты имеют меньший встроенный набор инструментов, поэтому запись, которую может использовать только передний подагент, попадает сюда, когда подагент будет работать в фоне, что является значением по умолчанию. Если вы указываете `Agent`, сообщение сообщает об этом в следующей группе.
3139* **Matched no tools in this session**: запись действительна, но ни один инструмент в текущем сеансе не соответствует ей прямо сейчас, например `mcp__github__*` без подключённого сервера GitHub MCP или `Agent` для подагента на [пределе глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents).
3140
3141Пропуск поля `tools` никогда не вызывает этот отказ. Если вы оставляете список `tools` пустым или `disallowedTools` удаляет каждую запись в нём, Claude Code также пропускает отказ и запускает подагента без инструментов.
3142
3143До версии 2.1.208 подагент запускался без инструментов и мог вернуть пустой или запутанный результат.
3144
3145```text theme={null}
3146Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
3147```
3148
3149**Что делать:**
3150
3151* Исправьте каждую запись, которую называет ошибка, в соответствии с [инструментами, доступными подагентам](/docs/ru/sub-agents#available-tools)
3152* Удалите записи для инструментов, которые сеанс не имеет, например инструменты MCP с сервера, который не подключён
3153* Для инструмента, который [фоновые подагенты отбрасывают](/docs/ru/sub-agents#available-tools), например `LSP`, удалите запись. Чтобы сохранить инструмент, [отключите режим fork](/docs/ru/sub-agents#turn-fork-mode-on-or-off) и попросите Claude запустить подагента на переднем плане
3154* Удалите поле `tools` вместо перечисления инструментов, чтобы дать подагенту каждый [инструмент, доступный подагентам](/docs/ru/sub-agents#available-tools)
3155* Для списка `tools`, содержащего только `Agent`, повысьте [предел глубины](/docs/ru/sub-agents#let-subagents-spawn-their-own-subagents) или дайте агенту по крайней мере один другой инструмент: Claude Code скрывает `Agent` на этом пределе, поэтому список с ничем другим в нём разрешается в отсутствие инструментов
3156
3157<h3 id="file-is-covered-by-a-read-deny-rule">
3158 File is covered by a Read deny rule
3159</h3>
3160
3161Инструмент Edit или Write был вызван на пути, соответствующем [правилу отказа `Read`](/docs/ru/permissions#read-and-edit), включая создание нового файла по этому пути. Оба инструмента изменяют содержимое, которое Claude должен иметь возможность прочитать обратно, поэтому Claude Code отказывает в вызове перед любым доступом к файлу. NotebookEdit не охватывается правилами отказа `Read`. До версии 2.1.228 правило блокировало только инструмент Edit, а до версии 2.1.208 только правило отказа `Edit` блокировало редактирование.
3162
3163```text theme={null}
3164File is covered by a Read deny rule in your permission settings and cannot be edited.
3165```
3166
3167Когда Claude Code отказывает инструменту Write, сообщение заканчивается на `and cannot be written` вместо этого.
3168
3169**Что делать:**
3170
3171* Если Claude должен иметь возможность изменять файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings-reference#permission-settings)
3172* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы также заблокировать инструмент NotebookEdit
3173
3174<h3 id="subagent-type-is-required">
3175 subagent\_type is required
3176</h3>
3177
3178```text theme={null}
3179subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...
3180```
3181
3182Claude вызвал [инструмент Agent](/docs/ru/tools-reference#agent-tool-behavior) без `subagent_type`, и этот сеанс не имеет [универсального подагента](/docs/ru/sub-agents#built-in-subagents) для отката. Это происходит в двух конфигурациях:
3183
3184* [`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/ru/env-vars) установлен в неинтерактивном режиме, что удаляет каждого встроенного подагента
3185* Основной поток агента сеанса имеет [`tools: Agent(...)` список разрешений](/docs/ru/sub-agents#restrict-which-subagents-can-be-spawned), который исключает `general-purpose`
3186
3187**Что делать:**
3188
3189* Обычно ничего: сообщение перечисляет подагентов, которые есть в сеансе, поэтому Claude может повторить попытку с одним из них
3190* Если Claude продолжает терпеть неудачу, добавьте `general-purpose` в список разрешений `tools: Agent(...)` или отмените установку `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`
3191
3192До версии 2.1.235 тот же вызов завершался с ошибкой `Agent type 'general-purpose' not found`.
3193
3194<h3 id="memory-index-is-over-its-read-limit">
3195 Memory index is over its read limit
3196</h3>
3197
3198Claude написал в индекс [автоматической памяти](/docs/ru/memory#auto-memory) `MEMORY.md` и оставил его выше одного из его пределов чтения: 200 строк или 25 КБ. Запись прошла успешно, но загружаются только первые 200 строк или 25 КБ, в зависимости от того, что меньше, в начале сеанса, поэтому всё, что находится за пределом, отбрасывается каждый раз при чтении индекса. До версии 2.1.210 индекс, превышающий лимит, молча усекался при следующей загрузке без сигнала во время записи.
3199
3200```text theme={null}
3201Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.
3202```
3203
3204Только содержимое, которое загружается, учитывается в пределах. Frontmatter YAML и блочные комментарии HTML удаляются перед загрузкой индекса, поэтому они исключаются из измерения. До версии 2.1.211 Claude Code измерял исходный файл, и frontmatter или комментарии могли вызвать эту ошибку даже когда загруженное содержимое подходило.
3205
3206Claude Code доставляет ошибку Claude после записи, а не выводит её как баннер в вашем терминале, поэтому вы можете заметить её только в стенограмме.
3207
3208Когда запись Claude приносит файл близко к пределу без его пересечения, Claude Code возвращает более мягкое напоминание о сжатии индекса вместо этой ошибки.
3209
3210**Что делать:**
3211
3212* Позвольте Claude переписать `MEMORY.md` или попросите это: сохраняйте одну строку на запись, перемещайте детали в файлы тем и объединяйте или отбрасывайте устаревшие записи
3213* Чтобы обрезать индекс самостоятельно, см. [Аудит и редактирование вашей памяти](/docs/ru/memory#audit-and-edit-your-memory)
3214
3215<h3 id="pkill-pattern-matches-the-claude-code-process">
3216 pkill pattern matches the Claude Code process
3217</h3>
3218
3219Команда `pkill` в вызове инструмента Bash использовала шаблон, обычно с `-f`, который соответствует самому процессу Claude Code, поэтому Claude Code отказывает в команде вместо того, чтобы позволить ей завершить сеанс. Claude Code тестирует шаблон с помощью `pgrep` перед запуском `pkill` и отказывает, когда его собственный ID процесса находится в результате. Проверка выполняется только на Linux; на macOS `pkill` работает без изменений. До версии 2.1.214 команда выполнялась, и соответствующий шаблон убивал сеанс Claude Code в середине хода.
3220
3221```text theme={null}
3222pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.
3223```
3224
3225Отказ появляется в результате инструмента Bash, а не как баннер в вашем терминале, и Claude обычно самостоятельно корректирует команду.
3226
3227**Что делать:**
3228
3229* Сузьте шаблон так, чтобы он соответствовал только предполагаемому процессу, например полному пути целевого двоичного файла, а не короткой подстроке
3230* Чтобы остановить процессы, запущенные текущей оболочкой, используйте `pkill -P $$` с шаблоном, который ограничивает совпадение дочерними процессами оболочки
3231
3232<h3 id="failed-to-write-to-a-teammate-inbox">
3233 Failed to write to a teammate's inbox
3234</h3>
3235
3236Claude Code не смог написать сообщение в файл почтового ящика товарища под `~/.claude/teams/{team-name}/inboxes/`, поэтому получатель ничего не получил. Запись не удаётся, когда Claude Code не может создать или обновить файл, например потому что диск заполнен, каталог не доступен для записи или другой агент держит блокировку входящих сообщений слишком долго. До версии 2.1.224 Claude Code сообщал сообщение как отправленное даже когда запись не удалась.
3237
3238Ошибка появляется в результате инструмента отправляющего агента, а не как баннер в вашем терминале, и его текст говорит Claude повторить попытку:
3239
3240```text theme={null}
3241Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.
3242```
3243
3244Структурированные сообщения протокола [команды агентов](/docs/ru/agent-teams) терпят неудачу таким же образом, и ошибка называет недоставленное сообщение: когда Claude Code не может написать одобрение плана, отклонение плана, запрос на завершение или отклонение завершения, ошибка читается как `Failed to write the <message> to <name>'s inbox — nothing was sent`. `plan approval` в этом списке — это решение лидера, одобряющее план товарища; отправка плана товарищем — это отдельное сообщение `plan approval request`. Это сообщение и два других сообщения протокола несут свой собственный текст сообщения и последствие:
3245
3246* `Failed to write the plan approval request to the lead's inbox — plan not submitted; try again`: план товарища никогда не достиг лидера, и товарищ остаётся в режиме плана до успешной повторной отправки
3247* `The permission request could not be delivered to the team lead (mailbox write failed)`: запрос разрешения товарища никогда не достиг лидера, поэтому никто не одобрил вызов инструмента
3248* `The confirmation could not be written to team-lead's inbox.`: само одобрение завершения вступило в силу и товарищ выходит; только подтверждение лидеру отсутствует
3249
3250Когда вы сами отправляете сообщение товарищу, вводя `@name` с последующим сообщением в сеансе лидера, та же ошибка появляется как уведомление, `Couldn't write to @name's inbox — message not sent. Try again.`, и Claude Code сохраняет ваш текст в поле подсказки, чтобы вы могли отправить его снова.
3251
3252**Что делать:**
3253
3254* Попросите отправителя повторно отправить сообщение; конкуренция за блокировку входящих сообщений является временной и разрешается при повторной попытке
3255* Проверьте свободное место на диске и убедитесь, что `~/.claude/teams` и файлы под ним доступны для записи вашим пользователем
3256
3257<h3 id="message-too-large-for-cross-session-delivery">
3258 Message too large for cross-session delivery
3259</h3>
3260
3261[Кросс-сеансовое сообщение](/docs/ru/cross-session-messaging) Claude другому вашему сеансу на этой машине было слишком длинным для отправки. Claude Code отказал в нём, и получающий сеанс ничего не получил. Отказ появляется в результате инструмента отправляющего сеанса, а не как баннер в вашем терминале. Он называет оба размера и как сделать сообщение подходящим:
3262
3263```text wrap theme={null}
3264Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.
3265```
3266
3267Повторная отправка того же текста терпит неудачу таким же образом.
3268
3269**Что делать:**
3270
3271* Попросите Claude резюмировать сообщение или поместить объёмное содержимое в файл и отправить путь файла
3272* Попросите Claude разделить содержимое на несколько более коротких сообщений
3273
3274До версии 2.1.235 Claude Code сообщал об увеличенном сообщении как отправленном. Получающий сеанс отбросил его непрочитанным.
3275
3276<h3 id="too-many-messages-to-this-session-just-now">
3277 Too many messages to this session just now
3278</h3>
3279
3280Claude отправил быстрый всплеск [кросс-сеансовых сообщений](/docs/ru/cross-session-messaging) одному из ваших сеансов на этой машине, и всплеск достиг того, что этот сеанс принимает. Claude Code отказал в следующей отправке, и получающий сеанс ничего не получил от неё. Отказ появляется в результате инструмента отправляющего сеанса, а не как баннер в вашем терминале:
3281
3282```text wrap theme={null}
3283Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.
3284```
3285
3286**Что делать:**
3287
3288* Обычно ничего: Claude объединяет оставшееся содержимое в одно сообщение или ждёт перед отправкой большего
3289* Если вы сами вызвали всплеск, попросите Claude объединить то, что осталось, в одно сообщение
3290
3291До версии 2.1.236 Claude Code сообщал об этих отправках как отправленных. Получающий сеанс отбросил их непрочитанными.
3292
3293<h3 id="refusing-to-send-a-cross-session-message">
3294 Refusing to send a cross-session message
3295</h3>
3296
3297Перед тем как Claude Code напишет [кросс-сеансовое сообщение](/docs/ru/cross-session-messaging) другому вашему сеансу на этой машине, он проверяет, что сокет входящих сообщений целевого сеанса является конечной точкой, на которую было адресовано сообщение. Когда проверка не удаётся, Claude Code отказывает в отправке в отправляющем сеансе, и целевой сеанс ничего не получает. Для сообщения, которое отправляет Claude, отказ появляется в результате инструмента отправляющего сеанса:
3298
3299```text theme={null}
3300Failed to send to api-worker: Refusing to send: reply target is a symlink
3301```
3302
3303Текст после `Refusing to send:` называет проверку, которая не удалась:
3304
3305* `reply target is a symlink`: символическая ссылка находится на пути сокета целевого сеанса. Claude Code не доставляет через неё, потому что ссылка там может перенаправить сообщение на конечную точку, которую целевой сеанс не создавал.
3306* `cannot vet reply target`: Claude Code не смог проверить целевой путь вообще, например потому что чтение не удалось с ошибкой разрешения.
3307* `connected endpoint is not the expected process`: процесс, держащий сокет, не является сеансом, на который было адресовано сообщение, поэтому адрес устарел или другой процесс заменил сокет.
3308* `connected endpoint identity could not be read`: Claude Code подключился, но не смог прочитать, какой процесс держит другой конец, поэтому он не смог подтвердить цель. Это может быть временным.
3309* `connected endpoint is not owned by this user`: процесс, держащий сокет, работает под другой учётной записью пользователя, поэтому это не один из ваших сеансов.
3310* `connected endpoint owner could not be read`: Claude Code подключился, но не смог прочитать, какая учётная запись пользователя владеет другим концом, поэтому он не смог подтвердить, что конечная точка ваша.
3311* `connected endpoint is a different process with the expected pid`: ID процесса соответствует тому, на который было адресовано сообщение, но Claude Code не смог подтвердить, что это тот же процесс. Обычно этот сеанс вышел и операционная система переиспользовала его ID процесса, поэтому адрес устарел.
3312
3313**Что делать:**
3314
3315* Обычно ничего: проверки предотвращают достижение сообщением конечной точки, отличной от сеанса, на который оно было адресовано, и ничего не было отправлено
3316* Попросите Claude снова перечислить ваши сеансы и повторно отправить; отказ, вызванный устаревшим адресом, разрешается после того как Claude отправляет текущему
3317* Если `reply target is a symlink` повторяется для одного сеанса, проверьте, что создало ссылку на пути сокета этого сеанса, показанном в его `/status` под `Peer address`
3318* Для `connected endpoint identity could not be read`, повторно отправьте; условие может быть временным
3319* Если `connected endpoint is not owned by this user` появляется на общей машине, сеанс по этому адресу работает под учётной записью другого пользователя, поэтому Claude не может отправить ему сообщение из вашей
3320
3321До версии 2.1.248 Claude Code не проверял владельца конечной точки или время запуска процесса, поэтому отказы, которые называют эти проверки, не появляются в более ранних версиях.
3322
3323<h3 id="refusing-after-a-symlink-changed">
3324 Refusing to read, write, or search a path
3325</h3>
3326
3327Claude Code проверяет [правила разрешений](/docs/ru/permissions#read-and-edit) пути файла, затем подтверждает это разрешение снова, когда инструмент открывает файл или начинает поиск. Когда он не может подтвердить, что путь по-прежнему ведёт к месту, которое проверка одобрила, Claude Code отказывает в операции вместо того, чтобы следовать ей. Отказ появляется в результате инструмента:
3328
3329```text theme={null}
3330Refusing to read /path/to/file: its symlink resolution changed after permission was checked. If a link in the working directory is being rewritten concurrently, stop that and retry.
3331```
3332
3333Текст после пути называет причину:
3334
3335* `its symlink resolution changed after permission was checked`: символическая ссылка вдоль пути или в корне поиска Grep или Glob была заменена между проверкой разрешения и операцией
3336* `its parent-directory symlink resolution changed after permission was checked`: каталог, через который проходит путь записи, больше не разрешается в одобренное место
3337* `it is a symbolic link. Write to the link's target path instead`: символическая ссылка находится в одобренном месте записи
3338* `a path one of its Read deny rules is written through changed while the search was being prepared. Retry.`: правило отказа `Read` для поиска называет путь, который проходит через символическую ссылку, и эта ссылка изменилась, пока Claude Code готовил поиск
3339* `it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.`: корень поиска существует, но не смог быть открыт; код в скобках — это ошибка операционной системы
3340* `its permission check expired before it ran (too many concurrent file operations). Retry.`: Claude Code вытеснил запись одобрения при множественных одновременных операциях с файлами перед использованием инструментом; повторная попытка выполняет свежую проверку разрешения
3341* `ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration`: Claude Code не смог разрешить двоичный файл `rg` в абсолютный путь, поэтому он отказывает в поисках вне рабочего каталога, а не выполняет один, который ваши правила отказа не охватывают
3342
3343**Что делать:**
3344
3345* Обычно ничего: отказ достигает Claude как результат инструмента, и отказанная операция не выполняется
3346* Если отказ символической ссылки повторяется на одном пути, найдите, что продолжает переписывать ссылку там, например инструмент сборки или наблюдатель файлов, или попросите Claude использовать разрешённый путь файла вместо связанного
3347* Если этот отказ появляется для каждого файла, пока Claude Code работает на Windows внутри AppContainer или песочницы с ограниченным токеном, обновитесь до версии 2.1.265 или позже
3348* Для отказа ripgrep установите ripgrep с помощью вашего менеджера пакетов, чтобы `rg` разрешался в абсолютный путь на `PATH`, или сохраняйте поиски под рабочим каталогом
3349
3350До версии 2.1.251 Claude Code повторно проверял разрешение пути только для записей файлов, поэтому ссылка, заменённая после проверки разрешения, могла перенаправить чтение или поиск в другое место без сообщения. Из этих отказов только отказ записи родительского каталога появляется в более ранних версиях.
3351
3352<h3 id="task-output-swap-refused">
3353 Task output swap refused
3354</h3>
3355
3356Claude Code сохраняет вывод каждой команды Bash в файл в своём временном каталоге. Каждый раз, когда он открывает один из этих файлов, он проверяет, что путь по-прежнему ведёт к файлу, который он создал, без символической ссылки, дополнительной жёсткой ссылки или перемещённого каталога, перенаправляющего его. Это сообщение означает, что проверка не удалась, поэтому Claude Code отказал в операции, а не писал или читал вывод через этот путь. Сообщение появляется в результате инструмента Bash:
3357
3358```text wrap theme={null}
3359task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.
3360```
3361
3362Текст в скобках называет проверку, которая не удалась. Причины, такие как `output symlink was re-pointed`, `output file identity changed` и `not a regular file`, все сообщают об одном и том же условии: что-то на пути вывода или вдоль него больше не является файлом, который создал Claude Code. Только некоторые причины несут предложение `To recover:`.
3363
3364Если проверка не удаётся, пока команда всё ещё выполняется, Claude Code останавливает команду, и её результат сообщает:
3365
3366```text theme={null}
3367Command killed: its output file was replaced or could no longer be verified
3368```
3369
3370**Что делать:**
3371
3372* Обновитесь до версии 2.1.260 или позже. Более ранние версии иногда показывали это сообщение, когда ссылка или перемещённый каталог не были присутствуют
3373* Перезагрузите Claude Code с [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars), установленным в свежий каталог
3374* Или проверьте каталог вашего проекта в временном каталоге Claude Code, `/private/tmp/claude-501/-Users-you-my-project` в примере сообщения. Если этот путь является символической ссылкой или каталогом, который не должен быть там, удалите саму ссылку или каталог, а не цель ссылки, и перезагрузитесь
3375* Если отказ повторяется, процесс заменяет, связывает или удаляет записи в временном каталоге Claude Code, пока сеанс работает. Установите [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог, который ничто другое не управляет, и перезагрузитесь
3376
3377<h3 id="the-source-file-is-not-valid-utf-8-text">
3378 The source file is not valid UTF-8 text
3379</h3>
3380
3381Claude попытался опубликовать [артефакт](/docs/ru/artifacts) из файла, чьи байты не декодируются как текст, или чей текст уже содержит символ замены `U+FFFD`, поэтому Claude Code отказал в публикации перед загрузкой чего-либо. Сообщение появляется в результате инструмента Artifact и называет первую позицию для исправления:
3382
3383```text wrap theme={null}
3384file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.
3385
3386file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.
3387```
3388
3389Claude Code декодирует файл как UTF-8 или как UTF-16, когда он начинается с метки порядка байтов UTF-16 с прямым порядком байтов. Когда такой файл UTF-16 не декодируется, первое сообщение называет `UTF-16` и по-прежнему говорит вам переписать файл как UTF-8. Когда после названной позиции следуют дополнительные позиции, сообщение добавляет счётчик, такой как `(+2 more)`, после позиции.
3390
3391**Что делать:**
3392
3393* Обычно ничего: Claude переписывает файл и публикует снова
3394* Если файл — это тот, который вы написали или экспортировали, сохраните его снова как UTF-8 и замените каждый `U+FFFD` на символ, который более ранний редактор, вставка или преобразование потеряло
3395* Чтобы показать намеренный `U+FFFD` на странице, напишите его как `�` в HTML вместо буквального символа
3396
3397До версии 2.1.267 Claude Code загружал такой файл без проверки, и сервер отказывал в публикации вместо этого.
3398
3399<h2 id="background-session-errors">
3400 Ошибки фоновых сеансов
3401</h2>
3402
3403[Фоновые сеансы](/docs/ru/agent-view) работают без собственного интерактивного терминала, поэтому команды, которым он требуется, ведут себя там иначе. Эти сообщения появляются в стенограмме фонового сеанса, в терминале, подключённом к нему, в сеансе или оболочке, из которой вы его запустили, или, для [записей worktree-guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) ниже, в любом сеансе, изолированном в worktree, или в работающем изолированном подагенте worktree; где сообщение относится к одной поверхности, его запись это указывает.
3404
3405<h3 id="commands-refused-in-a-background-session">
3406 Команды, отклонённые в фоновом сеансе
3407</h3>
3408
3409Команды, которые открывают интерактивный диалог, не могут это делать, пока к фоновому сеансу не подключён терминал. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP отвечают сообщением, и сеанс появляется под **Needs input** в [представлении агента](/docs/ru/agent-view), чтобы вы могли его найти, подключиться и запустить команду снова. Пока терминал подключён, эти команды работают нормально.
3410
3411До версии 2.1.216 сеанс не появлялся под **Needs input** после одного из этих отказов. В версиях 2.1.213–2.1.215 команды всё ещё работали, пока был подключён терминал, и сообщение об отказе говорило вам подключиться и запустить команду снова. С версии 2.1.208 по 2.1.212 Claude Code отклонял их даже при подключённом терминале с сообщением вроде `Can't open MCP settings in a background session`; на этих версиях запустите команду из обычного сеанса `claude` вместо этого или обновитесь. До версии 2.1.208 они открывали свой диалог внутри фонового сеанса. Только в версии 2.1.208 Claude Code также отклонял средство выбора `/model` в фоновом сеансе, и `/upgrade` выводил URL обновления вместо открытия браузера.
3412
3413Формулировка называет команду. Список параметров `/mcp` сообщает:
3414
3415```text theme={null}
3416Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.
3417```
3418
3419**Что делать:**
3420
3421* Подключитесь к сеансу из представления агента, где он указан под **Needs input**, и запустите команду снова
3422* Или используйте форму, которую называет сообщение, например `/mcp reconnect <server>`, `/mcp enable` или `/mcp disable`, которые работают без подключения
3423
3424<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">
3425 Запись или команда заблокирована, потому что путь не может быть безопасно разрешён
3426</h3>
3427
3428Claude обратился к файлу или рабочему каталогу через написание, которое [защита изоляции worktree](/docs/ru/agent-view#how-file-edits-are-isolated) не может разрешить в одно проверяемое место. Защита проверяет записи и рабочие каталоги команд в [любом сеансе, изолированном в worktree](/docs/ru/worktrees#how-claude-code-enforces-isolation), интерактивном или фоновом, и в [изолированных подагентах worktree](/docs/ru/worktrees#isolate-subagents-with-worktrees). Она разрешает символические ссылки перед проверкой того, что операция не достигает общей проверки, и когда разрешение не удаётся, она блокирует операцию вместо того, чтобы позволить ей туда попасть. Сообщение называет формы пути, которые она отклоняет, и как повторить попытку:
3429
3430```text theme={null}
3431This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.
3432```
3433
3434Заблокированная команда сообщает ту же причину для своего рабочего каталога и заканчивается `re-run the command from its direct symlink-free path`. До версии 2.1.217 защита сравнивала написания пути без разрешения символических ссылок, поэтому эти написания не блокировались и запись, маршрутизированная через символическую ссылку, могла попасть в общую проверку.
3435
3436**Что делать:**
3437
3438* Обычно ничего: полное сообщение идёт к Claude как ошибка инструмента, и Claude повторяет попытку с прямым путём, который он называет. Для заблокированного редактирования файла представление разговора показывает только короткую строку `Error editing file`; полное сообщение появляется в представлении стенограммы, которое вы открываете с помощью `Ctrl+O`. Заблокированная команда выводит его в выходные данные команды.
3439* Если блокировка повторяется на том же файле, путь, вероятно, проходит через зафиксированную символическую ссылку, цель которой содержит `..`, например `docs/current -> ../README.md`; попросите Claude отредактировать целевой файл по его реальному пути вместо ссылки
3440
3441<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
3442 Запись или команда заблокирована, потому что путь называет сетевое расположение
3443</h3>
3444
3445Claude обратился к файлу или рабочему каталогу через путь, который называет диск, которого нет на вашей машине, общую папку UNC, например `\\server\share\file`, или путь автомонтирования `/net`, в то время как проверка сеанса находится на локальном диске. Та же [защита изоляции worktree](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) не может проверить, что такой путь остаётся вне общей проверки, поэтому она блокирует операцию. Изоляция сеанса в worktree не снимает блокировку. Сообщение называет форму пути для использования вместо этого:
3446
3447```text theme={null}
3448This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.
3449```
3450
3451Заблокированная команда сообщает ту же причину для своего рабочего каталога и заканчивается `re-run the command from its local, plainly-spelled path`. До версии 2.1.217 защита сравнивала только текст пути, поэтому обращение к файлу внутри проверки через путь UNC или `/net` не блокировалось.
3452
3453**Что делать:**
3454
3455* Обычно ничего: Claude повторяет попытку с локальным написанием, которое просит сообщение
3456* Если файл находится на сетевом ресурсе, а не на локальном файле, написанном с сетевым путём, он находится вне локального рабочего пространства сеанса; отредактируйте его из обычного интерактивного сеанса вместо этого
3457
3458<h3 id="this-session-has-no-saved-transcript">
3459 Этот сеанс не имеет сохранённой стенограммы
3460</h3>
3461
3462Вы подключились к остановленному [фоновому сеансу](/docs/ru/agent-view), который был отправлен в фон из другого разговора с `←` или `/background` и остановлен до завершения его первого ответа. До завершения этого первого ответа разговор всё ещё существует только в сеансе, из которого он был отправлен в фон, поэтому `claude attach` отказывает в запуске остановленного сеанса вместо того, чтобы начать пустой разговор с тем же ID сеанса. Сообщение заканчивается командой `claude respawn` для этого сеанса:
3463
3464```text theme={null}
3465This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.
3466```
3467
3468Открытие той же строки сеанса в [представлении агента](/docs/ru/agent-view) показывает `Press enter again to restart this session fresh` ниже списка, и второе нажатие `Enter` на строке перезапускает сеанс с пустым разговором. До версии 2.1.212 открытие строки показывало сообщение об отказе без способа перезапуска из представления агента. До версии 2.1.211 открытие остановленного сеанса молча запускало этот пустой разговор и могло повторно запустить исходный запрос сеанса.
3469
3470**Что делать:**
3471
3472* Разговор, который вы отправили в фон, остаётся нетронутым: возобновите его с помощью [`claude --resume`](/docs/ru/sessions) или продолжайте работать в нём
3473* Чтобы запустить остановленный сеанс заново, запустите `claude respawn <id>` с ID из сообщения или нажмите `Enter` дважды на его строке в представлении агента
3474* Если сеанс завершил ответ и вы всё ещё видите этот отказ в версии до 2.1.214, нечитаемая папка в `~/.claude/projects` могла заставить сканирование стенограммы пропустить сохранённый разговор; обновитесь до версии 2.1.214 или позже, которая допускает нечитаемые папки во время сканирования
3475
3476<h3 id="this-session-is-running-in-another-terminal">
3477 Этот сеанс работает в другом терминале
3478</h3>
3479
3480Вы открыли строку остановленного сеанса в [представлении агента](/docs/ru/agent-view), и его сохранённый разговор уже открыт в другом живом процессе Claude Code на этой машине, поэтому Claude Code отказывает в запуске второго процесса, который писал бы в ту же стенограмму. Какое сообщение вы видите, зависит от [того, что держит разговор](/docs/ru/agent-view#opening-a-session-says-the-conversation-is-already-open):
3481
3482```text theme={null}
3483Can't open — this session is running in another terminal
3484This conversation is already open in another running Claude session — use that one, or close it and try again
3485```
3486
3487* **`running in another terminal`**: терминал держит разговор, например тот, где вы возобновили его с помощью `claude --resume` или `/resume`. Строка также показывает `Open in a terminal`.
3488* **`already open in another running Claude session`**: другой неинтерактивный процесс Claude Code держит его, например процесс [фонового сеанса](/docs/ru/agent-view#the-supervisor-process) для того же разговора, который ещё не вышел.
3489
3490Claude Code сохраняет ответ, который вы напечатали при открытии строки, и отправляет его как следующий запрос сеанса, когда сеанс в следующий раз запустится.
3491
3492**Что делать:**
3493
3494* Продолжите разговор в процессе, который его имеет, или выйдите из этого процесса и откройте строку снова
3495
3496До версии 2.1.248 существовал только отказ `already open in another running Claude session`: разговор, возобновленный в терминале, не считался открытым, и открытие строки запускало второй процесс Claude Code, пишущий в тот же разговор.
3497
3498<h3 id="this-sessions-saved-conversation-is-no-longer-on-disk">
3499 Сохранённый разговор этого сеанса больше не находится на диске
3500</h3>
3501
3502Вы открыли [фоновый сеанс](/docs/ru/agent-view), который завершился, пока фоновая служба была отключена, и [очистка стенограммы](/docs/ru/settings-reference#cleanupperioddays) с тех пор удалила его сохранённый разговор, например после того, как машина была отключена в течение недель. Открытие такой строки обычно [возобновляет её сохранённый разговор](/docs/ru/agent-view#sessions-show-as-failed-after-shutdown). Когда нечего возобновлять, Claude Code отказывает вместо того, чтобы повторно запустить исходный запрос сеанса без вопроса:
3503
3504```text theme={null}
3505This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
3506```
3507
3508`claude attach <id>` выводит этот текст. В представлении агента нижний колонтитул короче и заканчивается `ctrl+x deletes the row`.
3509
3510**Что делать:**
3511
3512* Запустите `claude rm <id>` для удаления строки. Когда применяется один из [сохраняемых случаев](/docs/ru/agent-view#what-deleting-a-session-removes), `claude rm` сохраняет строку и worktree вместо этого и называет причину
3513* Чтобы запустить исходный запрос сеанса снова как новый разговор, запустите `claude respawn <id>`
3514
3515До версии 2.1.248 открытие такой строки повторно запускало исходный запрос сеанса вместо отказа, вытягивая задачу, которая была неделю назад, на передний план.
3516
3517<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">
3518 Worktree имеет коммиты, которые не отправлены никуда
3519</h3>
3520
3521Вы попытались удалить [фоновый сеанс](/docs/ru/agent-view#what-deleting-a-session-removes), чей worktree содержит коммиты, которые Claude Code не может подтвердить, что они сохранены где-то ещё. Claude Code сохраняет worktree и строку сеанса вместо того, чтобы уничтожить коммиты без присмотра. `claude rm` называет ветвь и неотправленные коммиты и говорит, как действовать:
3522
3523```text theme={null}
3524kept 7c5dcf5d — 2 unpushed commits on claude/fix-login (a1b2c3d Fix login flow, … and 1 more)
3525 worktree: /home/you/project/.claude/worktrees/fix-login
3526 push them, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
3527```
3528
3529Когда Claude Code не может суммировать коммиты, сообщение читается `worktree has commits that are not pushed anywhere` вместо этого. В [представлении агента](/docs/ru/agent-view) строка сеанса показывает `not deleted` с той же причиной.
3530
3531Коммиты на удалённом хранилище не блокируют удаление. Также не блокируют коммиты на локальной копии ветви по умолчанию вашего удалённого хранилища `origin`, пока эта ветвь проверена в вашей основной проверке, в самом каталоге репозитория, а не в worktree.
3532
3533**Что делать:**
3534
3535* Чтобы сохранить коммиты, отправьте ветвь worktree или объедините её в ветвь по умолчанию, проверенную в вашей основной проверке, затем удалите сеанс снова
3536* Чтобы отклонить коммиты, запустите команду `claude rm <id> --discard-unpushed`, которую выводит сообщение, или нажмите `Ctrl+X` дважды на строке сеанса в представлении агента снова. Это удаляет сеанс и worktree вместе с его ветвью, неотправленными коммитами и любыми незафиксированными изменениями. Если worktree получил коммит с момента отказа, Claude Code сохраняет его снова и показывает обновленное состояние
3537* Когда сообщение говорит, что worktree также записан другим завершённым сеансом, удаление снова не отклоняет его: отправьте коммиты, затем удалите сеанс снова
3538
3539До версии 2.1.260 сообщение не называло ветвь или коммиты, и удаление снова отклонялось так же: удаление сеанса без отправки означало удаление worktree самостоятельно с помощью `git worktree remove --force <path>`, затем запуск `claude rm <id>` снова.
3540
3541До версии 2.1.248 ветвь по умолчанию, проверенная в вашей основной проверке, не считалась: ветвь, которую вы уже объединили там, всё ещё вызывала этот отказ, пока её коммиты не достигали удалённого хранилища.
3542
3543<h3 id="terminal-host-process-died">
3544 Процесс хоста терминала умер
3545</h3>
3546
3547Каждый терминал [фонового сеанса](/docs/ru/agent-view) работает в процессе хоста под фоновой службой, и этот процесс умер, пока служба всё ещё держала его соединение, поэтому сеанс не мог быть достигнут.
3548
3549На Linux и WSL фоновая служба проверяет каждый процесс хоста каждые несколько секунд, отмечает сеанс как неудачный, когда процесс вышел, но его соединение со службой никогда не закрывалось, и показывает причину на его строке в [представлении агента](/docs/ru/agent-view#read-session-state):
3550
3551```text theme={null}
3552terminal host process died — press Enter to restart
3553```
3554
3555Если вы откроете строку до запуска проверки, нижний колонтитул показывает `This session's terminal host process died (the conversation is saved) — press Enter to restart it` и строка становится неудачной.
3556
3557Из оболочки `claude attach <id>` перезапускает сеанс, уже отмеченный как неудачный для мёртвого хоста, и в противном случае выводит причину и выходит:
894 3558
895```text theme={null}3559```text theme={null}
896Unable 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.3560Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.
897Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
898Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
899Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
900```3561```
901 3562
902Claude Code обычно автоматически изменяет размер больших изображений. Эти ошибки означают, что встроенный обработчик изображений не смог загрузиться или вернул ошибку, поэтому изображение не удалось изменить в размер, чтобы соответствовать лимитам API.3563Разговор сохраняется в любом случае.
3564
3565Строка, работающая с [командой оболочки](/docs/ru/agent-view#run-a-shell-command) вместо этого, показывает `terminal host process died — its output is gone; the command was not run again`, и `claude attach` выводит `This command's terminal host process died — its output is gone and the command was not run again`. Claude Code никогда не повторно запускает команду для вас.
903 3566
904**Что делать:**3567**Что делать:**
905 3568
906* Если сообщение просит вас преобразовать изображение, преобразуйте его в PNG, JPEG, GIF или WebP и прикрепите снова. Claude Code может проверить размеры для этих форматов без обработчика изображений.3569* В представлении агента нажмите `Enter` на неудачной строке; сеанс перезапускается на свежем процессе хоста и разговор возобновляется
907* Если сообщение сообщает об ограничении размера или размеров, измените размер или перекомпрессируйте изображение ниже этого лимита перед прикреплением.3570* Из оболочки запустите `claude attach <id>` снова. Claude Code выводит `Session <id>'s terminal host died — restarting it on a fresh one…` и повторно открывает сеанс
3571* Вы не можете перезапустить строку shell-command таким образом; отправьте команду снова для её повторного запуска
908 3572
909<h3 id="pdf-errors">3573До версии 2.1.247 мёртвый процесс хоста мог пройти каждую проверку живучести, которую запускала фоновая служба, поэтому открытие сеанса показывало `opening… · esc to cancel` бесконечно и `claude attach <id>` ждал без сообщения об ошибке.
910 PDF errors3574
3575<h3 id="session-isnt-responding">
3576 Сеанс не отвечает
911</h3>3577</h3>
912 3578
913Прикреплённый PDF не удалось обработать.3579Вы открыли [фоновый сеанс](/docs/ru/agent-view) и фоновая служба приняла открытие, но никакой выход не прибыл примерно за десять секунд, поэтому Claude Code заключает, что процесс, передающий терминал сеанса, не может доставить выход, и заканчивает попытку вместо ожидания.
3580
3581В представлении агента Claude Code предлагает перезапуск в нижнем колонтитуле:
3582
3583```text theme={null}
3584Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
3585```
3586
3587Из оболочки `claude attach <id>` выводит причину и выходит:
914 3588
915```text theme={null}3589```text theme={null}
916PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.3590Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).
917PDF is password protected. Try removing protection or extracting text first.
918The PDF file was not valid. Try converting to a different format first.
919```3591```
920 3592
3593Claude Code никогда не перезапускает строку, работающую с [командой оболочки](/docs/ru/agent-view#run-a-shell-command) для вас, потому что перезапуск запустил бы команду снова.
3594
921**Что делать:**3595**Что делать:**
922 3596
923* Для больших PDF попросите Claude прочитать диапазон страниц с помощью инструмента Read вместо прикрепления всего файла, или извлеките текст с помощью инструмента, такого как `pdftotext`, и ссылайтесь на выходной файл по пути3597* В представлении агента нажмите `Enter` на той же строке снова. Claude Code останавливает неответивший процесс и перезапускает сеанс, и разговор возобновляется. Ничего не останавливается без этого второго нажатия
924* Для защищённых или недействительных PDF удалите пароль или переэкспортируйте файл из исходного приложения, затем попробуйте снова3598* Из оболочки запустите `claude stop <id>`, затем `claude attach <id>`
3599* Для строки shell-command нажмите `Ctrl+X` в представлении агента или запустите `claude stop <id>` для её остановки; отправьте команду снова для её повторного запуска
925 3600
926<h3 id="extra-inputs-are-not-permitted">3601<h3 id="session-was-stopped-while-the-respawn-was-in-flight">
927 Extra inputs are not permitted3602 Сеанс был остановлен, пока перезапуск был в полёте
928</h3>3603</h3>
929 3604
930Прокси или LLM шлюз между Claude Code и API удалил заголовок запроса `anthropic-beta`, поэтому API отклонил поля, которые от него зависят.3605Вы открыли [фоновый сеанс](/docs/ru/agent-view), чей процесс не работал, и пока Claude Code его перезапускал, другой процесс Claude Code остановил его, например `claude stop` в другом терминале. Claude Code держит сеанс остановленным:
931 3606
932```text theme={null}3607```text theme={null}
933API Error: 400 ... Extra inputs are not permitted ... context_management3608Session <id> was stopped while the respawn was in flight
934API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
935API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
936```3609```
937 3610
938Claude Code отправляет поля только для бета-версии, такие как `context_management`, `effort` и примеры инструментов `input_examples`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но удаляет заголовок, API видит поля, которые он не распознаёт.3611Открытие сеанса, который вы только что отправили, пока его процесс всё ещё запускается, ждёт процесса вместо этого. До версии 2.1.246 открытие его в этот момент могло остановить его и показать это сообщение.
939 3612
940**Что делать:**3613**Что делать:**
941 3614
942* Настройте ваш шлюз для пересылки заголовка `anthropic-beta`. Смотрите [feature pass-through](/docs/ru/llm-gateway-protocol#feature-pass-through) для того, что шлюзы должны пересылать.3615* Если вы не остановили сеанс, откройте его строку снова в представлении агента или запустите `claude respawn <id>` для его перезапуска
943* В качестве резервного варианта установите [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) перед запуском. Это отключает функции, которые требуют заголовка бета-версии, чтобы запросы успешно проходили через шлюз, который не может его пересылать.3616* Если вы остановили его сами, ничего не остаётся делать: сеанс остаётся остановленным
944 3617
945<h3 id="theres-an-issue-with-the-selected-model">3618<h3 id="session-agent-no-longer-available">
946 There's an issue with the selected model3619 Агент сеанса больше не доступен
947</h3>3620</h3>
948 3621
949Имя настроенной модели не было распознано, или ваша учётная запись не имеет доступа к ней. Начиная с v2.1.160 конечная подсказка, показанная здесь в её интерактивной форме, варьируется в зависимости от поверхности.3622Вы возобновили сеанс, который работал [пользовательским агентом](/docs/ru/sub-agents#invoke-subagents-explicitly), запущенным с `--agent` или параметром `agent`, и Claude Code не нашёл агента с таким именем. Он сначала ищет в исходном каталоге сеанса, когда вы [доверили это рабочее пространство](/docs/ru/permissions#project-allow-rules-and-workspace-trust), затем в каталоге, из которого вы возобновляете. Сеанс всё ещё возобновляется, но с инструментами по умолчанию, поэтому ограничения инструментов агента больше не применяются:
950 3623
951```text theme={null}3624```text theme={null}
952There'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.3625This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
953```3626```
954 3627
3628Предупреждение называет только каталоги, которые Claude Code искал, и оно появляется в возобновленном разговоре, пробудите ли вы [фоновый сеанс](/docs/ru/agent-view), запустите `/resume` или `claude --resume`, или возобновите в [неинтерактивном режиме](/docs/ru/headless), где оно также идёт в stderr. Сеансы, использующие `--input-format stream-json`, не показывают его, потому что Agent SDK поставляет агентов после запуска.
3629
3630Claude Code не сохраняет откат в сеанс, поэтому предупреждение повторяется при каждом возобновлении, пока вы не действуете. Встроенный агент `claude` не вызывает предупреждение, так как откат к инструментам по умолчанию ничего не меняет для него. До версии 2.1.216 Claude Code молча продолжал как агент по умолчанию, и поиск охватывал только каталог, из которого вы возобновляли, поэтому агент, ограниченный проектом, был потерян при любом возобновлении из другого каталога.
3631
955**Что делать:**3632**Что делать:**
956 3633
957* **Interactive CLI**: запустите `/model` для выбора из моделей, доступных вашей учётной записи.3634* Пересоздайте файл агента в `.claude/agents/<name>.md` в проекте сеанса или в `~/.claude/agents/<name>.md` для личного агента, затем возобновите снова
958* **Non-interactive mode (`-p`)**: передайте `--model` с действительным псевдонимом или ID, или установите [`ANTHROPIC_MODEL`](/docs/ru/env-vars). Текст ошибки показывает `Run --model` на этой поверхности.3635* Или возобновите с `--agent <name>`, называя агента, который действительно существует, для запуска сеанса как этого агента вместо этого
959* **Agent SDK**: текст ошибки опускает подсказку, потому что модель установлена программно. Установите [`model` на `Options`](/docs/ru/agent-sdk/typescript#options) в TypeScript или [`ClaudeAgentOptions(model=...)`](/docs/ru/agent-sdk/python#claudeagentoptions) в Python, и обработайте структурированную ошибку `model_not_found` для отображения вашего собственного повтора или средства выбора модели.3636* Если агент ограничен проектом и вы не доверили исходному каталогу сеанса, запустите Claude Code там один раз, примите диалог доверия, затем возобновите снова
960* Используйте псевдоним, такой как `sonnet` или `opus`, вместо полного версионного ID. Псевдонимы разрешаются в поддерживаемое значение по умолчанию, поэтому они не устаревают. Смотрите [Model configuration](/docs/ru/model-config).
961* Если неправильная модель продолжает возвращаться в CLI, где-то установлен устаревший ID. Проверьте в [порядке приоритета](/docs/ru/model-config#setting-your-model): флаг `--model`, переменная окружения `ANTHROPIC_MODEL`, затем поле `model` в `.claude/settings.local.json`, файл вашего проекта `.claude/settings.json` и `~/.claude/settings.json`. Удалите устаревшее значение, и Claude Code вернётся к умолчанию вашей учётной записи.
962* Claude Code сообщает об истёкшем входе claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До v2.1.206 истёкший вход, который больше не удалось обновить, не удавался для каждой модели с этой ошибкой; запустите `/login`, если вы видите это в более старой версии.
963* Для развёртываний Google Cloud's Agent Platform смотрите [Google Cloud's Agent Platform troubleshooting](/docs/ru/google-vertex-ai#troubleshooting).
964 3637
965<h3 id="model-is-not-a-recognized-model-id">3638<h3 id="claude_code_process_wrapper-launcher-errors">
966 Model is not a recognized model id3639 Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER
967</h3>3640</h3>
968 3641
969Строка модели, которую вы передали переключателю модели, не является псевдонимом модели, ID модели, который знает эта версия Claude Code, или ID, который начинается с `claude-`. Обычные причины — опечатка в ID, отображаемое имя, такое как `Sonnet 5`, где ожидается ID `claude-sonnet-5`, или псевдоним, который распознают только более новые версии Claude Code. Claude Code немедленно отклоняет переключение. До v2.1.200 Claude Code сохранял строку и не удавался при следующем запросе с [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).3642[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ru/corporate-launcher) установлен, и его значение не может быть использовано, поэтому Claude Code отказывает в запуске затронутого процесса вместо того, чтобы запустить его без средства запуска. Проблемы конфигурации сообщаются сообщением, которое начинается с имени переменной и указывает причину, например:
970 3643
971```text theme={null}3644```text theme={null}
972Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?3645CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
973```3646```
974 3647
975Конечная подсказка называет ближайший совпадающий псевдоним или ID модели. Когда ничего не совпадает достаточно близко, она читает `Run /model to see available models.` вместо этого.3648Средство запуска, которое запускается, но выходит без замены себя на Claude Code, не удаётся сеансу, который оно запускало, и строка сеанса в представлении агента сообщает, что средство запуска `must exec, not daemonize`, за которым следует всё, что выводило средство запуска. Сеанс, который не может запуститься или достичь фоновую службу из-за средства запуска, сообщает проблему средства запуска как причину внутри `Couldn't reach the background service (...)`.
976
977Claude Code производит эту ошибку локально в момент запроса переключения, перед любым запросом API. Она применяется, когда модель установлена через метод [Agent SDK](/docs/ru/agent-sdk/typescript) `setModel()` или приложением, таким как [Desktop app](/docs/ru/desktop), которое запускает Claude Code CLI для вас.
978 3649
979**Что делать:**3650**Что делать:**
980 3651
981* Запустите `/model` без аргумента, чтобы открыть средство выбора и выбрать из моделей, доступных вашей учётной записи, затем передайте показанный там псевдоним или ID3652* Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом `exec "$@"`. Смотрите [контракт средства запуска](/docs/ru/corporate-launcher#the-launcher-contract) для полного контракта
982* Если вы использовали псевдоним, который поддерживает более новая версия Claude Code, запустите `claude update`. Полный ID, который начинается с `claude-`, проходит эту проверку даже когда модель новее вашей версии Claude Code, поэтому обновление не требуется для них.3653* Проверьте `/status`, который показывает разрешённую команду запуска в его записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите `claude daemon status` из оболочки
983* Модель, сохранённая до v2.1.200, не восстанавливается этой проверкой. Если устаревшее значение продолжает возвращаться, удалите его из мест, перечисленных в [There's an issue with the selected model](#theres-an-issue-with-the-selected-model).3654* После исправления значения в блоке `env` [параметров](/docs/ru/corporate-launcher#set-up-the-launcher), перезапустите фоновую службу с помощью `claude daemon stop --any`, чтобы следующая отправка запустила завёрнутую
984* Проверка выполняется только на Anthropic API. На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) и за [LLM gateway](/docs/ru/llm-gateway) или пользовательским `ANTHROPIC_BASE_URL`, ваш поставщик или шлюз определяет имена моделей, поэтому Claude Code принимает любую строку и пропускает её.
985 3655
986<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">3656<h3 id="eunknown-when-starting-a-background-session">
987 Claude Opus is not available with the Claude Pro plan3657 EUNKNOWN при запуске фонового сеанса
988</h3>3658</h3>
989 3659
990Ваш активный план подписки не включает выбранную модель.3660Windows отказала в запуске программы с кодом ошибки, который не имеет стандартного имени, поэтому сбой появляется как `EUNKNOWN`. Обычный триггер — это политика ограничения программного обеспечения, такая как Group Policy или AppLocker, блокирующая запускаемую программу. Ошибка появляется, когда вы запускаете [фоновый сеанс](/docs/ru/agent-view) с `/background` или `claude --bg`:
991 3661
992```text theme={null}3662```text theme={null}
993Claude Opus is not available with the Claude Pro plan · Select a different model in /model3663Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'
994```3664```
995 3665
3666На некоторых учётных записях сообщение говорит `daemon` вместо `background service`.
3667
3668При установке npm ошибка `EUNKNOWN`, которая появляется, пока `npm install -g @anthropic-ai/claude-code` заменяет двоичный файл, имеет ту же причину, что и [`EACCES` при переустановке](#eacces-when-starting-a-background-session), и очищается, когда вы повторяете попытку после завершения установки.
3669
3670Claude Code запускает фоновую службу через PowerShell, чтобы служба пережила закрытие терминала, используя PowerShell 7, когда он установлен, и Windows PowerShell 5.1 в противном случае. Когда ни один PowerShell не может работать, Claude Code запускает службу напрямую вместо этого, поэтому политика, которая блокирует только PowerShell, не вызывает эту ошибку. Если вы видите её, пока не запущена установка npm, политика блокирует сам исполняемый файл Claude Code.
3671
3672До версии 2.1.212 Claude Code использовал только Windows PowerShell 5.1 для запуска службы, поэтому любая машина, где Group Policy блокировал PowerShell 5.1, не удавалась с `Couldn't start the session — EUNKNOWN: unknown error, uv_spawn`, даже с установленным PowerShell 7.
3673
996**Что делать:**3674**Что делать:**
997 3675
998* Запустите `/model` и выберите модель, которую включает ваш план3676* Если сообщение читается `Couldn't start the session`, обновитесь до версии 2.1.212 или позже. На более ранних версиях вы также можете запустить `claude daemon run` в отдельном терминале сначала, затем запустить фоновый сеанс снова. Эта команда запускает фоновую службу на переднем плане терминала, поэтому служба длится только столько, сколько этот терминал остаётся открытым.
999* Если вы недавно обновили свой план и всё ещё видите это, запустите `/logout`, затем `/login`. Сохранённый токен отражает ваш план на момент входа, поэтому обновление в интернете не вступает в силу в существующей сессии до переаутентификации.3677* Если установка npm заменяла двоичный файл, дождитесь её завершения, затем запустите фоновый сеанс снова
1000* Смотрите [claude.com/pricing](https://claude.com/pricing) для того, какие модели включает каждый план3678* Если ошибка появляется в версии 2.1.212 или позже, пока не запущена установка npm, попросите администратора Windows разрешить исполняемый файл Claude Code в политике ограничения
3679* Если фоновая служба останавливается при закрытии терминала, Claude Code запустил её без PowerShell. Установите PowerShell 7 или попросите администратора разблокировать PowerShell, чтобы служба могла пережить терминал.
1001 3680
1002<h3 id="model-is-restricted-by-your-organizations-settings">3681<h3 id="eacces-when-starting-a-background-session">
1003 Model is restricted by your organization's settings3682 EACCES при запуске фонового сеанса
1004</h3>3683</h3>
1005 3684
1006Администратор вашей организации отключил эту модель в консоли администратора claude.ai, или она исключена [`availableModels`](/docs/ru/model-config#restrict-model-selection) списком разрешений в управляемых параметрах. Когда ограниченная модель была установлена с `--model`, `ANTHROPIC_MODEL` или параметром `model`, Claude Code подставляет разрешённую модель и продолжает. Ввод `/model <name>` для ограниченной модели отклоняется с `Run /model to choose a different model.` и сессия сохраняет свою текущую модель.3685Claude Code не мог запустить свой собственный двоичный файл для запуска [фоновой службы](/docs/ru/agent-view#the-supervisor-process), которая размещает фоновые сеансы. При установке npm это обычно означает, что `npm install -g @anthropic-ai/claude-code` заменял двоичный файл в этот момент, запустили ли вы его или [автоматическое обновление](/docs/ru/setup#auto-updates) сделало это. Ошибка появляется, когда вы открываете сеанс из [представления агента](/docs/ru/agent-view):
1007 3686
1008```text theme={null}3687```text theme={null}
1009Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.3688Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
3689```
3690
3691Когда вы запускаете сеанс с `/background` или `claude --bg`, та же причина появляется внутри `Couldn't reach the background service (...)`. Во время того же окна переустановки ошибка может называть другой код вместо этого, например `ENOENT` или `ENOEXEC`, или `EUNKNOWN` или `EPERM` на Windows; `EUNKNOWN`, который сохраняется при повторных попытках, имеет [другую причину](#eunknown-when-starting-a-background-session).
3692
3693При установке npm Claude Code ждёт завершения переустановки и повторяет попытку самостоятельно: до десяти секунд и до двух минут, пока установка npm Claude Code явно всё ещё работает на машине, что охватывает другой процесс Claude Code, загружающий обновление. Когда установка превышает это ожидание, сбой называет обновление вместо простого кода ошибки:
3694
3695```text theme={null}
3696Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes
1010```3697```
1011 3698
1012Claude Code рассматривает псевдоним семейства моделей, один из `opus`, `sonnet`, `haiku` или `fable`, как запрос для этого семейства, а не для его новейшей версии. На Anthropic API и на [Claude Platform on AWS](/docs/ru/claude-platform-on-aws) ограниченный псевдоним семейства разрешается в новейшую версию семейства, которую разрешают ваша организация и список разрешений `availableModels`, и уведомление о подстановке называет эту версию. Claude Code отклоняет `/model <alias>` только когда каждая версия семейства ограничена. До v2.1.205 псевдоним семейства был подставлен или отклонен на основе только его новейшей версии, даже когда была разрешена более старая версия того же семейства.3699До версии 2.1.257 ожидание остановилось в десять секунд в каждом случае, поэтому эта ошибка появилась, пока другой процесс Claude Code всё ещё загружал обновление. До версии 2.1.246 Claude Code не удавался сразу же, без ожидания.
1013 3700
1014**Что делать:**3701**Что делать:**
1015 3702
1016* Запустите `/model` для выбора из моделей, которые разрешает ваша организация. Ограниченные модели скрыты от средства выбора.3703* Подождите несколько секунд, затем откройте сеанс или отправьте снова. Когда сообщение говорит, что Claude Code обновляется, повторите попытку после завершения обновления.
1017* Если ограниченная модель была установлена в `--model`, `ANTHROPIC_MODEL` или поле `model` файла параметров, удалите или обновите это значение, чтобы уведомление не повторялось при каждом запуске3704* Если ошибка сохраняется, пока не запущена установка npm, ваш пользователь не может запустить установленный двоичный файл. Проверьте его разрешения и его каталога, или переустановите Claude Code.
1018* Если вам нужен доступ к ограниченной модели, попросите администратора вашей организации включить её. Смотрите [Organization model restrictions](/docs/ru/model-config#organization-model-restrictions).
1019 3705
1020<h3 id="thinking-type-enabled-is-not-supported-for-this-model">3706<h3 id="background-service-exited-before-it-became-reachable">
1021 thinking.type.enabled is not supported for this model3707 Фоновая служба вышла до того, как стала доступной
1022</h3>3708</h3>
1023 3709
1024Ваша версия Claude Code старше минимума для Sonnet 5, Opus 4.8 или Opus 4.7. CLI отправил конфигурацию мышления, которую модель больше не принимает.3710Процесс, который Claude Code запустил как [фоновую службу](/docs/ru/agent-view#the-supervisor-process), вышел до того, как он принял соединения, поэтому Claude Code не мог открыть ваш сеанс. Когда служба выводила ошибку перед выходом, причина в скобках даёт код выхода или сигнал и первую строку, которую служба выводила, которая называет то, что её остановило:
1025 3711
1026```text theme={null}3712```text theme={null}
1027API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.3713Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'
1028```3714```
1029 3715
3716Когда вы открываете сеанс из [представления агента](/docs/ru/agent-view), та же причина следует `Couldn't start the background service —`. Когда служба ничего не выводила перед выходом, сообщение говорит `nothing on stderr` вместо этого.
3717
3718Claude Code сообщает об ошибке с линией ошибки службы. До версии 2.1.246 ошибка появлялась только после ожидания в 45 секунд, как `background service did not become reachable within 45s`, без линии ошибки службы.
3719
3720Две цитируемые причины имеют известные причины:
3721
3722* `Error: claude native binary not installed.`: установка npm заменяла двоичный файл Claude Code в этот момент, поэтому служба запускала заполнитель npm вместо этого. Повторите попытку после завершения установки; если строка сохраняется без запущенной установки, [завершите установку npm](/docs/ru/troubleshoot-install#native-binary-not-found-after-npm-install). До версии 2.1.257 самообновление npm на macOS производило эту ошибку при каждом запуске во время окна установки.
3723* `nothing on stderr` с кодом выхода 1, при каждом запуске, на Windows: `daemon.lock` называет процесс, который Claude Code не может ни сигнализировать, ни доказать, что он ушёл, поэтому каждая новая служба заключает, что другая держит блокировку и выходит. Блокировка, чей писатель Claude Code может доказать, что ушёл, заменяется самостоятельно и не производит эту ошибку. Когда ошибка повторяется при каждом запуске, удалите `~/.claude/daemon.lock`, затем откройте сеанс или отправьте снова. До версии 2.1.257 такая блокировка блокировала каждый запуск, пока вы не удалили файл.
3724
1030**Что делать:**3725**Что делать:**
1031 3726
1032* Запустите `claude update` и перезагрузите Claude Code. Opus 4.7 требует v2.1.111 или позже. Opus 4.8 требует v2.1.154 или позже. Sonnet 5 требует v2.1.197 или позже3727* Если сообщение цитирует строку, исправьте то, что она называет, затем откройте сеанс или отправьте снова. Следующая попытка запускает службу снова
1033* Если вы не можете обновиться, запустите `/model` и выберите Opus 4.6 или Sonnet 4.6 вместо этого3728* Запустите `claude daemon status` для проверки, работает ли служба сейчас
1034* Если вы столкнулись с этим в [Agent SDK](/docs/ru/agent-sdk/overview), обновите пакет SDK вместо этого. Opus 4.8 требует TypeScript SDK v0.3.154 или позже и Python SDK v0.2.88 или позже. Sonnet 5 требует TypeScript SDK v0.3.197 или позже
1035 3729
1036<h3 id="thinking-budget-exceeds-output-limit">3730<h3 id="working-directory-no-longer-exists-when-starting-a-background-session">
1037 Thinking budget exceeds output limit3731 Рабочий каталог больше не существует при запуске фонового сеанса
1038</h3>3732</h3>
1039 3733
1040Настроенный бюджет расширенного мышления превышает максимальную длину ответа, поэтому для фактического ответа не остаётся места.3734Вы попытались запустить [фоновый сеанс](/docs/ru/agent-view) в каталоге, который больше не существует. Это происходит, когда вы отправляете из представления агента или запускаете `/background` после того, как каталог, в котором вы работаете, был удалён или перемещён. Это также происходит, когда вы подключаетесь к или перезапускаете сеанс, чей процесс вышел и чей каталог ушёл, потому что новый процесс запустился бы в том же каталоге. Claude Code не запускает сеанс, и сообщение называет отсутствующий каталог:
1041 3735
1042```text theme={null}3736```text theme={null}
1043API Error: 400 ... max_tokens must be greater than thinking.budget_tokens3737Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
1044```3738```
1045 3739
1046Claude Code автоматически регулирует эти значения на Anthropic API. Вы обычно видите эту ошибку на Amazon Bedrock или Google Cloud's Agent Platform, когда [`MAX_THINKING_TOKENS`](/docs/ru/env-vars) установлен выше лимита вывода поставщика, или когда режим плана повышает бюджет мышления.3740До версии 2.1.257 сеанс казался запущенным и затем показывался в представлении агента как неудачная строка с той же причиной.
1047 3741
1048**Что делать:**3742**Что делать:**
1049 3743
1050* Понизьте `MAX_THINKING_TOKENS`, или повысьте [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ru/env-vars) выше бюджета мышления3744* Пересоздайте каталог, который называет сообщение, или отправьте из каталога, который существует, затем попробуйте снова
1051* Смотрите [Extended thinking](/docs/ru/model-config#extended-thinking) для того, как бюджет взаимодействует с длиной вывода
1052 3745
1053<h3 id="tool-use-or-thinking-block-mismatch">3746<h2 id="wrapper-and-ide-errors">
1054 Tool use or thinking block mismatch3747 Ошибки обёртки и IDE
3748</h2>
3749
3750Эти ошибки исходят от программы, которая запустила Claude Code для вас, такой как расширение IDE или приложение [Agent SDK](/docs/ru/agent-sdk/overview), а не от самого Claude Code.
3751
3752<h3 id="claude-code-process-exited-with-code-n">
3753 Claude Code process exited with code N
1055</h3>3754</h3>
1056 3755
1057История разговора достигла API в несогласованном состоянии, обычно после прерывания вызова инструмента или редактирования хода в процессе.3756Базовый процесс `claude` завершился с ненулевым кодом. Сам код выхода не говорит, что не удалось: реальная ошибка находится в собственном выводе процесса, который обёртка добавляет, если она что-то захватила, в противном случае она хранит это в своих логах.
1058 3757
1059```text theme={null}3758```text theme={null}
1060API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.3759Error: Claude Code process exited with code 1
1061API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
1062API Error: 400 ... thinking blocks ... cannot be modified
1063```3760```
1064 3761
1065Все три варианта означают одно и то же: последовательность блоков `tool_use`, `tool_result` и `thinking` в истории больше не совпадает с тем, что ожидает API.
1066
1067**Что делать:**3762**Что делать:**
1068 3763
1069* Если вы используете Opus 4.7 или Opus 4.8, сначала запустите `claude update`. Версии до v2.1.156 могут вызвать эту ошибку при нормальном использовании инструмента, и `/rewind` её не очищает.3764* В VS Code перейдите по ссылке **View output logs**, показанной с ошибкой, чтобы увидеть основную ошибку
1070* Запустите `/rewind`, или нажмите Esc дважды, чтобы вернуться к контрольной точке перед повреждённым ходом и продолжить оттуда. Смотрите [Checkpointing](/docs/ru/checkpointing) для того, как создаются и восстанавливаются контрольные точки.3765* В приложении Agent SDK перехватите ошибку вокруг вашего цикла сообщений. Записи в разделе [CLI process exit](/docs/ru/agent-sdk/troubleshooting#cli-process-exit) охватывают то, что ваш код получает в каждом языке SDK.
3766* Запустите `claude` в терминале в том же проекте. Ошибка обычно воспроизводится там с её реальным сообщением об ошибке, которое вы затем можете найти на этой странице.
3767* Запустите `claude doctor` в терминале, чтобы проверить установку и конфигурацию
1071 3768
1072<h3 id="usage-policy-refusal">3769<h3 id="could-not-locate-the-claude-cli-on-path">
1073 Usage Policy refusal3770 Could not locate the Claude CLI on PATH
1074</h3>3771</h3>
1075 3772
1076API отказался отвечать, потому что содержимое в разговоре вызвало проверку [Usage Policy](https://www.anthropic.com/legal/aup). Сообщение включает ID запроса, который вы можете цитировать в поддержку, если вы считаете, что отказ неправильный.3773[Расширение VS Code](/docs/ru/vs-code) показывает эту ошибку в Windows, когда вы открываете Claude Code в интегрированном терминале, оболочка терминала — это PowerShell, и расширение не может найти установленный исполняемый файл `claude` в PATH. Расширение отказывается запускать Claude Code, пока не найдёт установленный `claude` в PATH.
1077 3774
1078```text theme={null}3775```text theme={null}
1079API Error: 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.3776Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.
1080```3777```
1081 3778
1082Проверка оценивает весь разговор, а не только ваш последний prompt, поэтому отправка нового сообщения в той же сессии обычно повторно вызывает тот же отказ. То же самое применяется после выхода и переоткрытия сессии с `--continue` или `--resume`, так как стенограмма на диске всё ещё содержит вызывающее содержимое. На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) это сообщение также охватывает запросы, которые меры безопасности модели отметили как тему кибербезопасности. Смотрите [Safety measures flagged a cybersecurity topic](#safety-measures-flagged-a-cybersecurity-topic).
1083
1084**Что делать:**3779**Что делать:**
1085 3780
1086* Нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал отказ, затем переформулируйте или примите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).3781* Откройте новое окно PowerShell вне VS Code и запустите `where.exe claude`. Если оно не выводит путь, CLI не находится в вашем PATH: добавьте его каталог установки, следуя [Verify your PATH](/docs/ru/troubleshoot-install#verify-your-path). Если оно выводит путь, запись поступает из вашего профиля PowerShell или из изменения PATH, которое VS Code ещё не подхватил; следующие два шага охватывают эти случаи.
1087* Если вы не можете определить, какой ход вызвал это, запустите `/clear` для начала новой разговора в том же проекте. Ваш предыдущий разговор сохраняется на диске и остаётся доступным в `/resume`.3782* Установите запись PATH как переменную окружения пользователя или системы, а не в вашем профиле PowerShell. Расширение не запускает ваш профиль, поэтому редактирование PATH, которое существует только там, никогда до него не доходит.
1088* В [non-interactive mode](/docs/ru/headless) (`-p`), где перемотка недоступна, повторите попытку с переформулированным prompt в новой сессии без `--continue`. Проверки политики варьируются в зависимости от модели, поэтому переключение на другую модель с `--model` также может разрешить отказ в некоторых случаях.3783* Перезагрузите VS Code после изменения PATH. Расширение проверяет PATH, который VS Code захватил при запуске, поэтому изменение PATH вступает в силу только после перезагрузки.
1089 3784
1090<h3 id="safety-measures-flagged-a-cybersecurity-topic">3785<h2 id="rewind-warnings-and-errors">
1091 Safety measures flagged a cybersecurity topic3786 Предупреждения и ошибки Rewind
3787</h2>
3788
3789Эти сообщения поступают из восстановления кода [`/rewind`](/docs/ru/checkpointing). `Restored the code, but skipped N files` — это предупреждение о том, что Claude Code пропустил некоторые пути. `No files were restored` — это ошибка, которая означает, что ничего не было восстановлено.
3790
3791<h3 id="restored-the-code-but-skipped-files">
3792 Restored the code, but skipped files
1092</h3>3793</h3>
1093 3794
1094Меры безопасности модели отметили содержимое в разговоре как тему кибербезопасности. Сообщение называет модель, которая отметила запрос:3795Восстановление кода `/rewind` пропустило один или несколько отслеживаемых путей вместо того, чтобы записать или удалить их. Claude Code пропускает путь, когда:
1095 3796
1096```text theme={null}3797* это символическая ссылка, жёсткая ссылка или другой нерегулярный файл, или он стал таким
1097API Error: Opus 4.8 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: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.3798* его директория изменилась с момента создания контрольной точки
3799* его резервную копию невозможно безопасно прочитать
1098 3800
1099If you were not engaging in a cybersecurity topic, please send feedback via /feedback.3801Пропущенные пути сохраняют своё текущее содержимое. До версии 2.1.216 `/rewind` записывал и удалял данные через ссылки на отслеживаемых путях и не сообщал о частичном восстановлении.
3802
3803```text theme={null}
3804Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.
1100```3805```
1101 3806
1102Сообщение ссылается на [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude), который предоставляет доступ для законной работы в области кибербезопасности. Сама защита находится на стороне сервера и предшествует v2.1.203; этот выпуск изменил только формулировку сообщения и страницу, на которую оно ссылается.3807**Что делать:**
3808
3809* Определите, какие файлы были пропущены, чтобы вы могли обработать каждый из них, следуя приведённым ниже шагам. Сообщение содержит только количество; журнал отладки в `~/.claude/debug/<session-id>.txt` указывает каждый пропущенный путь по мере выполнения восстановления, поэтому включите логирование отладки с помощью `/debug` перед следующим восстановлением. На macOS или Linux вы можете вместо этого найти ссылки напрямую: `find . -type l` для символических ссылок и `find . -type f -links +1` для жёстко связанных файлов.
3810* Если пропущенный файл — это ссылка, которую вы создали намеренно, например файл конфигурации, управляемый менеджером dotfile, или файл, жёстко связанный инструментами вроде pnpm, то rewind оставил его содержимое без изменений. Чтобы отменить изменения сеанса в этом файле, попросите Claude отменить редактирование или отредактируйте файл самостоятельно
3811* Если вы не создавали ссылку, проверьте путь перед тем, как доверять его содержимому: что-то заменило файл после создания контрольной точки
1103 3812
1104То, что вы видите, зависит от вашего поставщика и режима:3813<h3 id="no-files-were-restored">
3814 No files were restored
3815</h3>
3816
3817Claude Code показывает это сообщение, когда вы восстанавливаете код с помощью [`/rewind`](/docs/ru/checkpointing) и Claude Code не может восстановить ни один из файлов в этой контрольной точке. Для каждого файла либо резервная копия, которую Claude Code сохранил перед редактированием, отсутствует, либо Claude Code не смог записать или удалить файл.
1105 3818
1106* На [Amazon Bedrock](/docs/ru/amazon-bedrock), [Google Cloud's Agent Platform](/docs/ru/google-vertex-ai) и [Microsoft Foundry](/docs/ru/microsoft-foundry) флаг кибербезопасности производит сообщение [Usage Policy refusal](#usage-policy-refusal) вместо этого.3819```text theme={null}
1107* [Non-interactive mode](/docs/ru/headless) опускает предложение `/feedback`.3820Failed to restore the code:
3821No files were restored: 1 file failed (backup missing, or the file could not be updated)
3822```
1108 3823
1109До v2.1.203 сообщение читалось `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` с последующей ссылкой на форму исключения.3824Claude Code удаляет резервные копии сеанса при [очистке хранения](/docs/ru/claude-directory#cleaned-up-automatically), по умолчанию примерно через 30 дней после того, как сеанс последний раз их сохранил. Если вы возобновите сеанс после этого, `/rewind` по-прежнему будет отображать его контрольные точки, но восстановление одной из них может завершиться ошибкой. Если сообщение также говорит `N paths were skipped for link safety`, см. раздел [Restored the code, but skipped files](#restored-the-code-but-skipped-files) для этих путей.
1110 3825
1111**Что делать:**3826**Что делать:**
1112 3827
1113* Если ваша работа требует этого содержимого, подайте заявку на доступ через [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)3828* Отмените изменения другим способом: попросите Claude отменить его редактирование или восстановите файлы из системы контроля версий. Когда резервные копии удалены, повторный запуск `/rewind` завершится с той же ошибкой.
1114* Если ваш запрос не был о теме кибербезопасности, запустите `/feedback` для сообщения о ложном срабатывании3829* Если Claude Code не смог записать или удалить файл, исправьте то, что блокирует запись, например разрешения на файл, а затем снова запустите `/rewind`.
1115* Чтобы продолжить работу в той же сессии, нажмите Esc дважды или запустите `/rewind` для возврата к контрольной точке перед ходом, который вызвал флаг, затем примите другой подход. Смотрите [Checkpointing](/docs/ru/checkpointing).3830* Чтобы сохранять резервные копии дольше в будущих сеансах, увеличьте значение [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays).
1116 3831
1117<h2 id="installation-errors">3832До версии 2.1.260 Claude Code молча пропускал файлы, резервные копии которых отсутствовали, и восстановление казалось успешным.
1118 Ошибки установки3833
3834<h2 id="session-saving-warnings">
3835 Предупреждения о сохранении сеанса
1119</h2>3836</h2>
1120 3837
1121Эти ошибки появляются при установке или обновлении Claude Code из [скрипта установки](/docs/ru/setup#install-claude-code), `claude install` или `claude update`. Для проблем с `command not found`, PATH, разрешениями и TLS во время установки см. [Устранение неполадок установки и входа](/docs/ru/troubleshoot-install).3838Claude Code показывает эти предупреждения на постоянной строке ниже поля ввода, когда он не сохраняет транскрипт вашего сеанса. Сеанс продолжает работать в любом случае; предупреждения говорят вам, что сеанс может отсутствовать при [`--resume`](/docs/ru/sessions) позже.
1122 3839
1123<h3 id="installation-was-killed-before-it-could-finish">3840<h3 id="transcript-writes-are-failing">
1124 Установка была прервана до завершения3841 Запись транскрипта не удаётся
1125</h3>3842</h3>
1126 3843
1127Скрипт установки сообщает, когда этап `claude install` завершается сигналом. На Linux код выхода 137 означает, что процесс получил SIGKILL, а на хосте с низким объёмом памяти это обычно означает, что ядро активировало средство защиты от нехватки памяти (OOM killer). Скрипт выводит это объяснение и завершается с кодом 137:3844Claude Code сохраняет транскрипт на диск по мере работы, и его записи в [файл транскрипта](/docs/ru/sessions#where-transcripts-are-stored) не удаются. Сообщение указывает причину с кодом базовой ошибки, например полный диск:
1128 3845
1129```text theme={null}3846```text theme={null}
1130Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.3847Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume
1131Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.
1132```3848```
1133 3849
1134Для любого другого фатального сигнала и для кода выхода 137 на macOS скрипт выводит `Installation was killed before it could finish (exit code <N>)` с фактическим кодом выхода и опускает объяснение о нехватке памяти. Сообщение поступает из скрипта установки, который используют macOS и Linux, и также охватывает установки внутри WSL; встроенные скрипты установки Windows никогда его не выводят. До версии 2.1.200 скрипт завершался только с простой строкой `Killed` оболочки.3850Предупреждение появляется в разных точках в зависимости от ошибки:
3851
3852* При первом сбое для условий, которые не исчезают сами по себе: полный диск, превышена квота диска, файловая система только для чтения, путь превышает лимит длины файловой системы, или на macOS и Linux — ошибка разрешения
3853* После повторных сбоев, длящихся не менее минуты, для всего остального, включая ошибки разрешения на Windows, где сканирование антивируса может привести к сбою одной записи, которая затем успешно выполняется при повторной попытке
3854
3855До версии 2.1.217 Claude Code отбрасывал неудачные записи без предупреждения, и позже отсутствие недавних сообщений при `--resume` было первым признаком.
1135 3856
1136**Что делать:**3857**Что делать:**
1137 3858
1138* Остановите другие процессы, чтобы освободить память, затем повторно запустите установщик3859* Исправьте условие, которое указывает код ошибки: освободите место на диске для `ENOSPC`; повысьте или очистите квоту для `EDQUOT`; восстановите доступ на запись в расположение транскрипта для `EACCES`, `EPERM` или `EROFS`
1139* Добавьте пространство подкачки или перейдите на экземпляр большего размера. См. [Установка прервана на серверах Linux с низким объёмом памяти](/docs/ru/troubleshoot-install#install-killed-on-low-memory-linux-servers) для команд файла подкачки.3860* Предупреждение исчезает само по себе при следующей успешной записи; перезагрузка не требуется
3861* Сообщения, отправленные во время отображения предупреждения, могут по-прежнему отсутствовать при возобновлении сеанса позже
1140 3862
1141<h3 id="the-connection-dropped-while-downloading-the-update">3863<h3 id="transcript-saving-is-off-skip-prompt-history">
1142 Соединение разорвалось при загрузке обновления3864 Сохранение транскрипта отключено, потому что установлена переменная CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY
1143</h3>3865</h3>
1144 3866
1145Соединение с сервером загрузки закрылось, пока `claude install`, `claude update` или [автоматический обновитель](/docs/ru/setup#auto-updates) загружал двоичный файл Claude Code, и повторные попытки не восстановили соединение. Claude Code повторяет загрузку, когда соединение разрывается, передача зависает или загруженный файл не проходит проверку контрольной суммы, всего до трёх попыток. Завершённая ошибка HTTP, такая как 404, не повторяется, потому что сервер уже ответил. До версии 2.1.202 одно разорванное соединение немедленно приводило к сбою загрузки с простой ошибкой `aborted` вместо повторной попытки.3867Этот сеанс начался с установленной переменной [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/ru/env-vars), поэтому Claude Code не записывает для него транскрипт или историю подсказок:
1146 3868
1147```text theme={null}3869```text theme={null}
1148The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.3870Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart
1149```3871```
1150 3872
1151Текст в скобках указывает, какая попытка не удалась, и основную ошибку сети. `claude update` предваряет сообщение с `Error: Failed to install native update` на stderr.3873Переменная является преднамеренным отказом для эфемерных скриптовых сеансов, но она также может достичь сеанса через профиль оболочки, скрипт-обёртку или родительский процесс, который её экспортировал.
3874
3875**Что делать:**
1152 3876
1153Загрузка, которая остаётся подключённой, но не завершается в течение 10 минут, завершается с ошибкой `Download timed out: exceeded the total deadline`. Claude Code не повторяет истёкшую по времени загрузку, потому что соединение, которое слишком медленно для завершения в установленный срок, не завершится и при немедленной повторной попытке. Приведённые ниже шаги применяются к обоим сообщениям. До версии 2.1.205 тот же 10-минутный срок сообщался как универсальный `timeout of 600000ms exceeded` HTTP-клиента.3877* Если вы установили переменную намеренно, никаких действий не требуется; уведомление подтверждает, что сеанс не будет отображаться в `--resume`, `--continue` или истории стрелки вверх
3878* Если нет, удалите переменную из оболочки или скрипта, который запускает `claude`, затем начните новый сеанс. Сообщения из текущего сеанса не сохраняются задним числом.
1154 3879
1155Обычная причина — прокси или шлюз, который закрывает длительную передачу до её завершения. Двоичный файл Claude Code — это большая загрузка, поэтому ограничение соединения прокси, которое никогда не влияет на обычный трафик API, всё равно может его прервать.3880<h3 id="transcript-saving-is-off-child-session-marker">
3881 Сохранение транскрипта отключено из-за унаследованного маркера CLAUDE\_CODE\_CHILD\_SESSION
3882</h3>
3883
3884Claude Code устанавливает [`CLAUDE_CODE_CHILD_SESSION`](/docs/ru/env-vars) в подпроцессах, которые он порождает, и рассматривает интерактивный сеанс, который его наследует, как вложенный: Claude Code не сохраняет для него транскрипт, поэтому сеансы, которые сам Claude запускает, не заполняют ваш список `--resume`. Это уведомление означает, что ваш текущий сеанс унаследовал маркер:
3885
3886```text theme={null}
3887Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts
3888```
3889
3890Уведомление ожидается, когда вы запустили `claude` изнутри другого сеанса Claude Code; оно сигнализирует о неправильной классификации, когда маркер просочился через долгоживущий посредник, например терминал, сеанс `screen` или средство запуска, которое первоначально запустил сеанс Claude Code.
3891
3892Внутри tmux Claude Code обнаруживает маркер, который прибыл через глобальную среду сервера tmux, и продолжает сохранять, поэтому это уведомление не появляется для этого случая.
1156 3893
1157**Что делать:**3894**Что делать:**
1158 3895
1159* Запустите `claude update` снова. На в остальном здоровой сети загрузка обычно успешна при следующем запуске. Для сообщения об истечении времени запустите его снова из более быстрой или менее ограниченной сети.3896* Если вы запустили этот сеанс изнутри другого сеанса Claude Code намеренно, никаких действий не требуется
1160* Если ваша сеть требует прокси, установите `HTTPS_PROXY` перед запуском установщика или `claude update`. См. [Проверка подключения к сети](/docs/ru/troubleshoot-install#check-network-connectivity).3897* Если это сеанс верхнего уровня, выйдите и перезагрузитесь с установленной переменной [`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1`](/docs/ru/env-vars). Сохранение применяется с момента перезагрузки, поэтому сообщения, отправленные до неё, не сохраняются.
1161* Если корпоративный прокси продолжает закрывать передачу, попросите вашу команду сети разрешить полную загрузку с `downloads.claude.ai`. См. [Требования к доступу в сеть](/docs/ru/network-config#network-access-requirements).3898* Чтобы исправить будущие запуски из того же терминала или средства запуска, удалите `CLAUDE_CODE_CHILD_SESSION` из его среды
1162* Запустите `claude doctor` из вашей оболочки для диагностики установки
1163 3899
1164<h2 id="command-line-errors">3900<h2 id="configuration-warnings">
1165 Ошибки командной строки3901 Предупреждения о конфигурации
1166</h2>3902</h2>
1167 3903
1168Эти ошибки поступают из командной строки `claude` и её подкоманд. Claude Code выводит их перед запуском вашего запроса или отправкой любого запроса API.3904Claude Code записывает большинство этих сообщений в stderr, а не в беседу, и выводит большинство из них при запуске. Запись указывает, когда её сообщение появляется в другом месте, например в журнале отладки или как уведомление при запуске в представлении беседы, или в другое время, например [диагностическая строка unrecognized-model](#unrecognized-model-id-on-a-request) во время запроса.
1169 3905
1170<h3 id="conflict-between-bg-and-print">3906<h3 id="fullscreen-failed-start-notice">
1171 Конфликт между --bg и --print3907 Fullscreen renderer didn't finish starting
1172</h3>3908</h3>
1173 3909
1174Это сообщение требует Claude Code v2.1.198 или позже. Вы объединили `--bg` с `-p` или `--print` в одном вызове `claude`. `--bg` запускает [фоновый сеанс](/docs/ru/agent-view#from-your-shell), к которому вы позже подключаетесь с помощью `claude agents`, а `--print` запускает [неинтерактивно](/docs/ru/headless) и никогда не запускает интерактивный сеанс, к которому подключается `claude agents`. До версии v2.1.198 эта комбинация молча создавала фоновое задание, которое никогда не могло быть подключено.3910Предыдущий сеанс [fullscreen](/docs/ru/fullscreen) на этом компьютере завершился до того, как закончил запускаться, поэтому Claude Code запускает этот сеанс на классическом renderer и выводит одно из этих уведомлений:
1175 3911
1176```text theme={null}3912```text theme={null}
3913Claude Code's fullscreen renderer didn't finish starting last time on this machine, so this launch is using the classic renderer. It will try fullscreen again next launch; /tui default keeps the classic renderer.
3914
3915Claude Code's fullscreen renderer has repeatedly failed to start on this machine, so it has been turned off here. Run /tui fullscreen to try it again (this also resets after an update).
1177```3916```
1178 3917
1179**Что делать:**3918**Что делать:**
1180 3919
1181* Удалите `-p` или `--print`. `--bg` принимает запрос в качестве позиционного аргумента, поэтому `claude --bg "<task>"` — это полная команда. См. [Dispatch new agents from your shell](/docs/ru/agent-view#from-your-shell).3920* Следуйте инструкциям [Fullscreen rendering](/docs/ru/fullscreen#fullscreen-renderer-didnt-finish-starting). Там указано, какое уведомление вы получите, что Claude Code делает в последующих сеансах и как снова попробовать fullscreen или оставить классический renderer.
1182* Чтобы запустить запрос неинтерактивно и вывести результат вместо создания фонового сеанса, удалите `--bg` и запустите `claude -p "<task>"`3921* Если сеанс, который завершился, вывел сообщение об выходе, см. [Claude Code exited after an unrecoverable interface error](#exited-after-an-unrecoverable-interface-error) для получения информации о том, что оно называет.
1183 3922
1184<h3 id="the-json-schema-value-is-not-a-valid-json-schema">3923До версии 2.1.236 Claude Code не выводил уведомление и продолжал запускать сеансы в fullscreen rendering после неудачного запуска.
1185 Значение --json-schema не является допустимой JSON Schema3924
3925<h3 id="exited-after-an-unrecoverable-interface-error">
3926 Claude Code exited after an unrecoverable interface error
1186</h3>3927</h3>
1187 3928
1188Схема, которую вы передали в [`--json-schema`](/docs/ru/cli-reference#cli-flags) в [неинтерактивном режиме](/docs/ru/headless#get-structured-output), не прошла компиляцию JSON Schema, поэтому `claude` завершает работу с кодом 1 вместо запуска запроса. До версии v2.1.205 недопустимая схема выдавала неструктурированный вывод без ошибки, и любая схема, использующая ключевое слово `format`, считалась недопустимой.3929Claude Code выводит это сообщение при выходе, потому что его интерфейс терминала столкнулся с ошибкой, от которой он не может восстановиться, в любом из renderer. Второе предложение появляется только когда ошибка произошла во время запуска [fullscreen](/docs/ru/fullscreen) renderer:
1189 3930
1190```text theme={null}3931```text theme={null}
1191Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values3932Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).
1192```3933```
1193 3934
1194Текст после второго двоеточия — это диагностика валидатора и указывает на ключевое слово или местоположение, которое не прошло проверку. Схемы, использующие ключевое слово `format`, такие как `"format": "email"`, являются допустимыми: Claude Code принимает `format` как аннотацию и не применяет её.3935**Что делать:**
3936
3937* Запустите Claude Code снова. Чтобы продолжить беседу, выполните `claude --resume` в том же каталоге.
3938* Если сообщение называет fullscreen renderer, [Fullscreen rendering](/docs/ru/fullscreen#fullscreen-renderer-didnt-finish-starting) говорит, что делает следующий запуск, что зависит от того, как вы включили fullscreen, и как снова попробовать fullscreen или оставить классический renderer.
3939
3940До версии 2.1.236 Claude Code выходил без вывода сообщения после этого вида ошибки.
3941
3942<h3 id="agent-descriptions-are-over-the-15000-token-limit">
3943 Agent descriptions are over the 15.0k-token limit
3944</h3>
3945
3946Claude Code показывает это предупреждение как уведомление при запуске в представлении беседы, а не на stderr. Объединённые описания ваших [subagents](/docs/ru/sub-agents), кроме встроенных, превышают 15 000 токенов в соответствии с оценкой Claude Code. Каждый агент считает своё имя плюс его frontmatter `description`. Claude Code загружает каждого агента независимо от того, превышен ли лимит, поэтому предупреждение не меняет то, что загружается.
1195 3947
1196Claude Code выполняет две проверки перед компиляцией схемы: он отклоняет значение, которое не является парсируемым JSON, с помощью `Error: --json-schema is not valid JSON`, и допустимый JSON, который не является объектом, с помощью `Error: --json-schema must be a JSON object`.3948```text theme={null}
3949Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/
3950```
1197 3951
1198**Что делать:**3952**Что делать:**
1199 3953
1200* Исправьте часть схемы, которую указывает диагностика, затем повторно запустите команду3954* Сократите frontmatter `description` ваших файлов агентов или попросите Claude сократить их для вас.
1201* Если диагностика — `schema too large`, уменьшите вложенность схемы и повторное использование `$ref`3955* Удалите файлы агентов, которые вы больше не используете.
1202* См. [Get structured output](/docs/ru/headless#get-structured-output) для рабочей схемы и команды
1203 3956
1204<h3 id="could-not-import-a-server-from-claude-desktop">3957<h3 id="workspace-has-not-been-trusted">
1205 Не удалось импортировать сервер из Claude Desktop3958 Workspace has not been trusted
1206</h3>3959</h3>
1207 3960
1208Claude Code не смог добавить один из серверов, которые вы выбрали в `claude mcp add-from-claude-desktop`. Команда по-прежнему импортирует другие выбранные серверы и выводит одну строку для каждого сервера, который она не смогла добавить. До версии v2.1.205 первый сервер, который не прошёл проверку, останавливал импорт и ни один из выбранных серверов не был добавлен.3961Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила allow из параметров проекта требуют доверия рабочей области](/docs/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. На правила `deny` и `ask` это не влияет.
1209 3962
1210```text theme={null}3963```text theme={null}
1211Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3964Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.
1212```3965```
1213 3966
1214Текст после имени сервера — это причина. Наиболее распространённая — это проверка имени: Claude Desktop допускает символы в именах серверов, такие как пробелы и точки, которые `claude mcp` ограничивает буквами, цифрами, дефисами и подчёркиваниями. Другие причины включают конфигурацию сервера, которая не прошла валидацию, и сервер, заблокированный [политикой MCP](/docs/ru/managed-mcp) вашей организации.
1215
1216**Что делать:**3967**Что делать:**
1217 3968
1218* Переименуйте сервер в `claude_desktop_config.json`, используя только буквы, цифры, дефисы и подчёркивания, затем снова запустите `claude mcp add-from-claude-desktop`3969* Выполните `claude` в каталоге и примите диалог доверия. [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust) говорит, какую папку охватывает это принятие.
1219* Добавьте этот сервер напрямую с помощью `claude mcp add` или `claude mcp add-json` под допустимым именем. См. [Import MCP servers from Claude Desktop](/docs/ru/mcp#import-mcp-servers-from-claude-desktop).3970* В [non-interactive mode](/docs/ru/headless) с `-p` диалог не показывается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.
3971* Если сообщение называет `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или позже. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих областях. На версии 2.1.207 и позже обновления недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка не находится внутри репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалог доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой [configuration home](/docs/ru/permissions#project-allow-rules-and-workspace-trust) освобождены и не ждут диалога. См. [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust).
1220 3972
1221<h3 id="mcp-permission-prompt-tool-not-found">3973<h3 id="working-directory-is-a-network-path">
1222 Инструмент запроса разрешения MCP не найден3974 Working directory is a network path
1223</h3>3975</h3>
1224 3976
1225Инструмент, который вы передали в [`--permission-prompt-tool`](/docs/ru/cli-reference#cli-flags), не был среди подключённых инструментов MCP, когда запуск впервые нуждался в решении о разрешении, либо потому, что его сервер никогда не подключался, либо потому, что ни один подключённый сервер не предоставляет инструмент с таким именем. Claude Code по-прежнему отправляет ваш запрос: [неинтерактивный](/docs/ru/headless) запуск завершается с этой ошибкой и кодом выхода 1 при первом вызове инструмента, который требует одобрения, поэтому он не выдаёт ответ, хотя запрос был сделан. Перед первым запросом Claude Code ждёт до 30 секунд, установленного [`MCP_TIMEOUT`](/docs/ru/env-vars) для подключения этого сервера. До версии v2.1.206 запуск не ждал завершения подключения сервера, поэтому медленно запускающийся, но здоровый сервер также выдавал эту ошибку.3977Claude Code не добавляет сетевые пути как рабочие каталоги. Поиск сетевого пути может связаться с хостом, который он называет, и на Windows этот контакт может отправить хосту ваши учётные данные, поэтому Claude Code отказывает в пути без его поиска. Вы видите это сообщение при выполнении `/add-dir` с таким путём или как предупреждение при запуске. Когда оно появляется при запуске, Claude Code запускается без этого каталога.
1226 3978
1227```text theme={null}3979```text theme={null}
1228Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3980\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).
1229```3981```
1230 3982
1231Список после `Available MCP tools:` указывает инструменты MCP, которые были подключены, когда ожидание закончилось.3983Пути, которые Claude Code отказывает таким образом, включают:
3984
3985* UNC shares такие как `\\server\share`
3986* Automount paths такие как `/net/<host>`, если вы не запустили Claude Code из каталога под automount этого хоста
3987* Локальные пути, которые достигают сетевого расположения через символическую ссылку или junction
3988
3989Сопоставленные буквы дисков и пути `\\wsl$` не считаются сетевыми путями.
1232 3990
1233**Что делать:**3991**Что делать:**
1234 3992
1235* Проверьте, что сервер запускается и остаётся подключённым: запустите `claude mcp list` в том же каталоге и подтвердите, что сервер указан как подключённый3993* На Windows сопоставьте share с буквой диска, например с помощью `net use Z: \\server\share`, и передайте диск при запуске с `claude --add-dir Z:\`.
1236* Подтвердите, что имя инструмента совпадает с именем `mcp__<server>__<tool>`, которое предоставляет сервер3994* На macOS или Linux смонтируйте share в локальный путь и добавьте этот путь вместо этого.
1237* Если серверу требуется более 30 секунд для запуска, увеличьте [`MCP_TIMEOUT`](/docs/ru/env-vars)3995* Если путь находится в `permissions.additionalDirectories`, удалите его из файла параметров, который его перечисляет.
1238 3996
1239<h2 id="plugin-errors">3997До версии 2.1.257 Claude Code принимал достижимый сетевой путь как рабочий каталог.
1240 Ошибки плагинов3998
1241</h2>3999<h3 id="remote-managed-settings-failed-to-load">
4000 Remote managed settings failed to load
4001</h3>
1242 4002
1243Эти ошибки возникают из конфигурации [плагина](/docs/ru/plugins) и [маркетплейса](/docs/ru/plugin-marketplaces). Для проблем с плагинами, которые не выдают одно из сообщений на этой странице, например маркетплейс, который не загружается, или плагин, который устанавливается, но не отображается, см. [Устранение неполадок плагинов](/docs/ru/discover-plugins#troubleshooting).4003Ваш сеанс имеет право на [server-managed settings](/docs/ru/server-managed-settings), но Claude Code не смог их получить, поэтому он показывает это предупреждение в интерактивных сеансах. Причина в скобках называет то, что не удалось, например `network error`, `request timed out` или `authentication rejected (401)`, а остальная часть строки говорит, какую политику запускает сеанс:
1244 4004
1245<h3 id="marketplace-is-registered-from-an-untrusted-source">4005* **Settings cached from an earlier successful fetch**: Claude Code запускает сеанс на этой кэшированной политике, кроме [withheld environment variables](/docs/ru/server-managed-settings#fetch-and-caching-behavior), и строка читается `using cached policy`.
1246 Marketplace is registered from an untrusted source4006* **No cache**: Claude Code запускает сеанс без server-managed settings, и строка читается `no remote policy applied`.
4007
4008**Что делать:**
4009
4010* Действуйте в соответствии с причиной, которую называет сообщение: для сетевой причины проверьте, что эта машина может достичь `api.anthropic.com`; для причины аутентификации проверьте вашу регистрацию с помощью `/status`
4011* Выполните `/status` или `claude doctor` для полной диагностики
4012
4013До версии 2.1.248 Claude Code сообщал о неудачной выборке параметров только в журнале отладки.
4014
4015<h3 id="managed-settings-were-not-approved">
4016 Managed settings were not approved
1247</h3>4017</h3>
1248 4018
1249Маркетплейс зарегистрирован под именем, которое [зарезервировано для официальных маркетплейсов Anthropic](/docs/ru/plugin-marketplaces#marketplace-schema), но его зарегистрированный источник не является репозиторием GitHub `anthropics`. Claude Code повторно проверяет зарезервированные имена каждый раз при загрузке или обновлении маркетплейса, поэтому маркетплейс и плагины, установленные из него, перестают загружаться. До версии 2.1.205 имя проверялось только при добавлении маркетплейса, поэтому запись, зарегистрированная до того, как её имя было зарезервировано, продолжала загружаться.4019[server-managed settings](/docs/ru/server-managed-settings) вашей организации включают параметры, которые требуют вашего одобрения, и вы отклонили [security approval dialog](/docs/ru/server-managed-settings#security-approval-dialogs), поэтому Claude Code выходит без их применения:
1250 4020
1251```text theme={null}4021```text theme={null}
1252Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.4022Managed settings were not approved; exiting without applying them.
1253```4023```
1254 4024
1255**Что делать:**4025**Что делать:**
1256 4026
1257* Выполните `claude plugin marketplace remove <name>`, затем снова добавьте маркетплейс из официального репозитория `github.com/anthropics`4027* Запустите Claude Code снова и одобрите диалог, чтобы продолжить в соответствии с параметрами вашей организации. Отклонённый диалог не запоминается, поэтому он появляется снова при следующем запуске.
1258* Если вы публикуете маркетплейс третьей стороны, который использовал это имя до того, как оно было зарезервировано, переименуйте его и попросите пользователей добавить его из вашего источника4028* Если вы не уверены в параметре, который перечисляет диалог, спросите того, кто поддерживает управляемые параметры вашей организации, перед одобрением
1259* См. список зарезервированных имён в разделе [Marketplace schema](/docs/ru/plugin-marketplaces#marketplace-schema)
1260 4029
1261<h3 id="plugin-command-references-user-config">4030<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">
1262 Plugin command references user\_config in a shell command4031 MCP server is blocked by enterprise managed policy
1263</h3>4032</h3>
1264 4033
1265Хук плагина, [monitor](/docs/ru/plugins-reference#monitors), или MCP команда [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) ссылается на [опцию плагина](/docs/ru/plugins-reference#user-configuration) `${user_config.KEY}`, и подставленная строка будет передана в оболочку. Настроенное значение, содержащее `$(...)`, обратные кавычки или `;`, будет выполнено как код там, поэтому Claude Code отказывается запускать компонент вместо подстановки значения. Проверка выполняется на шаблоне команды, поэтому ошибка появляется даже когда значение ещё не настроено. До версии 2.1.207 значение подставлялось в команду оболочки.4034Вы выбрали **Reconnect** на сервере в `/mcp` или снова включили отключённый сервер там, и параметр, который [restricts MCP servers](/docs/ru/managed-mcp) блокирует этот сервер. Claude Code отказывает в подключении и показывает:
1266
1267Формулировка зависит от того, какая поверхность ссылалась на опцию. Хук в форме оболочки сообщает:
1268 4035
1269```text theme={null}4036```text theme={null}
1270Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}4037MCP server <name> is blocked by enterprise managed policy
1271```4038```
1272 4039
1273Monitor сообщает:4040Любой из этих параметров может создать сообщение:
4041
4042* Запись [`deniedMcpServers`](/docs/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists), которая соответствует серверу, включая одну в вашем собственном `~/.claude/settings.json` или в `.claude/settings.json` проекта
4043* Список [`allowedMcpServers`](/docs/ru/managed-mcp#policy-based-control-with-allowlists-and-denylists), которому сервер не соответствует
4044* [`strictPluginOnlyCustomization`](/docs/ru/settings-reference#strictpluginonlycustomization) с заблокированным `mcp`, который блокирует серверы, настроенные в `~/.claude.json` и `.mcp.json`
4045* [`disableClaudeAiConnectors`](/docs/ru/mcp#disable-claude-ai-connectors), когда сервер является claude.ai connector
4046
4047**Что делать:**
4048
4049* Проверьте ваши собственные файлы параметров пользователя и проекта на наличие одного из этих параметров и измените или удалите его
4050* Если ни один из ваших собственных параметров не объясняет блокировку, спросите вашего администратора, какой управляемый параметр блокирует сервер
4051
4052До версии 2.1.257 **Reconnect** и повторное включение в `/mcp` могли подключить сервер, который обновление политики в середине сеанса заблокировало.
4053
4054<h3 id="managed-settings-document-could-not-be-parsed">
4055 Managed settings document could not be parsed
4056</h3>
4057
4058Ваша организация развёртывает [managed settings](/docs/ru/managed-settings), и один из развёрнутых документов присутствует, но не может быть проанализирован как объект JSON, поэтому Claude Code выходит с кодом 1 при запуске вместо запуска без политики, которую несёт документ. Строка называет неудачный источник перед сообщением:
1274 4059
1275```text theme={null}4060```text theme={null}
1276Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.4061/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.
1277```4062```
1278 4063
1279MCP `headersHelper` сообщает:4064Источник является одним из:
4065
4066* Путь файла `managed-settings.json` или drop-in файла под `managed-settings.d`
4067* Профиль управляемых параметров macOS, `per-user managed preferences` или `device-level managed preferences`
4068* Значение реестра Windows, `Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings`
4069
4070[Find entries Claude Code dropped](/docs/ru/managed-settings#find-entries-claude-code-dropped) перечисляет то, что делает каждый источник непарсируемым.
4071
4072Claude Code отказывает в запуске даже когда другой источник администратора доставляет действительную политику. Вы видите эту ошибку в интерактивных сеансах, `claude -p`, сеансах Agent SDK, [background sessions](/docs/ru/agent-view) и большинстве подкоманд, включая `claude doctor`. Отказ закрывается намеренно: параметры в документе, который Claude Code не может проанализировать, не могут быть применены, и запуск в любом случае запустил бы сеансы без элементов управления организации.
4073
4074Проблема схемы в парсируемом документе не создаёт эту ошибку. [Find entries Claude Code dropped](/docs/ru/managed-settings#find-entries-claude-code-dropped) охватывает то, что Claude Code делает с одной.
4075
4076Когда каталог `managed-settings.d/` существует, но не может быть перечислен, Claude Code сообщает `Managed settings drop-in directory could not be read:` с последующей базовой ошибкой вместо этого. [Find entries Claude Code dropped](/docs/ru/managed-settings#find-entries-claude-code-dropped) охватывает, когда отказ при чтении выходит при запуске.
4077
4078**Что делать:**
4079
4080* Если вы администрируете машину, исправьте названный документ так, чтобы он анализировался как объект JSON, или удалите файл, профиль или значение реестра. Пустой `managed-settings.json` считается `{}` и не блокирует запуск.
4081* Если нет, попросите вашего администратора исправить развёрнутый документ. Ничто в ваших собственных файлах параметров не вызывает и не очищает эту ошибку.
4082
4083<h3 id="headershelper-not-run">
4084 headersHelper not run
4085</h3>
4086
4087Claude Code подключил MCP сервер с его статическими `headers` только и пропустил [`headersHelper`](/docs/ru/mcp#use-dynamic-headers-for-custom-authentication) сервера, потому что помощник является shell командой и папка не имеет сохранённого доверия. Папка получает сохранённое доверие, когда вы устанавливаете её запись в `~/.claude.json` вручную или, вне вашего домашнего каталога, когда вы принимаете диалог доверия для неё в интерактивном сеансе. См. [Trust a folder before its headersHelper runs](/docs/ru/mcp#trust-a-folder-before-its-headershelper-runs) для того, какие серверы применяется эта проверка.
4088
4089Claude Code записывает эту строку в [non-interactive mode](/docs/ru/headless) только, один раз на сервер. В интерактивном сеансе он записывает тот же отказ в журнал отладки вместо этого.
1280 4090
1281```text theme={null}4091```text theme={null}
1282headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).4092MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.
1283```4093```
1284 4094
4095Ключ `projects`, который выводит сообщение, является папкой, на которой [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust) говорит Claude Code ключи доверия. Принятие диалога доверия для родительской папки не удовлетворяет проверку, и сеанс `-p` или SDK не удовлетворяет её либо.
4096
1285**Что делать:**4097**Что делать:**
1286 4098
1287* Для хука добавьте массив `args`, чтобы он выполнялся в [exec форме](/docs/ru/hooks#exec-form-and-shell-form), где каждый `${user_config.KEY}` становится одним аргументом без оболочки между ними. Или удалите ссылку и прочитайте переменную окружения `$CLAUDE_PLUGIN_OPTION_<KEY>` внутри скрипта4099* Выполните `claude` в папке, которую называет сообщение, примите диалог доверия, затем выполните вашу команду `-p` или SDK снова
1288* Для monitor удалите ссылку и пусть скрипт monitor прочитает значение из файла конфигурации4100* Установите запись `hasTrustDialogAccepted` в `~/.claude.json` самостоятельно, используя точный ключ `projects`, который выводит сообщение
1289* Для `headersHelper` переместите `${user_config.KEY}` в поле `headers` сервера, которое не анализируется оболочкой, или прочитайте значение внутри скрипта помощника4101* Если вы запустили сеанс в вашем домашнем каталоге, работайте из каталога проекта, которому вы доверяете. Когда вы принимаете диалог доверия в вашем домашнем каталоге, Claude Code держит это доверие только для текущего сеанса.
1290 4102
1291<h2 id="tool-errors">4103<h3 id="malformed-tool-content-rule">
1292 Ошибки инструментов4104 Malformed Tool(content) rule
1293</h2>4105</h3>
1294 4106
1295Эти ошибки возникают, когда встроенные инструменты Claude отказывают во входных данных. Claude самостоятельно исправляет большинство ошибок инструментов; два приведённых ниже требуют изменений с вашей стороны, так как они происходят из определения подагента или правила разрешений, которыми вы управляете.4107[permission rule](/docs/ru/permissions#permission-rule-syntax) в одном из ваших файлов параметров не имеет формы `Tool` или `Tool(content)`, например потому что текст следует за закрывающей скобкой или одна из скобок отсутствует. Claude Code пропускает правило и перечисляет его в диалоге недействительных параметров при запуске интерактивного сеанса и в выводе [`claude doctor`](/docs/ru/debug-your-config#check-resolved-settings):
1296 4108
1297<h3 id="agent-would-be-spawned-with-zero-tools">4109```text theme={null}
1298 Agent would be spawned with zero tools4110Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal
4111```
4112
4113**Что делать:**
4114
4115* В файле параметров, указанном в сообщении, переписать правило так, чтобы оно заканчивалось на закрывающей скобке, например `Bash(ls *)` вместо `Bash(ls) x`
4116* Оставьте скобки внутри содержимого как они есть. Они буквальные, поэтому правило такое как `Edit(./Finance (2024)/**)` действительно без экранирования
4117
4118До версии 2.1.260 Claude Code сообщал о правиле с несовпадающими скобками как `Mismatched parentheses`.
4119
4120<h3 id="is-not-matched-by-file-permission-checks">
4121 Is not matched by file permission checks
1299</h3>4122</h3>
1300 4123
1301Ничего в [списке `tools` подагента](/docs/ru/sub-agents#supported-frontmatter-fields) не разрешилось в инструмент, поэтому Claude Code отказывается запускать подагента, а не запускать его без возможности действовать. Сообщение группирует записи по причине, по которой они не разрешились: неизвестный инструмент, инструмент, который недоступен подагентам, или распознанный, но не соответствующий ни одному инструменту в текущей сессии. Пропуск поля `tools` никогда не вызывает этот отказ. Шаблон сервера MCP, такой как `mcp__github__*`, не исключён: когда ни один подключённый инструмент не поступает с этого сервера, запуск отказывается с шаблоном в группе, которая ничего не совпала. До версии 2.1.208 подагент запускался без инструментов и возвращал пустой или запутанный результат.4124Claude Code обнаружил `Write`, `NotebookEdit`, `MultiEdit` или `Glob` [permission rule](/docs/ru/permissions#read-and-edit) с путём в одном из ваших [settings files](/docs/ru/settings#where-settings-live), в [managed settings](/docs/ru/managed-settings) или в значении флага `--allowedTools`, `--disallowedTools` или `--settings`. Он проверяет разрешения файлов только против правил `Edit` и `Read`, поэтому он никогда не консультирует правило пути, которое называет один из других инструментов файлов. Он сохраняет правило и ничего больше не меняет; предупреждение называет правило, его источник в скобках и замену для записи:
1302 4125
1303```text theme={null}4126```text theme={null}
1304Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.4127Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).
1305```4128```
1306 4129
1307**Что делать:**4130**Что делать:**
1308 4131
1309* Исправьте каждую запись, которую ошибка называет, в соответствии с [инструментами, доступными подагентам](/docs/ru/sub-agents#available-tools)4132* Замените `Write(path)`, `NotebookEdit(path)` и устаревшие `MultiEdit(path)` правила на `Edit(path)`. Правила `Edit` охватывают все инструменты редактирования файлов.
1310* Удалите записи для инструментов, которые сессия не имеет, такие как инструменты MCP с сервера, который не подключён4133* Кроме как в `--allowedTools`, где Claude Code принимает правило `Glob` без предупреждения, замените правила `Glob(path)` на `Read(path)`.
1311* Чтобы дать подагенту каждый инструмент, который есть у родителя, удалите поле `tools` вместо перечисления инструментов4134* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг для `--allowed-tools` и `--disallowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.
4135* Оставьте простые правила имён инструментов такие как `Write` или `Glob` в покое. Claude Code соответствует им на [tool level](/docs/ru/permissions#match-all-uses-of-a-tool) и не предупреждает о них.
4136* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.
1312 4137
1313<h3 id="file-is-covered-by-a-read-deny-rule">4138В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr, поэтому вывод, читаемый машиной, остаётся чистым. Выполните с `--debug` для захвата его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.210 Claude Code принимал эти правила без предупреждения.
1314 File is covered by a Read deny rule4139
4140<h3 id="has-a-wildcard-before-the-rest-of-the-command">
4141 Has a wildcard before the rest of the command
1315</h3>4142</h3>
1316 4143
1317Инструмент Edit был вызван на пути, соответствующем [правилу отказа `Read`](/docs/ru/permissions#read-and-edit), включая создание нового файла по этому пути. Редактирование переписывает содержимое, которое Claude должен иметь возможность прочитать обратно, поэтому вызов отказывается до любого доступа к файлу. Правило блокирует только инструмент Edit: Write и NotebookEdit не охватываются правилами отказа `Read`. До версии 2.1.208 только правило отказа `Edit` блокировало редактирование, и правило отказа `Read` само по себе не блокировало.4144Claude Code обнаружил правило allow `Bash`, чей `*` приходит перед более поздним словом, которое определяет, какая это команда, например `Bash(git * main)` или `Bash(git -C * status *)`, в одном из ваших [settings files](/docs/ru/settings#where-settings-live), в [managed settings](/docs/ru/managed-settings) или в значении флага `--allowedTools` или `--settings`. `*` соответствует любому тексту, включая опции, вставленные в этой позиции: `Bash(git * main)` также одобряет `git -c core.fsmonitor=<script> diff main`, где `-c` заставляет git запустить программу, которую называет команда. [Wildcard patterns](/docs/ru/permissions#wildcard-patterns) показывает правила соответствия.
4145
4146Предупреждение существует, чтобы вы могли сузить правило, чей подстановочный знак шире, чем вы предполагали. Claude Code сохраняет правило и ничего не меняет о том, как оно соответствует; предупреждение называет правило и его источник в скобках:
1318 4147
1319```text theme={null}4148```text theme={null}
1320File is covered by a Read deny rule in your permission settings and cannot be edited.4149Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).
1321```4150```
1322 4151
1323**Что делать:**4152**Что делать:**
1324 4153
1325* Если Claude должен иметь возможность редактировать файл, удалите или сузьте правило отказа `Read` в `/permissions` или в [параметрах](/docs/ru/settings#permission-settings)4154* Замените `*` перед подкомандой на точное значение, которое вы имеете в виду: `Bash(git checkout main)` вместо `Bash(git * main)`.
1326* Если файл должен остаться нетронутым, сохраните правило и добавьте правило отказа `Edit` для того же пути, чтобы инструменты Write и NotebookEdit также были заблокированы4155* Переместите каждый `*` после подкоманды: `Bash(git status *)` вместо `Bash(git -C * status *)`. Напишите одно правило на подкоманду, которую вы хотите разрешить.
4156* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг `--allowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.
4157* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.
1327 4158
1328<h2 id="background-session-errors">4159Claude Code не предупреждает о правилах deny и ask с той же формой: он отказывает или запрашивает дополнительные команды, которые они соответствуют, а не одобряет их. Он также не предупреждает о правилах, чья подкоманда приходит перед первым `*`, например `Bash(git commit *)`, или правилах, в которых ни одно слово, кроме опции, не следует за `*`, например `Bash(git *)`, или о правилах префикса `:*` такие как `Bash(git:*)`.
1329 Ошибки фоновой сессии
1330</h2>
1331 4160
1332[Фоновые сессии](/docs/ru/agent-view) работают без собственного интерактивного терминала, поэтому команды, которым он требуется, ведут себя там иначе. Эти сообщения появляются в стенограмме фоновой сессии в представлении агента или после присоединения.4161В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr, поэтому вывод, читаемый машиной, остаётся чистым. Выполните с `--debug` для захвата его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.246 Claude Code принимал эти правила без предупреждения.
1333 4162
1334<h3 id="commands-refused-in-a-background-session">4163<h3 id="crosssessioninbound-must-be-one-of-accept-hold-refuse">
1335 Команды, отклоненные в фоновой сессии4164 crossSessionInbound must be one of accept, hold, refuse
1336</h3>4165</h3>
1337 4166
1338Команды, которые открывают интерактивное диалоговое окно, отклоняются в фоновой сессии с сообщением, в котором указывается форма, которая там работает, или вам предлагается запустить команду из обычного терминала. `/install-github-app`, список параметров `/mcp` и действия аутентификации в меню сервера MCP все отклоняются таким образом. До версии 2.1.208 они открывали свое диалоговое окно внутри фоновой сессии.4167Файл параметров устанавливает [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) на значение, которое Claude Code не распознаёт, например опечатка `"reject"`. Второе предложение предупреждения зависит от того, какой файл содержит значение; в пользовательском, проектном, локальном или файле `--settings` оно читается:
1339В версии 2.1.208 только средство выбора `/model` также было отклонено в фоновой сессии, а `/upgrade` вывел URL обновления вместо открытия браузера.4168
4169```text theme={null}
4170"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.
4171```
4172
4173В [managed settings](/docs/ru/managed-settings) Claude Code рассматривает нераспознанное значение как `refuse`, наиболее ограничивающее значение, и предупреждение говорит, что сообщения между сеансами отклоняются до тех пор, пока администратор не исправит это. Для того, как hold объединяется со значениями в ваших других файлах параметров, см. [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound).
4174
4175**Что делать:**
4176
4177* Установите ключ на `"accept"`, `"hold"` или `"refuse"` или удалите его
4178* Когда предупреждение называет управляемые параметры, попросите администратора исправить значение
1340 4179
1341Формулировка указывает команду, которая была отклонена. Список параметров `/mcp` сообщает:4180До версии 2.1.248 Claude Code игнорировал нераспознанное значение без предупреждения.
4181
4182<h3 id="the-200k-limit-isnt-enforced">
4183 The 200K limit isn't enforced
4184</h3>
4185
4186Вы установили [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ru/env-vars), что обычно заставляет [auto-compaction](/docs/ru/model-config#default-auto-compact-thresholds) держать сеансы на 1M-context моделях в окне 200K, но нет порога compaction, который ограничивает этот сеанс на или ниже 200K, поэтому беседа может расти за его пределы.
1342 4187
1343```text theme={null}4188```text theme={null}
1344Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.4189CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).
1345```4190```
1346 4191
4192Claude Code применяет лимит 200K самостоятельно для каждой модели, которую он распознаёт как имеющую собственное окно 1M, и для ID моделей, которые он не распознаёт, он compacts в окне, которое он предполагает. Предупреждение появляется, когда другая конфигурация побеждает это применение:
4193
4194* ID модели не является одним, который Claude Code распознаёт, например [LLM gateway](/docs/ru/llm-gateway) alias, и вы установили [`CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1`](/docs/ru/env-vars) или повысили предполагаемое окно выше 200K с [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](/docs/ru/env-vars). В этом случае сообщение также предлагает `or update to a Claude Code version that recognizes <model>` как средство.
4195* Beta `context-1m` запрошенный через [`ANTHROPIC_BETAS`](/docs/ru/env-vars) или флаг [`--betas`](/docs/ru/cli-reference#cli-flags) всё ещё запрашивает API для окна 1M на модели, которая принимает эту бету, в то время как ничего не compacts сеанс на 200K
4196
1347**Что делать:**4197**Что делать:**
1348 4198
1349* Используйте форму, указанную в сообщении, например `/mcp reconnect <server>`, `/mcp enable` или `/mcp disable`4199* Установите [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](/docs/ru/env-vars) или параметр [`autoCompactWindow`](/docs/ru/settings-reference#autocompactwindow) на `200000`, чтобы auto-compaction compacts на границе 200K
1350* Для потоков входа и авторизации запустите команду из обычной сессии `claude` в терминале4200* Если сообщение называет ID модели, который эта версия не распознаёт, выполните `claude update`. Версия, которая распознаёт ID как 1M-context модель, применяет лимит без дополнительной конфигурации.
4201* Если вы хотите, чтобы сеанс использовал полное окно модели вместо этого, отмените `CLAUDE_CODE_DISABLE_1M_CONTEXT`; предупреждение сообщает только, что лимит 200K не применяется
1351 4202
1352<h3 id="claude_code_process_wrapper-launcher-errors">4203В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr.
1353 Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER4204
4205<h3 id="unrecognized-model-id-on-a-request">
4206 Unrecognized model ID on a request
1354</h3>4207</h3>
1355 4208
1356[`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ru/corporate-launcher) установлен, и его значение невозможно использовать, поэтому Claude Code отказывается запускать затронутый процесс вместо того, чтобы запустить его без средства запуска. Проблемы конфигурации сообщаются сообщением, которое начинается с имени переменной и указывает причину, например:4209Claude Code отправил запрос для ID модели, который ваша версия Claude Code не распознаёт, и не нашёл запись [`modelOverrides`](/docs/ru/model-config#override-model-ids-per-version), которая отображает этот ID на модель, которую он распознаёт. Claude Code всё ещё отправляет запрос с ID, как вы его настроили, и не выходит и не переключает модели.
1357 4210
1358```text theme={null}4211```text theme={null}
1359CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file4212[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}
1360```4213```
1361 4214
1362Средство запуска, которое запускается, но завершается без замены себя на Claude Code, приводит к сбою сессии, которую оно запускало, и строка сессии в представлении агента сообщает, что средство запуска `must exec, not daemonize`, за которым следует все, что вывело средство запуска. Сессия, которая не может запуститься или достичь фоновой службы из-за средства запуска, сообщает о проблеме средства запуска как о причине внутри `Couldn't reach the background service (...)`.4215В скрипте или harness, который читает stderr, совпадайте с префиксом `[claude-code:unrecognized_model]`. После префикса и одного пробела Claude Code записывает однострочный объект JSON. Claude Code может добавлять поля к нему в более поздней версии, поэтому игнорируйте любое поле, которое вы не ожидаете. Он записывает по крайней мере эти два:
4216
4217* `model`: строка модели, как вы её настроили
4218* `query_source`: путь запроса, который использовал модель. Claude Code сообщает `sdk` для запуска `-p` и значение, которое начинается с `agent:` для subagent.
4219
4220Claude Code записывает строку в одно из двух мест, в зависимости от того, как вы его запускаете:
4221
4222* В [non-interactive mode](/docs/ru/headless) с `-p`, Claude Code записывает её в stderr под каждым `--output-format`, поэтому вы можете анализировать stdout без фильтрации строки
4223* В интерактивном сеансе или [background session](/docs/ru/agent-view), Claude Code записывает её в журнал отладки вместо этого; выполните с `--debug` для захвата её в `~/.claude/debug/<session-id>.txt`
4224
4225Claude Code записывает строку один раз на строку модели на процесс. Он записывает отдельную строку для каждого дополнительного нераспознанного ID, например одного, который [subagent](/docs/ru/sub-agents#choose-a-model) или [background functionality](/docs/ru/costs#background-token-usage) использует.
4226
4227Claude Code не записывает строку для ID поставщиков, которые он разрешает на модель, которую он распознаёт, например Amazon Bedrock `us.anthropic.claude-...` ID, ID Google Cloud's Agent Platform с суффиксом версии `@` и имена развёртывания Microsoft Foundry, которые содержат ID модели Claude. Claude Code проверяет модель позади Amazon Bedrock [application inference profile ARN](/docs/ru/amazon-bedrock#map-each-model-version-to-an-inference-profile) а не сам ARN. Он не записывает строку для ARN, который он не может разрешить, например неправильно введённый.
1363 4228
1364**Что делать:**4229**Что делать:**
1365 4230
1366* Установите переменную на абсолютный путь исполняемого файла, который заканчивается вызовом `exec "$@"`. Полный контракт см. в разделе [контракт средства запуска](/docs/ru/corporate-launcher#the-launcher-contract)4231* Если вы установили ID намеренно, например [LLM gateway](/docs/ru/llm-gateway) alias, добавьте запись [`modelOverrides`](/docs/ru/model-config#override-model-ids-per-version) в ваш [settings file](/docs/ru/settings#where-settings-live) с ID как его значение. Используйте ID модели Anthropic как ключ, а не семейный alias такой как `opus`. Для `my-proxy-model` из примера строки добавьте эту запись:
1367* Проверьте `/status`, который показывает разрешенную команду запуска в записи Self-exec и предупреждает, когда работающая фоновая служба не совпадает с ней, или запустите `claude daemon status` из оболочки
1368* После исправления значения в блоке `env` [параметров](/docs/ru/corporate-launcher#set-up-the-launcher) перезагрузите фоновую службу с помощью `claude daemon stop --any`, чтобы следующая отправка запустила завернутую
1369 4232
1370<h2 id="configuration-warnings">4233 ```json theme={null}
1371 Предупреждения о конфигурации4234 {
1372</h2>4235 "modelOverrides": {
4236 "claude-opus-4-6": "my-proxy-model"
4237 }
4238 }
4239 ```
1373 4240
1374Claude Code выводит эти сообщения в stderr при запуске, а не показывает ошибку в диалоговом окне. Они сообщают о конфигурации, которую он прочитал, но не применил.4241 Claude Code затем рассматривает `my-proxy-model` как `claude-opus-4-6` и прекращает записывать строку.
1375 4242
1376<h3 id="workspace-has-not-been-trusted">4243* Если ID называет модель новее, чем ваша версия Claude Code, выполните `claude update`
1377 Рабочее пространство не было доверено4244
4245* Если ID является опечаткой, исправьте его в любом из [places you can set a model](/docs/ru/model-config#setting-your-model) или [alias variables](/docs/ru/model-config#environment-variables), который его содержит. Если `query_source` начинается с `agent:`, исправьте его там, где вы устанавливаете [subagent's model](/docs/ru/sub-agents#choose-a-model) вместо этого.
4246
4247До версии 2.1.233 Claude Code не записывал строку, когда отправлял запрос для ID модели, который он не распознавал.
4248
4249<h3 id="stale-sandbox-mask-files-left-by-a-killed-session">
4250 Stale sandbox mask files left by a killed session
1378</h3>4251</h3>
1379 4252
1380Claude Code обнаружил правила `permissions.allow` или записи `permissions.additionalDirectories` в файле `.claude/settings.json` или `.claude/settings.local.json` проекта и не применил их, потому что [правила разрешения из параметров проекта требуют доверия рабочему пространству](/docs/ru/permissions#project-allow-rules-and-workspace-trust). Количество, имя параметра и имя файла в сообщении варьируются в зависимости от вашей конфигурации. На правила `deny` и `ask` это не влияет.4253`claude doctor` выводит это предупреждение в своей диагностике, и `/status` перечисляет ту же строку. Оно появляется на Linux и WSL2, когда [sandboxing](/docs/ru/sandboxing) включена с изоляцией файловой системы.
4254
4255Пока выполняется sandboxed команда, sandbox держит отказ в записи на файл, который ещё не существует, создавая 0-байтовый заполнитель только для чтения там, и удаляет его впоследствии. Сеанс, убитый перед тем, как эта очистка запустится, например SIGKILL, оставляет заполнители позади. Более поздние сеансы привязывают их только для чтения снова при каждом запуске, поэтому запись параметров такая как сохранение "Yes, and don't ask again" не удаётся там, где она сидит.
1381 4256
1382```text theme={null}4257```text theme={null}
1383Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.4258- Stale sandbox mask files left by a killed session: /home/you/project/.claude/settings.local.json
4259 Fix: Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start
1384```4260```
1385 4261
1386**Что делать:**4262**Что делать:**
1387 4263
1388* Запустите `claude` в каталоге и примите диалоговое окно доверия. Диалоговое окно появляется даже если родительский каталог уже доверен, отображает удерживаемые правила и позволяет вам отклонить их и продолжить работу без них. До версии 2.1.200 диалоговое окно не появлялось в этой ситуации, поэтому этот шаг не мог быть завершен там.4264* Выйдите из любого другого сеанса Claude Code, работающего в этом проекте, затем удалите каждый перечисленный файл с `rm`. Предупреждение называет до трёх файлов и считает остальное, поэтому переустановите `claude doctor` после удаления до тех пор, пока предупреждение больше не появляется. Заполнитель, который sandbox другого сеанса всё ещё использует, является живой частью защиты от записи этого сеанса
1389* В [неинтерактивном режиме](/docs/ru/headless) с флагом `-p` диалоговое окно не отображается. Установите запись `hasTrustDialogAccepted` в `~/.claude.json`, используя точный ключ `projects`, который выводит сообщение.4265* Если выбор разрешения, который вы сохранили с "Yes, and don't ask again" не прижился, сохраните его снова после удаления заполнителя
1390* Если сообщение указывает на `.claude/settings.local.json` и вы запустили Claude Code вне репозитория git или в вашем домашнем каталоге, обновитесь до версии 2.1.200 или более поздней. Версии 2.1.196 по 2.1.199 рассматривали ваш собственный `.claude/settings.local.json` как предоставленный репозиторием в этих рабочих пространствах. На версии 2.1.207 и более поздних обновление недостаточно вне репозитория git, если вы не доверили папке: определение того, что папка находится вне репозитория, запускает git, и Claude Code запускает эту проверку только после того, как вы примете диалоговое окно доверия, поэтому используйте первый шаг. Ваш домашний каталог и любой другой [домашний каталог конфигурации](/docs/ru/permissions#project-allow-rules-and-workspace-trust) исключены и не ждут диалогового окна. См. [Правила разрешения проекта и доверие рабочему пространству](/docs/ru/permissions#project-allow-rules-and-workspace-trust).4266
4267До версии 2.1.257 `claude doctor` не отмечал эти файлы; более ранние версии оставляют те же заполнители позади, когда сеанс убивается.
1391 4268
1392<h2 id="responses-seem-lower-quality-than-usual">4269<h2 id="responses-seem-lower-quality-than-usual">
1393 Ответы кажутся менее качественными, чем обычно4270 Ответы кажутся ниже обычного качества
1394</h2>4271</h2>
1395 4272
1396Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно заключается в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:4273Если ответы Claude кажутся менее способными, чем вы ожидаете, но ошибка не отображается, причина обычно в состоянии разговора, а не в самой модели. Claude Code не молча меняет версии модели. Он может переключиться на резервную модель в трёх конкретных случаях:
1397 4274
1398* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке4275* Настроенный [`--fallback-model`](/docs/ru/cli-reference#cli-flags) берёт на себя управление после ошибки доступности только для этого хода с уведомлением в расшифровке
1399* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна4276* Проверка запуска Amazon Bedrock или Google Cloud's Agent Platform обнаруживает, что ваша модель по умолчанию недоступна
1400* [Автоматический fallback модели](/docs/ru/model-config#automatic-model-fallback) на Fable 5 переводит сеанс на модель Opus по умолчанию и показывает уведомление в расшифровке4277* [Автоматический переход на резервную модель](/docs/ru/model-config#automatic-model-fallback) на Fable 5.1, Fable 5 и Opus 5 переводит сеанс на резервную модель категории с флагом, когда у этой категории она есть, и показывает уведомление в расшифровке
1401 4278
1402Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый fallback.4279Проверка выбора модели ниже ловит второй и третий случаи; первый появляется как уведомление в расшифровке, а не как изменение `/model`. [Конфигурация модели](/docs/ru/model-config) объясняет, когда применяется каждый переход на резервную модель.
1403 4280
1404Сначала проверьте следующее:4281Сначала проверьте следующее:
1405 4282
1406* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.4283* **Выбор модели**: запустите `/model`, чтобы подтвердить, что вы используете ожидаемую модель. Предыдущий выбор `/model` или переменная окружения `ANTHROPIC_MODEL` могут привести вас к меньшей модели, чем вы предполагали.
1407* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или работы над дизайном. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Adjust effort level](/docs/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.4284* **Уровень усилий**: запустите `/effort`, чтобы проверить текущий уровень рассуждений и повысить его для сложной отладки или проектной работы. Значения по умолчанию варьируются в зависимости от модели, поэтому проверьте перед тем, как предполагать, что вы ниже максимума. См. [Отрегулируйте уровень усилий](/docs/ru/model-config#adjust-effort-level) для значений по умолчанию для каждой модели и сокращение `ultrathink`.
1408* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Explore the context window](/docs/ru/context-window) для того, как auto-compact влияет на предыдущие ходы.4285* **Давление контекста**: запустите `/context`, чтобы увидеть, насколько заполнено окно. Если оно близко к ёмкости, запустите `/compact` в естественной точке разрыва или `/clear`, чтобы начать заново. См. [Изучите окно контекста](/docs/ru/context-window), чтобы узнать, как auto-compact влияет на предыдущие ходы.
1409* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии 2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.4286* **Устаревшие инструкции**: большие или устаревшие файлы `CLAUDE.md` и определения инструментов MCP потребляют контекст и могут направлять ответы. Проверка `/doctor` отмечает файлы памяти большого размера и неиспользуемые расширения, а `/context` показывает использование токенов инструментов MCP. До версии 2.1.205 `/doctor` открывал экран диагностики, который отмечал файлы памяти большого размера и определения подагентов.
1410 4287
1411Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Checkpointing](/docs/ru/checkpointing).4288Когда ответ идёт неправильно, откат обычно работает лучше, чем ответ с исправлениями. Нажмите Esc дважды или запустите `/rewind`, чтобы вернуться к моменту перед неправильным ходом, затем переформулируйте подсказку с большей конкретикой. Исправление в потоке сохраняет неправильную попытку в контексте, что может привязать более поздние ответы к ней. См. [Контрольные точки](/docs/ru/checkpointing).
1412 4289
1413Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Report an error](#report-an-error), если `/feedback` недоступен в вашей среде.4290Если качество всё ещё кажется неправильным после проверки вышеуказанного, запустите `/feedback` и опишите, что вы ожидали в сравнении с тем, что вы получили. Обратная связь, отправленная таким образом, включает расшифровку разговора, что является самым быстрым способом для Anthropic диагностировать реальную регрессию. См. [Сообщить об ошибке](#report-an-error), если `/feedback` недоступен в вашей среде.
1414 4291
1415Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет в разговор автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.4292Если Claude предупреждает о подозреваемой инъекции подсказки или отказывает в запросе из-за подозреваемой инъекции, и текст, который называет предупреждение, — это контекст, который Claude Code добавляет к разговору автоматически, а не содержимое файла или веб-сайта, запустите `claude update` и повторите попытку. Если предупреждение повторяется после обновления, [сообщите об этом](#report-an-error) вместо того, чтобы вставлять отмеченное содержимое обратно в подсказку. До версии 2.1.201 Sonnet 5 отказывал в некоторых запросах таким же образом.
1416 4293
1417<h2 id="report-an-error">4294<h2 id="report-an-error">
1418 Сообщить об ошибке4295 Сообщить об ошибке
