Codex Desktop

Приложение Codex может отправлять локальные задачи модели через Responses API NeuroAPI. Для этого нужен пользовательский провайдер Codex. Вход в само приложение, облачные задачи и отдельные функции OpenAI настраиваются независимо от провайдера модели.

Проверено 30 сентября 2026: на тестовой Windows-машине Codex Desktop с GPT-6 Sol и отключённым VPN создал index.html через NeuroAPI. До исправления пользовательской конфигурации ошибка показывала запрос к https://chatgpt.com/backend-api/codex/responses. Это подтверждает один локальный файловый сценарий, а не работу всех возможностей приложения.

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

1. Ключ NeuroAPI с доступом к модели Codex и достаточным лимитом.
2. Установленное приложение Codex и небольшой тестовый проект без секретов.
3. Доступ к https://codex.neuroapi.host/v1 с этого компьютера.

Для терминального клиента есть отдельная инструкция по Codex CLI. Установщик NeuroAPI предлагает отдельную настройку Codex Desktop: при согласии он создаёт резервную копию пользовательского конфига, подключает каталог моделей для вашего ключа и защищённый helper. После установки перезапустите приложение и проверьте новый запрос. Если вы пропустили предложение установщика, настройте провайдер вручную ниже.

Настройте провайдер для приложения

Codex читает провайдер и авторизацию из пользовательского config.toml:

Сделайте копию существующего файла. Сохраните прочие настройки и добавьте или обновите следующие значения. Если в файле уже есть model или [model_providers.neuroapi], измените существующие записи, не дублируя их.

model = "gpt-6-sol"
model_provider = "neuroapi"
model_catalog_json = "/absolute/path/to/neuroapi-codex-models.json"

[model_providers.neuroapi]
name = "NeuroAPI"
base_url = "https://codex.neuroapi.host/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.neuroapi.auth]
command = "/absolute/path/to/your-neuroapi-credential-helper"

auth.command должен выводить ключ NeuroAPI в stdout. В официальной документации Codex описан этот способ авторизации. Не вписывайте сам ключ в TOML. Если защищённого helper пока нет, для краткой проверки можно заменить секцию [model_providers.neuroapi.auth] на env_key = "NEUROAPI_API_KEY" внутри [model_providers.neuroapi] и передать переменную процессу приложения. Переменная, заданная только в отдельной вкладке терминала, обычно не попадёт в уже запущенный GUI.

Замените путь model_catalog_json на абсолютный путь к локальному JSON-каталогу. Получите его через авторизованный GET https://codex.neuroapi.host/v1/models с тем же ключом, который будет использовать приложение; сохраните ответ как файл, доступный только вашему пользователю. При смене ключа или доступных моделей обновите файл. Установщик NeuroAPI выполняет эти действия автоматически. Если каталога ещё нет, удалите строку model_catalog_json только для проверки подключения: выбор модели и локальные инструменты приложения могут работать неполно. Инструкция CLI описывает загрузку каталога launcher. Проектный .codex/config.toml не может задать model_provider, model_providers и способ авторизации: Codex игнорирует эти ключи вне пользовательского слоя.

Проверьте работу

1. Полностью закройте Codex Desktop и откройте его снова, чтобы он перечитал пользовательский конфиг.
2. Создайте новую локальную задачу в тестовом проекте и выберите gpt-6-sol или другую доступную модель NeuroAPI.
3. Попросите создать небольшой файл, например index.html с заголовком neuroapi ok. Убедитесь, что файл появился и ответ модели завершился.
4. Сверьте расход и модель в истории запросов NeuroAPI. Не делайте вывод о маршруте по старой задаче: её прежняя ошибка останется в истории.

Если ошибка всё ещё показывает chatgpt.com/backend-api/codex/responses, приложение использует провайдера OpenAI. Проверьте пользовательский файл, строку model_provider = "neuroapi", отсутствие синтаксической ошибки TOML и перезапуск приложения. Ошибка 401 на codex.neuroapi.host указывает на ключ или его передачу helper; ошибка о модели требует сверки точного ID и доступа ключа. При проблемах с WebSocket оставьте supports_websockets = false и повторите короткий запрос по HTTP/SSE.

Границы подключения

Настройка меняет маршрут локального model inference. Она не заменяет аккаунт ChatGPT для входа в Codex, не перенаправляет облачные задачи и не доказывает, что вспомогательные сервисы приложения, поиск или генерация изображений используют NeuroAPI. Наличие фонового соединения с доменом OpenAI само по себе не доказывает, куда ушёл конкретный запрос модели: проверяйте URL ошибки нового запроса, успешный файловый результат и журнал NeuroAPI.

Источники: конфигурация провайдера Codex, ограничения проектного config.toml.