NeuroAPI: Codex CLI и Claude Code через российский AI API

Открытые установщики для подключения Codex CLI и Claude Code к NeuroAPI на Windows и macOS.

NeuroAPI — российский AI API-сервис: единый доступ к моделям OpenAI, Anthropic Claude, Google Gemini, DeepSeek, генерации изображений и видео с оплатой в рублях. Проект работает от российского ООО, инфраструктура сервиса размещена в РФ. Актуальные модели и цены всегда проверяйте в живом каталоге.

English version

Установка в один запуск

Сначала установите сам Codex CLI и/или Claude Code, затем создайте API-ключ в кабинете NeuroAPI.

Windows

1. Скачайте ZIP с установщиками и распакуйте его.
2. Дважды щёлкните setup-windows.bat.
3. Вставьте API-ключ в скрытый запрос PowerShell.
4. Откройте новый терминал и запустите:

codex-neuroapi
claude-neuroapi

Права администратора не нужны. BAT-файл не принимает ключ через аргументы командной строки.

macOS

1. Скачайте ZIP с установщиками и распакуйте его.
2. Откройте Terminal в распакованной папке.
3. Запустите:

chmod +x setup-macos.command
./setup-macos.command

4. Вставьте API-ключ в защищённый запрос macOS Keychain.
5. Запустите:

~/.local/bin/codex-neuroapi
~/.local/bin/claude-neuroapi

Скрипт не использует sudo и не редактирует shell profile. Если ~/.local/bin уже входит в PATH, достаточно команд codex-neuroapi и claude-neuroapi.

Что именно делает установщик

Установщик не вызывает API и не отправляет ключ в сеть. Сеть используется уже Codex CLI или Claude Code при ваших запросах к https://neuroapi.host.

Почему ключ не лежит в конфиге

• ключ не принимается аргументом BAT/shell-команды;
• ключ не сохраняется в .env, TOML, JSON или репозитории;
• Windows шифрует значение через DPAPI без отдельного сохранённого master key;
• macOS сохраняет значение штатной командой Keychain с интерактивным -w;
• helpers печатают только токен в stdout в момент, когда его запрашивает клиент.

Это защищает от случайной публикации ключа, но не от вредоносной программы, уже работающей от имени того же пользователя. Полная модель угроз: docs/security.md.

Что будет создано

Windows:

• %LOCALAPPDATA%\NeuroAPIAgents\ — helper, Claude settings, DPAPI-ciphertext и launchers;
• %USERPROFILE%\.codex\neuroapi-host.config.toml — отдельный профиль Codex;
• %LOCALAPPDATA%\NeuroAPIAgents\bin — одна запись в пользовательском PATH.

macOS:

• ~/.local/share/neuroapi-agents/ — helper и Claude settings;
• ~/.codex/neuroapi-host.config.toml — отдельный профиль Codex;
• ~/.local/bin/codex-neuroapi и ~/.local/bin/claude-neuroapi;
• Keychain item host.neuroapi.agents.api-key.

Каждый удаляемый файл имеет узкий ownership-маркер. Если путь уже занят чужим файлом, установка завершится с ошибкой вместо перезаписи.

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

Codex CLI:

1. Запустите codex-neuroapi.
2. Выполните /debug-config.
3. Проверьте профиль neuroapi-host, provider neuroapi и https://neuroapi.host/v1.

Claude Code:

1. Запустите claude-neuroapi.
2. Выполните /status.
3. Проверьте base URL https://neuroapi.host и credential source apiKeyHelper.

Примеры используют gpt-5.6-sol и claude-sonnet-4-5. ID моделей меняются: при model not found возьмите точное имя из каталога NeuroAPI или GET /v1/models.

Удаление и замена ключа

• Чтобы заменить ключ, повторно запустите setup-файл — защищённое значение обновится.
• Windows: uninstall-windows.bat.
• macOS: ./uninstall-macos.command.

Uninstaller удаляет только installer-owned файлы и локально сохранённый ключ. Удалённый ключ через этот пакет восстановить нельзя.

Документация

• Модель безопасности
• Ручная настройка и созданные файлы
• Решение проблем
• Codex через NeuroAPI
• Claude Code через NeuroAPI
• OpenAI-совместимый API
• Модели и цены

Проверяемость

GitHub Actions выполняет:

• PowerShell syntax + Windows DPAPI smoke test с тестовым токеном;
• Bash syntax + macOS smoke test с mock Keychain;
• ShellCheck;
• JSON/TOML parse checks;
• поиск случайно добавленных секретов и небезопасных способов передачи ключа.

Реальный пользовательский ключ никогда не нужен CI.