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

    Как подключить 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"
  }
}