Решение проблем

Claude Code не подключается: диагностика ошибок

У Claude Code есть несколько независимых этапов: запуск команды, авторизация, запрос к модели и выполнение локальных действий. Найдите сбойный этап до изменения DNS.

Команда OvertNetоколо 3 мин чтения

Ноутбук с терминалом и два отдельных соединения к облакам
Иллюстрация. Соединение модели и сеть рабочего окружения проверяются отдельно.

Открытый сайт Claude не подтверждает, что CLI подключился к модели. Терминал, редактор и браузер могут работать с разными настройками сети. Начните с конкретного сообщения Claude Code и этапа, на котором оно появляется.

Проверьте запуск команды

В том же терминале, где возникает ошибка, выполните:

claude --version

Если команда не найдена, проблема находится на этапе установки или поиска исполняемого файла. DNS в этом случае не исправляет отсутствие команды. Проверьте способ установки по документации Anthropic и перезапустите терминал после изменения окружения.

Для встроенной диагностики установленных компонентов в справке Anthropic предусмотрен claude doctor. Прочитайте результат и предлагаемые действия до их применения. Сетевое сообщение, ошибка установки и несовместимость расширения требуют разных решений.

  1. БраузерМожет использовать свой DoH
  2. ПриложениеИспользует настройки своей среды
  3. Удалённый процессПроверяется на удалённом компьютере
Настройка одного процесса не подтверждает подключение остальных.

Отделите вход от запроса к модели

Укажите, что произошло: не открылся экран входа, браузер не вернулся к CLI, вход завершился, но первый запрос отклонен. Если вы используете разные учетные записи в браузере и CLI, сравнение может оказаться непоказательным.

Ошибка об организации, правах модели, лимите или ключе относится к соответствующим условиям провайдера. Подписка OvertNet обеспечивает свой сетевой сервис и не заменяет доступ Anthropic.

Уточните, где выполняется Claude Code

Локальный терминал, WSL, контейнер и SSH-сеанс — разные среды. Например, команда, запущенная по SSH, работает на удаленной машине. Настройка DNS на ноутбуке не становится автоматически настройкой этого сервера.

Проверьте сеть именно той среды, где работает CLI. Не меняйте конфигурацию удаленной или корпоративной машины без понимания ее правил. Для обращения достаточно указать тип среды и ОС: открывать доступ к машине поддержке на первом шаге не требуется.

Проверьте явный прокси

В документации Claude Code описана работа через прокси и корпоративную TLS-инфраструктуру. Если у вас заданы HTTP_PROXY или HTTPS_PROXY, дальнейшее соединение может зависеть от этого прокси, даже когда системный DNS уже изменен.

Проверьте, не осталась ли настройка от предыдущего способа подключения. Для первичного отчета хватит отметки «прокси задан» и описания среды. Полный вывод переменных окружения может раскрыть ключи или пароль в адресе прокси, поэтому его не нужно публиковать.

Проверьте OvertNet и TLS

  1. Убедитесь, что нужное устройство активно в кабинете OvertNet.
  2. Проверьте актуальность конфигурации и ее применение к нужной сети.
  3. Сопоставьте настройку CLI-среды с проверкой DNS.
  4. Повторите тот же небольшой запрос в Claude Code.

При ошибке TLS сохраните ее текст. Проверку сертификатов отключать не нужно: это скрывает причину и меняет свойства защищенного соединения. Проверьте часы устройства и правильность адреса; вопросы корпоративного центра сертификации решайте с администратором.

Как выглядит полезная проверка результата

Используйте короткий запрос без файлов проекта и секретов, в пределах вашего доступа и лимитов. Если вход прошел, но запрос не проходит, сохраните ответ об ошибке. Если модель отвечает, а локальная команда не выполняется, исследуйте права и состояние рабочего окружения отдельно от DNS.

Что передать поддержке

Запишите версию Claude Code, ОС, тип запуска, время с часовым поясом и точный этап сбоя. Добавьте наличие VPN или прокси и результат проверки устройства OvertNet. Ключи API, токены, файлы учетных данных и полный терминальный журнал с содержимым проекта в открытое обсуждение не отправляйте.

Источники

Названия пунктов настроек могут отличаться в зависимости от версии системы или приложения.