图文实操教程
Claude Code 状态栏(Statusline)设置教程:一条 /statusline 命令搞定
跟着真实 Windows 录屏,一步步开启 Claude Code 状态栏:运行 /statusline、选全新默认方案、批准生成的 statusline-command.sh 脚本,看懂底部那行「用户名 · 目录 · 分支 · 模型 · 上下文用量」。

约 5 分钟 · 13 个图文步骤
太长不看版
启动 claude,输入 /statusline,回答设置问题即可。Windows 上找不到 shell 配置文件,所以选项 3(全新默认状态栏)最快:它会生成 ~/.claude/statusline-command.sh、更新 ~/.claude/settings.json,并在终端底部显示用户名、当前目录、Git 分支、模型和上下文用量。弹出 diff 审批时选同意,之后想改随时让 Claude「更新状态栏」。
关于来源视频
本页每一帧画面都来自 ProgrammingKnowledge2 的录屏——Windows 上 D:\Dev 目录里的 Claude Code v2.1.83 会话(Opus 4.6 · 1M 上下文 · Claude Max),录制于 2026 年 3 月。
截图经署名使用,每一步都链回视频的精确秒数。旁白没有照抄——上文根据画面内容撰写,并已与 code.claude.com/docs 核对。
在终端里打开 Claude Code
整个过程只需要一个 PowerShell 窗口,不需要编辑器或任何面板。
- 1
启动 CLI
打开 Windows PowerShell(任何终端都行,录屏用的是 PowerShell),cd 进项目目录,输入 claude 回车,CLI 就在该目录里启动了。

在 PowerShell 提示符里输入 claude 启动命令(D:\Dev 目录)。看视频 0:18 处 - 2
欢迎框
Claude Code 会先弹出欢迎框,显示版本(录屏里是 v2.1.83)、套餐和当前模型——Claude Max 账号上的 Opus 4.6、1M 上下文窗口。接下来的一切都发生在这个终端会话里。

Claude Code v2.1.83 会话在 Claude Max 套餐下的 D:\Dev 目录启动。看视频 0:22 处
运行 /statusline 命令
一条斜杠命令,把任务交给专门的设置代理。
- 3
输入斜杠命令
在输入框里输入 /statusline。自动补全菜单里能看到两个相关命令:/statusline——「Set up Claude Code's status line UI」,以及 /status,后者按需打印版本、模型、账号、API 连接和工具状态。提交 /statusline。

自动补全菜单里的 /statusline 条目,上方紧挨着 /status。看视频 0:32 处 - 4
设置代理接管
提交 /statusline 并不只是切换一个开关——它会启动一个小的设置代理(statusline-setup,「Configure statusline from PS1」),根据你的 shell 和平台决定怎么配置。你会看到它以 Initializing 转圈开始干活。

命令提交后立刻转起来的 statusline-setup 代理。看视频 0:42 处
回答设置问题
Windows 没有 shell 提示符配置可转换——全新默认方案最快。
- 5
先找现成的 PS1
代理会先找你 shell 的提示符定义,读取 C:\Users\<用户名>\.bashrc、.bash_profile 之类的文件,看有没有可以直接转换的 PS1。这台 Windows 机器上没有。

代理在 .bashrc 和 .bash_profile 里搜寻 PS1 的 Read 调用记录。看视频 0:52 处 - 6
三条路
在 Windows 上,代理报告「couldn't find standard shell config files」,给出三个选项:1. 粘贴你的 PS1 让它转换;2. 指向自定义位置的配置文件,比如 WSL 或 Git Bash;3. 全新配一条状态栏——「sensible default showing user, directory, model, and context usage」。

Windows 上没找到 shell 配置后的提问——三个编号选项。看视频 1:02 处 - 7
选全新方案
视频作者输入 3。全新默认路线不依赖你现有的 shell 提示符,是 Windows 上最快的路径——在 macOS 和 Linux 上不想翻译 PS1 的话,同样可以这么选。

输入 3,要求配置全新默认状态栏。看视频 1:24 处 - 8
生成默认配置
拿到答复后,statusline-setup 代理把任务改标为「Setup fresh default statusline」开始配置——动手之前先读取你现有的 ~/.claude/settings.json。

确认选项 3 后,Setup fresh default statusline 开始运行。看视频 1:48 处
检查并批准生成的脚本
动你的设置之前,Claude 会把完整 diff 摆给你看。
- 9
批准 diff
Claude 会把要写入的内容完整亮出来:一个小 bash 脚本,把状态 JSON 用 jq 解析出上下文窗口百分比、git 分支和模型名,再用 printf 拼成一行。对话框问「Do you want to make this edit to statusline-command.sh?」——作者选了选项 2「Yes, and allow Claude to edit its own settings for this session」,之后再改就不用重新审批。

生成的 statusline-command.sh diff 和它的审批对话框。看视频 2:10 处 - 10
写了哪些文件
批准后,工具的动作列表显示两个落点:创建 ~/.claude/statusline-command.sh(渲染状态行的脚本),更新 ~/.claude/settings.json(让 Claude Code 运行它的配置项)。

工具动作列表里的 Create statusline-command.sh 和 Update settings.json。看视频 2:22 处
确认状态栏生效
状态栏直接出现在同一个终端底部,并给出日后自定义所需的两个路径。
- 11
49 秒收工
这一轮以「Done (5 tool uses · 6.4k tokens · 49s)」结束。注意终端底边:还没等代理把话说完,新状态栏已经实打实显示在那里了——harddik | d:/Dev。

工具调用收尾,底部已经渲染出真正的状态行。看视频 2:48 处 - 12
每一段是什么
确认信息给出了示例和图例——harddik | ~/Dvs/project | main | Claude Opus 4.6 | ctx:42%:依次是用户名、当前目录(缩短显示)、在 Git 仓库里时的分支名、当前模型,以及上下文窗口用量。

「Your status line is configured!」——示例状态行和五段图例。看视频 3:06 处 - 13
配置在哪
记住两个路径:配置在 ~/.claude/settings.json,脚本在 ~/.claude/statusline-command.sh。以后想改显示内容,直接让 Claude「update the status line」就行,不用手动编辑。

最终总结点出两个文件路径,底部是已生效的状态行。看视频 3:12 处