Интеграция для разработчиков≈ 5 мин чтения

Как подключить Claude Code к NeuroAPI

Практическая настройка локального Claude Code через Anthropic Messages в NeuroAPI — с явным base URL, моделью и безопасной проверкой credential.

Короткий ответ

Краткий ответ

Подключение Claude Code к NeuroAPI через открытый установщик для Windows и macOS: защищённый ключ, apiKeyHelper, автоматический каталог моделей и проверка через /status.

Профиль Claude Code

Отдельный адрес https://claude.neuroapi.host направляет Messages API и каталог моделей в профиль Claude Code. Старый путь https://neuroapi.host/v1/claude-code остаётся совместимым.

Ключ вне JSON

Установщик использует apiKeyHelper и защищённое хранилище ОС вместо plaintext credential.

Модель из каталога

Предпочтительная модель — опубликованная claude-opus-5-5. Launcher выбирает её при доступе вашего ключа.

Проверка /status

Claude Code показывает фактический base URL и источник credential в меню /status.

Поддержка Claude Code

Отдельный адрес claude.neuroapi.host направляет каталог моделей, Messages и подсчёт токенов в профиль Claude Code. На 29 сентября 2026 Claude Code 2.1.284 с Opus 5.5 прошёл чтение и правку файла, запуск теста и создание HTML-лендинга. Для других моделей и конкретного проекта проверяйте доступность маршрута и нужных инструментов.

Профиль /v1/claude-code предоставляет отдельный каталог и настройки меню моделей. Обычный адрес https://neuroapi.host также остаётся доступен для ручного подключения. Кэширование зависит от модели и повторяемости контекста: наличие маркера не гарантирует cache hit.

Что потребуется

Для launcher нужен Claude Code версии 2.1.284 или новее и обычный ключ NeuroAPI. Если клиента нет, установщик загрузит его из официального источника. Предпочтительная модель claude-opus-5-5 попадёт в ваш список при наличии доступа ключа, тарифа и маршрута; иначе launcher выберет первую доступную рекомендованную модель.

Claude Code сам добавляет /v1/messages к ANTHROPIC_BASE_URL. Для отдельного профиля укажите https://claude.neuroapi.host. Старый адрес https://neuroapi.host/v1/claude-code также поддерживается.

  • Claude Code CLI или локальное расширение Claude Code для VS Code.
  • Ключ NeuroAPI с достаточным балансом и лимитом.
  • Опубликованная модель семейства Claude.
  • Безопасный тестовый репозиторий без секретов в контексте.

Рекомендуемый способ: открытый установщик

Скачайте публичный репозиторий neurogen-dev/NeuroAPI, изучите исходники и запустите setup-windows.bat либо setup-macos.command. Установщик поставит отсутствующие клиенты и проверит доступ ключа к каталогам без платной генерации. Ключ не передаётся в аргументах команды, не попадает в историю shell и не сохраняется в settings.json.

Установщик создаёт отдельный Claude settings-файл с ANTHROPIC_BASE_URL и apiKeyHelper. На Windows helper читает DPAPI-защищённый секрет текущего пользователя, на macOS — login Keychain.

Обновлённый claude-neuroapi перед каждым запуском получает /v1/claude-code/client-settings и формирует отдельное меню из доступных вашему ключу моделей. Если каталог пуст или недоступен, запуск останавливается. Для этого не нужен специальный API-ключ.

Установщик выпускается отдельно от API. Проверьте, что используете обновлённую версию с /v1/claude-code и загрузкой client-settings: сам выпуск API не обновляет ранее установленный launcher.

  • Существующий ~/.claude/settings.json не перезаписывается.
  • Launcher claude-neuroapi использует installer-owned settings через --settings.
  • Один ключ можно заменить повторным безопасным запуском.
  • Исходники, модель угроз и uninstaller доступны в том же GitHub-репозитории.

Ручная настройка как запасной вариант

Для краткого ручного теста задайте ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL только в текущей сессии терминала. ANTHROPIC_AUTH_TOKEN отправляет значение как Authorization: Bearer.

Основная модель задаётся через ANTHROPIC_MODEL; Haiku для фоновых задач — через ANTHROPIC_DEFAULT_HAIKU_MODEL. Фоновые запросы оплачиваются по обычным ценам выбранной модели. Обе модели должны быть доступны ключу: если его список ограничен, включите claude-haiku-4-5.

Чтобы Claude Code показывал доступные вашему ключу модели NeuroAPI в меню /model, включите CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1. Профиль /v1/claude-code возвращает каталог с учётом ключа и тарифа; функция выключена самим Claude Code по умолчанию.

Для постоянной настройки предпочтительнее apiKeyHelper. Не помещайте credential в общий .claude/settings.json проекта: такой файл обычно коммитится и распространяется среди команды.

Примеры ниже используют обычный корневой адрес и опубликованную claude-opus-5-5. После включения discovery выберите доступный NeuroAPI ID через /model; без discovery укажите ID вручную. Discovery добавляет модели NeuroAPI в список Claude Code, а managed launcher заменяет встроенный список свежим каталогом ключа.

Проверка подключения

Запустите обновлённый claude-neuroapi и выполните /status. Для новой конфигурации Anthropic base URL должен показывать https://claude.neuroapi.host, а credential source — installer-owned apiKeyHelper. Проверьте, что выбранная модель доступна в полученном списке.

Затем отправьте короткий запрос. NeuroAPI сохраняет текущие служебные beta-заголовки Claude Code, context management, output config и свойства локально исполняемых tools, когда запрос обслуживается нативным совместимым маршрутом.

  • 401 — повторно сохраните ключ установщиком либо проверьте временный ANTHROPIC_AUTH_TOKEN.
  • Model not found — возьмите ID из живого каталога NeuroAPI.
  • invalid_request_error — проверьте размер контекста, параметры и доступность запрошенной функции. Не повторяйте без изменений запрос с заведомо неподдерживаемой возможностью.
  • Временная несовместимость маршрута — выбранная модель сейчас не может принять нативное расширение; выберите другой опубликованный Claude ID или тариф.
  • Не виден base URL — убедитесь, что запущен launcher claude-neuroapi.
  • Перед отправкой диагностического лога в поддержку удалите ключи, Authorization и содержимое рабочих файлов.

VS Code и границы совместимости

Локальное расширение Claude Code для VS Code проверяет credential до запуска. Для него Anthropic рекомендует продублировать переменные в VS Code setting claudeCode.environmentVariables.

Матрица совместимости: нативный маршрут сохраняет обычные stateless-поля Claude Code; конвертирующий bridge принимает только представимое базовое подмножество Messages и отклоняет нативные расширения до отправки запроса. Provider-owned container, remote MCP, premium speed и непроверенные серверные tools закрыты на обоих маршрутах.

Remote Control и Anthropic-hosted cloud-поверхности не используют эту локальную конфигурацию так же, как CLI.

NeuroAPI выдаёт собственный ключ для своего API. Это не официальный ключ Anthropic и не подписка Claude.

Windows: скачать и запустить

PowerShell
git clone --branch agents https://github.com/neurogen-dev/NeuroAPI.git
Set-Location .\NeuroAPI
.\setup-windows.bat

macOS: скачать и запустить

Shell
git clone --branch agents https://github.com/neurogen-dev/NeuroAPI.git
cd NeuroAPI
./setup-macos.command

Первый запуск в PowerShell

PowerShell
$env:ANTHROPIC_BASE_URL = "https://claude.neuroapi.host"
$env:ANTHROPIC_AUTH_TOKEN = "<NEUROAPI_API_KEY>"
$env:ANTHROPIC_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"

Set-Location "C:\path\to\project"
claude

Первый запуск в Bash или Zsh

Shell
export ANTHROPIC_BASE_URL="https://claude.neuroapi.host"
export ANTHROPIC_AUTH_TOKEN="<NEUROAPI_API_KEY>"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

cd /path/to/project
claude

Ручной settings.json с helper вместо plaintext-ключа

JSON
{
  "apiKeyHelper": "/absolute/path/to/get-neuroapi-key",
  "env": {
    "ANTHROPIC_BASE_URL": "https://claude.neuroapi.host",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}