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

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

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

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

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

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

Корневой base URL

Для Claude Code задайте https://neuroapi.host без суффикса /v1.

Ключ вне JSON

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

Явная модель

Укажите опубликованный ID Claude, чтобы клиент не выбрал отсутствующий default.

Проверка /status

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

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

Установите актуальный Claude Code, создайте ключ NeuroAPI и выберите опубликованную модель Claude в каталоге. Пример использует claude-sonnet-4-5; при изменении каталога замените его точным актуальным ID.

NeuroAPI принимает Anthropic Messages по адресу /v1/messages. Claude Code сам добавляет этот путь к ANTHROPIC_BASE_URL, поэтому в переменной нужен корень https://neuroapi.host.

  • 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/settings.json не перезаписывается.
  • Launcher claude-neuroapi использует installer-owned settings через --settings.
  • Один ключ можно заменить повторным безопасным запуском.
  • Исходники, модель угроз и uninstaller доступны в том же GitHub-репозитории.

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

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

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

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

Запустите claude-neuroapi и выполните /status. Строка Anthropic base URL должна показывать https://neuroapi.host, а credential source — installer-owned apiKeyHelper.

Затем отправьте короткий запрос. Если /status верен, но первый запрос падает, проверьте точный ID модели и совместимость используемых Claude Code-возможностей с Anthropic Messages в NeuroAPI.

  • 401 — повторно сохраните ключ установщиком либо проверьте временный ANTHROPIC_AUTH_TOKEN.
  • Model not found — возьмите ID из живого каталога NeuroAPI.
  • Ошибка anthropic-beta — временно проверьте CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1.
  • Не виден base URL — убедитесь, что запущен launcher claude-neuroapi.

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

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

Custom gateway может не поддерживать каждую новую beta-возможность Claude Code сразу. 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://neuroapi.host"
$env:ANTHROPIC_AUTH_TOKEN = "<NEUROAPI_API_KEY>"
$env:ANTHROPIC_MODEL = "claude-sonnet-4-5"

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

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

Shell
export ANTHROPIC_BASE_URL="https://neuroapi.host"
export ANTHROPIC_AUTH_TOKEN="<NEUROAPI_API_KEY>"
export ANTHROPIC_MODEL="claude-sonnet-4-5"

cd /path/to/project
claude

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

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