ccstatusline 上手：一条命令给 Claude Code 底部加上模型、Git 分支和 token 用量状态栏
01开始前
- 已安装 Claude Code 和 Node.js（也可用 Bun）。
- Windows 用户另见项目的 docs/WINDOWS.md（PowerShell、WSL、字体说明）。
- 想要 Powerline 箭头样式，终端需使用 Powerline 字体；README 说明首次设置时可征得同意后自动安装字体。
02第一步：打开配置界面
npx -y ccstatusline@latest # 或用 Bun bunx -y ccstatusline@latest
这会打开一个终端交互界面，可以配置多行状态栏、增删和排序组件（widget）、给每个组件设颜色、实时预览，最后选择安装到 Claude Code 设置。你的配置保存在 ~/.config/ccstatusline/settings.json。
03第二步：安装到 Claude Code
首次设置时界面会让你选安装方式。README 的建议是：想让 Claude Code 固定在当前版本、不随 @latest 变化，就选“Pinned global install”（固定版本的全局安装）；界面会用 npm 或 Bun 全局安装当前版本，并把命令写成 ccstatusline。之后直接运行 ccstatusline 就能再次打开配置界面。
安装完成后，Claude Code 的设置文件里会出现这样的 statusLine 配置（README 给出的格式）：
{
"statusLine": {
"type": "command",
"command": "npx -y ccstatusline@latest",
"padding": 0,
"refreshInterval": 10
}
}refreshInterval 只在 Claude Code 版本不低于 2.1.97 时才会写入，界面里可设为 1 到 60 秒，留空则删除。命令也可以是 bunx -y ccstatusline@latest，或自行管理的全局安装命令 ccstatusline。
04第三步：确认生效
重启或新开一个 Claude Code 会话，输入框下方应出现状态栏。想在不开 Claude Code 的情况下验证，可以给它喂一段模拟的状态 JSON（本站在 Linux 沙箱用 2.2.32 版实际跑过，首次运行会自动写入默认配置）：
echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/tmp"},"session_id":"x"}' | npx -y ccstatusline@latest
# 实测输出：Model: Opus | ⎇ no git | (no git)在非 Git 目录里显示 no git 是正常的；进入 Git 仓库后会显示分支。默认配置只有模型、分支等少数几项，其余需要在配置界面里自己添加。
05能显示什么
| 类别 | 例子（来自 README） |
|---|---|
| 会话与用量 | Session Usage、Weekly Usage、Block Timer、Session Cost、Context Bar |
| Token | 输入/输出 token、Token Speed、缓存命中率 |
| Git | 分支、改动与暂存文件数、PR、CI 状态、worktree |
| 其他 | 当前目录、会话名、Vim 模式、Claude 服务状态、自定义命令 |
06常见问题
- 状态栏每次重绘都会执行一次命令。README 提到 npx 加 @latest 或固定版本，在其测量中都要一秒多，固定全局安装能省掉这部分解析开销；所以日常用建议选固定全局安装。
- 某个文件夹里状态栏是空的：Claude Code 只在受信任的工作区运行状态栏命令，且从 Claude Code 2.1.232 起，嵌套的 Git 仓库不再继承信任，需要单独确认；细节见项目 docs/USAGE.md。
- Claude 配置不在默认位置：设置环境变量 CLAUDE_CONFIG_DIR 指向你的 .claude 目录。
- 走代理：用量和服务状态请求读取大写的 HTTPS_PROXY，并尊重 NO_PROXY。
- 配置损坏：settings.json 无效时，工具不会改写它，只在状态栏里提示并用默认配置显示。
- 导入别人分享的配置时，2.2.32 版会完整展示新增的 shell 命令并要求确认，默认选“取消”，别无脑点同意。
07取舍
它适合想一眼看到用量、上下文和分支的重度用户；如果只想要最简信息，默认配置加一两个组件就够，没必要把状态栏堆满。项目也有人维护的中文第三方分支，但 README 明确说这些分支未经原项目审核，使用前请自行检查代码。本文的安装命令除模拟输入验证外，其余按官方 README，未在真实 Claude Code 会话中实测。
DeepSeek
Hy-Memory
Timestral