Восстановление подключения Codex и Claude

Что делать после старой или неудачной настройки Codex CLI, Codex Desktop, Claude Code и Claude Desktop.

Эта инструкция нужна, если вы уже пытались подключить NeuroAPI, но клиент не отвечал, показывал ошибку или обращался не к тому адресу. Начните с короткой проверки, затем выберите автоматическое обновление или ручную настройку своего клиента. Не удаляйте проект, переписку и все настройки приложения целиком.

Если предпочитаете сами вставить настройки в файлы, используйте пошаговую ручную инструкцию с готовыми блоками для Windows и macOS. В ней есть отдельные команды для Codex CLI и Claude Code, а также защищённый helper для Codex Desktop.

1. Проверьте ключ и нужный адрес

Откройте ключи NeuroAPI. Убедитесь, что ключ активен, его тариф и ограничения допускают выбранную модель, а баланс и лимит позволяют выполнить запрос. Используйте полный ключ в том виде, в каком его выдал кабинет; не добавляйте и не убирайте sk- вручную. Если ключ был опубликован в чате, скриншоте или репозитории, отзовите его и создайте новый.

Клиент	Базовый адрес	Где его задают
Codex CLI и локальный Codex Desktop	`https://codex.neuroapi.host/v1`	Пользовательский provider Codex
Claude Code CLI	`https://claude.neuroapi.host`	`ANTHROPIC_BASE_URL` или отдельный launcher
Локальная вкладка Code в Claude Desktop	`https://claude.neuroapi.host`	Developer → Configure Third-Party Inference
Обычный OpenAI SDK и совместимые клиенты	`https://neuroapi.host/v1`	`base_url` клиента

Не дописывайте /responses к адресу Codex и /v1/messages к адресу Claude: клиент добавляет путь метода сам. Старые адреса NeuroAPI продолжают поддерживаться, но для новой настройки используйте адреса из таблицы. Подписка ChatGPT или Claude не заменяет API-ключ NeuroAPI.

2. Автоматическое обновление для CLI

Если раньше запускали codex-neuroapi или claude-neuroapi, скачайте свежую версию открытого установщика NeuroAPI. Обновление сервера само по себе не меняет файлы уже установленного launcher. Закройте запущенные CLI и GUI, затем запустите установщик повторно с тем же или новым ключом:

git clone --branch agents https://github.com/neurogen-dev/NeuroAPI.git
Set-Location .\NeuroAPI
.\setup-windows.bat

На macOS:

git clone --branch agents https://github.com/neurogen-dev/NeuroAPI.git
cd NeuroAPI
./setup-macos.command

Если каталог NeuroAPI уже существует, загрузите свежий ZIP из того же репозитория в другую папку или обновите чистый clone. Не подменяйте скрипт из старой папки отдельно: launcher, helper и настройки должны быть одной версии. Установщик сохраняет ключ в защищённом хранилище ОС и создаёт отдельные настройки; следуйте его подсказкам для нужных клиентов. Прежде чем изменять существующий пользовательский config.toml Codex для Desktop, сохраните его копию. Настройка Claude Desktop выполняется в интерфейсе приложения, а не через CLI-установщик.

После установки откройте новую локальную задачу. Проверьте codex-neuroapi командой /debug-config, claude-neuroapi командой /status; затем попросите создать один небольшой файл в тестовом проекте и посмотрите историю запросов. Выбирайте модель, доступную именно вашему ключу; список мог измениться после прежней попытки.

3. Ручное восстановление Codex

Сначала сохраните копию %USERPROFILE%\.codex\config.toml на Windows или ~/.codex/config.toml на macOS. Для CLI, запущенного через codex-neuroapi, проверьте его отдельный профиль ~/.codex/neuroapi-host.config.toml; для Codex Desktop проверьте пользовательский config.toml. Проектный .codex/config.toml не переключает provider и авторизацию.

В действующей конфигурации должны быть base_url = "https://codex.neuroapi.host/v1" и wire_api = "responses". CLI launcher использует model_provider = "neuroapi" в отдельном профиле и включает supports_websockets = true; при транспортной ошибке поставьте false и проверьте HTTP/SSE. Установщик Codex Desktop добавляет в пользовательский файл model_provider = "neuroapi_agents", секцию [model_providers.neuroapi_agents] и supports_websockets = false. При самостоятельной настройке можно использовать ID neuroapi, если он совпадает в обеих строках. Не создавайте дубликаты ключей или секций: исправьте прежние записи. Убедитесь, что model_catalog_json указывает на существующий JSON, полученный с тем же ключом, и обновите каталог при смене ключа. Полные примеры есть в инструкциях Codex CLI и Codex Desktop.

Полностью закройте Codex Desktop, откройте заново и создайте новую локальную задачу. Старую не используйте для проверки маршрута. Если в ошибке нового запроса виден chatgpt.com/backend-api/codex/responses, активным остался провайдер OpenAI: проверьте расположение пользовательского файла, совпадение model_provider с ID секции, TOML-синтаксис, выбранную модель и перезапуск. Наличие фонового соединения с ChatGPT без такой ошибки ещё не означает, что модельный запрос ушёл мимо NeuroAPI.

4. Ручное восстановление Claude

Claude Code CLI: проверьте /status — там должны быть адрес https://claude.neuroapi.host и ожидаемый источник ключа. Старые ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY из оболочки, пользовательского ~/.claude/settings.json, проектных настроек или среды IDE могут конкурировать с launcher. Исправляйте конкретный источник, показанный /status; не удаляйте весь ~/.claude. Для краткой проверки в новом терминале используйте пример на странице Claude Code. Запускайте claude-neuroapi, если ключ хранится в helper установщика. Если приложение продолжает выбирать старую авторизацию, проверьте сохранённый вход и при необходимости выйдите через /logout, затем войдите нужным способом.

Claude Desktop Code: настройте шлюз отдельно в Help → Troubleshooting → Enable Developer Mode → Developer → Configure Third-Party Inference. Выберите Gateway, базовый адрес https://claude.neuroapi.host, полный ключ NeuroAPI и схему Bearer. Сохраните, перезапустите приложение и откройте новую Local сессию Code. Переменные ANTHROPIC_BASE_URL и ~/.claude/settings.json не переключают этот GUI. Если поля заблокированы политикой организации, обратитесь к администратору устройства. Пошаговый экранный путь — в инструкции Claude Desktop.

5. Если всё ещё есть ошибка

Что видно	Что проверить
`401` на домене NeuroAPI	Полный ключ, его срок и состояние; helper или источник credential; для Desktop Claude — Bearer.
Модели нет в списке	Тариф, ограничения ключа, точный ID, повторную загрузку каталога тем же ключом.
Ошибка TOML/JSON до отправки	Исправьте синтаксис файла, который указал клиент; затем полностью перезапустите его.
WebSocket или обрыв потока Codex	Для проверочного запуска задайте `supports_websockets = false` и повторите короткий запрос через HTTP/SSE.
`Gateway was unreachable`	Откройте базовый адрес с этого же компьютера; проверьте DNS, сеть, прокси и VPN.
Запрос виден в NeuroAPI, но задача не завершилась	Запишите время, модель, локальный/облачный режим и безопасный код ошибки; проверьте файл и следующий ход, а не только HTTP-статус.

Если тест не проходит, отправьте в поддержку название и версию клиента, ОС, время запроса, выбранную модель, тариф, адрес без ключа, код ошибки и отметку, появился ли запрос в истории NeuroAPI. Удалите из скриншотов ключ, заголовки авторизации, содержимое проекта и рабочие файлы. Само присутствие домена Anthropic или OpenAI в сетевой активности приложения не определяет маршрут конкретного модельного запроса: проверяйте новую локальную задачу и журнал NeuroAPI.

Источники: конфигурация Codex, Claude Code gateway, Claude Desktop gateway.