Codex Guide

Тема

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

Начните с версии, встроенной справки и безопасного redacted-report:

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

doctor --json предназначен для машинного redacted-отчёта, но всё равно просмотрите файл перед отправкой третьим лицам.

Официальные рекомендации: Troubleshooting и Authentication.

codex: command not found ​

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

Перезапустите shell после установки. Не исправляйте проблему постоянным запуском через sudo.

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

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

Причина обычно в версии, платформе, rollout или стадии feature. Experimental-команды cloud, remote-control, app-server и debug surface могут меняться. Обновите CLI штатным package manager или codex update, если self-update поддерживается.

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

Для headless/remote host:

bash
codex login --device-auth

В корпоративной сети может потребоваться путь к доверенному CA bundle:

bash
export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login

Не отключайте TLS validation. Проверьте codex login status и dedicated login log в настроенном log directory.

Project config не применяется ​

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

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

Это ожидаемо: cloud environment видит checkout GitHub, а не локальный диск. Создайте branch/commit либо передайте небольшой несекретный patch. Для визуальной локальной работы используйте /app, а не cloud.

Cloud task не собирается ​

  • Добавьте воспроизводимый setup script.
  • Убедитесь, что lockfile закоммичен.
  • Проверьте runtime version и системные зависимости.
  • Сеть setup phase и agent phase настраиваются отдельно.
  • Запишите точные test/build-команды в AGENTS.md.

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

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

В TUI:

text
/mcp verbose

Проверьте executable/URL, environment, OAuth, CA, network policy и workspace restrictions. Не расширяйте доступ до всего home или сети ради диагностики.

TUI ломает scrollback ​

bash
codex --no-alt-screen

Для копирования длинного вывода включите /raw; последний завершённый ответ копируется через /copy или Ctrl+O.

Что приложить к issue или support ​

  • Версию Codex и ОС.
  • Минимальные шаги воспроизведения.
  • Ожидаемый и фактический результат.
  • Redacted codex doctor --json.
  • Название команды и exit code.
  • Только относящийся к ошибке фрагмент лога без prompt, source code и секретов.

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