Codex не подключается: 4 причины и команда, которая чинит сама

Почти всегда дело в одной из четырёх вещей: не перезапущен терминал, истёк код подтверждения, недоступен шлюз или выбрана организация без подписки. Проверка занимает пару минут — а многое чинит одна команда:

recodex doctor --fix

Она сначала делает только безопасные вещи (перезапрашивает конфигурацию, а при недоступном шлюзе переключается на самый быстрый доступный), потом сама прогоняет проверку заново. Начните с неё — часто на этом всё и заканчивается. Ниже — что именно она закрывает и что делать, если не помогло.

1. Перезапустите терминал полностью

Самая частая причина, и её легко пропустить.

После recodex login нужно полностью закрыть и открыть заново терминал, IDE или Codex Desktop. Учётные данные читаются при старте процесса, поэтому уже открытое окно их не увидит. Новая вкладка в том же окне не считается.

Характерный симптом: Codex сообщает об ошибке учётных данных, хотя вход только что прошёл успешно. Решение — повторить recodex login и перезапустить терминал целиком.

2. Проверьте код подтверждения

recodex login открывает в браузере страницу подтверждения устройства. Код действует около 10 минут.

Отвлеклись и вернулись позже — подтверждение не сработает. Просто запустите recodex login снова, новый код выдаётся сразу.

На странице подтверждения стоит проверить две вещи: имя устройства и выбранный тариф. Если подписок несколько, тариф нужно выбрать явно — иначе устройство встанет не на тот.

3. Переключите шлюз

Запросы идут через наши шлюзы в разных регионах. Если выбранный шлюз недоступен из вашей сети, всё остальное выглядит исправным, а работа — нет.

recodex gateways auto    # выбрать самый быстрый исправный (рекомендуется)
recodex gateways list    # все шлюзы: задержка, состояние, отметка выбранного
recodex gateways test    # перезамерить задержки
recodex gateways use jp  # переключиться на конкретный

Короткий путь — recodex gateways auto: клиент сам замерит и выберет. Хотите вручную — сначала посмотрите list, там видно и задержку, и состояние. В десктопном клиенте это одна кнопка.

4. Проверьте организацию

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

recodex org               # список доступных; * — та, что использует это устройство
recodex org use <имя или id>

Два подводных камня:

• После переключения нужно заново открыть терминал — учётные данные лежат в переменной окружения и действуют только для новых процессов.
• Организацию без активной подписки выбрать нельзя. Квота берётся из её собственной подписки; такие организации видны в списке, но не выбираются. Обратитесь к администратору этой организации.

В десктопном клиенте это раздел «Организация» в панели ReCodex: кнопка «Переключить» действует сразу, без перезапуска. Если организация одна, раздел скрыт.

Если не помогло: полная самодиагностика

recodex doctor        # полная проверка
recodex doctor --json # то же в JSON — это и отправляйте в поддержку

recodex doctor проверяет установку клиента, конфигурацию, вход, учётные данные, подписку, доступность Codex и достижимость каждого шлюза именно с вашей машины. Последнее важно: задержки, которые видит сервер, и задержки, которые видите вы, — разные величины.

Отправьте в поддержку вывод recodex doctor --json — по нему сразу видно, где проблема: в шлюзе, в учётных данных или в локальном окружении. Это быстрее, чем описывать симптомы словами.

Можно приложить и recodex logs --limit 50 — последние 50 обезличенных записей (команда, результат, версия, ОС), без каких-либо секретов.

Полезные команды под рукой

Сменили компьютер — освободите место сами

Каждое устройство занимает одно место, число мест зависит от тарифа. В разделе «Мои устройства» ненужное устройство выводится из аккаунта, и место освобождается сразу — писать в поддержку не нужно.

На одной машине десктоп и CLI используют один аккаунт, одну квоту и одно место, не вытесняя друг друга.

Когда это вообще не сбой

Если всё подключено, но приходит уведомление о лимите — это не поломка. Вы израсходовали свою долю, и она вернётся сама, когда сдвинется официальное окно; обычно это несколько часов, обращаться в поддержку не нужно.

Подробно — в статье «Как считается ваша доля лимита». Общая картина сервиса — в «Что такое ReCodex».