Как проверить расход токенов Codex: CLI /status, dashboards, API usage и локальные логи

У Codex нет одного числа, которое честно отвечает на все вопросы про token usage. Сначала нужно понять, какой счетчик вам нужен: текущая CLI-сессия, постоянная строка состояния в терминале, quota или credits в ChatGPT/Codex, API billing, usage одного завершенного ответа или локальная история на этой машине.

Если вопрос возник прямо внутри Codex CLI, первым шагом выполните /status. Если нужно видеть счетчики во время работы, настройте /statusline. Если вопрос про quota плана или credits, переходите в usage settings Codex или ChatGPT. Если речь про API key, organization, project или backend, используйте OpenAI Platform Usage и usage object в завершенном API response.

Не начинайте с локальных JSONL-скриптов или private endpoint snippets из обсуждений. Они могут быть полезны для личной оценки, но не являются официальным billing record и могут раскрыть prompt, путь к файлу, фрагменты кода или данные клиента.

• Текущая CLI-сессия: /status
• Постоянный footer в CLI: /statusline
• Quota или credits плана: usage settings Codex или ChatGPT
• API-key spend: OpenAI Platform Usage
• Один API request: usage в completed response
• История на машине: локальные Codex logs, только как estimate

Быстрый ответ: выберите правильный счетчик

Надежный вопрос звучит не как “сколько токенов использовал Codex вообще”, а как “какой record должен доказать это число”. CLI session, subscription quota, API organization usage, usage одного response и local logs — разные записи. Их нельзя сводить в один ledger без потери смысла.

По состоянию на 23 мая 2026 года правила credits, плановые ограничения, названия вкладок и доступность моделей остаются volatile. Команды CLI и идея response usage стабильнее, чем точные подписи в интерфейсе. Поэтому сохраняйте не только число, но и поверхность, где вы его увидели.

CLI: начните с /status

В Codex CLI команда /status отвечает на узкий вопрос: что происходит в этой активной terminal session. Она может показать model, configuration, context pressure и token usage текущей рабочей поверхности. Она не является месячным отчетом по аккаунту.

text
/status

Читайте вывод как session evidence. Он помогает понять, почему текущая работа стала тяжелой, какой model реально активен и близко ли вы к давлению контекста. Но он не говорит, сколько quota осталось в ChatGPT plan, что списал API key вчера или что делала другая машина.

Практический порядок: выполните /status, сохраните вывод, затем решите, остаетесь ли вы в CLI lane или вопрос уже относится к subscription usage или API billing.

/statusline: счетчики в footer, а не billing

/statusline нужен, когда вы хотите видеть состояние без постоянных manual checks. Его полезно настроить для model, context, limits, token counters, git, session, current directory и Codex version в нижней строке TUI.

Разница принципиальна. /status — запрос “покажи сейчас”. /statusline — display surface. Он хорошо предупреждает, что session становится тяжелой, но не превращается в официальный history dashboard.

Хорошие задачи для /statusline:

• наблюдать context pressure во время длинного refactor
• видеть model и session identity при переключении проектов
• понять, когда пора compact или разделить задачу
• сократить частые вызовы /status

Плохие задачи:

• доказывать historical spend
• сверять ChatGPT quota с API bill
• оценивать другую машину
• заменять OpenAI Platform Usage

Если вопрос про “этот terminal сейчас”, оставайтесь в CLI. Если вопрос про account, plan или API key, переходите на соответствующую official surface.

Quota и credits ChatGPT/Codex

Subscription-side usage чаще всего путают с API. Codex plan quota, credits, CLI session и API organization bill — разные договоры. Для ChatGPT sign-in, Codex app, cloud tasks или workspace Codex первым местом должны быть Codex или ChatGPT usage settings.

Этот путь отвечает на вопросы:

• Сколько included Codex usage осталось в моем плане?
• Уперся ли я в plan limit или credit limit?
• Применяются ли credits к этому route?
• Я работаю через ChatGPT sign-in или через API key?

Не стоит превращать usage check в полную таблицу планов. Окна, credits, варианты после лимита и caveats лучше читать в отдельной статье OpenAI Codex usage limits. Здесь задача уже: не спутать meter до того, как вы поверите цифре.

Для поддержки сохраните account, workspace или plan, route Codex, surface usage и timestamp. Одно число без этих четырех деталей почти бесполезно для диагностики.

API billing и response usage

Если участвует API key, project, organization, service account, SDK или backend integration, вы находитесь в API lane. OpenAI Platform Usage отвечает за organization или project usage. Completed response usage отвечает за token accounting одного request.

Минимальная запись для request-level учета:

json
{
  "response_id": "resp_...",
  "model": "gpt-...",
  "usage": {
    "input_tokens": 1200,
    "cached_input_tokens": 800,
    "output_tokens": 350,
    "total_tokens": 1550
  }
}

Такая запись помогает attribution, debugging и cost checks. Но она не говорит, сколько ChatGPT subscription quota осталось. Если workflow переключился с ChatGPT sign-in на API key, сменился и meter.

Для route decision используйте Codex API key vs subscription. Сначала определите route, потом сравнивайте usage.

Локальная история: оценка, а не официальный отчет

Local Codex logs полезны для личного анализа: какой проект дал длинные сессии, была ли большая задача вчера, какие directories часто открывались. Но это слабое доказательство для billing или quota disputes.

Перед парсингом локальных файлов держите границу:

Если запускаете parser, делайте его read-only, scoped и private. Не отправляйте полные transcripts в внешние сервисы. Не называйте local JSONL total official ledger. Честная формулировка: локальная история показывает то, что эта машина записала.

Почему цифры не совпадают

Разные usage numbers часто не совпадают, потому что отвечают на разные вопросы.

Не пытайтесь получить один reconciled total. Сначала классифицируйте число, затем сравнивайте его с same-kind evidence.

Что сохранить перед support

Для CLI issue:

• вывод /status активной session
• Codex version, model и project directory
• route: ChatGPT sign-in или API key
• approximate time window

Для subscription quota issue:

• screenshot usage surface в Codex или ChatGPT
• plan или workspace type
• credits involvement
• timezone и time window
• cloud tasks, local messages или code reviews

Для API billing issue:

• organization и project scope
• API key owner или service account без самого ключа
• Platform Usage range
• representative completed response usage
• model names и request ids

Так support или admin увидит, какой meter проверять. “Codex token usage wrong” слишком широко. “Я сравниваю /status, ChatGPT quota и Platform Usage из разных routes” уже диагностируемо.

Часто задаваемые вопросы

Как посмотреть token usage в Codex CLI?

Выполните /status в активной Codex CLI-сессии. Используйте его для current session state, а не для account-wide history.

Что делает /statusline?

/statusline настраивает footer в Codex TUI. Он может показывать counters и context во время работы, но не является billing dashboard.

Где смотреть Codex quota или credits?

В usage settings Codex или ChatGPT для signed-in account. UI labels, credits и plan rules нужно проверять на текущую дату.

Где смотреть OpenAI API token usage?

Organization или project usage смотрите в OpenAI Platform Usage. Usage одного request смотрите в completed response usage.

Почему CLI usage не совпадает с Platform Usage?

Это разные счетчики. CLI описывает active Codex session, Platform Usage описывает API organization или project.

Можно ли читать локальные Codex logs?

Можно для local estimate на этой машине. Нельзя использовать их как official account-wide usage, и они могут содержать sensitive context.

Стоит ли использовать private endpoint scripts?

Нет как normal path. Сначала используйте supported CLI commands, account usage settings, Platform Usage и completed response usage.