Skip to main content
Claude Code использует нативный Anthropic Messages. Base URL NexusAPI — https://nexusapi.link; не добавляйте /v1.

Системные требования

  • macOS 13+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ или Windows 10 версии 1809+;
  • не менее 4 ГБ памяти и процессор x64 или ARM64;
  • сеть с доступом к NexusAPI;
  • при работе в Git Bash на Windows можно дополнительно установить Git for Windows.

1. Установка Claude Code

Используйте официальный установщик:
Также доступны winget install Anthropic.ClaudeCode для Windows и brew install --cask claude-code для macOS. Проверьте установку:

Windows WinGet

macOS Homebrew

2. Создайте ключ NexusAPI

В Управлении токенами → Добавить токен выберите группу, содержащую модель, нужную для Claude Code, и задайте лимит. Не судите по одному названию модели: проверьте каталог или матрицу возможностей.

Выберите безопасные параметры ключа

Используйте понятное проектное имя и подходящий лимит. Ограничение модели и IP allowlist включайте только при понимании последствий; для временных тестовых ключей задавайте срок действия.

3. Создайте пользовательскую конфигурацию

Найдите каталог конфигурации

macOS, Linux, WSL и Git Bash:
В Windows PowerShell сначала создайте каталог, затем откройте файл настроек:

Задайте переменные окружения

Объедините эти значения с существующим env, не затирая MCP и разрешения:
Сохраняйте это в каталоге пользователя, а не в репозитории проекта.
Отключайте экспериментальные поля только при явной ошибке совместимостиЕсли текст ошибки прямо упоминает context_management или неподдерживаемые экспериментальные входные поля, добавьте в env значение CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 и проверьте снова. Оно отключает часть preview-полей и не является настройкой по умолчанию.

4. Запуск и проверка

Откройте новый терминал, перейдите в каталог проекта и выполните:
Затем выполните /status. Убедитесь, что Anthropic base URL — https://nexusapi.link, а источником аутентификации указан ANTHROPIC_AUTH_TOKEN, и отправьте короткий вопрос. Доверяйте только знакомым рабочим каталогам.

Частые проблемы

Invalid API Key · Please run /login

Проверьте обе переменные, состояние ключа и перезапуск терминала. Не исправляйте это прямым редактированием внутренних файлов состояния входа Claude.

Не удаётся подключиться к сервисам Anthropic

Выполните claude doctor, проверьте JSON в settings.json и две переменные окружения, затем откройте терминал заново. Если ошибка остаётся, сохраните её текст, claude --version и вывод claude doctor.
Не перезаписывайте скриптом внутренние поля .claude.json. Они могут меняться между версиями, а перезапись способна удалить состояние входа или другие настройки.

PowerShell блокирует установщик

Сначала используйте WinGet или официальный установщик из Windows CMD. Если вы подтвердили, что проблема только в локальной политике выполнения, измените её лишь для текущего пользователя:
Не меняйте глобальную политику компьютера только для установки клиента.

fetch failed

  1. Отправьте обычный короткий запрос. Если он работает, проблема, вероятно, в WebFetch или другой отдельной сетевой функции.
  2. Если не работает ни один вызов модели, выполните claude doctor и проверьте Base URL через /status.
  3. Проверьте DNS, firewall, корпоративную сеть или доверенный прокси для nexusapi.link.
  4. Откройте новый терминал и проверьте один раз. При постоянной ошибке сохраните версию, вывод doctor, текст ошибки и Request ID, затем пройдите самопроверку.

Статус offline

Вспомогательные функции могут проверять отдельные сервисы. Подтвердите реальный вызов через /status и короткий запрос к модели, прежде чем считать gateway недоступным.

WebFetch не работает, но обычный чат работает

WebFetch может использовать отдельные проверки безопасности доменов и внешний сетевой доступ. Если короткий текстовый запрос успешен, не меняйте Base URL NexusAPI и разбирайте ошибку WebFetch по сетевым правилам Claude Code.

API-запрос не выполняется

Завершите текущую сессию, откройте новую сессию claude и выполните одну короткую проверку. При повторении ошибки сохраните Request ID и пройдите самопроверку.

Официальные материалы