Claude Code /status 命令详解:一眼看清会话全貌
目录
什么是 /status
用 Claude Code 的时候,你可能遇到过这样的情况:
- 忘了当前用的是哪个模型——是 Opus 还是 Sonnet?
- 不确定自己是在哪个 Git 分支上工作
- 想知道当前账户类型是 API 还是订阅,但又不想去翻设置
- 对话进行了一段时间,想确认一下上下文还剩多少空间
这些信息散落在不同的地方,每次都要分别去查,很烦。
这就是 /status 命令的用武之地。
/status 是 Claude Code 的一个内置命令,用来显示当前会话的完整状态信息。模型、账户、工作目录、Git 分支、上下文用量——所有你关心的会话元信息,一个命令全部呈现。
简单来说:一张仪表盘,看清 Claude Code 当前的”运行状态”。
怎么用
基本用法
在 Claude Code 交互模式下输入:
/status
就这么简单。Claude Code 会输出一段结构化的状态摘要,涵盖当前会话的所有关键信息。
没有参数,没有选项,输入即查看。
它能告诉你什么
账户信息
/status 首先会告诉你当前的账户类型和认证方式:
- Account type —— 你是用 API Key 登录还是用 OAuth(订阅账户)登录
- Plan —— 如果是订阅用户,会显示是 Pro 还是 Max
为什么这很重要?因为账户类型直接决定了你的计费方式和用量限制。API 用户按 token 计费,订阅用户按配额使用。不同的账户类型,优化策略也不同。
当前模型
显示你当前正在使用的模型:
- Claude Opus 4.6
- Claude Sonnet 4.6
- Claude Haiku 4.5
如果你在 CLAUDE.md 或设置里指定了默认模型,但不确定有没有生效,/status 一查就知道。
工作目录
显示 Claude Code 当前的工作目录路径。
这个信息看起来平淡无奇,但在以下场景很有用:
- 你同时开了多个终端窗口,分别在不同项目里用 Claude Code,想确认”我现在在哪”
- 用了
/add-dir添加了额外目录后,想确认工作范围 - monorepo 项目中,确认 Claude Code 是在根目录还是某个子包里
Git 状态
如果当前目录是 Git 仓库,/status 会显示:
- Branch —— 当前所在分支
- Dirty —— 是否有未提交的更改
你不需要退出 Claude Code 去跑 git status,一个 /status 就能确认当前的版本控制状态。在做功能开发的时候,尤其是涉及多分支操作时,这个信息能帮你快速定位”我在哪条线上”。
上下文用量
显示当前上下文窗口的使用情况——已经用了多少、还剩多少。
这是 /status 中最实用的信息之一。上下文窗口是 Claude Code 最核心的资源,了解它的使用状态能帮你:
- 判断是否需要
/compact压缩对话 - 预估还能处理多少内容
- 在上下文快满之前主动做清理
工具和 MCP 状态
/status 还会显示当前可用的工具数量和已连接的 MCP(Model Context Protocol)服务器信息。
如果你配置了 MCP 工具但不确定是否连接成功,/status 能帮你快速确认。不用去翻配置文件或者试着调用工具来验证。
谁应该用 /status
多项目开发者
如果你同时在多个项目中使用 Claude Code,/status 能帮你快速确认当前会话的上下文——我在哪个项目、哪个分支、用什么模型。避免在错误的分支上开发,或者在不该用 Opus 的地方浪费配额。
Claude Code 新手
如果你刚开始用 Claude Code,/status 是了解”当前发生了什么”最直接的方式。不用记住每个设置在哪里配置的,一个命令就能看到全貌。
调试环境问题的人
Claude Code 行为不符合预期的时候,第一步往往是排查环境问题:
- 模型对不对?
- 工作目录对不对?
- MCP 连接正不正常?
- 上下文是不是快满了?
/status 能在 5 秒内帮你排除大部分环境因素。
实际使用技巧
技巧一:每次开始新任务前看一眼 /status
不需要每条消息都查,但在开始一个重要任务之前,花 2 秒看一下 /status 是个好习惯。确认模型、分支、上下文都在预期状态,避免做了一半才发现”原来我在错误的分支上”。
技巧二:配合 /compact 管理上下文
/status 告诉你上下文用了多少,/compact 帮你释放空间。两个命令配合使用:
/status检查上下文用量- 如果用量偏高,用
/compact压缩 - 再次
/status确认空间已释放
这比等到 Claude Code 自动压缩要主动得多,效果也更好。
技巧三:用 /status 验证配置
改了 CLAUDE.md 里的模型配置、添加了 MCP 工具、或者调整了权限设置之后,用 /status 快速验证是否生效。比起”试一下看看行不行”,直接查状态更高效也更可靠。
技巧四:排查问题的第一步
Claude Code 的行为不对劲?别急着重开会话。先 /status 看一下:
- 模型可能不是你以为的那个
- 可能不小心切到了错误的分支
- MCP 工具可能断开了连接
- 上下文可能已经快满了
很多时候,问题的根源在环境而不在模型。/status 帮你快速定位。
/status vs /config vs /context
这三个命令都和”了解当前状态”有关,但侧重点不同:
| /status | /config | /context | |
|---|---|---|---|
| 关注什么 | 会话的整体状态概览 | 配置项和设置详情 | 上下文用量的详细分析 |
| 信息深度 | 广而浅——覆盖面广 | 深入配置细节 | 深入上下文细节 |
| 主要用途 | 快速确认”一切正常” | 调整和审查设置 | 优化上下文管理 |
| 类比 | 汽车仪表盘 | 汽车设置菜单 | 油量详细报告 |
我的经验:
- 想快速了解当前会话状态 →
/status - 想查看或修改具体配置 →
/config - 想深入分析上下文用量并优化 →
/context
写在最后
/status 是 Claude Code 里最”无聊”的命令之一——它不写代码,不修 bug,不做任何实际操作。它只做一件事:告诉你现在的状态。
但正是这种”无聊”,让它成为了最可靠的排查工具。
很多人用 Claude Code 的时候,遇到问题第一反应是”重来”——重新开一个会话,重新描述需求,重新跑一遍。但大多数时候,问题不在对话本身,而在环境:模型不对、分支错了、上下文满了、工具断了。
先诊断,再行动。 这是任何排查的基本原则。/status 就是 Claude Code 的”诊断命令”——在你决定重来之前,先花 2 秒看看是不是环境出了问题。
下次 Claude Code 表现不符合预期的时候,先别急着抱怨”模型变笨了”。敲一个 /status,也许答案就在那张仪表盘上。
相关推荐
Claude Code Agent Loop:拆解 AI 编程助手的心脏
Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的?从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复,一次讲透。
Claude Code settings.json 详解(一):配置文件在哪里、谁说了算
全面介绍 Claude Code 的配置文件体系——五个配置来源的路径、优先级规则、数组合并与单值覆盖的区别、企业管理设置的多种下发方式。
Claude Code settings.json 详解(二):permissions 权限系统全解析
深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义,以及 additionalDirectories 的作用。
Claude Code settings.json 详解(三):hooks 钩子全解析
深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件(PreToolUse/PostToolUse/Stop/Notification)、stdin/stdout 协议、exit code 语义,以及实用配置示例。
Claude Code settings.json 详解(四):env、模型、认证与其他实用字段
全面介绍 Claude Code settings.json 中的 env 环境变量注入、模型配置、身份认证辅助、Git 提交署名、会话清理、语言与界面、思考深度、自动更新、记忆系统等实用字段。