Skip to content

Latest commit

 

History

History
115 lines (70 loc) · 13.8 KB

troubleshooting.md

File metadata and controls

115 lines (70 loc) · 13.8 KB

Решение проблем

Терминальные launchers и графические приложения читают разные настройки. Codex Desktop можно подключить отдельным согласием в установщике или вручную; Claude Desktop настраивается в официальной форме приложения. Если вы уже пробовали настроить клиент до обновления, начните с инструкции по переподключению.

Codex Desktop обращается к chatgpt.com

Проверьте пользовательский ~/.codex/config.toml: model_provider = "neuroapi_agents", base_url = "https://codex.neuroapi.host/v1", supports_websockets = false. Перезапустите приложение и создайте новую локальную задачу. Старые задачи и облачные функции могут сохранять прежний маршрут. Если вы пропустили предложение установщика, запустите setup заново и согласитесь на подключение Desktop.

В CLI повторный setup создаёт отдельный профиль с plugins = false и remote_plugin = false: это отключает фоновые запросы плагинов, которые при запуске с API-ключом могут обращаться к ChatGPT/Git-каталогам. Используйте codex-neuroapi. В Desktop установщик сохраняет вашу настройку plugins; если плагины не нужны, вручную добавьте plugins = false в существующую [features], оставив remote_plugin = false. Инструменты плагинов отключатся; отдельно настроенные MCP и облачные функции приложения используют собственную сеть.

Если удаление останавливается из-за изменения config.toml, сначала сравните текущий файл с резервной копией в каталоге установщика. Это защищает ваши правки и сохраняет key helper до ручного разбора.

codex-neuroapi или claude-neuroapi не найдены

Windows: откройте новый терминал после установки. Проверьте наличие %LOCALAPPDATA%\NeuroAPIAgents\bin в пользовательском PATH.

macOS: используйте полный путь ~/.local/bin/codex-neuroapi. Установщик намеренно не редактирует shell profile.

Codex не видит provider

Запустите именно codex-neuroapi, затем /debug-config. Проверьте:

  • profile neuroapi-host;
  • provider neuroapi;
  • base URL https://codex.neuroapi.host/v1;
  • wire_api = "responses";
  • supports_websockets = true (или false для диагностики HTTP/SSE).
  • web_search = "live" и [features] с plugins = false, remote_plugin = false: hosted поиск идёт через NeuroAPI, плагины CLI отключены для запуска с API-ключом. Отдельно настроенные MCP остаются доступны.
  • В CLI-профиле остаются multi_agent = false, goals = false, apps = false, browser_use = false: эти возможности требуют отдельной проверки исполнения.

Если ~/.codex/neuroapi-host.config.toml существовал до установки без ownership-marker, setup должен отказать, а не перезаписать его.

WebSocket не подключается

В [model_providers.neuroapi] файла neuroapi-host.config.toml временно установите supports_websockets = false, оставив base URL https://codex.neuroapi.host/v1. Перезапустите codex-neuroapi и проверьте короткий запрос по HTTP/SSE. Не переносите ключ в TOML и не меняйте helper. Повторная установка восстановит true.

404 на https://codex.neuroapi.host/v1/models или /v1/responses обычно указывает на неверный URL, сеть/прокси или проблему маршрутизации сервиса. Проверьте, что в профиле нет лишнего /responses после /v1, и посмотрите историю запросов. Один переход на HTTP не исправляет отсутствующий endpoint.

Codex сообщает, что профиль не найден

Обновите Codex CLI. В codex --help описание --profile должно указывать на отдельный <name>.config.toml, а не на старую таблицу [profiles.name]. Проверьте профиль и ownership-marker в путях из ручной настройки. Если у вас задан CODEX_HOME, установщик и uninstaller используют его для Codex-профиля, не меняя переменную. Запускайте setup, launcher и uninstall с одинаковым значением: изменение переменной не переносит ранее установленный профиль.

Claude Code использует другой URL или credential

Запустите именно claude-neuroapi, затем /status. Launcher передаёт isolated settings через --settings, имеющий приоритет над user/project settings для совпадающих ключей.

401 или неверный ключ

Повторно запустите setup-файл и введите новый ключ. Не вставляйте ключ в issue или screenshot.

Windows DPAPI-ciphertext можно расшифровать только в подходящем user/machine context. После переноса на другой компьютер запустите setup заново.

macOS может показать системный запрос доступа к Keychain. Проверьте, что запускается /usr/bin/security, и подтвердите доступ только для ожидаемого локального процесса.

model not found

Перезапустите launcher: он получает свежий список, доступный ключу. Проверьте явный --model и сохранённую модель старой сессии. Если список пуст или каталог недоступен, launcher остановится; это не повод подставлять случайный ID. Codex дополнительно требует Responses-совместимость.

Каталог не загружается или список пуст

Проверьте ключ, соединение и ограничения моделей/тарифа. Установщик обращается к https://codex.neuroapi.host/v1/models и https://claude.neuroapi.host/client-settings. Ответы 401, 403, redirects, слишком большой/неправильный JSON и пустой список не заменяются локальным старым каталогом. При 401 повторите setup с действующим ключом; при пустом списке проверьте права ключа и доступные модели тарифа; при сетевой ошибке проверьте DNS и прокси. Если проблема остаётся, передайте в поддержку время запроса и код ошибки без самого ключа.

В меню всё ещё есть другие модели

Запуск напрямую через codex/claude обходит managed launcher. Обычное discovery может дополнять встроенный список. Даже в управляемом режиме Claude сохраняет строки Default/текущей модели, а корпоративные настройки и явные CLI-переопределения могут иметь приоритет. Launcher не обходит host-managed provider mode: для него нужна настройка со стороны управляющего приложения.

Есть успешный каталог, но задача не выполняется

Каталог подтверждает только доступ к списку моделей. Начните новую локальную задачу с коротким запросом, проверьте результат в файле и запись в истории использования NeuroAPI. Если записи нет, запрос мог не дойти до NeuroAPI: проверьте фактический URL в /debug-config или /status и выбранный режим Desktop. Если запись есть, сохраните время, модель и нормализованный код ошибки для поддержки. Старые сессии могут продолжать использовать прежний маршрут.

macOS блокирует .command

Убедитесь, что файл скачан из neurogen-dev/NeuroAPI. Выполните:

bash setup-macos.command

Если Gatekeeper всё ещё блокирует запуск, откройте файл через Finder → правый клик → Open. Не отключайте Gatekeeper глобально.

Установка отказывается перезаписывать файл

Это защитный механизм. Переместите или переименуйте конфликтующий user-owned файл вручную после проверки. Не создавайте ownership-marker самостоятельно.

Удаление отменено

Windows и macOS требуют точное подтверждение DELETE. Это предотвращает случайное удаление локально сохранённого ключа.

Сообщить об ошибке

Обычные ошибки можно описать в GitHub Issues без API-ключа. Уязвимости и credential-handling проблемы отправляйте по SECURITY.md.

Диагностика без раскрытия ключа

  1. Откройте новый терминал и запустите codex-neuroapi --doctor либо claude-neuroapi --doctor. Успех означает совместимую версию клиента и доступ вашего ключа к актуальному каталогу; баланс генерации и WebSocket при этом не проверяются.
  2. Для проверки реального ответа используйте --doctor-generate вместо --doctor. Будет один короткий платный API-запрос с вашего баланса (ожидание до 180 секунд), без автоматического повтора. Пустой, незаконченный ответ или одна статистика usage не считаются успехом. Идентификатор модели в ответе должен точно совпадать с запрошенным; отсутствующий или другой идентификатор даёт model_identity_unverified. Это может быть сопоставление имени на сервисе, а не сетевой сбой. Сверка проверяет заявленное имя, но не устанавливает подлинность модели провайдера. Роль сообщения должна быть assistant. Этот режим не запускает инструменты и не создаёт сессию клиента.
  3. Если doctor проходит, а обычный запуск нет, проверьте явные --model, --settings и -c, а также политики организации: doctor использует модель и адрес из управляемого профиля, а параметры вашего запуска могут их переопределять.

Не публикуйте содержимое Keychain/DPAPI, полный конфиг или API-ключ. Диагностику можно передать поддержке: она выводит только адрес, модель, результат и время проверки.

Claude Code теперь использует проверенные сервером лимиты вместо постоянного ограничения вывода 4096 токенами. На старом сервере этот лимит остаётся запасным значением. Не увеличивайте окно контекста вручную сверх доступного модели: серверная оценка резерва не увеличивает контекст и не фиксирует окончательную стоимость запроса.