Codex не работает: 12 проверок и решений

Сначала определите, что именно не работает

Фраза «Codex не работает» может означать разные проблемы: приложение не открывается, агент не видит файлы, команда зависает, сайт не публикуется или результат не соответствует ожиданиям. Запишите один наблюдаемый симптом и последний успешный шаг.

Помоги диагностировать проблему без изменений.

Ожидалось: [результат].
Фактически: [симптом или текст ошибки].
Последний успешный шаг: [действие].
Повторяется: [всегда / иногда / только в этом проекте].

Сначала перечисли три вероятные причины и безопасные проверки.
Не меняй настройки и файлы без подтверждения.

Проверки 1–3: аккаунт, обновление и статус

Не переустанавливайте всё сразу. Сначала сохраните точный текст ошибки и проверьте, воспроизводится ли она в другой задаче.

1. Убедитесь, что выполнен вход в нужный аккаунт и профиль.
2. Перезапустите сессию и установите доступное обновление официальным способом.
3. Если проблема массовая, проверьте официальный статус сервиса.

Проверки 4–5: Codex не видит файлы

Проверьте границы проекта и режим доступа. Проблема часто связана с расположением файла относительно открытой папки.

• Открыт именно нужный проект, а не пустая или родительская папка.
• Файл существует и находится внутри разрешённой области.
• Более близкий AGENTS.md не вводит дополнительное ограничение.
• У операционной системы есть нужные права.
• Codex может перечислить связанные файлы без изменений.

Проверки 6–7: команда зависла или упала

После второго одинакового падения нужно менять гипотезу, а не повторять команду бесконечно.

1. Найдите первую конкретную ошибку в выводе.
2. Проверьте, не ожидает ли процесс ввода или подтверждения.
3. Остановите явно зависший процесс.
4. Запустите минимальную команду проверки отдельно.
5. Сравните версию среды с инструкцией проекта.

Проверки 8–9: сеть и внешний сервис

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

• Проверьте обычное соединение и статус сервиса.
• Уточните, разрешён ли интернет в текущем окружении.
• Проверьте VPN, прокси и корпоративный фильтр.
• Не публикуйте ключи и токены в выводе.
• Сохраните код ответа и идентификатор запроса.

Проверка 10: локально работает, после публикации — нет

Разделите проблему на уровни. Успешная сборка ещё не доказывает, что домен и HTTPS работают у посетителя.

Проверка 11: Codex сказал «готово», но результат неверный

Это проблема постановки или проверки. Покажите конкретное расхождение, верните критерий готовности и попросите сначала объяснить причину.

Результат не принят.

Ожидалось: [критерий].
Получилось: [наблюдаемое расхождение].
Нужно сохранить: [части, которые уже верны].

Сначала объясни причину и предложи минимальное исправление.
После изменения повтори проверку [команда или сценарий].

Проверка 12: проблема только в одном проекте

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

• Сравните команды запуска с рабочим проектом.
• Проверьте локальные инструкции и конфигурацию.
• Изучите незакоммиченные изменения.
• Проверьте переменные среды без раскрытия секретов.
• Создайте минимальное воспроизведение.

Что собрать для обращения за помощью

Хороший отчёт позволяет другому человеку воспроизвести проблему без долгой переписки.

• Точный текст ошибки без секретов.
• Время и часовой пояс.
• Поверхность Codex и версия.
• Операционная система и тип проекта.
• Минимальные шаги воспроизведения.
• Что уже проверено.
• Request ID или Cloudflare Ray ID, если показан.