_        _             _ _            
  ___ ___ ___| |_ __ _| |_ _   _ ___| (_)_ __   ___ 
 / __/ __/ __| __/ _` | __| | | / __| | | '_ \ / _ \
| (_| (__\__ \ || (_| | |_| |_| \__ \ | | | | |  __/
 \___\___|___/\__\__,_|\__|\__,_|___/_|_|_| |_|\___|
                                                     

📚 目录

• 近期更新
• 功能特性
• 本地化支持
• 快速入门
• Windows 支持
• 使用方法
• 开发指南
• 贡献说明
• 许可证
• 相关项目

🆕 近期更新

v2.2.8 - Git 小部件、更智能的选取器搜索及极简模式

• 🔀 新增 Git PR 小部件 - 添加了一个带有可点击 PR 链接的 Git PR 小部件，并可选择性显示当前分支的状态和标题。
• 🧰 大幅扩展 Git 小部件 - 新增了 Git Status、Git Staged、Git Unstaged、Git Untracked、Git Ahead/Behind、Git Conflicts、Git SHA、Git Origin Owner、Git Origin Repo、Git Origin Owner/Repo、Git Upstream Owner、Git Upstream Repo、Git Upstream Owner/Repo、Git Is Fork、Git Worktree Mode、Git Worktree Name、Git Worktree Branch、Git Worktree Original Branch 以及 Custom Symbol。
• 👤 Claude 账户邮箱小部件 - 增加了一个会话小部件，它会从 ~/.claude.json 中读取已登录的 Claude 账户邮箱，同时尊重 CLAUDE_CONFIG_DIR 环境变量。
• 🧼 全局极简模式 - 在 Global Overrides 中新增了一个全局切换开关，可将所有小部件强制设置为原始值模式，从而实现更简洁、无标签的状态栏。
• 🔎 更智能的小部件选取器搜索 - 添加小部件或更改现有小部件的选取器现在支持子字符串、首字母缩写词和模糊匹配，结果会按排名排序，并实时高亮匹配项。
• 📏 改进的终端宽度检测 - 当 ccstatusline 通过包装进程或嵌套 PTY 启动时，柔性分隔符和右对齐功能现在可以更可靠地工作。
• 🎨 Powerline 主题延续性 - 内置的 Powerline 主题现在可以在多行状态栏之间平滑地延续颜色，而无需每行重新开始。

v2.2.0 - v2.2.6 - 速度、小部件、链接及可靠性更新

• 🚀 新增 Token 速度小部件 - 添加了三个小部件：Input Speed、Output Speed 和 Total Speed。
  • 每个速度小部件都支持在小部件编辑器（w 键）中配置 0-120 秒的窗口。
  • 设置为 0 时，禁用窗口模式，使用整个会话的平均速度。
  • 设置为 1-120 时，则计算所选滚动窗口内的近期速度。
• 🧩 新技能小部件控制选项（v2.2.1） - 增加了可配置的技能模式（最后一条/数量/列表）、空时不显示行为以及按最新优先顺序限制列表大小的功能。
• 🌐 使用量 API 代理支持（v2.2.2） - 使用量小部件在直接调用 Anthropic API 时会尊重大写的 HTTPS_PROXY 环境变量。
• 🧠 新增思考力度小部件（v2.2.4） - 添加了一个显示当前 Claude Code 思考力度水平的小部件。
• 🍎 提升 macOS 上使用量查询的可靠性（v2.2.5） - 改进了在 macOS 上加载使用量 API token 时的可靠性。
• ⌨️ 新 Vim 模式小部件（v2.2.5） - 添加了一个显示当前 Vim 模式的小部件，支持 ASCII 字符和可选的 Nerd Font 图标显示。
• 🔗 Git 小部件链接模式（v2.2.6） - Git Branch 可以渲染可点击的 GitHub 分支链接，而 Git Root Dir 则可以渲染针对 VS Code 和 Cursor 的可点击 IDE 链接。
• 🤝 更好的子代理感知速度报告 - Token 速度计算将继续包含引用的子代理活动，以便显示的速度更能反映实际的并发工作。

✨ 功能

• 📊 实时指标 - 显示模型名称、Git 分支、Token 使用量、会话时长、块计时器等信息。
• 🎨 完全可定制 - 选择要显示的内容，并为每个元素自定义颜色。
• ⚡ Powerline 支持 - 以箭头分隔符、帽饰和自定义字体呈现美丽的 Powerline 风格。
• 📐 多行支持 - 可配置多条独立的状态行。
• 🖥️ 交互式 TUI - 使用 React/Ink 构建的内置配置界面。
• 🔎 快速小部件选择器 - 按类别添加/更改小部件，支持搜索和排名匹配。
• ⚙️ 全局选项 - 对所有小部件应用一致的格式化设置（填充、分隔符、加粗、极简模式和颜色覆盖）。
• 🚀 跨平台 - 与 Bun 和 Node.js 均无缝兼容。
• 🔧 灵活配置 - 支持通过 CLAUDE_CONFIG_DIR 环境变量指定自定义 Claude Code 配置目录。
• 📏 智能宽度检测 - 自动适应终端宽度，使用弹性分隔符。
• ⚡ 零配置 - 提供合理的默认设置，开箱即用。

🌐 本地化

本节中的本地化版本是由第三方在本仓库之外维护的分支。这些版本不由本仓库维护、审查或认可，因此在使用之前请仔细检查其代码和发布内容。

• 🌏 中文版: ccstatusline-zh

🚀 快速开始

无需安装！直接使用 npx 或 bunx 即可：

# 使用 npm 运行配置 TUI
npx -y ccstatusline@latest

# 或者使用 Bun（更快）
bunx -y ccstatusline@latest

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

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. 分支仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些令人惊叹的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

支持

如果 ccstatusline 对您有帮助，请考虑请我喝杯咖啡：

📄 许可证

MIT © Matthew Breedlove

👤 作者

Matthew Breedlove

• GitHub：@sirmalloc

🔗 相关项目

• tweakcc - 自定义 Claude Code 主题、思考动词等。
• ccusage - 跟踪并显示 Claude Code 的使用指标。
• codachi - 一款养成类状态栏宠物，会随着您的上下文窗口增长而成长。

🙏 致谢

• 专为与 Anthropic 的 Claude Code CLI 一起使用而构建
• 使用 Ink 构建终端 UI
• 由 ❤️ 为 Claude Code 社区打造

星标历史

ccstatusline 快速上手指南

ccstatusline 是一款专为 Claude Code CLI 设计的高度可定制状态栏格式化工具。它能在终端中实时显示模型信息、Git 分支、Token 用量、会话成本等关键指标，并支持 Powerline 风格主题。

🛠️ 环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS、Linux 或 Windows (需配置 UTF-8 环境)。
• 运行时依赖：已安装 Node.js (建议最新 LTS 版本) 或 Bun。
• 核心工具：已安装并配置好 claude (Claude Code CLI)。
  • 检查命令：claude --version
• 可选优化：为了获得最佳的 Powerline 箭头符号和图标显示效果，建议终端字体支持 Nerd Fonts。

📦 安装步骤

推荐使用 npx 直接运行，无需全局安装即可体验；若需长期使用，也可全局安装。

方式一：直接使用 (推荐)

无需安装，每次通过 npx 调用。这是最轻量且能自动获取最新版本的方式。

npx ccstatusline

方式二：全局安装

如果你希望将其作为系统命令使用：

npm install -g ccstatusline
# 或者使用 bun
bun install -g ccstatusline

国内加速提示：如果 npm 下载缓慢，建议使用国内镜像源进行安装：

npm install -g ccstatusline --registry=https://registry.npmmirror.com

🚀 基本使用

1. 启动与配置

在终端中运行以下命令启动交互式配置界面（TUI）：

npx ccstatusline

• 首次运行：工具会自动检测当前的 Claude Code 会话，并引导你进入配置界面。
• 添加组件：在界面中按下 a 键打开组件选择器（Widget Picker），支持模糊搜索（如输入 "git", "token", "cost"）。
• 自定义布局：使用方向键调整组件顺序，按 Enter 确认，按 q 退出配置。

2. 集成到 Claude Code

配置完成后，你需要让 Claude Code 调用此状态栏。通常有两种方式：

方法 A：通过别名 (Alias) 在你的 Shell 配置文件（如 ~/.zshrc, ~/.bashrc 或 PowerShell 配置文件）中添加别名，将 claude 命令包装起来：

# 示例：将 claude 命令重定向为带状态栏的模式
alias claude='npx ccstatusline -- claude'

(注：具体集成方式可能随 Claude Code 版本更新而变化，请参考工具运行时的提示或官方 USAGE 文档)

方法 B：直接在支持钩子的环境中调用 如果你的终端多路复用器（如 tmux）或 Shell 提示符支持动态命令，可直接调用：

# 简单测试输出
npx ccstatusline --render

3. 常用功能速览

配置界面中支持以下核心功能（通过快捷键操作）：

• w: 编辑选中组件的详细参数（如 Token 速度计算窗口时间）。
• t: 切换内置主题（Themes），包含多种 Powerline 配色方案。
• h: 在 Git 组件中隐藏“非仓库目录”的提示信息。
• u: 在上下文组件中切换“已用百分比”与“剩余百分比”模式。
• Global Minimalist Mode: 在全局设置中开启，可移除所有标签文字，仅显示原始数值，打造极简状态栏。

现在，你可以在享受 Claude Code 强大能力的同时，通过底部的状态栏实时监控开发进度和资源消耗了！