状态栏配置
自定义 Claude Code 状态栏,实时显示项目关键信息。
状态栏显示在 Claude Code 界面底部,类似终端提示符,可显示 Git 分支、模型名称、令牌使用量等信息。
配置方法
交互式设置
# 打开状态栏配置向导
/statusline
Claude 会引导你配置状态栏显示内容,包括:
- 当前使用的 Claude 模型
- 当前 Git 分支和状态
- 项目名称和目录
- 会话成本和令牌使用量
- 当前时间
手动配置
在 .claude/settings.json
中添加配置:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"padding": 0
}
}
状态栏脚本
Claude 会通过 stdin 向您的脚本传递包含会话信息的 JSON 数据:
#!/bin/bash
# ~/.claude/statusline.sh
read -r json_data
echo "📁 $(echo "$json_data" | jq -r '.directories[0]') | 🌿 $(git branch --show-current 2>/dev/null || echo 'no git') | 🤖 $(echo "$json_data" | jq -r '.model')"
推荐工具
CC Statusline
使用专业的状态栏工具 ccstatusline
:
# 使用 Bun (最快)
bunx ccstatusline@latest
# 或全局安装
npm install -g ccstatusline
特性包括:
- 🎨 Powerline 风格的美观渲染
- ⚡ 实时指标显示
- 🎯 多行状态栏支持
- 🌈 自定义颜色主题
社区状态栏
其他优秀的状态栏工具:
claude_monitor_statusline
- 显示使用统计claude-code-statusline
- 原子级精确状态栏cc-statusline
- 美观信息显示
显示内容示例
🤖 Claude-3.5-Sonnet | 📁 my-project | 🌿 feature/login | 💰 $0.05 | ⏱️ 14:30
最佳实践:使用 emoji 和颜色让信息更易扫描,测试脚本时可手动运行验证输出。
故障排除
- 确保脚本具有执行权限:
chmod +x ~/.claude/statusline.sh
- Windows PowerShell 用户可能遇到显示问题,建议使用 WSL
- 状态栏在会话消息更新时刷新
状态栏帮助你在开发过程中保持上下文意识,避免在错误分支或项目中工作!