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-maxreasoning 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 还可能显示远程地址和服务器版本;本地会话没有这些项目时,不需要额外排错。

官方资料

参考文档

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐