把 Claude Code 状态栏界面换成中文（ccstatusline-zh）

Claude Code 在终端底部默认给出的状态信息很有限。想知道当前模型、Git 分支、Token 用量、上下文占用，要么自己在提示里拼，要么写脚本从 stdin 读 JSON 再打印。上游 sirmalloc/ccstatusline 处理了这件事，它的 README 和配置界面都是英文；huangguang1999/ccstatusline-zh 把其中所有用户可见的文本换成了中文。

ccstatusline-zh 是 Claude Code CLI 的中文状态栏格式化工具，用 TypeScript 写成，读取 Claude Code 从 stdin 传入的 JSON，把模型、Git 分支、Token 用量等指标渲染到终端底部那一行。

它由 Claude Code 的 statusLine 机制按需调用，不是常驻进程。配置写在 ~/.claude/settings.json，适合每天长时间待在 Claude Code 里、又不想对着英文配置菜单点选的人。仓库地址 https://github.com/huangguang1999/ccstatusline-zh，MIT 许可，主要语言 TypeScript，当前 806 star、29 fork、3 个开放 Issue。

这几个项目分别在解决什么

ccstatusline-zh 要解决的是「终端底部那一行显示什么」。仓库 README 列出 88 种组件，覆盖模型、输出风格、版本号、思考力度、Vim 模式、语音状态、沙箱状态，以及 Claude 服务状态（可附带最近 48 小时故障历史条）。Git 这一类拆得很细，有分支、PR、CI 状态、变更统计、新增与删除行数，还有已暂存、未暂存、未跟踪、冲突、超前/滞后等单独组件。用量侧包括 Token、上下文、会话、费用、速度，以及缓存命中率、缓存读取、缓存写入。

布局上支持多行状态栏、Powerline 主题、极简模式（所有组件切到无标签显示）、模糊搜索添加组件、实时预览。每个组件可以单独设前景色和背景色，也可以嵌入自定义 Shell 命令输出、静态文本或单个符号与 Emoji。Git 分支、Git PR、仓库根目录这类条目支持 OSC8 终端超链接。

组件的显示行为还有两层控制。组件编辑器里按 h 可以打开该组件支持的隐藏条件，用空格切换、Enter 保存，例如无 Git 仓库、无用量数据、数值为零时隐藏，旧配置里的隐藏选项会自动迁移，装饰文本和符号可以跟随合并目标隐藏。数值组件按 . 循环切换固定小数、紧凑和整数三种格式；全局覆盖菜单按 n，可分别设置令牌、速度、占比、内存和费用，全局设置优先于组件设置，也可以在 settings.json 里用 decimals 指定 0 到 6 位小数。

安装用一条命令：

npm install -g ccstatusline-zh

也可以换成 bun install -g ccstatusline-zh。装完在 ~/.claude/settings.json 里声明 statusLine：

{
  "statusLine": {
    "type": "command",
    "command": "ccstatusline-zh",
    "padding": 0,
    "refreshInterval": 10
  }
}

refreshInterval 只在 Claude Code ≥ 2.1.97 时生效，TUI 里可设 1 到 60 秒，留空则不写入这个字段。用 npx -y ccstatusline-zh@latest 或 bunx -y ccstatusline-zh@latest 运行也可以。命令行参数有三个：setup 打开交互式 TUI 配置界面，--config <path> 指定自定义配置文件路径，--version 显示版本号。想手动看输出效果，可以跑 cat scripts/payload.example.json | ccstatusline-zh。

TUI 是主要的配置入口，执行 ccstatusline-zh setup 后可以添加、删除、重新排列组件，设置颜色和样式，选 Powerline 主题，并即时预览。v2.2.14 起 TUI 里多了「固定全局安装」选项，锁定当前版本而不是跟随 @latest，能省掉状态栏每次重绘时的包解析开销；如果重绘延迟明显，优先选它。装完中文版后你还会看到 ccstatusline-zh 这个命令本身支持 --config，多套配置可以分文件放。

第二个是上游 sirmalloc/ccstatusline。按本仓库的差异表，两者功能完全一致，共用同一份 settings.json，区别只在界面语言：上游是英文，中文包把组件名称、分类标签、菜单项、帮助文本、提示信息和对话框全部替换成中文。中文包版本号与上游独立递增，当前是 2.2.31，对应上游 v2.2.30 加 main@35440e4，2026-09-28 核对。settings.json 里的 widget type ID（例如 "model"、"git-branch"）保持英文不变，这是两版配置能互通的原因。

第三个是 taekchef/claude-code-zh-cn。输入里只给了它的仓库地址，从项目名判断与 Claude Code 的界面汉化有关，翻译范围覆盖到哪里、由谁维护、更新节奏如何，这些信息没有更多材料可以核实，这里不做推测。

逐项对照

差距出现在哪

三者的差别集中在翻译覆盖面和同步方式，不在于谁多出某个功能。ccstatusline-zh 译的不是几个菜单标题，而是 88 个组件的名称、描述与分类标签，加上 TUI 的全部菜单项、帮助文本、提示信息和确认对话框，连极简模式、模糊搜索组件选择器、Powerline 主题色延续这些细节也一并处理。

同步是它最值得注意的一环，也是最先出问题的地方。仓库每周同步一次上游 main 并发布中文版本，上次同步的基线提交写在 README 里，中文包与上游版本号各自递增。这条流水线并不总是顺：有一期自动同步脚本已经完成从上游 cherry-pick v2.2.20..v2.2.22、中文化新增字符串、lint 与测试全部通过，但 PR 创建受阻，最后需要人工介入。你拿到的中文界面，滞后多少取决于上一轮同步有没有卡住。

不如上游的地方有两处。功能上它没有任何增量，上游没有的组件它也没有，上游发布新组件后得等同步完成才能在中文界面里选到。社区也不在上游那个量级，上游的 Issue 与讨论发生在 sirmalloc 仓库，中文版这边只有 3 个开放 Issue，遇到问题时能参照的历史记录更少。

历史上报过的问题都落在显示细节上，当前状态都是已解决。cache-hit-rate 组件一度把分母算成不含未命中的 token，缓存命中率永远显示接近 100%；Windows 下用 npm install -g ccstatusline-zh 装好之后执行 ccstatusline-zh setup，会报 No package.json was found for directory，根源在 bun 的全局安装目录，用户并没有用本地 bun；按 README 抄 hooks 配置后启动报 Settings Error；还有人配置了 3 行状态栏，实际只显示 1 行。

什么情况下选它

你在 Claude Code 里待的时间足够长，希望终端底部那一行菜单和提示一眼看懂，就装中文版。你手上已经有一份调好的 settings.json，不用为新界面重配，两版共用同一份文件。上游刚发布的组件对你没用，你更在意配置过程是不是中文，中文版合适。

反过来，两种情况不该选它。你需要第一时间用上上游刚发布的组件或修复，等一轮同步不划算，直接用 sirmalloc/ccstatusline，功能与它完全相同。你要的是 Claude Code 本身界面的汉化，比如输入区、对话区、斜杠命令提示，这个仓库只处理终端底部那一条状态栏，管不到别处。

它属于本机辅助工具，读取 Claude Code 交给它的状态数据并在终端渲染，不涉及对外部目标的扫描、探测或抓取，同时它也不改写 Claude Code 的行为，装与不装都不影响对话本身。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.8 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。