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

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

codex-neuroapi
claude-neuroapi

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

macOS

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

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

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

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

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

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

| Действие | Windows | macOS | |---|---|---| | Запрашивает ключ | Read-Host -AsSecureString | защищённый prompt /usr/bin/security | | Хранит ключ | DPAPI, текущий пользователь и компьютер | login Keychain текущего пользователя | | Codex | отдельный ~/.codex/neuroapi-host.config.toml | отдельный ~/.codex/neuroapi-host.config.toml | | Claude Code | отдельный installer-owned JSON через --settings | отдельный installer-owned JSON через --settings | | Получает ключ | command-backed auth helper | apiKeyHelper / Keychain helper | | Существующие конфиги | не перезаписываются | не перезаписываются |

Установщик не вызывает 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:

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

Claude Code:

Запустите claude-neuroapi.
Выполните /status.
Проверьте 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 файлы и локально сохранённый ключ. Удалённый ключ через этот пакет восстановить нельзя.