Claude Code Statusline
在终端状态栏展示模型、上下文、费用或 Git 信息。
当前收录 15 个精选条目
Statusline 脚本
什么是 Statusline
Claude Code 可以执行状态栏命令,并在终端底部附近显示输出。状态栏可展示当前模型、目录、Git 分支、上下文用量或会话费用。命令通过标准输入接收 JSON;脚本应只解析需要的字段,输出简短易读的一行。
选择会话中真正需要查看的信息:模型与上下文帮助了解会话状态,分支标签方便切换仓库。状态栏空间有限,少量稳定字段比换行的长串计数更易读。
脚本只格式化 Claude Code 提供的数据,不更换模型,也不执行预算限制。费用字段是会话数据,不是账单;预算控制和权限设置需要单独配置。
如何配置 Statusline
可以在 Claude Code 设置中添加 `statusLine` 命令,或运行维护者的配置工具。所列项目分别侧重编译二进制、交互式组件配置和用量显示。仅安装软件包可能尚未写入设置;按来源说明配置并重新加载。
下方 Shell 示例需要 sh 和 jq,分支示例还需要 git。先选一个脚本;费用脚本保存为 ~/.claude/statusline-cost.sh,再把展示的 statusLine 对象合并到 ~/.claude/settings.json。通过 sh 调用无需赋予文件执行权限。
先运行测试命令,应输出 Example model | $1.25 session。这个值是模拟数据,不需要真实会话或凭据;输出正确后再重新加载 Claude Code 检查实际效果。
模型与上下文
{
"statusLine": {
"type": "command",
"command": "jq -r '[.model.display_name, ((.context_window.used_percentage // 0 | floor | tostring) + \"% context\")] | join(\" | \")'"
}
}会话费用
#!/bin/sh
input=$(cat)
model=$(printf '%s' "$input" | jq -r '.model.display_name // "Claude"')
cost=$(printf '%s' "$input" | jq -r '.cost.total_cost_usd // 0')
printf '%s | $%.2f session\n' "$model" "$cost"
Git 分支
#!/bin/sh
input=$(cat)
directory=$(printf '%s' "$input" | jq -r '.workspace.current_dir // .cwd // "."')
branch=$(git -C "$directory" branch --show-current 2>/dev/null || true)
printf 'git: %s\n' "${branch:-detached or not a repository}"
~/.claude/settings.json · session cost
{
"statusLine": {
"type": "command",
"command": "sh \"$HOME/.claude/statusline-cost.sh\""
}
}模拟输入测试 · 终端
printf '%s\n' '{"model":{"display_name":"Example model"},"cost":{"total_cost_usd":1.25}}' | sh "$HOME/.claude/statusline-cost.sh"效果截图
下方图片来自所列维护者的仓库,展示该项目的真实终端布局。可以先比较信息密度,再考虑安装。截图只是预览;本机字体、颜色、终端宽度、配置与 Claude Code 版本都会影响最终效果。
按常用终端宽度比较截图。宽窗口中合适的布局,在分屏编辑器里可能遮住关键信息。先确认纯文本输出,再增加分隔符和颜色。
下方演示来自 ccstatusline,而本页小脚本是独立示例。只需要少量字段时不必安装完整项目;脚本也不会复现演示里的整套界面。

问题排查
如果状态栏没有显示,先检查命令是否能独立运行、可执行文件是否在 PATH 中,再核对设置并重启 Claude Code。若刷新太慢,可选择本地二进制或缓存数据;费用与上下文显示异常时先对照输入 JSON 和项目说明。
模拟输入正常而实际显示为空时,检查生效的设置文件及 statusLine 是否被其他配置覆盖。使用绝对路径或示例中的带引号主目录路径,避免依赖当前工作目录。
Git 信息不对时,应读取输入 JSON 的 workspace.current_dir 并用 git -C 指定目录。示例在非仓库或游离 HEAD 时输出回退文字;刷新慢则先去掉网络请求和昂贵扫描。
Claude Code 官方参考文档常见问题
什么是 Claude Code Mod?
Mod 是通过 JavaScript 或 TypeScript 函数钩子在 Claude Code 内部运行的插件,可以改变界面或会话事件的处理方式。Skills 和 MCP Servers 属于不同的扩展类型。
这些项目都是官方的吗?
本站是独立目录,部分条目来自 Anthropic 仓库,其他来自社区维护者。安装前请查看每条项目的来源。
安装 Mods 安全吗?
扩展可能读取文件、执行命令或连接外部服务。请检查来源和权限,尤其是 Hooks 与 MCP Servers。本站收录不构成安全保证。
星数和日期代表什么?
它们是来源 GitHub 仓库的数据。仓库内的单个插件通常没有独立星数或更新时间。