request-free-img

Claude Code 增强状态栏脚本详解:让你的工作状态一目了然

很多粉丝朋友问我这个Claude Code的状态栏是怎么设置的,今天就分享给大家,顺便给大家普及一些关于Claude少为人知的知识,让你可以更了解Claude Code。

Claude Code 增强状态栏脚本介绍

我这个Claude Code 增强状态栏脚本,经过了我多轮的改进后,所显示的信息能让我对当前工作状态一目了然。

下面我给大家逐个解释一下所显示的信息。

第一行:Git 仓库信息

Git [test] M:1 D:0 S:0 U:0 A:0 B:25 V:0 C:0

这个是指当前的工作分支,如果是非 git 目录,那么会显示一个-(中划线)。

M:0 │ Modified — 表示已修改但未 git add 的文件数

D:0 │ Deleted — 表示已删除但未 git add 的文件数

S:0 │ Staged — 表示已经 git add 等待提交的文件数

U:0 │ Untracked — 表示未被 git 追踪的新文件数

A:0 │ Ahead — 表示本地比远程多几个 commit(也就是待 push的数量)

B:0 │ Behind — 表示本地比远程落后几个 commit(也就是等待你执行 pull)

V:0 │ diVerged — 本地和远程各有对方没有的 commit

C:0 │ Conflicts — 表示合并冲突的文件数

第二行:模型信息

Model: Sonnet 4.6 (1M context) | ctx:16%

这里表示当前使用的模型是 Sonnet 4.6,上下文窗口为 100 万 token, 目前已用了 16%。

什么是上下文窗口?

可能有些人不理解这里的上下文窗口是什么来的?

Claude 在工作时,是不是给你一种感觉,它似乎它能记住你们之间的对话信息?

其实呢它并不是真正”记住”了之前的对话——它实际上是把当前对话的全部内容(你说的每一句话、Claude的每一条回复、所有工具调用结果、读取的文件内容等)打包成一个巨大的文本,一次性送给模型处理。

这个”打包文本”的容量上限,就是上下文窗口。Sonnet 4.6 (1M context) 它的上下文窗口上限是 100 万 token,大约相当于 75 万个英文单词,或者几千页文档。

我们这里的ctx:16% 的意思,你现在这个 session 已经积累的对话内容,占了这 100 万 token 的 16%,这样说你应该就明白了吧?

第三行至第五行:工作目录、配额与 Session 数据

第三行是 Claude Code 当前工作目录。

第四行是Claude Max 订阅的配额使用率。? 表示本次 session 还没有收到配额数据,(通常在发送几条消息后才会出现具体百分比)

这里的 5h │ 表示过去 5 小时滚动窗口的配额使用率,7d │ 表示过去 7 天滚动窗口的配额使用率。

第五行是本次 session(也就是从打开 Claude Code 到现在)的累计token数据:

in:103k │ 表示你发送给模型的 token 数

out:73.2k │ 表示模型生成并回复的 token 数

↑cache:0 │ 表示从缓存读取的 token

✎cache:159.5k │ 表示写入缓存的 token 数

Cost: $79.552 │ 是指这些TOKEN的费用,要注意的是这是按 Anthropic API 定价折算的等价费用,并不是实际扣费

14h31m │表示 本次 session 已持续时长

+459/-111 │ 表示本次 session 中新增 459 行代码、删除 111 行

关于 Prompt Cache 的费用说明

有朋友可能要问了,怎么写入缓存还有token数,这也要算钱的吗?

没错没错,新时代开发,一切都是token呀。

写入缓存不但要钱,而且比普通输入还要贵呢,比如在anthropic定价中,普通输入的基准价格是: 3块, 写入缓存的价格要贵25%,也就是3.75。

不过读取缓存就非常便宜,它比普通输入便宜90%,只要0.3。

要注意的是这里说的写入缓存,读取缓存并不是在你本地写入读取,而是Anthropic 服务器会把你发送过去的上下文缓存起来,下次处理时,如果开头部分完全一样,就直接复用缓存。

特别特别注意了:Anthropic 的 prompt 缓存只有 5 分钟 时间。超过 5 分钟没有新请求,缓存就失效。

第六行及以下:累计 Token 消耗统计

第六行是当前项目目录历史所有 session 的累计 token 消耗,它和当前session的一样,也包括in, out以及cache的。

再下边一行是今天(CST 时区)所有项目的累计 token 消耗。

再往下边一行就是 历史所有时间、所有项目的累计 token 消耗。

再下边的就是当前 session 的唯一 ID。

最后这一行里,前边是当前 UTC 时间,后边这个是CST时间,CST的全称是:(China Standard Time)中国标准时间。

最后这个是 当前安装的 Claude Code 版本号。

这些信息的作用

这些信息已经完整的显示了我们平时频繁需要关注的claude code的运行信息了,把这些信息显示在状态栏上,方便我们随时关注。

脚本开源与安装指南

现在这份脚本我已经开源到github上了,大家可以随便拿来用。

脚本的安装方式也很简单:

首先克隆这个仓库

git clone https://github.com/PeterCang/claude-code-statusline.git

再进入这个仓库目录

cd claude-code-statusline

在目录中启动claude,进入 Claude Code 后输入 install,它会自动完成所有配置。

卸载同理,在Claude Code中输入 uninstall就可以了。

目前支持 Windows PowerShell,macOS 和 Linux。


更多问题探讨,请关注公众号:程序员角