Codex CLI /status 在哪里输入?PowerShell 报错时先进入 TUI
Codex CLI /status 在哪里输入?PowerShell 报错时先进入 TUI
/status 不是 PowerShell、CMD、Bash 或 Zsh 命令,而是 Codex 终端交互界面(TUI)里的斜杠命令。请先在系统终端运行 codex;看到 Codex 的消息输入区后,再输入 /status 查看当前会话摘要。
按顺序完成版本确认、启动和状态查看
下面三个动作存在真实依赖:先确认系统能找到 Codex CLI,才能启动交互界面;进入交互界面后,才能使用 /status。
1. 在系统终端确认 Codex CLI 版本
在准备交给 Codex 处理的项目目录打开 PowerShell、CMD、Bash 或 Zsh。
codex --version
这一步不是确认登录或会话状态,而是检查启动 TUI 所需的入口能否被当前 Shell 找到并运行。终端出现一行 Codex CLI 版本信息,只能证明当前 Shell 运行了一份 Codex;它没有说明安装来源,也不能保证版本符合你的预期。本文在 Windows 本机核验时看到的是:
codex-cli 0.146.1
这行输出只记录本文的参考环境,不要求你的版本号完全相同。本文参考 Codex CLI 0.146.1,核验日期为 2026-08-07。
如果没有出现版本行,或者 Shell 提示找不到 codex,问题仍在安装或命令搜索路径这一层,此时先停止 /status 路径。打开一个全新的终端,核对实际 codex 路径和 codex --version;只有预期入口能够启动后,再回来运行 codex 进入 TUI。
2. 在同一项目目录启动 Codex
版本确认通过后,继续在同一个系统终端运行:
codex
codex --help 对无子命令的用法说明是进入交互式 CLI;OpenAI 的 Codex CLI 官方页面也要求从项目目录的系统终端启动 codex。看到 Codex 交互界面及其消息输入区,说明已经从 Shell 命令阶段进入 TUI 阶段。
如果画面停在登录选择页,还没有出现可用的消息输入区,就先完成认证或首次连接。认证流程不影响本文的命令分类:登录完成后仍然是先运行 codex 进入 TUI,再在消息输入区使用斜杠命令。
3. 在 TUI 消息输入区查看会话状态
进入 Codex 交互界面后,把光标放在消息输入区。OpenAI 的斜杠命令说明要求在 chat composer,也就是消息输入区中输入 /;官方把 /status 定义为查看当前会话摘要。
/status
提交后,判断位置正确的信号是界面给出当前会话摘要。摘要具体包含哪些字段、字段按什么顺序出现以及各自的值,可能随 Codex CLI 版本、账号或连接方式变化,因此不需要逐项对照别人的界面。
输错位置时看下一步
如果仍处在 PowerShell、CMD、Bash 或 Zsh 提示符下,输入 /status 后看到的是 Shell 自己的处理结果,错误文字会因 Shell 而异。此时不要继续修改 /status 的拼写;在项目目录运行 codex,进入消息输入区后再使用它。
codex --version 是系统终端命令。如果误输到 TUI 的消息输入区,请切回系统终端执行;不需要根据 TUI 的具体回应猜测命令是否可用。
需要时再读懂 /status 状态卡
只需要解决输入位置错误时,到这里即可;如果还要读懂当前会话摘要,再继续看下面的固定案例。
这份摘要的意义不只是证明 /status 输对了位置。下面是 OpenAI Codex rust-v0.146.1 官方源码自带的状态卡测试快照。它是 Codex 实际渲染测试生成的案例,不是本文根据字段名称拼写的示意图;其中 v0.0.0 和 [[workspace]] 是测试使用的脱敏占位符,模型和额度数值也不是对读者环境的推荐或承诺。
╭───────────────────────────────────────────────────────────────────────────╮
│ >_ OpenAI Codex (v0.0.0) │
│ │
│ Visit https://chatgpt.com/codex/settings/usage for up-to-date │
│ information on rate limits and credits │
│ │
│ Model: gpt-5.1-codex-max (reasoning high, summaries detailed) │
│ Directory: [[workspace]] │
│ Permissions: Workspace (Ask for approval) │
│ Agents.md: <none> │
│ │
│ Token usage: 1.9K total (1K input + 900 output) │
│ Context window: 100% left (2.25K used / 272K) │
│ 5h limit: [██████░░░░░░░░░░░░░░] 28% left (resets 03:14) │
│ Weekly limit: [███████████░░░░░░░░░] 55% left (resets 03:24) │
╰───────────────────────────────────────────────────────────────────────────╯
不用记字段名,按下面的方式读就行:
| 输出 | 大白话是什么 | 本例具体怎么读 |
|---|---|---|
OpenAI Codex (v0.0.0) |
当前 Codex CLI 版本 | v0.0.0 是官方测试用的占位版本;你的界面会显示自己安装的版本 |
Visit .../usage |
查看账号额度和使用限制的网页地址 | 需要查更完整的额度信息时,在浏览器打开这个地址 |
Model |
这次会话正在使用哪个模型 | 本例是 gpt-5.1-codex-max;reasoning high 表示推理强度为 high,summaries detailed 表示使用详细摘要 |
Directory |
Codex 现在把哪个文件夹当作工作目录 | [[workspace]] 是测试用的脱敏占位值;你应在这里看到自己当前项目的目录 |
Permissions |
Codex 在这次会话里可以操作到什么范围,什么时候需要问你 | Workspace (Ask for approval) 表示主要在当前工作区内操作,遇到需要批准的动作时会询问你 |
Agents.md |
状态卡是否显示项目指导文件 | <none> 表示这个测试案例没有显示 AGENTS.md 指导;它不是让你删除文件 |
Token usage |
Token 可以先理解为模型统计输入和输出内容用量的小单位,不等同于字数 | 1.9K total 约等于总共 1900 Token;其中约 1000 是发给模型的输入,900 是 Codex 生成的输出 |
Context window |
这次会话能同时保留的上下文空间,已用多少、还剩多少 | 上限是 272K,已用 2.25K;在这个官方测试快照中,剩余显示为 100% left |
5h limit |
账号在当前 5 小时额度窗口里还能用多少 | 28% left 表示还剩 28%,也就是已用约 72%;resets 03:14 表示预计在 03:14 重置这个额度窗口 |
Weekly limit |
账号在当前每周额度窗口里还能用多少 | 55% left 表示还剩 55%,也就是已用约 45%;resets 03:24 表示预计在 03:24 重置这个额度窗口 |
远程连接的 TUI 还可能显示远程地址和服务器版本;本地会话没有这些项目时,不需要额外排错。
官方资料
- OpenAI Codex CLI:说明如何从项目目录的终端启动交互式 CLI。
- Use a slash command:说明斜杠命令应从消息输入区开始输入。
- Inspect the session with /status:说明
/status用于查看当前会话摘要。 - 0.146.1
/status测试构造:交代本文案例的测试条件。 - 0.146.1
/status固定快照:查看官方状态卡原文。
参考文档
- Muze Wiki 的 Codex 完整配置字段与生成器:提供持续更新的完整配置字段说明与配置生成器,适合在掌握终端和 TUI 输入位置后继续查阅。
更多推荐




所有评论(0)