#CCStatusline 状态栏

CCStatusline 是一个高度可定制的 Claude Code CLI 状态栏工具，在终端底部实时显示当前模型、Git 分支、Token 用量、会话费用等关键信息。

#为什么需要 CCStatusline

默认的 Claude Code CLI 界面不显示模型名称、Token 用量等信息。你需要切换到其他窗口或手动查询才能了解当前状态。CCStatusline 解决了这个问题：

• 实时查看当前使用的模型（如 claude-opus-4-6）
• 跟踪 Token 消耗和会话费用，避免超出预算
• 显示 Git 分支和工作区状态，减少上下文切换
• 监控 5 小时 Block 计时器，合理安排使用节奏

#安装

运行以下命令会启动一个交互式 TUI，引导你完成配置和安装：

:::code-tabs

@tab npm

npx -y ccstatusline@latest

@tab Bun

bunx -y ccstatusline@latest

:::

TUI 会自动将配置写入 Claude Code 的 settings.json，无需手动编辑。

#固定版本安装

如果不想每次运行都拉取最新版本，可以在 TUI 中选择「固定版本全局安装」，或手动全局安装：

npm install -g ccstatusline

此时 settings.json 中的命令为 ccstatusline（不带 npx）。

#配置

#settings.json

CCStatusline 通过 Claude Code 的 statusLine 配置项工作。安装后，~/.claude/settings.json 会包含：

{
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline@latest",
    "padding": 0,
    "refreshInterval": 10
  }
}

#环境变量

#自定义配置路径

ccstatusline --config /path/to/settings.json

配置文件自动保存到 ~/.config/ccstatusline/settings.json。

#使用 TUI 配置

CCStatusline 的 TUI 界面基于 React/Ink 构建，提供可视化配置体验：

• 添加 / 删除 Widget：从分类列表中选择要显示的组件
• 拖拽排序：调整各组件在状态栏中的位置
• 颜色定制：为每个元素单独设置前景色和背景色
• 克隆组件：按 k 键复制当前选中的 Widget
• 实时预览：修改后立即在终端中看到效果
• 一键安装：直接将配置写入 Claude Code settings

TUI 内置快速 Widget 选择器，支持分类浏览、子串匹配和模糊搜索，可以快速找到需要的组件。

#常用 Widget

CCStatusline 提供了丰富的 Widget，按类别分组：

#模型与会话

#Token 用量

#Git 信息

#上下文窗口

#计时器

#其他

#Powerline 风格

CCStatusline 支持 Powerline 风格的箭头分隔符和主题系统：

# 在 TUI 中选择 Powerline 主题
# 自动安装所需字体并配置分隔符

特性包括：

• 可自定义箭头分隔符（支持 4–6 位 Unicode 十六进制码）
• 多行状态栏自动对齐
• 内置主题支持跨行颜色延续
• 三种颜色模式：16 色、256 色（ANSI）、TrueColor（HEX）

#Windows 用户

在 Windows 上使用 CCStatusline 需要注意：

• 推荐使用 Windows Terminal，对 Unicode 和颜色支持更好
• PowerShell 示例：npx -y ccstatusline@latest
• 如果使用 WSL，配置方式与 Linux 相同
• 字体安装：从 Nerd Fonts 下载并安装

详见 Windows 指南。

#相关资源

• CCStatusline GitHub — 源码和完整文档
• npm: ccstatusline — npm 包页面
• CCStatusline 中文版 — 中文社区本地化版本

#下一步

• Hooks — 使用 Hooks 自动化 Claude Code 行为
• CC-Switch 配置管理 — 管理多 Provider 和 MCP 服务器配置
• 最佳实践 — 更多使用技巧