Команда Codex CLI /status: проверка состояния сеанса

Слеш-команда Codex CLI /status применяется для просмотра конфигурации текущего сеанса, активной модели, разрешений, доступных каталогов и использования контекста. Это своего рода «панель приборов» прямо в терминале: вместо догадок пользователь получает краткий снимок того, в каком окружении сейчас работает Codex, какие ограничения действуют и сколько контекста уже занято.

/status показывает не историю проекта вообще, а состояние текущего сеанса Codex CLI в данный момент. Поэтому команда особенно полезна перед выполнением важных операций, сменой модели или разбором ситуации, когда поведение агента отличается от ожидаемого.

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

Как использовать /status в Codex CLI

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

Смысл /status — не в том, чтобы показать как можно больше технических деталей, а в том, чтобы быстро ответить на вопрос: «В каких условиях Codex сейчас принимает решения и выполняет команды?»

Сначала запустите Codex CLI обычным способом и дождитесь появления интерактивного приглашения. Затем введите команду с начальным слешем:

/status

Важно не путать слеш-команды с командами операционной системы. Запись /status вводится в интерфейсе самого Codex CLI, а не в отдельном окне Bash, PowerShell или другой оболочки. Если выполнить её в системном терминале вне Codex, оболочка может воспринять её как путь или неизвестную команду.

Действие Что сделать Ожидаемый результат
Открыть Codex CLI Запустить Codex из нужного проекта Появится интерактивная сессия
Выполнить проверку Ввести /status Отобразится сводка текущего сеанса
Изучить модель Найти строку с активной моделью Станет понятно, какая модель обрабатывает запросы
Проверить разрешения Посмотреть режим подтверждений и доступ к среде Будет видно, может ли агент менять файлы или запускать команды самостоятельно
Оценить контекст Проверить сведения об использовании контекстного окна Можно понять, не приближается ли сессия к пределу

Вывод может отличаться в зависимости от версии Codex CLI, способа запуска, подключённой модели и набора активных настроек. Поэтому не стоит воспринимать расположение строк или точные формулировки как неизменный API. Надёжнее ориентироваться на смысл полей: модель, разрешения, рабочая область, доступные каталоги и контекст.

Как читать основные сведения

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

Элемент вывода Простой смысл Почему это важно
Активная модель Модель, которая обрабатывает текущие запросы Разные модели могут по-разному справляться с кодом, анализом и длинным контекстом
Режим подтверждений Когда Codex должен спрашивать разрешение Определяет, сможет ли агент выполнить действие автоматически
Среда выполнения Ограничения на запуск команд и доступ к системе Объясняет, почему некоторые операции запрещаются или требуют подтверждения
Рабочий каталог Проект или папка, которую Codex считает текущей Команда может искать файлы не там, где ожидает пользователь
Доступные каталоги Пути, с которыми агенту разрешено работать Помогает понять ошибки доступа к соседним папкам
Контекст Объём уже учтённой информации в сеансе Большой диалог может приблизиться к пределу окна модели

Если отчёт показывает неожиданное значение, не спешите сразу менять глобальные настройки. Сначала проверьте, из какого каталога была запущена сессия, какие параметры передавались при старте и не действует ли конфигурация проекта, переопределяющая пользовательскую. В CLI нередко применяется несколько уровней настроек, поэтому «я изменил параметр» ещё не означает «текущий сеанс действительно использует новое значение».

Пример 1. Быстрая проверка перед началом работы

codex
/status

Проверьте:
- активную модель;
- текущий проект;
- доступ к нужным каталогам;
- режим подтверждения опасных действий;
- объём использованного контекста.

Если после изменения конфигурации вывод остался прежним, перезапустите сессию и снова выполните /status. Уже запущенный процесс может продолжать работать со значениями, которые были загружены при старте. Это особенно важно при смене модели, песочницы, профиля или разрешений.

Ситуация Что проверить через /status Следующий шаг
Codex не видит файл Рабочий каталог и доступные пути Перейти в правильный проект или изменить разрешённую область
Codex отказывается запускать команду Режим песочницы и подтверждений Подтвердить действие или выбрать подходящий режим
Ответы стали менее точными Модель и заполненность контекста Сократить диалог, начать новый сеанс или выбрать другую модель
Изменения настройки не видны Фактическую конфигурацию текущего процесса Перезапустить Codex и повторить проверку

Когда применять /status

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

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

Перед началом нового проекта

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

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

cd ~/projects/payment-service
codex

/status

Если рабочая область указывает на payment-service,
можно продолжать анализ репозитория.
Если открыт другой каталог — завершите сеанс и запустите Codex заново.

Перед изменением файлов

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

Тип задачи Что желательно проверить Риск без проверки
Чтение кода Доступ к рабочему каталогу Неполный анализ из-за пропущенных файлов
Редактирование одного файла Разрешение на запись Агент предложит изменение, но не применит его
Массовый рефакторинг Подтверждения и область записи Часть файлов будет изменена, а часть — нет
Запуск тестов Разрешение на выполнение команд Проверка завершится отказом до запуска тестов
Пример 3. Проверка перед массовым рефакторингом

/status

Затем сформулируйте задачу:

Переименуй устаревший API во всех файлах src,
но сначала покажи список предполагаемых изменений.
Не изменяй файлы без моего подтверждения.

При отказе в выполнении команды

Сообщение вроде «операция запрещена» не всегда означает, что запрос составлен неправильно. Возможно, команда требует доступа к сети, записи за пределами разрешённого каталога или отдельного подтверждения. /status позволяет проверить эту гипотезу до обращения к более глубокой диагностике.

Пример 4. Разбор отказа в запуске команды

/status

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

После этого повторите операцию в безопасном и явно согласованном режиме.

При длинном диалоге

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

Пример 5. Проверка перед передачей большого лога

/status

Если контекст уже сильно заполнен:
1. не вставляйте весь лог целиком;
2. оставьте строки вокруг ошибки;
3. попросите Codex кратко обобщить текущий план;
4. при необходимости начните новый сеанс с этим резюме.

При передаче проекта коллеге

Снимок состояния полезен и в командной работе. Два разработчика могут открыть один и тот же репозиторий, но получить разные результаты из-за различий в модели, разрешениях или локальных настройках. Передача вывода /status помогает быстрее воспроизвести условия эксперимента.

Что передать коллеге Зачем Что не следует публиковать без проверки
Версию CLI Поведение команд может различаться между версиями Секреты и токены из окружения
Название модели Объясняет различия в ответах Закрытые идентификаторы, если они отображаются
Рабочий каталог Помогает открыть тот же проект Чувствительные абсолютные пути
Режим разрешений Показывает границы автоматических действий Содержимое приватных конфигураций
Сведения о контексте Позволяет сравнить объём диалога Фрагменты кода с секретными данными

Примеры использования /status

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

Хорошая привычка — запускать /status не постоянно, а в контрольных точках: перед опасным действием, после изменения настроек и при появлении неожиданного поведения.

Проверка выбранной модели

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

Пример 6. Проверка модели перед генерацией тестов

/status

Текущая модель: проверьте, что это модель,
которую вы планировали использовать для анализа кода.

Затем:
Сгенерируй тесты для модуля billing,
сначала перечисли непокрытые ветви,
а потом предложи изменения.

Проверка доступных каталогов

Когда проект состоит из нескольких репозиториев, рабочий каталог и область доступа особенно легко перепутать. Сводка состояния помогает понять, почему файл существует на диске, но недоступен агенту.

Пример 7. Файл найден на диске, но недоступен Codex

/status

Сравните:
- путь к текущей рабочей области;
- путь к файлу;
- список доступных каталогов.

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

Проверка после изменения настроек

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

Пример 8. Контроль применения новой конфигурации

Закройте текущую сессию.
Запустите Codex с обновлёнными параметрами.
Выполните:

/status

Сравните:
- модель;
- режим подтверждений;
- рабочий каталог;
- доступные каталоги.

Только после этого начинайте основную задачу.

Проверка перед сетевой операцией

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

Пример 9. Подготовка к установке зависимости

/status

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

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

Сравнение двух сеансов

Если у двух пользователей один запрос приводит к разным результатам, полезно сравнить не только текст запроса, но и состояние окружения. Такой подход превращает спор «у меня работает» в проверяемое техническое сравнение.

Пример 10. Сравнение окружений

Пользователь А:
/status

Пользователь Б:
/status

Сравните:
- версию CLI;
- активную модель;
- рабочую область;
- разрешения;
- доступные каталоги;
- состояние контекста.

Не делайте вывод о качестве модели,
пока эти параметры не совпадают.
Задача Когда выполнить /status Какой вывод нужен
Новый проект Сразу после запуска Проверить корень рабочей области
Редактирование файлов Перед первым изменением Убедиться в разрешении на запись
Запуск тестов Перед выполнением команды Понять ограничения среды
Смена профиля После перезапуска Убедиться, что применились новые параметры
Проблема с ответами Сразу после её обнаружения Проверить модель и контекст

Чем /status отличается от других слеш-команд

В Codex CLI несколько команд могут казаться похожими, потому что все они выводят техническую информацию. Однако у каждой свой уровень детализации и собственная задача: /status описывает текущую рабочую картину, /usage показывает статистику использования, /debug-config помогает разбираться с конфигурацией, а /statusline отвечает за отображение информации в строке состояния.

Обзор состояния, статистика, диагностика и визуальная настройка — это четыре разные задачи. Подмена одной команды другой обычно не ускоряет поиск причины, а только добавляет лишний шум.

Команда Главный вопрос Назначение Что не является её основной задачей
/status В каких условиях работает текущий сеанс? Обзор модели, разрешений, каталогов и контекста Подробный разбор происхождения каждой настройки
/usage Сколько ресурсов использовано? Статистика использования и расхода Изменение разрешений или рабочей области
/debug-config Почему действует именно такая конфигурация? Диагностика и анализ настроек Удобный краткий обзор для ежедневной работы
/statusline Что показывать в строке состояния? Настройка компактного интерфейса Полный отчёт о текущем сеансе

/status и /usage

Эти команды могут пересекаться в теме контекста, но смотрят на него с разных сторон. /status отвечает на вопрос о текущем состоянии и пригодности среды для продолжения работы. /usage нужен, когда важно оценить использование ресурсов, историю расхода или статистические показатели, доступные в конкретной версии CLI.

Критерий /status /usage
Фокус Операционное состояние сеанса Использование ресурсов
Модель Показывает, какая модель активна Может связывать расход с запросами или периодом
Контекст Помогает понять текущую заполненность Может показывать объём использованных токенов или статистику
Разрешения Имеют прямое значение Обычно не являются центральным элементом
Тип применения Проверка перед действием Анализ потребления и планирование

Пример: пользователь замечает, что длинная сессия стала менее удобной. Если он хочет понять, не переполнен ли текущий контекст, сначала уместен /status. Если же нужно разобраться в общем расходе ресурсов за работу или сравнить интенсивность использования, следует обратиться к /usage.

/status и /debug-config

/debug-config предназначена для более глубокого изучения конфигурации. Она полезна, когда нужно понять, откуда взялось конкретное значение: из параметров запуска, пользовательского файла, настроек проекта или другого уровня конфигурации. /status обычно показывает итог — то, что реально действует в текущем сеансе.

Сценарий Сначала использовать Почему
Проверить, какая модель активна /status Это быстрый вопрос о текущем состоянии
Понять, почему выбрана эта модель /debug-config Нужна цепочка источников конфигурации
Узнать разрешения текущей сессии /status Разрешения относятся к рабочему состоянию
Найти конфликт параметров /debug-config Требуется подробная диагностика
Сделать краткий отчёт коллеге /status Он компактнее и легче для чтения

Удобная последовательность при непонятном поведении выглядит так: сначала выполнить /status, затем сформулировать гипотезу и только после этого запускать /debug-config. Например, если активна не та модель, диагностика конфигурации поможет выяснить источник подстановки. Но если модель уже правильная, причина может находиться в контексте, разрешениях или самом запросе.

/status и /statusline

/statusline относится не к диагностике как таковой, а к представлению информации. Она позволяет настроить, какие краткие сведения отображаются в строке состояния интерфейса. Это похоже на настройку приборной панели: пользователь выбирает, какие индикаторы видеть постоянно, тогда как /status выдаёт развёрнутый снимок по запросу.

Свойство /status /statusline
Форма вывода Отдельный отчёт в ответ на команду Постоянная или настраиваемая строка интерфейса
Объём данных Более подробный обзор Короткий набор выбранных индикаторов
Основная цель Проверить состояние сеанса Быстро видеть важные показатели во время работы
Диагностика разрешений Подходит для проверки Обычно слишком компактна для полного анализа
Настройка отображения Не является основной функцией Является основной функцией

Если пользователь хочет постоянно видеть короткий индикатор контекста или другую доступную метрику, ему стоит изучить /statusline. Если возник вопрос, почему Codex не может открыть каталог или какая модель фактически работает, лучше применить /status. Одна команда отвечает за что действует сейчас, другая — за что показывать на экране постоянно.

Как выбрать правильную команду

Вместо запоминания длинных описаний можно использовать простой алгоритм. Он помогает не запускать диагностические инструменты «на всякий случай», когда достаточно одного короткого отчёта.

  1. Если нужно понять состояние текущей сессии, выполните /status.
  2. Если интересует объём или статистика использования, откройте /usage.
  3. Если нужно найти источник параметра или конфликт настроек, используйте /debug-config.
  4. Если требуется изменить набор показателей в интерфейсе, обратитесь к /statusline.
Формулировка проблемы Подходящая команда Результат
«Какая модель работает сейчас?» /status Быстрый ответ о текущем сеансе
«Почему подставилась именно эта настройка?» /debug-config Материалы для поиска источника параметра
«Сколько ресурсов уже израсходовано?» /usage Статистические сведения
«Как вывести показатель внизу интерфейса?» /statusline Настройка представления
«Почему агент не видит папку?» /status, затем /debug-config Сначала проверка факта, затем поиск причины

Ограничения и полезные привычки

Понимание границ команды не менее важно, чем знание её синтаксиса. /status показывает состояние, но не исправляет конфигурацию автоматически, не выдаёт опасные разрешения и не гарантирует, что задача будет выполнена корректно. Это диагностический снимок, а не кнопка «починить всё» — такой кнопки, к счастью или к сожалению, пока не придумали.

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

Следует учитывать несколько практических ограничений:

  • формат и названия полей могут меняться между версиями Codex CLI;
  • значения относятся к текущему процессу и могут не описывать будущую сессию после перезапуска;
  • видимость каталога не означает, что каждый файл внутри него можно безопасно изменять;
  • статус модели не заменяет проверку качества ответа и корректности кода;
  • данные отчёта нужно аккуратно передавать другим людям, если в нём встречаются чувствительные пути или сведения о среде.
Привычка Практическая польза Когда особенно нужна
Проверять состояние перед рискованным действием Снижает вероятность работы не в том проекте Массовое редактирование и удаление файлов
Повторять проверку после перезапуска Подтверждает применение настроек Смена профиля или модели
Сравнивать статусы двух сессий Помогает находить различия окружений Воспроизведение ошибки коллегой
Не путать статус и диагностику Экономит время на выборе команды Конфликт настроек
Сохранять краткое резюме перед новым сеансом Помогает уменьшить контекст без потери плана Очень длинный диалог

Оптимальный рабочий цикл выглядит так: запустить Codex из правильного проекта, выполнить /status, проверить модель и разрешения, сформулировать задачу с ограничениями, запросить план перед потенциально опасными действиями, а после изменений просмотреть результат. Если данные отчёта не объясняют проблему, переходите к специализированной команде — /debug-config для конфигурации или /usage для статистики.

Итог прост: /status — это быстрый способ увидеть фактические условия работы текущего сеанса Codex CLI. Он помогает проверить активную модель, разрешения, рабочую область, доступные каталоги и состояние контекста. Используйте его в контрольных точках, не подменяйте им другие диагностические команды и воспринимайте вывод как основу для осознанных решений, а не как автоматическое исправление всех проблем.

CIO-NAVIGATOR