🎉 欢迎使用 AI合租 文档系统!返回主站 →
文档中心
使用技巧
状态栏配置

状态栏配置

自定义 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
  • 状态栏在会话消息更新时刷新

状态栏帮助你在开发过程中保持上下文意识,避免在错误分支或项目中工作!