Claude Code не работает: разбор по симптомам

Материал редакции Зерокодера. Мы ведём несколько продакшн-проектов на Claude Code, так что чинили почти каждый из описанных сбоев на своих машинах. Обновлено: июль 2026.

«Claude code не работает» — это не одна поломка, а с десяток разных: не находится команда после установки, не проходит логин, регион-блок в России, упёрлись в лимит, не подключается MCP или CLI устарел под новые модели. Первый шаг всегда один — claude doctor: он покажет, что именно сломалось, вместо переустановки наугад.

Коротко, что чинить по симптому:

• command not found: claude — это не поломка, а не прописанный PATH.
• Не проходит логин — чистая переавторизация: /logout → перезапуск → /login.
• App unavailable in region — регион-блок; Claude Code недоступен в стране.
• This organization has been disabled при живой подписке — ваш старый ANTHROPIC_API_KEY молча перекрыл вход в аккаунт.
• rate limit / 429 — лимит плана или ключа, а не баг.
• MCP Failed to connect — проверяйте URL и авторизацию, а не переустанавливайте.

Дальше — по каждому блоку с конкретными командами.

С чего начинать: диагностика вместо переустановки

Прежде чем сносить и ставить заново, запустите диагностику. По официальной документации Anthropic, claude doctor из обычного шелла (или /doctor внутри сессии) печатает отчёт по установке, настройкам и расширениям и предлагает фиксы, а /mcp показывает статус MCP-серверов, /status — какая аутентификация активна сейчас. На наших проектах это экономит львиную долю времени: половина «поломок» оказывается неверным PATH или лишней переменной окружения, а не сломанным CLI.

Мини-вывод: сначала claude doctor и /status, потом уже гипотезы.

Не устанавливается или «command not found: claude»

Самый частый ложный сбой. Ошибка command not found: claude (или 'claude' is not recognized на Windows) после успешной установки означает не поломку, а что каталог установки не в PATH. Согласно официальному гайду по установке Anthropic{rel=»nofollow»}, установщик кладёт бинарь в ~/.local/bin/claude на macOS/Linux или в %USERPROFILE%\.local\bin\claude.exe на Windows. Фикс — открыть новый терминал или добавить этот каталог в PATH.

Ещё три частые причины, по той же официальной справке:

• Права и sudo. Не ставьте через sudo — частая причина в глобальном каталоге npm под root. Официальный фикс — нативный установщик: curl -fsSL https://claude.ai/install.sh | bash.
• WSL берёт Windows-npm. В WSL npm нередко подхватывает Windows-версию и падает с несовпадением платформы. Сначала npm config set os linux, затем npm install -g @anthropic-ai/claude-code --force. Без sudo.
• Не та команда под ОС. На Windows ставят из PowerShell: irm https://claude.ai/install.ps1 | iex. Ошибки 'irm' is not recognized, token '&&' is not valid или parameter name 'fsSL' означают, что вы скопировали команду для другой оболочки.

И проверьте Node.js: по справке Anthropic, Claude Code требует Node.js версии 18 или новее — node -v покажет вашу.

Мини-вывод: 8 из 10 «не ставится» — это PATH, sudo или Windows-npm в WSL, а не битый пакет.

Если ставите с нуля и хотите пошагово — у нас есть отдельный разбор установки Claude Code.

Ошибки авторизации и логина

Если логин не проходит по неочевидной причине, официальная документация советует чистую переавторизацию: /logout, закрыть Claude Code, запустить claude заново и войти. Ошибка OAuth error: Invalid code означает, что код входа истёк или обрезался при копировании — вводите быстрее и целиком.

Отдельный случай — вход по SSH, в WSL2 или в контейнере. Там браузер открывается на другом хосте, и OAuth-callback не доходит до локального сервера. По официальной справке Anthropic, после входа браузер показывает код — его надо вставить обратно в терминал; либо нажать c, чтобы скопировать URL входа и открыть его вручную на своей машине.

А API Error: 403 Forbidden после логина проверяют так: у Pro/Max — активна ли подписка в настройках claude.ai; у Console — есть ли у аккаунта роль «Claude Code» или «Developer».

Мини-вывод: почти любой залипший логин лечится /logout и повторным входом; по SSH — ручной ввод кода.

Claude Code не работает в России

Если вы видите App unavailable in region — это не ошибка вашей настройки, а регион-блок. По официальному списку поддерживаемых стран Anthropic{rel=»nofollow»}, сервис доступен только в перечисленных странах, и России в этом списке нет. Та же строка «App unavailable in region» всплывает и при установке, если запрос ушёл из неподдерживаемого региона.

Здесь честно: официального способа «обойти» блок Anthropic не публикует, и мы его не рекомендуем — это вопрос соответствия условиям сервиса, а не технический баг. Практически это означает, что при доступе из РФ-адреса возможны отказы на входе и обрыв соединений. Технические детали доступа мы разбираем отдельно — Claude Code и доступ из России, — но суть регион-блока именно такая: страна вне списка поддержки.

Мини-вывод: App unavailable in region = страна не поддержана, а не сломанный клиент.

«Организация отключена» при живой подписке — ловушка API-ключа

Самый коварный симптом. Вы платите за Pro или Max, а Claude Code выдаёт API Error: 400 ... This organization has been disabled. По официальной документации по устранению неполадок, причина — переменная окружения ANTHROPIC_API_KEY перекрывает подписку. Обычно это старый ключ от прошлого проекта или работодателя, оставшийся в профиле шелла.

Дело в приоритете. Официальный порядок разрешения учётных данных такой: сначала ANTHROPIC_API_KEY, затем apiKeyHelper, затем CLAUDE_CODE_OAUTH_TOKEN, затем сохранённый токен /login, и только потом сторонний провайдер. То есть заданный ключ всегда старше входа в аккаунт. Фикс:

И уберите строку export ANTHROPIC_API_KEY=... из ~/.zshrc, ~/.bashrc или ~/.profile, чтобы она не возвращалась. На Windows проверьте профиль PowerShell и пользовательские переменные среды. Затем /status покажет, какой метод аутентификации активен. На наших машинах это была причина №1 среди «подписка вроде есть, а не работает».

Мини-вывод: «organization disabled» при оплаченной подписке — это env-переменная, а не проблема биллинга.

Лимиты и rate-limit: что именно упёрлось

«Rate limit reached» — это не один лимит. По официальному справочнику ошибок Claude Code, You've hit your session limit, weekly limit или You've hit your Opus limit означают исчерпанный rolling-лимит плана: ждать сброса, переключить модель через /model или докупить через /usage-credits. Сами лимиты и время сброса видно в /usage.

Отдельно — Request rejected (429): по той же документации это лимит на API-ключ или проект, а не квота плана. Проверьте /status, подтвердите учётку, при необходимости запросите более высокий тир. Важная деталь: Claude Code сам повторяет серверные ошибки 5xx, 529 Overloaded и временные 429 до 10 раз с экспоненциальной задержкой — так что часть «лимитов» рассасывается без вашего участия.

Мини-вывод: сначала определите, чей лимит — плана (/usage) или ключа (/status), и лечите соответственно.

MCP не подключается: дерево решений

Если MCP-сервер показывает ✗ Failed to connect, не переустанавливайте наугад. По официальному гайду по MCP{rel=»nofollow»}, статус проверяют командой claude mcp list из шелла или /mcp в сессии, а для HTTP-сервера — простукивают URL через curl -I. Трактовка ответа:

• 404 или 405 — сервер жив (многие MCP-эндпоинты отвечают только на POST), проблема не в сети.
• 401 или 403 — сервер доступен, но нужна авторизация: браузерный вход или токен через --header.
• Нет ответа вообще — проверяйте URL и сеть.

Ещё частая причина ложной паники — таймаут. Дефолтный таймаут старта MCP-сервера 30 секунд, а первый запуск stdio-сервера бывает медленным, пока npx качает пакет. Первый claude mcp list может показать «Failed to connect» — подождите и повторите, а лимит поднимите переменной:

Мини-вывод: curl -I по URL сервера за десять секунд отделяет проблему сети от проблемы авторизации. Подробнее про подключение — в разборе MCP в Claude Code.

Node.js и обновление: сломалось после новых моделей

Свежий и неочевидный сбой. После релиза новых моделей команда пишет промпт — и получает thinking.type.enabled is not supported for this model. По официальному справочнику ошибок, это значит, что ваш Claude Code слишком старый для модели. Лечится обновлением claude update, но с конкретными минимальными версиями: Opus 4.7 требует v2.1.111+, Opus 4.8 — v2.1.154+, Sonnet 5 — v2.1.197+.

Сюда же — устаревший Node.js. Если CLI ведёт себя странно, а node -v показывает версию ниже 18, обновите Node (например, через nvm install --lts) и переустановите Claude Code нативным установщиком.

Мини-вывод: после каждого крупного релиза моделей первым делом claude update — половина «внезапно перестало» это version-gate.

Сервер лежит: 500 и 529

Иногда дело вообще не в вас. API Error: 500 Internal server error и Repeated 529 Overloaded errors — серверные сбои и перегрузка на стороне API. По официальной документации, фикс простой: проверить status.claude.com, подождать и повторить, а при 529 можно переключить модель через /model. Отдельная строка — Prompt is too long: переполнено контекстное окно, помогают /compact, /clear, проверка /context и отключение неиспользуемых MCP-серверов.

Мини-вывод: перед тем как винить свою настройку, гляньте статус-страницу — при массовом дауне чинить у себя нечего.

Итоговая карта: строка ошибки → команда

Общий принцип: Claude Code почти никогда не «сломан целиком». Есть конкретный симптом, конкретная строка ошибки и конкретная команда. Начинайте с claude doctor, читайте текст ошибки дословно — и чините точечно.