Слеш-команда Codex CLI /status применяется для просмотра конфигурации текущего сеанса, активной модели, разрешений, доступных каталогов и использования контекста. Это своего рода «панель приборов» прямо в терминале: вместо догадок пользователь получает краткий снимок того, в каком окружении сейчас работает Codex, какие ограничения действуют и сколько контекста уже занято.
/statusпоказывает не историю проекта вообще, а состояние текущего сеанса Codex CLI в данный момент. Поэтому команда особенно полезна перед выполнением важных операций, сменой модели или разбором ситуации, когда поведение агента отличается от ожидаемого.
На практике многие проблемы выглядят как ошибки модели, хотя на самом деле вызваны ограниченными разрешениями, неверно выбранным рабочим каталогом, другой конфигурацией или почти заполненным контекстом. Команда /status помогает быстро отделить одну причину от другой. Она не заменяет подробную диагностику, статистику расхода токенов или настройку интерфейса, но даёт удобную отправную точку для понимания текущей сессии.
- Как использовать /status в Codex CLI
- Как читать основные сведения
- Когда применять /status
- Перед началом нового проекта
- Перед изменением файлов
- При отказе в выполнении команды
- При длинном диалоге
- При передаче проекта коллеге
- Примеры использования /status
- Проверка выбранной модели
- Проверка доступных каталогов
- Проверка после изменения настроек
- Проверка перед сетевой операцией
- Сравнение двух сеансов
- Чем /status отличается от других слеш-команд
- /status и /usage
- /status и /debug-config
- /status и /statusline
- Как выбрать правильную команду
- Ограничения и полезные привычки
Как использовать /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. Одна команда отвечает за что действует сейчас, другая — за что показывать на экране постоянно.
Как выбрать правильную команду
Вместо запоминания длинных описаний можно использовать простой алгоритм. Он помогает не запускать диагностические инструменты «на всякий случай», когда достаточно одного короткого отчёта.
- Если нужно понять состояние текущей сессии, выполните
/status. - Если интересует объём или статистика использования, откройте
/usage. - Если нужно найти источник параметра или конфликт настроек, используйте
/debug-config. - Если требуется изменить набор показателей в интерфейсе, обратитесь к
/statusline.
| Формулировка проблемы | Подходящая команда | Результат |
|---|---|---|
| «Какая модель работает сейчас?» | /status |
Быстрый ответ о текущем сеансе |
| «Почему подставилась именно эта настройка?» | /debug-config |
Материалы для поиска источника параметра |
| «Сколько ресурсов уже израсходовано?» | /usage |
Статистические сведения |
| «Как вывести показатель внизу интерфейса?» | /statusline |
Настройка представления |
| «Почему агент не видит папку?» | /status, затем /debug-config |
Сначала проверка факта, затем поиск причины |
Ограничения и полезные привычки
Понимание границ команды не менее важно, чем знание её синтаксиса. /status показывает состояние, но не исправляет конфигурацию автоматически, не выдаёт опасные разрешения и не гарантирует, что задача будет выполнена корректно. Это диагностический снимок, а не кнопка «починить всё» — такой кнопки, к счастью или к сожалению, пока не придумали.
Сведения о разрешениях не отменяют принцип минимально необходимого доступа. Даже если операция технически разрешена, перед изменением большого числа файлов стоит запросить план, проверить дифф и сохранить возможность отката.
Следует учитывать несколько практических ограничений:
- формат и названия полей могут меняться между версиями Codex CLI;
- значения относятся к текущему процессу и могут не описывать будущую сессию после перезапуска;
- видимость каталога не означает, что каждый файл внутри него можно безопасно изменять;
- статус модели не заменяет проверку качества ответа и корректности кода;
- данные отчёта нужно аккуратно передавать другим людям, если в нём встречаются чувствительные пути или сведения о среде.
| Привычка | Практическая польза | Когда особенно нужна |
|---|---|---|
| Проверять состояние перед рискованным действием | Снижает вероятность работы не в том проекте | Массовое редактирование и удаление файлов |
| Повторять проверку после перезапуска | Подтверждает применение настроек | Смена профиля или модели |
| Сравнивать статусы двух сессий | Помогает находить различия окружений | Воспроизведение ошибки коллегой |
| Не путать статус и диагностику | Экономит время на выборе команды | Конфликт настроек |
| Сохранять краткое резюме перед новым сеансом | Помогает уменьшить контекст без потери плана | Очень длинный диалог |
Оптимальный рабочий цикл выглядит так: запустить Codex из правильного проекта, выполнить /status, проверить модель и разрешения, сформулировать задачу с ограничениями, запросить план перед потенциально опасными действиями, а после изменений просмотреть результат. Если данные отчёта не объясняют проблему, переходите к специализированной команде — /debug-config для конфигурации или /usage для статистики.
Итог прост: /status — это быстрый способ увидеть фактические условия работы текущего сеанса Codex CLI. Он помогает проверить активную модель, разрешения, рабочую область, доступные каталоги и состояние контекста. Используйте его в контрольных точках, не подменяйте им другие диагностические команды и воспринимайте вывод как основу для осознанных решений, а не как автоматическое исправление всех проблем.
