Руководство Codex

Тема

Диагностика ​

Зачем это изучать

Вы научитесь искать причину по шагам и не отправите пароль или исходный код вместе с отчётом об ошибке.

Сначала узнайте версию и получите встроенную справку:

bash
codex --version
codex --help
codex doctor --summary
codex doctor --json

doctor означает «диагностика». Вариант --json создаёт структурированный отчёт для другой программы. Перед отправкой всё равно откройте его и удалите личные данные, пути, запросы и секреты.

Codex не запускается: codex: command not found ​

Сообщение означает: оболочка не нашла программу codex.

bash
npm install --global @openai/codex
command -v codex
npm prefix --global

После установки перезапустите терминал. Не пытайтесь постоянно обходить ошибку запуском с правами администратора.

Команда из руководства отсутствует ​

bash
codex --version
codex --help
codex features list

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

Не открывается браузер при входе ​

На удалённом компьютере без обычного экрана используйте вход по коду:

bash
codex login --device-auth

В корпоративной сети может понадобиться сертификат, который выдаёт администратор. Не отключайте проверку защищённого соединения. Выполните codex login status, чтобы узнать состояние входа.

Настройки проекта не применяются ​

  1. Проверьте точное имя .codex/config.toml.
  2. Узнайте текущую папку командой pwd.
  3. Убедитесь, что проект отмечен доверенным.
  4. Выполните codex --strict-config: строгий режим сообщит о неверном ключе.
  5. Откройте /debug-config, чтобы увидеть найденные слои настроек.
  6. Помните: более близкий файл может переопределить значение.

Подробная схема есть на странице «Настройка Codex».

Codex на сайте не видит локальные изменения ​

Это ожидаемо: облачная среда получает GitHub-проект, а не диск вашего компьютера. Сохраните изменение в отдельной ветке Git или передайте небольшой несекретный файл. Для работы с локальной папкой используйте приложение.

Облачная задача не собирается ​

  • Добавьте повторяемую команду подготовки среды.
  • Сохраните точные версии зависимостей в файле блокировки проекта.
  • Проверьте версию среды запуска.
  • Учтите, что сеть во время подготовки и сеть во время задачи настраиваются отдельно.
  • Запишите команды тестов и сборки в AGENTS.md.

Не запускается MCP ​

bash
codex mcp list
codex mcp get <NAME>
codex doctor --all

В диалоге выполните /mcp verbose — команда покажет подробности. Проверьте адрес, отдельный вход, сетевые правила и ограничения организации. Не открывайте всю домашнюю папку или сеть только ради поиска ошибки.

Терминальный интерфейс мешает прокручивать старый вывод ​

bash
codex --no-alt-screen

Этот параметр отключает отдельный полноэкранный экран. Последний завершённый ответ можно скопировать командой /copy.

Что приложить к сообщению об ошибке ​

  • версию Codex и операционной системы;
  • короткие шаги, которые повторяют ошибку;
  • ожидаемый и фактический результат;
  • проверенный отчёт codex doctor --json без личных данных;
  • название команды и код её завершения;
  • только нужный фрагмент журнала без запроса, исходного кода и секретов.

Команда /feedback отправляет диагностику OpenAI. Сначала прочитайте, какие данные будут включены.

Куда дальше ​

Внешние источники ↗ ​