coralline 是一个面向 Claude Code 的 Powerlevel10k 风格状态栏工具，用 Shell/Bash 实现。它可以在 Claude Code 底部状态栏显示当前目录、Git 状态、Claude 模型、推理强度、上下文窗口、5小时/7天限额、会话成本、耗时、时间、代码增删行等信息。项目主打“一条提示词让 Claude 帮你安装和配置”，也支持 curl 一键安装和手动安装。
适用领域
AI 编程工具 / Claude Code 扩展 / 终端美化 / Shell 工具 / 开发者效率工具 / 状态栏/提示符定制 / Git 工作流辅助
配置难度
低到中等。普通用户可以直接让 Claude Code 自动安装和配置；熟悉终端的用户可用 curl 一键安装。若要深度定制主题、响应式布局、float readout 或手动接入 tmux/iTerm2，则需要一定 Shell、JSON 和终端配置经验。
商业价值
对个人开发者和 AI 编程重度用户价值较高，能提升 Claude Code 使用过程中的可观测性和体验感，帮助控制成本、监控限额、理解上下文占用并快速掌握 Git 状态。对企业团队而言，它更偏向开发者体验工具，不直接产生核心业务能力，但可作为 Claude Code 内部推广、AI 编程规范化和成本感知的一部分。由于 MIT 许可和纯 Shell 实现，集成成本较低，适合纳入团队 dotfiles 或开发环境模板。
01
技术亮点
- 专门为 Claude Code 设计，信息维度贴合 AI 编程场景。
- 安装体验很强：可以让 Claude 自己读取 playbook、采访用户并完成配置。
- Powerlevel10k 风格，对终端美化用户非常有吸引力。
- 显示 Claude 模型、推理强度、上下文窗口、token、限额、成本等 AI 会话关键信息。
- 支持 5小时/7天限额进度条和颜色阈值提醒。
- burn-rate 片段可以预测额度耗尽时间，适合高频 Claude Code 用户。
- 支持多主题，包括 claude-coral、catppuccin-mocha、nord、gruvbox-dark、tokyo-night、dracula 等。
- 支持 lean 和 pill 两种视觉风格。
- 支持响应式布局，可根据终端宽度自动换行。
- 支持从 Powerlevel10k 配置导入部分风格。
- 配置是普通 Bash 文件，便于高级用户直接编辑和版本管理。
- MIT 许可证，商业和个人使用限制较少。
02
目标用户
- 日常使用 Claude Code 的开发者
- 喜欢 Powerlevel10k、Nerd Font、终端美化的工程师
- 希望实时查看 Claude Code token、限额、成本和会话状态的用户
- 经常在 Git 仓库中进行 AI 辅助开发的开发者
- 使用 macOS/Linux 终端环境的开发者
- 喜欢通过配置文件深度自定义工具外观的高级用户
03
配置要求
- 运行环境需要 Bash/Shell。
- 必须安装 jq。
- 推荐终端使用 Nerd Font，以正确显示图标和 powerline glyph。
- 无 Nerd Font 时可在 ~/.claude/coralline.conf 中设置 VL_ASCII=1。
- Claude Code 需要支持 statusLine 配置，settings.json 中需注册 command 类型状态栏。
- 主要配置文件为 ~/.claude/coralline.conf，格式为 Bash 变量。
- 可配置 VL_STYLE 为 pill 或 lean。
- 可配置 VL_LAYOUT 为 fixed 或 auto，以控制固定行或响应式换行。
- 可配置 VL_SEGMENTS、VL_SEGMENTS2、VL_SEGMENTS3 控制显示片段及顺序。
- 可配置 VL_CLOCK、VL_BAR_WIDTH、VL_PATH_DEPTH、VL_WARN_PCT、VL_HOT_PCT、VL_COST_DECIMALS 等显示细节。
- 如启用 burn 片段，会写入采样文件 ~/.claude/coralline/burn-5h.tsv。
- 如启用 float readout，需要设置 VL_FLOAT=1，并可配置 VL_FLOAT_FILE、VL_FLOAT_SEGMENTS 等。
04
适用场景
- 在 Claude Code 中实时查看当前模型、上下文占用、费用和限额
- 通过状态栏快速判断 Git 分支、改动、stash、ahead/behind 状态
- 监控 Claude Code 5小时和7天使用限制，避免突然触达限额
- 使用 burn-rate 预测当前使用速度下多久会耗尽额度
- 将 Claude Code 状态栏做成 Powerlevel10k 风格的多彩视觉体验
- 根据终端宽度自动换行，适配窄窗口或分屏开发
- 把 plain-text readout 输出到 float.txt，再接入 tmux、iTerm2、WezTerm 或菜单栏工具
- 从已有 Powerlevel10k 配置导入风格、颜色和时间格式
05
部署与配置
- 确认已安装 jq，并使用支持 Nerd Font 的终端字体；如果没有 Nerd Font，可后续设置 VL_ASCII=1。
- 推荐方式：在 Claude Code 中粘贴提示词：Please install coralline for me: fetch https://raw.githubusercontent.com/Nanako0129/coralline/main/INSTALL.md and follow the playbook in it.
- Claude 会读取安装说明，运行 install.sh，询问你的主题、样式、片段、时钟、字体兼容性等偏好，并写入配置。
- 也可以手动一键安装：curl -fsSL https://raw.githubusercontent.com/Nanako0129/coralline/main/install.sh | bash
- 如需固定版本，可使用：curl -fsSL https://raw.githubusercontent.com/Nanako0129/coralline/main/install.sh | bash -s -- --ref v0.6.0
- 安装后可通过 bash ~/.claude/coralline/configure.sh 重新打开配置向导。
- 手动安装时，需要克隆仓库、复制 statusline.sh/configure.sh/install.sh/themes，并在 ~/.claude/settings.json 中配置 statusLine.command 为 bash ~/.claude/coralline/statusline.sh。
06
风险与注意事项
- 项目强依赖 Claude Code 的 statusLine 能力，不适合普通终端 prompt 或非 Claude Code 用户。
- 安装方式包含 curl | bash，对安全敏感团队需要先审计脚本。
- Nerd Font 依赖可能导致字体显示问题，尤其在远程终端、Web IDE 或部分 Windows 终端中。
- 配置文件是 Bash 形式，错误配置可能导致状态栏异常或渲染失败。
- 状态栏每秒刷新一次可能带来轻微性能开销，尤其在低性能机器或复杂 Git 仓库中。
- burn-rate 需要写采样文件，可能带来少量本地文件状态管理问题。
- 主题和 glyph 在不同终端、字体、颜色方案中显示效果可能不一致。
- 项目生态较新，虽然星标数不错，但仍需关注 Claude Code 版本变化带来的兼容性风险。
- README 中强调 Claude Code v2.1.153+ 对 COLUMNS 的支持，旧版本可能无法获得完整响应式体验。
2026-06-19
第22名
新收录 · github_search
