83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |83| `Your account does not have access to Claude. Please login again or contact your administrator.` | [Authentication](#oauth-token-revoked-or-expired) |
84| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |84| `API Error: 401 Invalid authentication credentials` | [Authentication](#api-error-401-invalid-authentication-credentials) |
85| `Login expired · Please run /login` | [Authentication](#login-expired) |85| `Login expired · Please run /login` | [Authentication](#login-expired) |
86| `The browser can't return the sign-in to Claude Code automatically` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
87| `Couldn't start the local listener that receives the browser sign-in. Try again.` | [Authentication](#couldnt-start-the-local-sign-in-listener) |
86| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |88| `Failed to start OAuth callback server` | [Authentication](#failed-to-start-oauth-callback-server) |
87| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |89| `Claude login not accepted · Run /login, then try again` | [Authentication](#claude-login-not-accepted) |
88| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |90| `Artifacts need a claude.ai login` | [Authentication](#artifacts-need-a-claude-ai-login) |
100| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |102| `claude.ai rejected the session token` / `session token rejected` | [Authentication](#claude-ai-rejected-the-session-token) |
101| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |103| `MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
102| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |104| `rejected the credential from its headersHelper` / `rejected the Authorization header in its config` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
105| `(check the helper, then start a new task or chat)` / `(update it, then start a new task or chat)` | [Authentication](#mcp-credential-rejected-in-cowork) |
103| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |106| `MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
104| `MCP server "<name>" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |107| `MCP server "<name>" requires re-authorization (token expired)` | [Authentication](#mcp-server-needs-you-to-sign-in-again) |
105| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |108| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentication](#mcp-server-url-is-missing-or-not-a-valid-url) |
200| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#installation-was-killed-before-it-could-finish) |203| `Installation was killed before it could finish (exit code 137)` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#installation-was-killed-before-it-could-finish) |
201| `The connection dropped while downloading the update` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |204| `The connection dropped while downloading the update` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |
202| `Download timed out: exceeded the total deadline` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |205| `Download timed out: exceeded the total deadline` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#the-connection-dropped-while-downloading-the-update) |
206| `Release verification failed for Claude Code <version> (<reason>). The update was not installed.` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#release-verification-failed) |
207| `Auto-update failed · Run claude doctor` | [Troubleshoot installation and login](/docs/ru/troubleshoot-install#auto-update-failed) |
203| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |208| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
204| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Command-line errors](#couldnt-tell-whether-bg-is-a-flag-or-text) |209| `Couldn't tell whether --bg is a flag or text here, so nothing was started` | [Command-line errors](#couldnt-tell-whether-bg-is-a-flag-or-text) |
205| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |210| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |
270| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |275| `Custom output styles can't be selected over Remote Control or from a relayed message` | [Command-line errors](#custom-output-styles-cant-be-selected-over-remote-control) |
271| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |276| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [Command-line errors](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |
272| `/recap only runs when you ask for it yourself in this session` | [Command-line errors](#recap-only-runs-when-you-ask-for-it-yourself) |277| `/recap only runs when you ask for it yourself in this session` | [Command-line errors](#recap-only-runs-when-you-ask-for-it-yourself) |
278| `/feedback is disabled by your organization's policy` или то же сообщение для `/bug` или `/share` | [Command-line errors](#feedback-is-disabled-by-your-organizations-policy) |
273| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |279| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [Plugin errors](#plugin-eval-is-currently-in-early-access) |
274| `cannot be evaluated where sessions load it` | [Test plugins with evals](/docs/ru/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |280| `cannot be evaluated where sessions load it` | [Test plugins with evals](/docs/ru/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |
275| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |281| `Marketplace "<name>" is registered from an untrusted source` | [Plugin errors](#marketplace-is-registered-from-an-untrusted-source) |
289| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin troubleshooting](/docs/ru/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |295| `The packages it lists are not installed` / `The packages it lists were not installed, because` | [Plugin troubleshooting](/docs/ru/plugins/troubleshooting#the-packages-it-lists-are-not-installed) |
290| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](/docs/ru/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |296| `does not load (...), so Claude Code ignores the whole file` | [Plugin troubleshooting](/docs/ru/plugins/troubleshooting#does-not-load-so-claude-code-ignores-the-whole-file) |
291| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |297| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
298| `Plugin not loaded: its manifest <path> was not read` | [Plugin errors](#plugin-not-loaded-its-manifest-was-not-read) |
292| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |299| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
293| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |300| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
294| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |301| `Plugin source path refused` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
304| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |311| `File is covered by a Read deny rule in your permission settings` | [Tool errors](#file-is-covered-by-a-read-deny-rule) |
305| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |312| `cannot contain null bytes (\0)` | [Tool errors](#path-cannot-contain-null-bytes) |
306| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |313| `Path contains null bytes` | [Tool errors](#path-cannot-contain-null-bytes) |
314| `File is too large to read as an image (the limit is 128MB)` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
315| `Cannot read this as an image: <path> is a pipe or a device` | [Tool errors](#file-is-too-large-to-read-as-an-image) |
307| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |316| `subagent_type is required: the general-purpose agent is not available in this session` | [Tool errors](#subagent-type-is-required) |
308| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |317| `Error: this write left the memory index at MEMORY.md at ..., over its ... read limit` | [Tool errors](#memory-index-is-over-its-read-limit) |
309| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |318| `pkill: refusing to run` | [Tool errors](#pkill-pattern-matches-the-claude-code-process) |
310| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |319| `Failed to write to <name>'s inbox — nothing was sent` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
311| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |320| `Failed to write the plan approval request to the lead's inbox — plan not submitted` | [Tool errors](#failed-to-write-to-a-teammate-inbox) |
312| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |321| `Its agent definition was not restored: the folder its definition file came from is not trusted` | [Tool errors](#teammate-agent-definition-not-restored) |
322| `Only a teammate can approve a shutdown request` | [Tool errors](#only-a-teammate-can-approve-a-shutdown-request) |
313| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |323| `Message too large for cross-session delivery` | [Tool errors](#message-too-large-for-cross-session-delivery) |
314| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |324| `Too many messages to this session just now` | [Tool errors](#too-many-messages-to-this-session-just-now) |
315| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |325| `Cross-session message was dropped at the recipient session's inbox` | [Tool errors](#cross-session-message-dropped-at-the-inbox) |
325| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |335| `Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
326| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |336| `The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
327| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |337| `Command output was lost: the temp filesystem at <dir> is full` / `is out of inodes` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
338| `The command was not started: this computer's disk is full (ENOSPC)` / `(EDQUOT)` | [Tool errors](#disk-quota-or-temp-filesystem-is-full) |
328| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Tool errors](#file-is-not-valid-utf-8) |339| `File is not valid UTF-8. It may use a legacy encoding such as Windows-1252, Shift-JIS or GBK, or be binary` | [Tool errors](#file-is-not-valid-utf-8) |
329| `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) |340| `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) |
330| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |341| `the source file has the replacement character U+FFFD` | [Tool errors](#the-source-file-is-not-valid-utf-8-text) |
331| `Not published: that file is on a network share` | [Tool errors](#not-published-that-file-is-on-a-network-share) |342| `Not published: that file is on a network share` | [Tool errors](#not-published-that-file-is-on-a-network-share) |
343| `Not published: Claude sent the same content again after a newer version of the artifact turned it away` / `Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away` | [Tool errors](#not-published-a-newer-version-of-the-artifact-turned-it-away) |
332| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |344| `Reading a local file from outside this session's connected folders, or through a link, needs the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
333| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |345| `cannot read file_path (...) — the file could not be examined, and no one can answer the approval card` | [Tool errors](#reading-a-local-file-from-outside-the-connected-folders) |
334| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |346| `WebFetch cannot fetch localhost or other hostnames without a dot` | [Tool errors](#webfetch-cannot-fetch-localhost) |
345| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |357| `Can't open — this session is running in another terminal` | [Background session errors](#this-session-is-running-in-another-terminal) |
346| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |358| `This conversation is already open in another running Claude session` | [Background session errors](#this-session-is-running-in-another-terminal) |
347| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |359| `This session's saved conversation is no longer on disk` | [Background session errors](#this-sessions-saved-conversation-is-no-longer-on-disk) |
348| `Bypass permissions was requested at launch and ignored` | [Пропуск всех проверок в режиме bypassPermissions](/docs/ru/permission-modes#bypass-permissions-acceptance) |360| `Bypass permissions was requested at launch and ignored` | [Режим bypassPermissions игнорируется в фоновой сессии](/docs/ru/permission-modes#bypass-permissions-ignored-in-a-background-session) |
349| `kept <id> — its worktree is still at <path>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |361| `kept <id> — its worktree is still at <path>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
350| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |362| `kept <id> — <n> unpushed commits on <branch>` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
351| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |363| `kept <id> — worktree has commits that are not pushed anywhere` | [Background session errors](#worktree-has-commits-that-are-not-pushed-anywhere) |
354| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |366| `Session <id> was stopped while the respawn was in flight` | [Background session errors](#session-was-stopped-while-the-respawn-was-in-flight) |
355| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |367| `This session was running agent '<name>', which is no longer available` | [Background session errors](#session-agent-no-longer-available) |
356| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Background session errors](#restarted-after-its-next-loop-wakeup-was-due) |368| `This session restarted <time> after its next /loop wakeup was due, so that wakeup will not fire` | [Background session errors](#restarted-after-its-next-loop-wakeup-was-due) |
369| `No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder` | [Background session errors](#no-llm-gateway-opened-from-another-folder) |
370| `No LLM gateway: opened from another folder · respawn from <folder>` | [Background session errors](#no-llm-gateway-opened-from-another-folder) |
357| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |371| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Background session errors](#claude_code_process_wrapper-launcher-errors) |
358| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |372| `EUNKNOWN: unknown error, uv_spawn` | [Background session errors](#eunknown-when-starting-a-background-session) |
359| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |373| `EACCES: permission denied, posix_spawn` | [Background session errors](#eacces-when-starting-a-background-session) |
394| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Configuration warnings](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |408| `API Error: ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name` | [Configuration warnings](#anthropic-foundry-resource-must-be-a-foundry-resource-name) |
395| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |409| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |
396| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |410| `Invalid permission rule "..." was skipped: Malformed Tool(content) rule` | [Configuration warnings](#malformed-tool-content-rule) |
411| `matches no tool · check for typos` / `matches no known tool — check for typos` | [Configuration warnings](#matches-no-tool) |
397| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |412| `... is not matched by file permission checks` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
413| `Write(<path>) never matches · use Edit(<path>)` / `Glob(<path>) never matches · use Read(<path>)` | [Configuration warnings](#is-not-matched-by-file-permission-checks) |
398| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |414| `... has a wildcard before the rest of the command` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
415| `allows any option at its * · use an exact value` | [Configuration warnings](#has-a-wildcard-before-the-rest-of-the-command) |
399| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |416| `Denying Bash also turns off the PowerShell tool, so Claude has neither` | [Configuration warnings](#denying-bash-also-turns-off-the-powershell-tool) |
400| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |417| `CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced` | [Configuration warnings](#the-200k-limit-isnt-enforced) |
418| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" reads as <N> tokens, so Claude Code treats it as the 100k minimum` | [Значения и предупреждения для `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/model-config#claude_code_auto_compact_window-values) |
419| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" is too large, so Claude Code treats it as the 1M maximum` | [Значения и предупреждения для `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/model-config#claude_code_auto_compact_window-values) |
420| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Значения и предупреждения для `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/ru/model-config#claude_code_auto_compact_window-values) |
401| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |421| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |
402| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |422| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Correct the window for a gateway or custom model ID](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id) |
403| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |423| `[claude-code:unrecognized_model]` | [Configuration warnings](#unrecognized-model-id-on-a-request) |
462| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество повторных попыток. Ограничено 15 начиная с v2.1.186; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |482| [`CLAUDE_CODE_MAX_RETRIES`](/docs/ru/env-vars) | 10 | Количество повторных попыток. Ограничено 15 начиная с v2.1.186; начиная с v2.1.199 `CLAUDE_CODE_RETRY_WATCHDOG` повышает значение по умолчанию и удаляет ограничение. Снизьте его, чтобы быстрее выявлять сбои в скриптах. |
463| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сессиях, таких как задания CI, чтобы повторять ошибки пропускной способности `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже если это `429` от [gateway spend cap](#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 сторож повторял такие запросы бесконечно. Для запросов в быстром режиме см. [Handle rate limits](/docs/ru/fast-mode#handle-rate-limits). На v2.1.199 или позже он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |483| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ru/env-vars) | не установлено | Установите значение `1` в автоматических сессиях, таких как задания CI, чтобы повторять ошибки пропускной способности `429` и `529` бесконечно вместо отказа после `CLAUDE_CODE_MAX_RETRIES` попыток. Claude Code сразу завершается с ошибкой, когда запрос со стандартной скоростью получает `429`, который сообщает о лимите расходов или исчерпанных кредитах использования, даже если это `429` от [gateway spend cap](#spend-limit-reached), который сбрасывается по расписанию. До v2.1.239 сторож повторял такие запросы бесконечно. Для запросов в быстром режиме см. [Handle rate limits](/docs/ru/fast-mode#handle-rate-limits). На v2.1.199 или позже он также повышает количество повторных попыток по умолчанию для других временных ошибок, таких как ошибки сервера, таймауты и разорванные соединения, до 300, примерно три часа задержки, и удаляет ограничение 15 на `CLAUDE_CODE_MAX_RETRIES`, если вы явно установите эту переменную. |
464| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ru/env-vars) | не установлено | Максимальное время в миллисекундах, которое каждый запрос к API тратит на ожидание при ошибках `429` и `529`, когда установлена `CLAUDE_CODE_RETRY_WATCHDOG`. Если переменная не установлена, время ожидания не ограничено. Требуется Claude Code v2.1.295 или позже. |484| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ru/env-vars) | не установлено | Максимальное время в миллисекундах, которое каждый запрос к API тратит на ожидание при ошибках `429` и `529`, когда установлена `CLAUDE_CODE_RETRY_WATCHDOG`. Если переменная не установлена, время ожидания не ограничено. Требуется Claude Code v2.1.295 или позже. |
485| [`CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS`](/docs/ru/env-vars) | не установлено | Минимальный интервал в миллисекундах между проверками того, не был ли [лимит использования](#youve-hit-your-session-limit) уже снят, пока запрос ожидает сброса этого лимита при установленной `CLAUDE_CODE_RETRY_WATCHDOG`. Когда проверка обнаруживает, что лимит снят, запрос отправляется сразу. Укажите значение только цифрами, от `60000` до `10800000`. Если переменная не установлена или значение выходит за пределы этого диапазона, проверки не выполняются. О том, когда Claude Code пропускает эти проверки, см. [справочник по переменным окружения](/docs/ru/env-vars). Требуется Claude Code v2.1.305 или позже. |
465| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ru/env-vars) | 500 | Начальная задержка в миллисекундах для экспоненциальной задержки между повторными попытками запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте её, вплоть до 32000, чтобы распределить повторные попытки на более длительный период, когда API работает на пределе пропускной способности. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.292 или позже. |486| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ru/env-vars) | 500 | Начальная задержка в миллисекундах для экспоненциальной задержки между повторными попытками запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте её, вплоть до 32000, чтобы распределить повторные попытки на более длительный период, когда API работает на пределе пропускной способности. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.292 или позже. |
466| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ru/env-vars) | 32000 | Верхний предел в миллисекундах для экспоненциальной задержки между повторными попытками запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте его, вплоть до 64000, чтобы последующие повторные попытки продолжали всё сильнее разноситься во времени, когда API работает на пределе пропускной способности. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.296 или позже. |487| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ru/env-vars) | 32000 | Верхний предел в миллисекундах для экспоненциальной задержки между повторными попытками запроса, который API отклоняет с ошибкой перегрузки `529`. Увеличьте его, вплоть до 64000, чтобы последующие повторные попытки продолжали всё сильнее разноситься во времени, когда API работает на пределе пропускной способности. Не действует, если `CLAUDE_CODE_RETRY_WATCHDOG` установлена в `1` или если отклонённый запрос был отправлен в [быстром режиме](/docs/ru/fast-mode#handle-rate-limits). Требуется Claude Code v2.1.296 или позже. |
467| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Время в миллисекундах, за которое каждая попытка запроса должна получить заголовки ответа. Оно не ограничивает, как долго после этого длится потоковый ответ. Повысьте его для медленных сетей или прокси. О том, как оно ограничивает дедлайн первого байта, см. [No response from API](#no-response-from-api). |488| [`API_TIMEOUT_MS`](/docs/ru/env-vars) | 600000 | Время в миллисекундах, за которое каждая попытка запроса должна получить заголовки ответа. Оно не ограничивает, как долго после этого длится потоковый ответ. Повысьте его для медленных сетей или прокси. О том, как оно ограничивает дедлайн первого байта, см. [No response from API](#no-response-from-api). |
490 511
491* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет активных инцидентов512* Проверьте [status.claude.com](https://status.claude.com) или страницу статуса поставщика, указанную в сообщении, на предмет активных инцидентов
492* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в диалоге, поэтому для длинного промпта вы можете ввести `try again` вместо вставки всего текста.513* Подождите минуту, затем отправьте сообщение еще раз. Ваше исходное сообщение все еще находится в диалоге, поэтому для длинного промпта вы можете ввести `try again` вместо вставки всего текста.
514* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM-шлюз](/docs/ru/llm-gateway) и каждый запрос завершается такой ошибкой, проверьте, не отклоняет ли ваш шлюз поля поиска инструментов, которые Claude Code отправляет по умолчанию. Для проверки установите `ENABLE_TOOL_SEARCH=false`, как описано в разделе [Поиск инструментов через LLM-шлюз](/docs/ru/mcp#tool-search-through-a-gateway), затем повторите попытку. До v2.1.304 поиск инструментов за шлюзом был отключен, если вы не включали его с помощью `ENABLE_TOOL_SEARCH`.
493* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла расследовать проблему с деталями вашего запроса. См. [Сообщить об ошибке](#report-an-error), если `/feedback` недоступен в вашей среде.515* Если ошибка сохраняется без опубликованного инцидента, запустите `/feedback`, чтобы Anthropic могла расследовать проблему с деталями вашего запроса. См. [Сообщить об ошибке](#report-an-error), если `/feedback` недоступен в вашей среде.
494 516
495### API Error: Repeated 529 Overloaded errors517### API Error: Repeated 529 Overloaded errors
520Request timed out542Request timed out
521```543```
522 544
523Таймаут запроса по умолчанию составляет 10 минут.545Таймаут запроса по умолчанию составляет 10 минут. Если вы установите [`API_TIMEOUT_MS`](/docs/ru/env-vars) в значение `0`, этот таймаут запроса отключается. [Срок ожидания первого байта](#no-response-from-api) и таймаут простоя тела ответа не отключаются при значении `0`, поэтому потоковый запрос по-прежнему выполняется с учетом [тех из них, которые применяются к вашему соединению](/docs/ru/network-config#streaming-idle-watchdogs). Непотоковая попытка в локальной сессии сохраняет свой лимит в 300 секунд и по-прежнему может завершиться этим сообщением.
524 546
525**Что делать:**547**Что делать:**
526 548
549* Если каждый запрос завершается этим сообщением и вы установили `API_TIMEOUT_MS` в `0`, проверьте `claude --version`. В версии до v2.1.305 обновите Claude Code или задайте положительное значение.
527* Повторите запрос550* Повторите запрос
528* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в разделе [Автоматические повторные попытки](#automatic-retries)551* Если причина в медленной сети или прокси, увеличьте `API_TIMEOUT_MS`, как описано в разделе [Автоматические повторные попытки](#automatic-retries)
529* Если таймауты частые, а сеть в остальном работает нормально, см. [Ошибки сети и подключения](#network-and-connection-errors) ниже552* Если таймауты частые, а сеть в остальном работает нормально, см. [Ошибки сети и подключения](#network-and-connection-errors) ниже
541* **Первая попытка**: [`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 КБ тела запроса.564* **Первая попытка**: [`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 КБ тела запроса.
542* **Повторная попытка**: на одну секунду меньше `API_TIMEOUT_MS`, по умолчанию чуть менее 10 минут, чтобы повторная попытка могла дождаться прокси или шлюза, который удерживает ответ до завершения генерации. На Amazon Bedrock повторная попытка использует тот же срок, что и первая, и сообщение показывает одну длительность вместо двух.565* **Повторная попытка**: на одну секунду меньше `API_TIMEOUT_MS`, по умолчанию чуть менее 10 минут, чтобы повторная попытка могла дождаться прокси или шлюза, который удерживает ответ до завершения генерации. На Amazon Bedrock повторная попытка использует тот же срок, что и первая, и сообщение показывает одну длительность вместо двух.
543 566
567 За исключением Amazon Bedrock, если вы установите `API_TIMEOUT_MS` в `0`, повторная попытка ждет 10 минут плюс одну секунду на каждые 32 КБ либо столько же, сколько первая попытка, если это дольше.
568
544Ни одно ожидание не превышает положительное значение `API_TIMEOUT_MS` минус одна секунда, а положительное значение `API_TIMEOUT_MS` менее 11 секунд отключает этот срок. Байтовый watchdog запускается только после получения заголовков ответа, поэтому ответ, который после этого перестает отправлять байты, подчиняется [правилам для зависших потоков](#automatic-retries), а не этому сроку.569Ни одно ожидание не превышает положительное значение `API_TIMEOUT_MS` минус одна секунда, а положительное значение `API_TIMEOUT_MS` менее 11 секунд отключает этот срок. Байтовый watchdog запускается только после получения заголовков ответа, поэтому ответ, который после этого перестает отправлять байты, подчиняется [правилам для зависших потоков](#automatic-retries), а не этому сроку.
545 570
546**Что делать:**571**Что делать:**
845* Запустите `/status` и убедитесь, что активные учётные данные — те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может направлять запросы через ключ низкого уровня вместо вашей подписки.870* Запустите `/status` и убедитесь, что активные учётные данные — те, которые вы ожидаете. Случайный `ANTHROPIC_API_KEY` в вашей среде может направлять запросы через ключ низкого уровня вместо вашей подписки.
846* Проверьте в консоли вашего поставщика действующие лимиты и при необходимости запросите более высокий уровень871* Проверьте в консоли вашего поставщика действующие лимиты и при необходимости запросите более высокий уровень
847* Для API-ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits), чтобы узнать, как работают уровни и как установить ограничения для рабочего пространства872* Для API-ключей Anthropic см. [rate limits reference](https://platform.claude.com/docs/en/api/rate-limits), чтобы узнать, как работают уровни и как установить ограничения для рабочего пространства
848* Снизьте параллелизм: уменьшите [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/docs/ru/env-vars), избегайте запуска множества параллельных субагентов или переключитесь на меньшую модель с помощью `/model` для высокообъёмных скриптовых запусков873* Снизьте параллелизм: избегайте запуска множества параллельных субагентов или переключитесь на меньшую модель с помощью `/model` для высокообъёмных скриптовых запусков
849 874
850### You've hit your monthly spend limit875### You've hit your monthly spend limit
851 876
1267* Если `/status` показывает только ваш вход, запустите `/login` один раз. Если учётные данные были отозваны, новый вход заменит их.1292* Если `/status` показывает только ваш вход, запустите `/login` один раз. Если учётные данные были отозваны, новый вход заменит их.
1268* Если то же сообщение возвращается для той же учётной записи, учётная запись или организация больше не активна. Проверьте учётную запись и организацию, которые показывает `/status`, и попросите администратора организации восстановить доступ.1293* Если то же сообщение возвращается для той же учётной записи, учётная запись или организация больше не активна. Проверьте учётную запись и организацию, которые показывает `/status`, и попросите администратора организации восстановить доступ.
1269* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM-шлюз](/docs/ru/llm-gateway), текст после `401` — это сообщение вашего шлюза, а не Anthropic, и `/login` его не меняет. Вместо этого исправьте учётные данные, которые ожидает ваш шлюз.1294* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM-шлюз](/docs/ru/llm-gateway), текст после `401` — это сообщение вашего шлюза, а не Anthropic, и `/login` его не меняет. Вместо этого исправьте учётные данные, которые ожидает ваш шлюз.
1295* Если каждый запрос завершается ошибкой `401`, хотя шлюз получает ожидаемые учётные данные, проверьте, не отклоняет ли шлюз поля поиска инструментов, которые Claude Code отправляет по умолчанию. Для проверки задайте `ENABLE_TOOL_SEARCH=false`, как описано в разделе [Поиск инструментов через LLM-шлюз](/docs/ru/mcp#tool-search-through-a-gateway), затем попробуйте снова. До v2.1.304 поиск инструментов за шлюзом был отключён, если вы не включали его через `ENABLE_TOOL_SEARCH`.
1270 1296
1271### Срок входа истёк1297### Срок входа истёк
1272 1298
1338* На других платформах снова запустите `/login`1364* На других платформах снова запустите `/login`
1339* Если вход по-прежнему не сохраняется, см. [Не выполнен вход или токен истёк](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired), где приведена команда разблокировки связки ключей и другие шаги восстановления хранилища учётных данных1365* Если вход по-прежнему не сохраняется, см. [Не выполнен вход или токен истёк](/docs/ru/troubleshoot-install#not-logged-in-or-token-expired), где приведена команда разблокировки связки ключей и другие шаги восстановления хранилища учётных данных
1340 1366
1341### Не удалось запустить сервер обратного вызова OAuth1367### Couldn't start the local listener that receives the browser sign-in
1342 1368
1343Когда `/login`, `claude auth login` или `claude setup-token` выполняют вход через браузер, Claude Code открывает прослушивающий порт на `127.0.0.1`, чтобы браузер мог вернуть ему результат входа. Это сообщение означает, что Claude Code не смог открыть этот порт, и вход останавливается до появления окна браузера или URL входа:1369Каждое из этих сообщений от `/login`, `claude auth login` или `claude setup-token` означает, что Claude Code не смог открыть порт на `127.0.0.1`, через который ваш браузер возвращает результат входа.
1344 1370
1345```text theme={null}1371При уведомлении, начинающемся с `The browser can't return the sign-in to Claude Code automatically`, вход продолжается без этого порта. Браузер не открывается, а уведомление появляется над URL, по которому вы входите вместо этого:
1346Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1372
1373```text wrap theme={null}
1374The browser can't return the sign-in to Claude Code automatically. After you sign in, paste the code shown.
1347```1375```
1348 1376
1349Если ваше сообщение заканчивается на `Is port 0 in use?`, попытка прослушивать адрес обратной петли IPv4 `127.0.0.1` полностью не удалась. Поскольку сбой происходит до того, как появляется URL входа, процесс `Paste code here if prompted` недоступен в качестве обходного пути.1377При сообщении, содержащем `Couldn't start the local listener`, вход остановился. Это происходит, например, когда вы передаёте входные данные в `claude auth login` через конвейер:
1378
1379```text theme={null}
1380Couldn't start the local listener that receives the browser sign-in. Try again.
1381```
1350 1382
1351**Что делать:**1383**Что делать:**
1352 1384
1353* Чтобы войти сразу без локального прослушивателя: если вы используете подписку claude.ai, запустите [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) на машине, где вход работает, и задайте выведенный токен как `CLAUDE_CODE_OAUTH_TOKEN` на этой машине. В противном случае задайте `ANTHROPIC_API_KEY` ключом из [Claude Console](https://platform.claude.com/settings/keys). [Приоритет аутентификации](/docs/ru/authentication#authentication-precedence) объясняет, как Claude Code выбирает между учётными данными.1385* **`The browser can't return the sign-in to Claude Code automatically`**: сначала ничего исправлять не нужно. Откройте URL, показанный под уведомлением, в браузере и войдите. Затем браузер покажет код: вставьте его в Claude Code в промпт `Paste code here >`, и вход продолжится с этого места.
1354* Чтобы вместо этого использовать вход через браузер на этой машине, Claude Code должен иметь возможность прослушивать `127.0.0.1`. Если он работает внутри песочницы, проверьте, что политика песочницы разрешает прослушивание локальных портов, затем снова запустите `/login`. Если такая возможность должна быть, но сбой сохраняется, запустите `/feedback`, чтобы отчёт включал сведения о вашем окружении.1386* **`Couldn't start the local listener that receives the browser sign-in`**: запустите ту же команду снова. Если она останавливается так же, войдите с помощью токена или API-ключа вместо браузера. Или, если вы передавали входные данные в `claude auth login` через конвейер, запустите её в терминале, чтобы она могла принять вставленный код.
1387* **Чтобы войти с помощью токена или API-ключа вместо браузера**: если вы используете подписку claude.ai, запустите [`claude setup-token`](/docs/ru/authentication#generate-a-long-lived-token) на компьютере, где вход работает. Затем задайте выведенный токен в переменной окружения [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/ru/env-vars) на этом компьютере. В противном случае задайте в переменной окружения `ANTHROPIC_API_KEY` ключ из [Claude Console](https://platform.claude.com/settings/keys). Раздел [Приоритет аутентификации](/docs/ru/authentication#authentication-precedence) объясняет, как Claude Code выбирает между учётными данными.
1388* **Чтобы вернуть автоматический возврат из браузера**: Claude Code должен иметь возможность прослушивать `127.0.0.1`. Если он работает в песочнице, проверьте, что политика песочницы разрешает прослушивание локальных портов, затем войдите снова. Если прослушивание там должно работать, а уведомление всё равно появляется, запустите `/feedback`, чтобы отчёт включал сведения о вашем окружении.
1389
1390До v2.1.305 вход останавливался, как только не удавалось открыть порт, и не показывал URL для входа. Сообщение выглядело, например, так: `Failed to start OAuth callback server: Failed to start server. Is port 0 in use?`. В этих версиях обновите Claude Code и войдите снова либо войдите с помощью токена или API-ключа вместо браузера.
1355 1391
1356### Вход Claude не принят1392### Вход Claude не принят
1357 1393
1513 1549
1514Обновите значение заголовка там, где настроен сервер, затем переподключитесь из `/mcp`.1550Обновите значение заголовка там, где настроен сервер, затем переподключитесь из `/mcp`.
1515 1551
1516До версии v2.1.273 во всех случаях — истёкшего входа, `headersHelper` и заголовка `Authorization` — показывалось `MCP server "<name>" requires re-authorization (token expired)`.1552В сессии [Cowork](https://claude.com/docs/cowork/overview) на вашем компьютере в приложении Claude Desktop эти сообщения означают, что MCP-сервер отклонил переданные ему учётные данные. Исправьте то, что названо в сообщении, затем начните новую задачу или чат в Cowork:
1553
1554```text theme={null}
1555MCP server "<name>" rejected the credential from its headersHelper (check the helper, then start a new task or chat)
1556MCP server "<name>" rejected the Authorization header in its config (update it, then start a new task or chat)
1557```
1558
1559* **Учётные данные `headersHelper` отклонены**: убедитесь, что вспомогательный скрипт возвращает учётные данные, которые принимает сервер, затем начните новую задачу или чат в Cowork
1560* **Заголовок `Authorization` отклонён**: обновите значение `Authorization` в разделе `headers` в конфигурации этого сервера, затем начните новую задачу или чат в Cowork
1561
1562До v2.1.302 сессия Cowork вместо этого показывала окончания `run /mcp to reconnect`, хотя `/mcp` там недоступна. Если вы видите такое окончание в Cowork, всё равно проверьте вспомогательный скрипт или обновите заголовок, затем начните новую задачу или чат. До v2.1.273 для истёкшего входа, `headersHelper` и заголовка `Authorization` во всех случаях показывалось `MCP server "<name>" requires re-authorization (token expired)`.
1517 1563
1518Сервер также может отклонить вызов инструмента с HTTP 403 `insufficient_scope`, чтобы попросить вас авторизовать scope, иногда такой, который уже указан в вашем токене. Сообщение называет этот scope:1564Сервер также может отклонить вызов инструмента с HTTP 403 `insufficient_scope`, чтобы попросить вас авторизовать scope, иногда такой, который уже указан в вашем токене. Сообщение называет этот scope:
1519 1565
1812* Убедитесь, что хост API доступен из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы не использовался встроенный псевдоним `Invoke-WebRequest`.1858* Убедитесь, что хост API доступен из той же оболочки, выполнив `curl -I https://api.anthropic.com`. В Windows PowerShell используйте `curl.exe -I https://api.anthropic.com`, чтобы не использовался встроенный псевдоним `Invoke-WebRequest`.
1813* Если вы находитесь за корпоративным прокси, задайте `HTTPS_PROXY` перед запуском Claude Code и см. [Настройка сети](/docs/ru/network-config)1859* Если вы находитесь за корпоративным прокси, задайте `HTTPS_PROXY` перед запуском Claude Code и см. [Настройка сети](/docs/ru/network-config)
1814* Если вы направляете трафик через LLM-шлюз или ретранслятор, задайте [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) равным его адресу. Инструкции по настройке см. в разделе [Подключение Claude Code к LLM-шлюзу](/docs/ru/llm-gateway-connect).1860* Если вы направляете трафик через LLM-шлюз или ретранслятор, задайте [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) равным его адресу. Инструкции по настройке см. в разделе [Подключение Claude Code к LLM-шлюзу](/docs/ru/llm-gateway-connect).
1861* Если `ANTHROPIC_BASE_URL` уже указывает на ваш шлюз и каждый запрос завершается `Connection dropped`, проверьте, не отклоняет ли ваш шлюз поля поиска инструментов, которые Claude Code отправляет по умолчанию. Для проверки задайте `ENABLE_TOOL_SEARCH=false`, как описано в разделе [Поиск инструментов через LLM-шлюз](/docs/ru/mcp#tool-search-through-a-gateway), затем повторите попытку. До версии v2.1.304 поиск инструментов за шлюзом был отключён, если вы не включали его с помощью `ENABLE_TOOL_SEARCH`.
1815* Убедитесь, что ваш брандмауэр разрешает хосты, перечисленные в разделе [Требования к сетевому доступу](/docs/ru/network-config#network-access-requirements)1862* Убедитесь, что ваш брандмауэр разрешает хосты, перечисленные в разделе [Требования к сетевому доступу](/docs/ru/network-config#network-access-requirements)
1816* Для периодических сбоев [повторные попытки выполняются автоматически](#automatic-retries); постоянные сбои указывают на локальную проблему с сетью1863* Для периодических сбоев [повторные попытки выполняются автоматически](#automatic-retries)
1817 1864
1818Если `curl` выполняется успешно, но Claude Code по-прежнему не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:1865Если `curl` выполняется успешно, но Claude Code по-прежнему не работает, причина обычно находится между средой выполнения и сетью, а не в самой сети:
1819 1866
2166* Сократите большие файлы памяти `CLAUDE.md` или перенесите инструкции в [правила, привязанные к путям](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости2213* Сократите большие файлы памяти `CLAUDE.md` или перенесите инструкции в [правила, привязанные к путям](/docs/ru/memory#path-specific-rules), которые загружаются только при необходимости
2167* Автосжатие включено по умолчанию и обычно предотвращает эту ошибку. Если вы отключили его в `/config` или с помощью [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), включите его снова. Если вы оставляете его отключённым, выполняйте `/compact` самостоятельно до заполнения окна.2214* Автосжатие включено по умолчанию и обычно предотвращает эту ошибку. Если вы отключили его в `/config` или с помощью [`DISABLE_AUTO_COMPACT`](/docs/ru/env-vars), включите его снова. Если вы оставляете его отключённым, выполняйте `/compact` самостоятельно до заполнения окна.
2168* Если ошибка появляется около 200K токенов на модели, которая принимает больше, одна из причин — идентификатор модели, который Claude Code не распознаёт. Для такого идентификатора Claude Code предполагает окно в 200K, поэтому, чтобы продолжить работу за этой границей, [укажите реальное контекстное окно модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id).2215* Если ошибка появляется около 200K токенов на модели, которая принимает больше, одна из причин — идентификатор модели, который Claude Code не распознаёт. Для такого идентификатора Claude Code предполагает окно в 200K, поэтому, чтобы продолжить работу за этой границей, [укажите реальное контекстное окно модели](/docs/ru/model-config#correct-the-window-for-a-gateway-or-custom-model-id).
2216* Если ошибка появилась сразу после того, как вы остановили Claude во время сжатия контекста диалога, ваш диалог не изменился и по-прежнему достаточно велик, чтобы требовать сжатия. Выполните `/compact` и отправьте сообщение снова. Чтобы ошибка не повторялась, [обновите Claude Code](/docs/ru/setup#update-claude-code) до v2.1.304 или новее. До v2.1.304 остановка в этот момент могла завершить ход этой ошибкой.
2169 2217
2170Интерактивную демонстрацию того, как заполняется контекст, см. в разделе [Explore the context window](/docs/ru/context-window).2218Интерактивную демонстрацию того, как заполняется контекст, см. в разделе [Explore the context window](/docs/ru/context-window).
2171 2219
2298 2346
2299### Extra inputs are not permitted2347### Extra inputs are not permitted
2300 2348
2301Прокси или LLM-шлюз между Claude Code и API удалил заголовок запроса `anthropic-beta`, поэтому API отклонил поля, которые от него зависят.2349Эндпоинт, получивший запрос, отклонил одно из полей запроса как входные данные, которые он не принимает, и в сообщении эндпоинта названо это поле.
2302 2350
2303```text theme={null}2351```text theme={null}
2304API Error: 400 ... Extra inputs are not permitted ... context_management2352API Error: 400 ... context_management: Extra inputs are not permitted
2305```2353```
2306 2354
2307Claude Code отправляет поля, доступные только в бета-версии, например `context_management`, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело запроса, но удаляет заголовок, API видит поля, которые не распознаёт.2355Claude Code отправляет поля, доступные только в бета-версии, такие как `context_management` и `defer_loading` для поиска инструментов, вместе с заголовком `anthropic-beta`, который их включает. Когда шлюз пересылает тело, но отбрасывает заголовок, API видит поля, которые не распознаёт. Когда шлюз пересылает тело в формате Anthropic вышестоящему сервису с другой схемой, этот сервис отклоняет такие поля. Оба случая описаны в разделе [Пары бета-заголовков и полей тела](/docs/ru/llm-gateway-protocol#beta-header-and-body-field-pairs).
2308 2356
2309**Что делать:**2357**Что делать:**
2310 2358
2311* Настройте шлюз на пересылку заголовка `anthropic-beta`. О том, что шлюзы должны пересылать, см. в разделе [feature pass-through](/docs/ru/llm-gateway-protocol#feature-pass-through).2359* Если сообщение содержит `context_management: Extra inputs are not permitted`, [обновите Claude Code](/docs/ru/setup#update-claude-code) до v2.1.304 или новее. После обновления Claude Code отвечает на такой отказ, отправляя запрос ещё раз без этого поля. До v2.1.304 Claude Code не повторял попытку при таком отказе.
2360* Если сообщение называет `defer_loading` или `tool_reference`, обновите Claude Code или отключите [поиск инструментов](/docs/ru/mcp#tool-search-through-a-gateway):
2361 * [Обновите Claude Code](/docs/ru/setup#update-claude-code) до v2.1.305 или новее. Тогда Claude Code отвечает на такой отказ, отправляя запрос ещё раз без полей поиска инструментов.
2362 * Если вы не можете обновиться или сообщение продолжает появляться после обновления, задайте `ENABLE_TOOL_SEARCH=false` в оболочке или в [`env` настроек](/docs/ru/settings-reference#env). Если файл настроек уже задаёт эту переменную, измените её там, поскольку это значение [может переопределить export в оболочке](/docs/ru/settings-reference#how-env-values-interact-with-your-shell). Тогда Claude Code загружает инструменты MCP заранее.
2363* Если ваш шлюз отбрасывает заголовок, настройте его на пересылку заголовка `anthropic-beta`. О том, что должны пересылать шлюзы, см. раздел [Сквозная передача функций](/docs/ru/llm-gateway-protocol#feature-pass-through).
2312* В качестве резервного варианта задайте [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) перед запуском. Точный охват описан в разделе [Disable pre-release capabilities](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities).2364* В качестве резервного варианта задайте [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/docs/ru/env-vars) перед запуском. Точный охват описан в разделе [Disable pre-release capabilities](/docs/ru/llm-gateway-protocol#disable-pre-release-capabilities).
2313 2365
2366До v2.1.302 эта ошибка также могла называть поле `diagnostics` без участия какого-либо шлюза. Она появлялась, когда сессия, уже использовавшая Anthropic API, переходила на Amazon Bedrock или Agent Platform от Google Cloud без перезапуска. Например, оставленная вами открытой сессия переходит на Bedrock, когда вы выполняете [`/setup-bedrock`](/docs/ru/commands) в другом окне Claude Code. В этих версиях выполните `/clear` в такой сессии или перезапустите её.
2367
2314### Tool input schema is invalid2368### Tool input schema is invalid
2315 2369
2316Инструмент в запросе объявил `input_schema`, которая не проходит проверку JSON Schema в API, поэтому API отклонил весь запрос. Число после `tools.` — это позиция проблемного инструмента в списке инструментов запроса, а не имя, которое можно найти.2370Инструмент в запросе объявил `input_schema`, которая не проходит проверку JSON Schema в API, поэтому API отклонил весь запрос. Число после `tools.` — это позиция проблемного инструмента в списке инструментов запроса, а не имя, которое можно найти.
2384* Используйте псевдоним, например `sonnet` или `opus`, вместо полного ID с версией. Псевдонимы указывают на поддерживаемое значение по умолчанию, поэтому не устаревают. См. раздел [Model configuration](/docs/ru/model-config).2438* Используйте псевдоним, например `sonnet` или `opus`, вместо полного ID с версией. Псевдонимы указывают на поддерживаемое значение по умолчанию, поэтому не устаревают. См. раздел [Model configuration](/docs/ru/model-config).
2385* Если в CLI постоянно возвращается неправильная модель, где-то задан устаревший ID. Проверьте места, где можно задать модель, в [порядке приоритета](/docs/ru/model-config#setting-your-model) и удалите устаревшее значение.2439* Если в CLI постоянно возвращается неправильная модель, где-то задан устаревший ID. Проверьте места, где можно задать модель, в [порядке приоритета](/docs/ru/model-config#setting-your-model) и удалите устаревшее значение.
2386* Claude Code сообщает об истёкшем входе в claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До версии 2.1.206 истёкший вход, который уже нельзя было обновить, приводил к этой ошибке для любой модели; если вы видите это в более старой версии, выполните `/login`.2440* Claude Code сообщает об истёкшем входе в claude.ai как [Login expired](#login-expired), а не как об этой ошибке. До версии 2.1.206 истёкший вход, который уже нельзя было обновить, приводил к этой ошибке для любой модели; если вы видите это в более старой версии, выполните `/login`.
2441* Если [`ANTHROPIC_BASE_URL`](/docs/ru/env-vars) указывает на [LLM-шлюз](/docs/ru/llm-gateway) и так завершаются все модели, проверьте, не отклоняет ли ваш шлюз поля поиска инструментов, которые Claude Code отправляет по умолчанию. Для проверки задайте `ENABLE_TOOL_SEARCH=false`, как описано в разделе [Поиск инструментов через LLM-шлюз](/docs/ru/mcp#tool-search-through-a-gateway), затем попробуйте снова. До v2.1.304 поиск инструментов за шлюзом был отключён, если вы не включали его через `ENABLE_TOOL_SEARCH`.
2387* Для развёртываний в Google Cloud's Agent Platform см. раздел [Устранение неполадок в Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#troubleshooting).2442* Для развёртываний в Google Cloud's Agent Platform см. раздел [Устранение неполадок в Google Cloud's Agent Platform](/docs/ru/google-vertex-ai#troubleshooting).
2388 2443
2389### Model is not a recognized model id2444### Model is not a recognized model id
2590О том же состоянии сообщают и другие сообщения:2645О том же состоянии сообщают и другие сообщения:
2591 2646
2592* В интерактивной сессии уведомление звучит так: `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.2647* В интерактивной сессии уведомление звучит так: `Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor`.
2593* При запуске с флагом `--advisor` выводится предупреждение `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.`, и сессия всё равно запускается.2648* Когда вы запускаете с флагом `--advisor` в [неинтерактивном режиме](/docs/ru/headless) и запуск не является [фоновой сессией](/docs/ru/agent-view), в stderr выводится предупреждение, и запуск всё равно начинается. Оно гласит `"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.` Интерактивная сессия записывает это предупреждение только в [отладочный лог](#configuration-warnings).
2594 2649
2595**Что делать:**2650**Что делать:**
2596 2651
3361 3416
3362Родственные сообщения появляются ещё до запуска команды:3417Родственные сообщения появляются ещё до запуска команды:
3363 3418
3364* `Shell command permission check failed for pattern "..."`: проверка разрешений команды её не пропустила. В разделе [Проверки разрешений для внедрённых команд](/docs/ru/skills#permission-checks-on-injected-commands) описано, какие результаты прерывают выполнение в каждом режиме разрешений и как заранее одобрить команду с помощью `allowed-tools`3419* `Shell command permission check failed for pattern "..."`: проверка разрешений не разрешила команду. Раздел [Проверки разрешений для внедрённых команд](/docs/ru/skills#permission-checks-on-injected-commands) описывает, какие результаты прерывают выполнение в каждом режиме разрешений и как заранее одобрить команду с помощью `allowed-tools`
3365* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](/docs/ru/skills#how-injected-commands-run)3420* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter скилла требует bash на компьютере, где его нет. Установите Git for Windows или измените frontmatter на `shell: powershell`. См. [Как выполняются внедрённые команды](/docs/ru/skills#how-injected-commands-run)
3366* `No shell command in <name> was run`: одна из команд `!` в файле содержит необработанный управляющий символ, отличный от табуляции или перевода строки, поэтому ни одна из них не выполняется. См. [как найти и удалить этот символ](#no-shell-command-was-run)3421* `No shell command in <name> was run`: одна из команд `!` в файле содержит необработанный управляющий символ, отличный от табуляции или перевода строки, поэтому ни одна из них не выполняется. См. [как найти и удалить этот символ](#no-shell-command-was-run)
3367 3422
3464Claude Code предлагает ближайшее имя команды или псевдоним, которые меню показывает в этой сессии. Если ничего близкого нет, сообщение заканчивается после имени. Обычно причина одна из следующих:3519Claude Code предлагает ближайшее имя команды или псевдоним, которые меню показывает в этой сессии. Если ничего близкого нет, сообщение заканчивается после имени. Обычно причина одна из следующих:
3465 3520
3466* Опечатка, например `/hepl` вместо `/help`. В разделе [Как меню команд сопоставляет вводимый текст](/docs/ru/commands#how-the-command-menu-matches-what-you-type) описано, как выбрать близкое совпадение перед отправкой3521* Опечатка, например `/hepl` вместо `/help`. В разделе [Как меню команд сопоставляет вводимый текст](/docs/ru/commands#how-the-command-menu-matches-what-you-type) описано, как выбрать близкое совпадение перед отправкой
3467* Команда существует, но недоступна в этой сессии, потому что не выполнено требование, например к вашей платформе, тарифу или способу аутентификации. Разделы устранения неполадок для [`/web-setup`](/docs/ru/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) и [`/schedule`](/docs/ru/routines#schedule-returns-unknown-command) разбирают два распространённых случая. Некоторые команды отвечают собственным сообщением, когда политика вашей организации их отключает, например [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3522* Команда существует, но недоступна в этой сессии, потому что не выполнено требование, например к платформе, тарифу или способу аутентификации. См. разделы для [`/web-setup`](/docs/ru/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command), [`/schedule`](/docs/ru/routines#schedule-returns-unknown-command) или [`/auto-mode-setup`](/docs/ru/auto-mode-config#auto-mode-setup-returns-unknown-command). Некоторые команды отвечают собственным сообщением, когда их отключает политика вашей организации, например [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3468* Команда из [плагина](/docs/ru/plugins/overview) или [MCP-сервера](/docs/ru/mcp#use-mcp-prompts-as-commands), который не установлен или не подключён в этой сессии3523* Команда из [плагина](/docs/ru/plugins/overview) или [MCP-сервера](/docs/ru/mcp#use-mcp-prompts-as-commands), который не установлен или не подключён в этой сессии
3469 3524
3470Claude Code отвечает так на несовпадающее имя с `/` только в интерактивной сессии терминала. В любой другой сессии он вместо этого отправляет промпт Claude как обычное сообщение с пометкой, что команда не была выполнена, и списком команд, которые Claude может выполнить в сессии. К таким сессиям относятся:3525Claude Code отвечает так на несовпадающее имя с `/` только в интерактивной сессии терминала. В любой другой сессии он вместо этого отправляет промпт Claude как обычное сообщение с пометкой, что команда не была выполнена, и списком команд, которые Claude может выполнить в сессии. К таким сессиям относятся:
3513 3568
3514* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше3569* **Вы не передали базовую ветку**: Claude Code сравнивал с веткой репозитория по умолчанию и предлагает явно передать вашу базовую ветку, как в примере выше
3515* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3570* **Вы передали базовую ветку, которая уже была в вашем клоне**: подсказка гласит ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3516* **Вы указали базовую ветку, которой не было в вашем клоне**: 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`. До v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, а в полном клоне эта команда завершается ошибкой `fatal: --unshallow on a complete repository does not make sense`.3571* **Вы передали базовую ветку, которой не было в вашем клоне**: 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 не может определить, является ли ваш клон неполным (shallow), он вместо этого предлагает `git fetch --unshallow origin`. До v2.1.221 подсказка предлагала `git fetch --unshallow origin` для каждой полученной базовой ветки, а на полном клоне эта команда завершается ошибкой `fatal: --unshallow on a complete repository does not make sense`.
3517 3572
3518**Что делать:**3573**Что делать:**
3519 3574
3856* Откройте сессию самостоятельно и выполните `/recap` там: в её терминале, в [приложении Desktop](/docs/ru/desktop) или [мобильном приложении](/docs/ru/mobile), на [claude.ai/code](https://claude.ai/code) или через [Remote Control](/docs/ru/remote-control)3911* Откройте сессию самостоятельно и выполните `/recap` там: в её терминале, в [приложении Desktop](/docs/ru/desktop) или [мобильном приложении](/docs/ru/mobile), на [claude.ai/code](https://claude.ai/code) или через [Remote Control](/docs/ru/remote-control)
3857* Если его отправила облачная запланированная задача или другая программа, удалите `/recap` из этого промпта3912* Если его отправила облачная запланированная задача или другая программа, удалите `/recap` из этого промпта
3858 3913
3914### /feedback is disabled by your organization's policy
3915
3916Это сообщение означает, что политика вашей организации не разрешает отправку отзывов о продукте из Claude Code, поэтому `/feedback`, `/bug` и `/share` не открывают диалоговое окно отзыва. Сообщение называет команду, которую вы ввели в промпте Claude Code:
3917
3918```text wrap theme={null}
3919/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.
3920```
3921
3922Сообщение также может состоять только из первого предложения.
3923
3924**Что делать:**
3925
3926* Чтобы сообщить об ошибке, создайте issue на [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Issues там может прочитать любой, поэтому не включайте код, транскрипты и любую другую конфиденциальную информацию.
3927
3928До версии v2.1.302 полное сообщение выглядело так: `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`
3929
3859## Ошибки плагинов3930## Ошибки плагинов
3860 3931
3861Эти ошибки связаны с конфигурацией [плагинов](/docs/ru/plugins/overview) и [маркетплейсов](/docs/ru/plugins/overview). Проблемы с плагинами, которые не приводят ни к одному из сообщений на этой странице, например URL маркетплейса, который не загружается, или плагин, который устанавливается, но не появляется, описаны в разделе [Устранение неполадок плагинов](/docs/ru/plugins/troubleshooting).3932Эти ошибки связаны с конфигурацией [плагинов](/docs/ru/plugins/overview) и [маркетплейсов](/docs/ru/plugins/overview). Проблемы с плагинами, которые не приводят ни к одному из сообщений на этой странице, например URL маркетплейса, который не загружается, или плагин, который устанавливается, но не появляется, описаны в разделе [Устранение неполадок плагинов](/docs/ru/plugins/troubleshooting).
4001 4072
4002### Путь выходит за пределы каталога плагина4073### Путь выходит за пределы каталога плагина
4003 4074
4004Путь компонента плагина, объявленный в `plugin.json` плагина или в его [записи маркетплейса](/docs/ru/plugins/marketplace-reference#plugin-entries), указывает за пределы собственного каталога плагина. Claude Code отбрасывает этот путь и загружает остальную часть плагина. Имя компонента в сообщении, например `commands` или `hooks`, указывает поле, в котором объявлен путь.4075Один из путей компонентов плагина ведёт за пределы каталога плагина или не удалось подтвердить, что он находится внутри него, поэтому Claude Code отбрасывает этот путь и загружает остальную часть плагина. Для пути, который плагин объявляет в `plugin.json` или в своей [записи маркетплейса](/docs/ru/plugins/marketplace-reference#plugin-entries), имя компонента в сообщении, например `commands` или `hooks`, указывает поле, в котором объявлен путь.
4005 4076
4006```text theme={null}4077```text theme={null}
4007commands path escapes plugin directory: ./../shared.md4078commands path escapes plugin directory: ./../shared.md
4015commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory4086commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory
4016```4087```
4017 4088
4089Сообщение, в котором указан полный путь к одному из собственных файлов плагина из маркетплейса, например `hooks/hooks.json`, означает, что Claude Code пропустил этот файл. Это происходит, когда Claude Code не может подтвердить, что файл находится внутри плагина или, для плагина в [локальном маркетплейсе](/docs/ru/plugins/loading#in-place-and-copied-plugins), внутри этого маркетплейса. Сообщение указывает каждый из этих файлов под следующим именем компонента:
4090
4091* `hooks/hooks.json`: `hooks`
4092* `monitors/monitors.json`: `monitors`
4093* `settings.json`: `settings`
4094* `SKILL.md` в корне плагина: `skills`
4095
4096Например, это сообщение относится к `hooks/hooks.json`, который разрешается за пределы как плагина, так и его локального маркетплейса:
4097
4098```text theme={null}
4099hooks path escapes plugin directory: /home/user/my-marketplace/my-plugin/hooks/hooks.json — it resolves to /home/user/dotfiles/hooks.json, outside the plugin directory and its marketplace directory
4100```
4101
4018В macOS и Linux Claude Code также отклоняет путь компонента, содержащий обратную косую черту в любом месте, даже если путь остаётся внутри плагина. Плагин, пути компонентов которого используют разделители в стиле Windows, загружается в Windows и вызывает этот отказ на других платформах:4102В macOS и Linux Claude Code также отклоняет путь компонента, содержащий обратную косую черту в любом месте, даже если путь остаётся внутри плагина. Плагин, пути компонентов которого используют разделители в стиле Windows, загружается в Windows и вызывает этот отказ на других платформах:
4019 4103
4020```text theme={null}4104```text theme={null}
4023 4107
4024До v2.1.251 Claude Code загружал путь `commands`, объявленный в записи маркетплейса, даже если он указывал за пределы каталога плагина.4108До v2.1.251 Claude Code загружал путь `commands`, объявленный в записи маркетплейса, даже если он указывал за пределы каталога плагина.
4025 4109
4026До v2.1.257 проверка учитывала только написание пути, а не то, куда ведёт символическая ссылка.4110До v2.1.257 проверка путей, которые объявляет плагин, учитывала только написание пути, а не то, куда ведёт символическая ссылка.
4027 4111
4028**Что делать:**4112**Что делать:**
4029 4113
4030* Переместите указанный файл внутрь каталога плагина и укажите на него относительным путём с `./`4114* Если вы установили плагин и не сопровождаете его, передайте сообщение его автору
4031* Если путь — символическая ссылка на файл вне плагина, замените символическую ссылку копией файла4115* Для пути, который объявляет плагин, переместите указанный файл внутрь каталога плагина и укажите на него относительным путём с `./`
4032* Если в сообщении сказано, что путь содержит обратную косую черту, запишите путь с прямыми косыми чертами, например `./commands/deploy.md`4116* Если путь или папка выше него внутри плагина является символической ссылкой, ведущей за пределы плагина, замените символическую ссылку копией того, на что она указывает
4117* Если в сообщении сказано, что путь, объявленный плагином, содержит обратную косую черту, запишите путь с прямыми косыми чертами, например `./commands/deploy.md`
4118* Если сообщение заканчивается на `EACCES`, восстановите право на выполнение для каждого каталога на пути к файлу или папке, которые указывает путь. Проверьте каталоги выше пути, затем переходите по каждой встреченной символической ссылке и проверьте каталоги, ведущие к месту, куда она указывает. Любой другой код ошибки найдите в разделе [причины и шаги для пути, который не удалось проверить](#path-could-not-be-checked).
4033* Чтобы совместно использовать файлы с другими плагинами того же маркетплейса, свяжите их символической ссылкой внутри каталога плагина, следуя [правилам символических ссылок](/docs/ru/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)4119* Чтобы совместно использовать файлы с другими плагинами того же маркетплейса, свяжите их символической ссылкой внутри каталога плагина, следуя [правилам символических ссылок](/docs/ru/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)
4034 4120
4121### Плагин не загружен: его манифест не был прочитан
4122
4123Claude Code не смог подтвердить, что [манифест](/docs/ru/plugins/manifest-reference) плагина из маркетплейса в `.claude-plugin/plugin.json` находится внутри плагина, поэтому ничего из этого плагина не загружает. Для плагина в [локальном маркетплейсе](/docs/ru/plugins/loading#in-place-and-copied-plugins) Claude Code также не смог подтвердить, что манифест находится внутри этого маркетплейса. Сообщение отображается на вкладке **Errors** в `/plugin`, а причина в его конце указывает, что обнаружил Claude Code.
4124
4125Например, это сообщение относится к плагину в локальном маркетплейсе, папка `.claude-plugin` которого является символической ссылкой, ведущей за пределы маркетплейса:
4126
4127```text theme={null}
4128Plugin not loaded: its manifest /home/user/my-marketplace/my-plugin/.claude-plugin/plugin.json was not read, because it resolves to /home/user/dotfiles/my-plugin/.claude-plugin/plugin.json, outside the plugin directory and its marketplace directory
4129```
4130
4131**Что делать:**
4132
4133* Если причина заканчивается на `EACCES`, восстановите право на выполнение для каждого каталога на пути к манифесту. Проверьте каталоги выше манифеста, затем переходите по каждой встреченной символической ссылке и проверьте каталоги, ведущие к месту, куда она указывает. Любой другой код ошибки найдите в разделе [причины и шаги для пути, который не удалось проверить](#path-could-not-be-checked).
4134* Если вы сопровождаете плагин и причина указывает, куда разрешается манифест, значит, папка `.claude-plugin` или сам `plugin.json` является символической ссылкой, которая ведёт туда. Замените эту ссылку копией того, на что она указывает.
4135* Если вы установили плагин и не сопровождаете его, передайте сообщение его автору
4136
4035### Путь не удалось проверить4137### Путь не удалось проверить
4036 4138
4037Claude Code запросил у операционной системы, существует ли путь плагина, и получил ошибку, отличную от «не найдено», поэтому не загружает то, на что указывает путь. Какая часть плагина загрузится, зависит от того, какой путь не прошёл проверку:4139Claude Code запросил у операционной системы, существует ли путь плагина, и получил ошибку, отличную от «не найдено», поэтому не загружает то, на что указывает путь. Какая часть плагина загрузится, зависит от того, какой путь не прошёл проверку:
4226 4328
4227До версии 2.1.281 нулевой байт в пути Read, Write, Edit или NotebookEdit завершал весь ход с ошибкой `Path contains null bytes`, и инструмент так и не запускался.4329До версии 2.1.281 нулевой байт в пути Read, Write, Edit или NotebookEdit завершал весь ход с ошибкой `Path contains null bytes`, и инструмент так и не запускался.
4228 4330
4331### File is too large to read as an image
4332
4333Claude попытался прочитать файл как изображение с помощью [инструмента Read](/docs/ru/tools-reference#read-tool-behavior), а размер файла превышает 128 МБ — максимум, который Read загружает из файла изображения. Ничего не было прочитано, и Claude получает эту ошибку как результат инструмента:
4334
4335```text wrap theme={null}
4336File is too large to read as an image (the limit is 128MB): <path>. If it is an image, resize it or export a smaller copy, then read that.
4337```
4338
4339Когда путь указывает на канал или устройство, а не на обычный файл, Read останавливается, как только поступит более 128 МБ, и вместо этого возвращает такую ошибку:
4340
4341```text wrap theme={null}
4342Cannot read this as an image: <path> is a pipe or a device, not a regular file, and it sent more than 128MB without ending.
4343```
4344
4345**Что делать:**
4346
4347* Если Claude последовал сообщению `File is too large` и затем уменьшил изображение или прочитал меньшую копию, ничего делать не нужно
4348* Если Claude остановился на ошибке, сами экспортируйте копию размером меньше 128 МБ, например с более низким разрешением, и укажите Claude на этот файл
4349* Если путь указывал на канал или устройство, укажите Claude вместо этого на обычный файл изображения
4350
4229### subagent\_type is required4351### subagent\_type is required
4230 4352
4231```text theme={null}4353```text theme={null}
4316* Запустите `claude` в папке, которую называет [лог отладки](/docs/ru/debug-your-config), и примите диалог доверия. Определение повторно применяется в следующий раз, когда Claude Code вернёт участника команды; перезапускать сессию лидера не нужно4438* Запустите `claude` в папке, которую называет [лог отладки](/docs/ru/debug-your-config), и примите диалог доверия. Определение повторно применяется в следующий раз, когда Claude Code вернёт участника команды; перезапускать сессию лидера не нужно
4317* Или установите запись `hasTrustDialogAccepted` в `true` в `~/.claude.json`, используя точный ключ `projects["<path>"]`, который выводит лог отладки4439* Или установите запись `hasTrustDialogAccepted` в `true` в `~/.claude.json`, используя точный ключ `projects["<path>"]`, который выводит лог отладки
4318 4440
4441### Only a teammate can approve a shutdown request
4442
4443Claude Code отклонил подтверждение завершения в [команде агентов](/docs/ru/agent-teams), потому что отправившая его сессия не работает как участник команды. Ничего не было отправлено, и ничего не завершилось. Отказ появляется в результате инструмента отправляющей сессии:
4444
4445```text wrap theme={null}
4446Only a teammate can approve a shutdown request, and this session is not running as one. Nothing was sent. To shut down a teammate, send that teammate a shutdown_request message. The teammate is the one that approves it.
4447```
4448
4449**Что делать:**
4450
4451* Если отказ появился в вашей сессии лидера, сначала проверьте, не завершил ли участник команды работу с тех пор. Отказ возвращается Claude с указанием вместо этого отправить `shutdown_request`, и ход продолжается. В интерактивной сессии лидера, когда участник команды подтверждает запрос на завершение, появляется `<name> has shut down.`.
4452* Если участник команды всё ещё работает, попросите лидера в его промпте завершить работу участника команды, например `Ask the researcher teammate to shut down`. См. [Завершение работы участников команды](/docs/ru/agent-teams#shut-down-teammates).
4453* Если этот отказ получил бывший участник команды, которого вы сами возобновили с помощью `claude --resume`, ничего не было отправлено. Чтобы завершить эту сессию, выполните `/exit` в её промпте.
4454
4319### Message too large for cross-session delivery4455### Message too large for cross-session delivery
4320 4456
4321[Межсессионное сообщение](/docs/ru/cross-session-messaging) Claude другой вашей сессии на этой машине было слишком длинным для отправки. Claude Code отклонил его, и получающая сессия ничего не получила. Отказ появляется в результате инструмента отправляющей сессии, а не как баннер в вашем терминале. Он называет оба размера и способ уместить сообщение:4457[Межсессионное сообщение](/docs/ru/cross-session-messaging) Claude другой вашей сессии на этой машине было слишком длинным для отправки. Claude Code отклонил его, и получающая сессия ничего не получила. Отказ появляется в результате инструмента отправляющей сессии, а не как баннер в вашем терминале. Он называет оба размера и способ уместить сообщение:
4449 4585
4450### Disk quota or temp filesystem is full4586### Disk quota or temp filesystem is full
4451 4587
4452Claude Code сохраняет вывод каждой команды Bash и PowerShell в файл в своём временном каталоге. Когда команда завершается с ненулевым кодом и вообще без вывода, Claude Code проверяет, не закончилось ли место или индексные дескрипторы на файловой системе, содержащей этот файл, и не исчерпана ли ваша дисковая квота на ней. Если это так, в результате команды вместо пустого вывода появляется диагностическое сообщение:4588Claude Code сохраняет вывод каждой команды Bash и PowerShell в файл в своём временном каталоге. Эти сообщения в результате команды означают, что файловая система, содержащая этот каталог, или ваша дисковая квота на ней заполнены.
4589
4590Если Claude Code не может создать этот файл, потому что файловая система или ваша квота на ней заполнены, команда не запускается, и результат выглядит так:
4591
4592```text wrap theme={null}
4593The command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran. If this is the user's own computer, tell them before deleting anything to make room.
4594```
4595
4596Когда команда завершается с ненулевым кодом и вообще без вывода, Claude Code проверяет файловую систему, содержащую файл вывода. Если на этой файловой системе закончилось место или индексные дескрипторы либо исчерпана ваша дисковая квота на ней, в результате команды вместо пустого вывода появляется диагностическое сообщение:
4453 4597
4454```text wrap theme={null}4598```text wrap theme={null}
4455Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.4599Your disk quota is full on the filesystem with Claude Code's temp directory /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks (EDQUOT), so any output this command printed was lost, and it may have failed because it could not write. Delete files you no longer need there, or restart Claude Code with CLAUDE_CODE_TMPDIR set to a directory on another filesystem.
4460* `Your disk quota is full ... (EDQUOT)`: ваша собственная квота на этой файловой системе исчерпана. Квота может быть исчерпана, даже когда на файловой системе ещё есть свободное место4604* `Your disk quota is full ... (EDQUOT)`: ваша собственная квота на этой файловой системе исчерпана. Квота может быть исчерпана, даже когда на файловой системе ещё есть свободное место
4461* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: на файловой системе или в вашей квоте на ней не осталось места4605* `The filesystem with Claude Code's temp directory ..., or your disk quota on it, is full (ENOSPC)`: на файловой системе или в вашей квоте на ней не осталось места
4462* `Command output was lost: the temp filesystem at ... is full` или `... is out of inodes`: на файловой системе почти не осталось свободного места или заканчиваются индексные дескрипторы4606* `Command output was lost: the temp filesystem at ... is full` или `... is out of inodes`: на файловой системе почти не осталось свободного места или заканчиваются индексные дескрипторы
4607* `The command was not started: this computer's disk is full (ENOSPC)` или `... (EDQUOT)`: на файловой системе не осталось места для файла вывода, или, в случае `EDQUOT`, исчерпана ваша собственная квота на ней
4463 4608
4464**Что делать:**4609**Что делать:**
4465 4610
4466* Удалите ненужные файлы на файловой системе, содержащей временный каталог Claude Code. Для `EDQUOT` удалите файлы, которые учитываются в вашей собственной квоте. Для `out of inodes` удалите много файлов, а не несколько больших, так как каждый файл занимает один индексный дескриптор независимо от размера4611* Удалите ненужные файлы на файловой системе, содержащей временный каталог Claude Code. Если ваше сообщение не называет этот каталог, найдите его расположение по умолчанию в справке по [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars). Для `EDQUOT` удалите файлы, которые учитываются в вашей собственной квоте. Для `out of inodes` удалите много файлов, а не несколько больших, так как каждый файл занимает один индексный дескриптор независимо от размера
4467* Или перезапустите Claude Code, установив [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог на файловой системе со свободным местом4612* Или перезапустите Claude Code, установив [`CLAUDE_CODE_TMPDIR`](/docs/ru/env-vars) в каталог на файловой системе со свободным местом
4468* Затем попросите Claude снова выполнить команду. Выведенные ею данные были потеряны, а не усечены4613* Затем попросите Claude снова выполнить команду
4614
4615До версии 2.1.305 команда, которую Claude Code не смог запустить из-за заполненного диска, возвращала только текст ошибки операционной системы. Этот текст выглядел, например, как `ENOSPC: no space left on device, open <path>.output`.
4469 4616
4470### File is not valid UTF-84617### File is not valid UTF-8
4471 4618
4524* В Windows, чтобы Claude мог публиковать файлы прямо с общего ресурса, подключите его как диск с буквой и передайте этот диск при запуске Claude Code. Например, в PowerShell выполните `net use Z: \\server\share`, а затем `claude --add-dir Z:\`. После этого Claude сможет публиковать файлы с этого диска. Добавления диска посреди сессии с помощью `/add-dir` недостаточно.4671* В Windows, чтобы Claude мог публиковать файлы прямо с общего ресурса, подключите его как диск с буквой и передайте этот диск при запуске Claude Code. Например, в PowerShell выполните `net use Z: \\server\share`, а затем `claude --add-dir Z:\`. После этого Claude сможет публиковать файлы с этого диска. Добавления диска посреди сессии с помощью `/add-dir` недостаточно.
4525* В macOS или Linux смонтируйте общий ресурс в каталог, например в каталог внутри `/mnt` или `/Volumes`, и публикуйте из этого пути вместо пути автомонтирования4672* В macOS или Linux смонтируйте общий ресурс в каталог, например в каталог внутри `/mnt` или `/Volumes`, и публикуйте из этого пути вместо пути автомонтирования
4526 4673
4674### Not published: Claude sent the same content again after a newer version of the artifact turned it away
4675
4676Эта красная строка под вызовом Artifact означает, что Claude Code остановил повторную публикацию: [артефакт](/docs/ru/artifacts) не был обновлён, и в файл, из которого Claude публикует, ничего не было записано. Делать ничего не нужно, если только Claude не остановится без публикации.
4677
4678Ранее в этой сессии Claude Code отклонил публикацию, потому что у артефакта была более новая версия, например опубликованная [редактором](/docs/ru/artifacts#let-someone-edit-with-you) или другой вашей сессией. Окончание строки указывает, что Claude должен сделать дальше:
4679
4680```text wrap theme={null}
4681Not published: Claude sent the same content again after a newer version of the artifact turned it away. Claude needs to work from that newer version first.
4682Not published: Claude sent the same content again after a newer version of the artifact turned it away. The artifact hasn't changed since, so publishing it once more should go through.
4683Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. Claude needs to work from that newer version first.
4684Not published: Claude sent its changes again over the same file after a newer version of the artifact turned them away. The artifact hasn't changed since, so publishing once more should go through.
4685```
4686
4687**Что делать:**
4688
4689* **Заканчивается на `Claude needs to work from that newer version first`**: если Claude остановился на этом, попросите его получить текущую версию артефакта, объединить с ней свои изменения и опубликовать снова
4690* **Заканчивается на `should go through`**: если Claude остановился на этом, попросите его опубликовать снова
4691
4527### Reading a local file from outside the connected folders in a Cowork session4692### Reading a local file from outside the connected folders in a Cowork session
4528 4693
4529В сессии [Cowork](https://claude.com/docs/cowork/overview), работающей на вашей машине в приложении Claude Desktop, Claude указал локальный файл для [артефакта](/docs/ru/artifacts). Claude Code не смог подтвердить, что файл является обычным файлом внутри подключённых папок сессии: путь находится вне этих папок, проходит через символическую ссылку или записан так, что может указывать на другой файл, чем кажется. Чтение такого файла требует вашего подтверждения, и в сессии, которая не может показать вам карточку подтверждения, например в сессии, настроенной на пропуск всех подтверждений, Claude Code отклоняет чтение.4694В сессии [Cowork](https://claude.com/docs/cowork/overview), работающей на вашей машине в приложении Claude Desktop, Claude указал локальный файл для [артефакта](/docs/ru/artifacts). Claude Code не смог подтвердить, что файл является обычным файлом внутри подключённых папок сессии: путь находится вне этих папок, проходит через символическую ссылку или записан так, что может указывать на другой файл, чем кажется. Чтение такого файла требует вашего подтверждения, и в сессии, которая не может показать вам карточку подтверждения, например в сессии, настроенной на пропуск всех подтверждений, Claude Code отклоняет чтение.
4816* Чтобы продолжить цикл, [ответьте в сессии](/docs/ru/agent-view#peek-and-reply) и скажите об этом, например `keep the loop running`. Claude прочитает уведомление вместе с вашим ответом и сможет запланировать следующее пробуждение4981* Чтобы продолжить цикл, [ответьте в сессии](/docs/ru/agent-view#peek-and-reply) и скажите об этом, например `keep the loop running`. Claude прочитает уведомление вместе с вашим ответом и сможет запланировать следующее пробуждение
4817* Если цикл вам больше не нужен, ничего не делайте. Он уже остановлен4982* Если цикл вам больше не нужен, ничего не делайте. Он уже остановлен
4818 4983
4984### No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder
4985
4986[Фоновая сессия](/docs/ru/agent-view), в которой показывается это сообщение, не использует ваш [LLM-шлюз](/docs/ru/llm-gateway): она не получила адрес шлюза, поэтому её запросы завершаются ошибкой. Сообщение появляется в диалоге вместо ответа Claude, с подставленными ID и папкой вашей сессии:
4987
4988```text wrap theme={null}
4989No LLM gateway: a gateway set in your shell isn't passed to a session opened from another folder. To fix, run `claude respawn abc12345` from ~/project in another terminal where your gateway is set, or set ANTHROPIC_BASE_URL and its API key or token in a settings file's env block.
4990```
4991
4992Пока вы подключены к сессии, уведомление под её промптом показывает краткую форму `No LLM gateway: opened from another folder · respawn from ~/project`.
4993
4994Вы запустили, пробудили или перезапустили сессию из папки, отличной от указанной в сообщении, когда `ANTHROPIC_BASE_URL` был задан для вашего шлюза. Случаи, когда шлюз, экспортированный в оболочке, всё же доходит до фоновой сессии, описаны в разделе [LLM-шлюз](/docs/ru/agent-view#llm-gateway).
4995
4996**Что делать:**
4997
4998* **Вы использовали представление агента в проекте, настройки которого задают шлюз**: поместите `ANTHROPIC_BASE_URL` и его API-ключ или токен в [блок `env` файла настроек](/docs/ru/llm-gateway-connect#set-in-a-settings-file). Используйте `~/.claude/settings.json` или `.claude/settings.local.json` в собственном проекте сессии — оба этих файла читает перезапущенная сессия. Затем выполните `claude respawn <id>` в оболочке из любой папки.
4999* **Вы экспортировали шлюз в терминале**: в терминале, где экспортированы переменные шлюза, перейдите с помощью `cd` в папку, указанную в сообщении, и выполните команду `claude respawn <id>` из сообщения. Сессия перезапустится из сохранённого диалога.
5000 * Шлюз доходит до сессии, только если [супервизор](/docs/ru/agent-view#the-supervisor-process) сам был запущен из оболочки, в которой экспортирован тот же шлюз. Если это не так, перезапустите его из этого терминала, как описано в разделе [Dispatch fails with `Could not resolve authentication method`](/docs/ru/agent-view#dispatch-fails-with-could-not-resolve-authentication-method), затем снова выполните команду перезапуска.
5001
5002До версии 2.1.302 фоновая сессия в такой ситуации вместо этого показывала ошибку входа, например [`Not logged in · Please run /login`](#not-logged-in), не называя папку.
5003
4819### Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER5004### Ошибки средства запуска CLAUDE\_CODE\_PROCESS\_WRAPPER
4820 5005
4821Переменная [`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ru/corporate-launcher) задана, но её значение нельзя использовать, поэтому Claude Code отказывается запускать затронутый процесс, а не запускает его без средства запуска. О проблемах конфигурации сообщается сообщением, которое начинается с имени переменной и указывает причину, например:5006Переменная [`CLAUDE_CODE_PROCESS_WRAPPER`](/docs/ru/corporate-launcher) задана, но её значение нельзя использовать, поэтому Claude Code отказывается запускать затронутый процесс, а не запускает его без средства запуска. О проблемах конфигурации сообщается сообщением, которое начинается с имени переменной и указывает причину, например:
5094 5279
5095## Предупреждения о конфигурации5280## Предупреждения о конфигурации
5096 5281
5097Claude Code записывает большинство этих сообщений в stderr, а не в беседу, и выводит большинство из них при запуске. Запись указывает, когда её сообщение появляется в другом месте, например в журнале отладки или как уведомление при запуске в представлении беседы, или в другое время, например [диагностическая строка unrecognized-model](#unrecognized-model-id-on-a-request) во время запроса.5282Чтобы найти предупреждение, которое Claude Code выдал при запуске интерактивной сессии, сначала посмотрите под баннером запуска, а затем в логе отладки:
5283
5284* **Строка под баннером запуска**: некоторые предупреждения о [правилах разрешений](/docs/ru/permissions), например [`⚠ Deny rule Bsh matches no tool · check for typos`](#matches-no-tool)
5285* **Лог отладки**: Claude Code ведёт этот лог только в режиме отладки. Чтобы прочитать предупреждения в нём, запустите Claude Code из оболочки командой `claude --debug-file <path>`, затем откройте файл по этому пути.
5286
5287В [неинтерактивном режиме](/docs/ru/headless) с текстовым выводом, вне [фоновой сессии](/docs/ru/agent-view), ищите предупреждения при запуске в stderr.
5288
5289До версии 2.1.305 в интерактивной сессии тоже нужно смотреть в stderr, в том числе для предупреждений о правилах разрешений, которые теперь отображаются как строки под баннером.
5098 5290
5099### Claude Code exited after an unrecoverable interface error5291### Claude Code exited after an unrecoverable interface error
5100 5292
5214 5406
5215### Working directory is a network path5407### Working directory is a network path
5216 5408
5217Claude Code не добавляет сетевые пути как рабочие каталоги. Поиск сетевого пути может связаться с хостом, который он называет, и на Windows этот контакт может отправить хосту ваши учётные данные, поэтому Claude Code отказывает в пути без его поиска. Вы видите это сообщение при выполнении `/add-dir` с таким путём или как предупреждение при запуске. Когда оно появляется при запуске, Claude Code запускается без этого каталога.5409Claude Code не добавляет сетевые пути в качестве рабочих каталогов. Обращение к сетевому пути может привести к соединению с указанным в нём хостом, а в Windows при таком соединении хосту могут быть отправлены ваши учётные данные. Поэтому Claude Code отклоняет путь, не обращаясь к нему.
5410
5411Вы видите это сообщение, когда выполняете `/add-dir` с сетевым путём:
5218 5412
5219```text theme={null}5413```text theme={null}
5220\\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).5414\\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).
5221```5415```
5222 5416
5417Если вместо этого вы передаёте такой путь при запуске, через `--add-dir` или в `permissions.additionalDirectories`, Claude Code запускается без этого каталога. В интерактивной сессии вы не увидите сообщение при запуске, потому что оно записывается в лог отладки вместе с другими [предупреждениями при запуске](#configuration-warnings).
5418
5223Пути, которые Claude Code отказывает таким образом, включают:5419Пути, которые Claude Code отказывает таким образом, включают:
5224 5420
5225* UNC shares такие как `\\server\share`5421* UNC shares такие как `\\server\share`
5465 5661
5466До версии 2.1.260 Claude Code сообщал о правиле с несовпадающими скобками как `Mismatched parentheses`.5662До версии 2.1.260 Claude Code сообщал о правиле с несовпадающими скобками как `Mismatched parentheses`.
5467 5663
5468### Is not matched by file permission checks5664### Matches no tool · check for typos
5665
5666Эта строка под баннером запуска называет [правило разрешений](/docs/ru/permissions) deny или ask, имя инструмента в котором Claude Code не распознаёт, поэтому правило не применяется к задуманному инструменту. Правило deny, записанное как `Bsh`, не применяется к Bash, как и правило, в котором вместо канонического имени инструмента используется подпись, отображаемая в транскрипте. Строка повторяет правило в том виде, в каком вы его записали:
5667
5668```text theme={null}
5669⚠ Deny rule Bsh matches no tool · check for typos
5670```
5469 5671
5470Claude 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`, поэтому он никогда не консультирует правило пути, которое называет один из других инструментов файлов. Он сохраняет правило и ничего больше не меняет; предупреждение называет правило, его источник в скобках и замену для записи:5672В [неинтерактивном режиме](/docs/ru/headless) с текстовым выводом Claude Code выводит предупреждение в stderr в более длинной форме:
5471 5673
5472```text theme={null}5674```text theme={null}
5473Permission 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).5675Permission deny rule "Bsh" matches no known tool — check for typos.
5474```5676```
5475 5677
5476**Что делать:**5678**Что делать:**
5477 5679
5680* Исправьте имя инструмента в правиле, например `Bash` вместо `Bsh`. Канонические имена можно найти в [справочнике по инструментам](/docs/ru/tools-reference).
5681* Чтобы узнать, где определено правило, выполните `/permissions` в сессии и выберите правило. В его подробностях указан источник, например `From project local settings` или `From CLI argument` для значения `--disallowedTools`.
5682* Если в подробностях указано `From enterprise managed settings`, перешлите эту строку тому, кто поддерживает ваши [управляемые настройки](/docs/ru/managed-settings), поскольку самостоятельно изменить это правило вы не можете.
5683
5684В [фоновой сессии](/docs/ru/agent-view) или с `--output-format json` либо `stream-json` Claude Code записывает предупреждение в лог отладки, а не в stderr. Запустите с `--debug`, чтобы сохранить его в `~/.claude/debug/<session-id>.txt`.
5685
5686До версии 2.1.305 интерактивная сессия при запуске выводила длинную форму в stderr вместо показа строки.
5687
5688### Is not matched by file permission checks
5689
5690Claude Code обнаружил [правило разрешений](/docs/ru/permissions#read-and-edit) `Write`, `NotebookEdit`, `MultiEdit` или `Glob` с путём в одном из ваших [файлов настроек](/docs/ru/settings#where-settings-live), в [управляемых настройках](/docs/ru/managed-settings) или в значении флага `--allowedTools`, `--disallowedTools` или `--settings`. Разрешения для файлов проверяются только по правилам `Edit` и `Read`, поэтому правило с путём, называющее один из других файловых инструментов, никогда не учитывается. Claude Code сохраняет правило и больше ничего не меняет.
5691
5692* **Интерактивная сессия**: полное предупреждение записывается в [лог отладки](#configuration-warnings), а правило deny или ask такого вида также отображается этой строкой под баннером запуска:
5693
5694 ```text theme={null}
5695 ⚠ Deny rule Write(docs/**) never matches · use Edit(docs/**)
5696 ```
5697
5698 Для правила allow такого вида строка не показывается. Чтобы узнать, где определено правило, выполните `/permissions` в сессии и выберите правило.
5699* **[Неинтерактивный режим](/docs/ru/headless) с текстовым выводом**: полное предупреждение в stderr называет правило, его источник в скобках и замену, которую следует записать:
5700
5701 ```text theme={null}
5702 Permission 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).
5703 ```
5704* **[Фоновая сессия](/docs/ru/agent-view) или `--output-format json` либо `stream-json`**: полное предупреждение записывается в лог отладки, а не в stderr, чтобы машиночитаемый вывод оставался чистым. Запустите с `--debug`, чтобы сохранить его в `~/.claude/debug/<session-id>.txt`.
5705
5706**Что делать:**
5707
5478* Замените `Write(path)`, `NotebookEdit(path)` и устаревшие `MultiEdit(path)` правила на `Edit(path)`. Правила `Edit` охватывают все инструменты редактирования файлов.5708* Замените `Write(path)`, `NotebookEdit(path)` и устаревшие `MultiEdit(path)` правила на `Edit(path)`. Правила `Edit` охватывают все инструменты редактирования файлов.
5479* Кроме как в `--allowedTools`, где Claude Code принимает правило `Glob` без предупреждения, замените правила `Glob(path)` на `Read(path)`.5709* Кроме как в `--allowedTools`, где Claude Code принимает правило `Glob` без предупреждения, замените правила `Glob(path)` на `Read(path)`.
5480* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг для `--allowed-tools` и `--disallowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.5710* Исправьте правило в источнике, указанном в скобках в полном предупреждении: это путь к файлу настроек или сам флаг для `--allowed-tools` и `--disallowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.
5481* Оставьте простые правила имён инструментов такие как `Write` или `Glob` в покое. Claude Code соответствует им на [tool level](/docs/ru/permissions#match-all-uses-of-a-tool) и не предупреждает о них.5711* Оставьте простые правила имён инструментов такие как `Write` или `Glob` в покое. Claude Code соответствует им на [tool level](/docs/ru/permissions#match-all-uses-of-a-tool) и не предупреждает о них.
5482* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.5712* Для правила из управляемых настроек в скобках полного предупреждения указано `managed policy settings`, а в подробностях правила в `/permissions` — `From enterprise managed settings`. Перешлите это предупреждение тому, кто поддерживает ваши управляемые настройки, поскольку самостоятельно устранить его вы не можете.
5483 5713
5484В [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 принимал эти правила без предупреждения.5714До версии 2.1.210 Claude Code принимал такие правила без предупреждения. До версии 2.1.305 интерактивная сессия выводила полное предупреждение в stderr.
5485 5715
5486### Has a wildcard before the rest of the command5716### Has a wildcard before the rest of the command
5487 5717
5488Claude 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) показывает правила соответствия.5718Claude 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) показывает правила соответствия.
5489 5719
5490Предупреждение существует, чтобы вы могли сузить правило, чей подстановочный знак шире, чем вы предполагали. Claude Code сохраняет правило и ничего не меняет о том, как оно соответствует; предупреждение называет правило и его источник в скобках:5720Предупреждение существует, чтобы вы могли сузить правило, подстановочный знак в котором шире, чем вы рассчитывали. Claude Code сохраняет правило и никак не меняет его сопоставление. В [неинтерактивном режиме](/docs/ru/headless) с текстовым выводом предупреждение в stderr называет правило и его источник в скобках:
5491 5721
5492```text theme={null}5722```text theme={null}
5493Permission 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 *)).5723Permission 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 *)).
5494```5724```
5495 5725
5726В интерактивной сессии полное предупреждение записывается в [лог отладки](#configuration-warnings), а правило отображается этой строкой под баннером запуска:
5727
5728```text theme={null}
5729⚠ Allow rule Bash(git -C * status *) allows any option at its * · use an exact value
5730```
5731
5732Чтобы узнать, где определено правило, выполните `/permissions` в сессии и выберите правило.
5733
5496**Что делать:**5734**Что делать:**
5497 5735
5498* Замените `*` перед подкомандой на точное значение, которое вы имеете в виду: `Bash(git checkout main)` вместо `Bash(git * main)`.5736* Замените `*` перед подкомандой на точное значение, которое вы имеете в виду: `Bash(git checkout main)` вместо `Bash(git * main)`.
5499* Переместите каждый `*` после подкоманды: `Bash(git status *)` вместо `Bash(git -C * status *)`. Напишите одно правило на подкоманду, которую вы хотите разрешить.5737* Переместите каждый `*` после подкоманды: `Bash(git status *)` вместо `Bash(git -C * status *)`. Напишите одно правило на подкоманду, которую вы хотите разрешить.
5500* Исправьте правило в источнике, который называет предупреждение в скобках: путь файла параметров или сам флаг `--allowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.5738* Исправьте правило в источнике, указанном в скобках в полном предупреждении: это путь к файлу настроек или сам флаг `--allowed-tools`. Путь `claude-settings-<hash>.json`, который не существует на диске, обозначает встроенное значение `--settings`. Исправьте JSON, который вы передаёте этому флагу.
5501* Если источник читает `managed policy settings`, перенаправьте предупреждение тому, кто поддерживает ваши управляемые параметры, так как вы не можете очистить его самостоятельно.5739* Для правила из управляемых настроек в скобках полного предупреждения указано `managed policy settings`, а в подробностях правила в `/permissions` — `From enterprise managed settings`. Перешлите это предупреждение тому, кто поддерживает ваши управляемые настройки, поскольку самостоятельно устранить его вы не можете.
5502 5740
5503В [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 принимал эти правила без предупреждения.5741В [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 принимал эти правила без предупреждения.
5504 5742
5743До версии 2.1.305 интерактивная сессия выводила полное предупреждение в stderr вместо показа строки.
5744
5505### Denying Bash also turns off the PowerShell tool5745### Denying Bash also turns off the PowerShell tool
5506 5746
5507Вы полностью отключили инструмент Bash, например с помощью `--disallowedTools Bash` или [правила deny](/docs/ru/permissions#match-all-uses-of-a-tool) в виде просто `Bash` или `Bash(*)` в одном из ваших файлов настроек. В Windows с установленным Git Bash [запрет Bash также отключает инструмент PowerShell](/docs/ru/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), поэтому сессия запускается без инструмента оболочки. Claude Code выводит это предупреждение при запуске:5747Вы полностью отключили инструмент Bash, например с помощью `--disallowedTools Bash` или [правила deny](/docs/ru/permissions#match-all-uses-of-a-tool) в виде просто `Bash` или `Bash(*)` в одном из ваших файлов настроек. В Windows с установленным Git Bash [запрет Bash также отключает инструмент PowerShell](/docs/ru/tools-reference#bash-deny-rules-also-turn-off-the-powershell-tool), поэтому сессия запускается без инструмента оболочки.
5748
5749В [неинтерактивном режиме](/docs/ru/headless) с текстовым выводом Claude Code выводит это предупреждение в stderr при запуске, а интерактивная сессия записывает его только в [лог отладки](#configuration-warnings):
5508 5750
5509```text theme={null}5751```text theme={null}
5510Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.5752Denying Bash also turns off the PowerShell tool, so Claude has neither. To use PowerShell, set CLAUDE_CODE_USE_POWERSHELL_TOOL=1.
5517 5759
5518В [фоновой сессии](/docs/ru/agent-view) или с `--output-format json` либо `stream-json` Claude Code записывает предупреждение в лог отладки, а не в stderr. Запустите с `--debug`, чтобы сохранить его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.287 Claude Code отключал инструмент PowerShell так же, но без вывода предупреждения.5760В [фоновой сессии](/docs/ru/agent-view) или с `--output-format json` либо `stream-json` Claude Code записывает предупреждение в лог отладки, а не в stderr. Запустите с `--debug`, чтобы сохранить его в `~/.claude/debug/<session-id>.txt`. До версии 2.1.287 Claude Code отключал инструмент PowerShell так же, но без вывода предупреждения.
5519 5761
5762До версии 2.1.305 интерактивная сессия тоже выводила предупреждение в stderr при запуске.
5763
5520### crossSessionInbound must be one of accept, hold, refuse5764### crossSessionInbound must be one of accept, hold, refuse
5521 5765
5522Файл параметров устанавливает [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) на значение, которое Claude Code не распознаёт, например опечатка `"reject"`. Второе предложение предупреждения зависит от того, какой файл содержит значение; в пользовательском, проектном, локальном или файле `--settings` оно читается:5766Файл параметров устанавливает [`crossSessionInbound`](/docs/ru/settings-reference#crosssessioninbound) на значение, которое Claude Code не распознаёт, например опечатка `"reject"`. Второе предложение предупреждения зависит от того, какой файл содержит значение; в пользовательском, проектном, локальном или файле `--settings` оно читается:
5566* Если сообщение называет ID модели, который эта версия не распознаёт, выполните `claude update`. Версия, которая распознаёт ID как 1M-context модель, применяет лимит без дополнительной конфигурации.5810* Если сообщение называет ID модели, который эта версия не распознаёт, выполните `claude update`. Версия, которая распознаёт ID как 1M-context модель, применяет лимит без дополнительной конфигурации.
5567* Если вы хотите, чтобы сеанс использовал полное окно модели вместо этого, отмените `CLAUDE_CODE_DISABLE_1M_CONTEXT`; предупреждение сообщает только, что лимит 200K не применяется5811* Если вы хотите, чтобы сеанс использовал полное окно модели вместо этого, отмените `CLAUDE_CODE_DISABLE_1M_CONTEXT`; предупреждение сообщает только, что лимит 200K не применяется
5568 5812
5569В [background session](/docs/ru/agent-view) или с `--output-format json` или `stream-json`, Claude Code записывает предупреждение в журнал отладки вместо stderr.5813В [неинтерактивном режиме](/docs/ru/headless) с текстовым выводом это предупреждение появляется в stderr. В интерактивной сессии, в [фоновой сессии](/docs/ru/agent-view) или с `--output-format json` либо `stream-json` оно записывается в лог отладки. Запустите с `--debug`, чтобы сохранить его в `~/.claude/debug/<session-id>.txt`.
5814
5815До версии 2.1.305 интерактивная сессия выводила предупреждение в stderr при запуске.
5570 5816
5571### Unrecognized model ID on a request5817### Unrecognized model ID on a request
5572 5818
5678Если ошибка не указана здесь или предложенное исправление не помогает:5924Если ошибка не указана здесь или предложенное исправление не помогает:
5679 5925
5680* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует [аутентификации](/docs/ru/authentication). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.5926* Запустите `/feedback` внутри Claude Code, чтобы отправить стенограмму и описание в Anthropic. Команда также предлагает открыть предварительно заполненную проблему GitHub. Отправка в Anthropic требует [аутентификации](/docs/ru/authentication). На Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry и других сторонних поставщиков, или когда учетные данные Anthropic не настроены, `/feedback` сохраняет локальный архив, который вы можете отправить представителю вашей учетной записи Anthropic.
5927* Если `/feedback` отвечает, что команда отключена политикой вашей организации, см. [описание этого сообщения](#feedback-is-disabled-by-your-organizations-policy)
5681* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку `/doctor` внутри Claude Code, чтобы найти и исправить проблемы настройки5928* Запустите `claude doctor` из вашей оболочки для диагностики только для чтения вашей установки или запустите проверку `/doctor` внутри Claude Code, чтобы найти и исправить проблемы настройки
5682* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов5929* Проверьте [status.claude.com](https://status.claude.com) на наличие активных инцидентов
5683* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub5930* Поищите [существующие проблемы](https://github.com/anthropics/claude-code/issues) на GitHub
