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 с https://neuroapi.host/v1/codex и supports_websockets = true, а профиль Claude Code — с https://neuroapi.host/v1/claude-code. Выпускайте и распространяйте установщик только после публикации серверных профилей: должны пройти авторизованные проверки GET /v1/codex/models, HTTP/WebSocket /v1/codex/responses, GET /v1/claude-code/client-settings и Claude Messages/count_tokens. Подготовленный код не доказывает доступность этих адресов в production; setup намеренно не вызывает API для проверки ключа.

Уже заданный CODEX_HOME учитывается для профиля и не изменяется; сохраняйте одинаковое значение при установке, запуске и удалении.

Нужен актуальный Codex с отдельными profile-файлами: codex --help должен описывать --profile как загрузку <name>.config.toml. Старые версии с [profiles.name] в общем конфиге обновите перед установкой. Для диагностики WebSocket можно временно поставить supports_websockets = false в созданном профиле, сохранив /v1/codex и credential helper. Подробнее — решение проблем.

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

Сначала установите сам 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.

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

Действие	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-neuroapi или claude-neuroapi запускатель получает актуальный каталог с https://neuroapi.host, затем клиент использует API при ваших запросах.

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

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

Это защищает от случайной публикации ключа, но не от вредоносной программы, уже работающей от имени того же пользователя. Полная модель угроз: 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/codex.

Claude Code:

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

При каждом запуске launcher получает актуальный список для вашего обычного ключа NeuroAPI. Codex использует отдельный каталог, Claude Code — настроенное меню; фиксированных моделей в установщике нет. Нужны Codex 0.147.0+ и Claude Code 2.1.280+. При ошибке обновления или пустом списке запуск останавливается, не возвращаясь к старым моделям. Подробности и ограничения managed-политик: ручная настройка.

Рекомендуемый серверный набор на 26.09.2026: Codex — GPT-6 Sol, Astra и Luna; Claude Code — Opus 5.5 (claude-opus-5-5, приоритетный), Sonnet 5, Haiku 4.5 и Fable 5.1. Opus 5.5 выбирается после публикации модели на сервисе и появления доступа у ключа; до этого используется следующая доступная рекомендация. Официальный ID: Anthropic.

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

• Чтобы заменить ключ, повторно запустите 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.