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

    Как подключить Codex CLI к NeuroAPI

    Воспроизводимая настройка локального Codex CLI через custom provider NeuroAPI — с безопасным хранением ключа и явной проверкой Responses-совместимости.

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

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

    Подключение Codex CLI к NeuroAPI через открытый установщик для Windows и macOS: защищённое хранение ключа, отдельный профиль, Responses API и проверка /debug-config.

    Локальный Codex CLI

    Инструкция относится к терминальному Codex CLI с пользовательским файлом конфигурации.

    Responses API

    Codex поддерживает для custom provider только wire_api = "responses".

    Открытый установщик

    BAT и macOS-скрипт опубликованы на GitHub: действия можно проверить до запуска.

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

    В примере указан gpt-5.6-sol; перед запуском проверьте его доступность и точный ID.

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

    Установите актуальный Codex CLI, создайте ключ NeuroAPI и убедитесь, что выбранная модель опубликована в каталоге. Для Codex нужен маршрут OpenAI Responses, а не только Chat Completions.

    Пример ниже использует gpt-5.6-sol. Если модель недоступна в вашем тарифе или каталоге, замените значение model на опубликованный ID модели с совместимыми инструментами и Responses API.

    • Codex CLI, запущенный локально из терминала.
    • Ключ NeuroAPI с достаточным лимитом.
    • Опубликованная модель, подходящая для программирования и tool calls.
    • Доступ к POST /v1/responses через https://neuroapi.host/v1.

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

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

    На Windows секрет сохраняется в зашифрованном DPAPI-файле текущего пользователя, на macOS — в login Keychain. Codex получает токен через официальный command-backed auth helper.

    • Существующий ~/.codex/config.toml не перезаписывается.
    • Создаётся отдельный профиль ~/.codex/neuroapi-host.config.toml.
    • Повторный запуск обновляет только файлы, принадлежащие установщику.
    • Исходный код, модель угроз и удаление опубликованы в том же репозитории.

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

    Без установщика добавьте provider в пользовательский ~/.codex/config.toml или в отдельный user-profile. Проектный .codex/config.toml поддерживает обычные настройки, но актуальный Codex намеренно игнорирует там model_provider, model_providers и credential-routing keys.

    Для краткого теста можно передать ключ через NEUROAPI_API_KEY только в текущую сессию терминала. Не сохраняйте секрет в репозитории, общем project config или примере для команды.

    • model_provider должен совпадать с ID секции model_providers.neuroapi.
    • base_url заканчивается на /v1.
    • env_key содержит имя переменной, а не сам секрет.
    • В текущей документации Codex wire_api принимает responses.

    Проверьте фактическую конфигурацию

    В запущенном Codex выполните /debug-config и проверьте, что выбран provider neuroapi и пользовательский config.toml. После этого отправьте небольшой запрос на анализ проекта.

    Если клиент сообщает о неподдерживаемом endpoint или формате, сначала проверьте wire_api, наличие /v1 в base_url и совместимость выбранной модели с Responses API.

    • 401 — повторно сохраните ключ установщиком либо проверьте временную NEUROAPI_API_KEY.
    • Model not found — возьмите точный ID из текущего каталога.
    • Responses error — проверьте модель и документацию POST /v1/responses.
    • Старый конфиг — обновите Codex CLI и повторите /debug-config.

    Граница этой интеграции

    Custom model providers — функция локальных клиентов Codex. Эта инструкция не обещает, что тот же provider автоматически применяется к Codex cloud, ChatGPT или другим размещённым OpenAI-поверхностям.

    NeuroAPI выдаёт собственный ключ доступа. Это не официальный API-ключ OpenAI и не подписка ChatGPT.

    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

    Пользовательский ~/.codex/config.toml

    TOML
    model = "gpt-5.6-sol"
model_provider = "neuroapi"

[model_providers.neuroapi]
name = "NeuroAPI"
base_url = "https://neuroapi.host/v1"
env_key = "NEUROAPI_API_KEY"
wire_api = "responses"

    Запуск из PowerShell

    PowerShell
    $env:NEUROAPI_API_KEY = "<NEUROAPI_API_KEY>"
Set-Location "C:\path\to\project"
codex

    Запуск из Bash или Zsh

    Shell
    export NEUROAPI_API_KEY="<NEUROAPI_API_KEY>"
cd /path/to/project
codex