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

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

Пакет настраивает клиенты в терминале через команды codex-neuroapi и claude-neuroapi. При отдельном согласии он также подключает Codex Desktop через пользовательский ~/.codex/config.toml. Claude Desktop настраивается в самом приложении по отдельной инструкции.

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

English version

Совместимость версии

Эта версия создаёт профиль Codex с https://codex.neuroapi.host/v1 и supports_websockets = true, а профиль Claude Code — с https://claude.neuroapi.host. Codex-профиль включает hosted web search (web_search = "live") через NeuroAPI и отключает плагины в отдельном CLI-профиле (plugins = false, remote_plugin = false), чтобы запуск с API-ключом не зависел от синхронизации ChatGPT/Git-каталогов. Команды, чтение и редактирование файлов, а также отдельно настроенные MCP остаются доступны. Настройки plugins Desktop установщик сохраняет; при ненужных плагинах их можно отключить вручную. Multi-agent, goals, apps и browser use в CLI-профиле отключены до отдельной проверки их исполнения. Установщик проверяет доступ ключа к обоим каталогам без платной генерации. После установки отправьте короткий реальный запрос и проверьте его в истории использования NeuroAPI: проверка каталога сама по себе не подтверждает генерацию.

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

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

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

Создайте API-ключ в кабинете NeuroAPI. Если Codex CLI или Claude Code отсутствуют либо устарели, установщик загрузит актуальные версии из официального источника Codex и официального источника Claude Code.

Ссылка на ZIP ведёт в опубликованную ветку agents. Изменения открытого PR появятся в этом архиве только после слияния в agents.

Windows

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

codex-neuroapi
claude-neuroapi

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

macOS

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

bash setup-macos.command

4. Вставьте API-ключ в защищённый запрос macOS Keychain.
5. Если используете Codex Desktop, ответьте «да» на отдельный вопрос установщика и перезапустите приложение. Установщик создаст резервную копию вашего пользовательского конфига.
6. Запустите:

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

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

Claude Desktop устанавливается отдельно. Установщик не меняет закрытые настройки приложения: включите Developer Mode и укажите NeuroAPI в штатной форме Configure Third-Party Inference по инструкции для Claude Desktop. Для Codex Desktop при установке ответьте «да» на отдельный вопрос, затем перезапустите приложение и создайте новую локальную задачу.

Если вы уже пробовали подключиться и получали ошибки, сначала пройдите восстановление старой настройки. Оно сохраняет ваши проекты и помогает найти старый URL, профиль или источник ключа.

Хотите настроить всё вручную? В инструкции с готовыми фрагментами указаны точные пути для Windows и macOS, содержимое файлов Codex CLI и Claude Code, ручная настройка Codex Desktop с защищённым helper и поля формы Claude Desktop. Настоящий ключ вводится скрыто в терминале или в форме приложения; в TOML/JSON его вставлять не нужно.

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

Действие	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
Codex Desktop по согласию	пользовательский config.toml, DPAPI helper, каталог доступных моделей	пользовательский config.toml, Keychain helper, каталог доступных моделей
Существующий config.toml	резервная копия и атомарное изменение только по согласию; конфликт останавливает установку	резервная копия и атомарное изменение только по согласию; конфликт останавливает установку

Установщик отправляет ключ только в NeuroAPI для проверки доступных моделей; платной генерации при настройке нет. При запуске codex-neuroapi или claude-neuroapi запускатель вновь получает актуальный каталог с соответствующего субдомена NeuroAPI, затем клиент использует 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;
• %USERPROFILE%\.codex\config.toml — только при согласии на Codex Desktop; исходный файл хранится в installer-owned каталоге;
• %LOCALAPPDATA%\NeuroAPIAgents\bin — одна запись в пользовательском PATH.

macOS:

• ~/.local/share/neuroapi-agents/ — helper и Claude settings;
• ~/.codex/neuroapi-host.config.toml — отдельный профиль Codex;
• ~/.codex/config.toml — только при согласии на Codex Desktop; исходный файл хранится в installer-owned каталоге;
• ~/.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://codex.neuroapi.host/v1.

Claude Code:

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

При каждом запуске launcher получает актуальный список для вашего обычного ключа NeuroAPI. Codex использует отдельный каталог, Claude Code — настроенное меню; фиксированных моделей в установщике нет. Проверенные минимумы: Codex 0.158.0 и Claude Code 2.1.284. Claude Code получает проверенные сервером пределы контекста и вывода и служебные диагностические заголовки. Если сервер ещё не передаёт предел вывода, сохраняется совместимый лимит 4096 токенов. Лимит ответа независим от оценки финансового резерва. При ошибке обновления или пустом списке запуск останавливается, не возвращаясь к старым моделям. Подробности и ограничения managed-политик: ручная настройка.

Рекомендуемый серверный набор: Codex — GPT-6 Sol, Astra и Luna; Claude Code — Opus 5.5 (claude-opus-5-5, приоритетный), Sonnet 5.5, Sonnet 5 и Fable 5.1. Модель появляется в меню только после публикации на сервисе и появления совместимого маршрута для тарифа и ключа. Если администратор сохранил собственный список, он имеет приоритет над рекомендуемым набором.

Claude Code обращается к alias haiku и в фоновых задачах. Если доступной рекомендованной Haiku нет, сервер назначает для этого alias доступную Sonnet или основную модель. Такие запросы тарифицируются по фактически выбранной модели; фоновая работа может стоить дороже Haiku.

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

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

Uninstaller удаляет только installer-owned файлы и локально сохранённый ключ. Удалённый ключ через этот пакет восстановить нельзя. Если после установки вы изменили ~/.codex/config.toml, удаление остановится до удаления helper и ключа: это сохраняет работоспособность вашей конфигурации. Сначала вручную разберите изменения и повторите удаление.

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

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

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

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

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

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

Проверить подключение

В терминале выполните codex-neuroapi --doctor или claude-neuroapi --doctor. Диагностика проверяет совместимость версии, доступ защищённого ключа к свежему каталогу и показывает адрес и модель по умолчанию. Генерация не выполняется и токены не оплачиваются. Ключ остаётся скрыт; временные каталоги удаляются.

Для одного короткого платного API-запроса выполните codex-neuroapi --doctor-generate или claude-neuroapi --doctor-generate. Этот режим проверяет законченный непустой ответ по HTTP и показывает время ожидания; автоматических повторов нет. Он не проверяет WebSocket, инструменты или текущую сессию GUI. Явные CLI overrides и политики организации могут менять обычный запуск, поэтому doctor не подтверждает их работу.

Если проверка не прошла, смотрите устранение проблем.