Claude Code 自定义状态栏带实时 VPS 监控

Claude Code 自定义状态栏：实时 VPS 监控

同时管理多台服务器上 Claude Code 的开发者，常常需要频繁切换上下文来查看基础设施状态。解决方案？一个自定义状态栏，直接在编辑器中显示关键会话指标和 VPS 监控数据——无需切换上下文。

系统架构

监控系统由两大部分组成：后台守护进程用于轮询服务器，客户端脚本用于显示数据。vps-poller.sh 守护进程每 30 秒通过 SSH 查询服务器，获取四个核心指标：

• 内存使用率
• CPU 负载
• 磁盘空间使用率
• 系统运行时间

数据以 JSON 文件形式缓存到 /tmp/ 目录，因此 statusline.sh 客户端脚本能即时拉取最新信息，无需额外网络请求。这让 Claude Code 的界面保持流畅。

核心架构优势：

• 缓存机制大幅降低网络开销
• 显示零延迟
• 模块化设计：守护进程可独立运行
• 支持同时处理多台服务器

自动聚焦活跃服务器

管理多个 VPS 实例时，最大痛点是搞不清当前操作哪台服务器。这个系统通过自动分析 Claude Code 日志来解决。

脚本扫描最近 20 KB 会话记录，使用两种策略识别活跃服务器：

• 检测 SSH 命令（ssh、scp、sftp）并匹配 IP 地址到预配置服务器列表
• 如果仅使用模型上下文协议（MCP），则回退搜索 MCP 服务器名称

实际效果预览：

# 通过 SSH 操作 'main' 服务器
▶ main●(内存:42% 磁盘:55%) new● sec●

# 通过 MCP 切换到 'sec'
main● new● ▶ sec●(内存:61% 磁盘:70%)

# 'new' 服务器高负载（始终高亮）
▶ main●(内存:42% 磁盘:55%) new◉(内存:92%) sec●

状态指示符包括：

• ● — 一切正常
• ◉ — 高负载（内存 > 85% 或磁盘 > 90%）
• ✗ — 服务器不可达
• ↻ — 最近重启
• ▶ — 当前活跃服务器

Claude API 集成与费用追踪

状态栏接入 Claude API，实时显示使用限额和会话费用估算。它自动识别账户类型：

• Claude Max 订阅用户看到理论会话费用
• API 用户看到实际支出

显示的 Claude API 指标：

• 活跃模型 — 当前模型（如 Opus 4.6）
• 上下文填充 — 带颜色编码的进度条（绿 → 黄 → 红）
• 剩余配额 — 5 小时（H）和周（W）限额的使用百分比
• 会话费用 — API 支出估算

API 数据缓存 2 分钟以减轻负载，从系统凭证存储中拉取 OAuth 令牌。

安装与配置

安装流程简化，便于快速部署，最好直接通过 Claude Code 操作。

通过 Claude Code 快速安装：

克隆 https://github.com/CreatmanCEO/claude-statusline 并运行 install.sh --ru

高级用户手动安装：

git clone https://github.com/CreatmanCEO/claude-statusline.git ~/claude-statusline
bash ~/claude-statusline/install.sh --ru

VPS 监控配置：

• 将服务器添加到 ~/.claude/statusline.conf
• 设置 SHOW_VPS=remote
• 在 VPS_SERVERS 中列出服务器
• 启动守护进程：~/claude-statusline/vps-poller.sh start

平台注意事项：

• Linux/macOS：完整功能支持
• Windows：仅通过 Claude Code 安装（跳过 PowerShell）
• 需要预装 bash 和 jq 处理 JSON

核心功能

• 即时 VPS 监控 — 无需切换工具查看服务器状态

• 自动聚焦 — 从 Claude Code 日志检测活跃服务器

• Claude API 集成 — 实时限额与会话费用

• 轻量级 — 纯 bash + jq，无需 Node.js 或重型运行时

• 跨平台 — 支持 Linux、macOS、Windows（有限制）

兼容性修复

开发测试中已解决主要问题：

Windows 权限：

• PowerShell 中 chmod 失败
• 修复：仅提供 Claude Code 安装说明

OAuth 令牌存储：

• Windows：.credentials.json
• Unix：.credentials
• 修复：脚本检查两者

嵌套 JSON 引号：

• echo 破坏 JSON
• 修复：切换到 printf 并正确转义

Windows bash 路径：

• command -v bash 返回含空格路径
• 修复：直接调用 bash，跳过路径检查

所有修复在发布一天内完成——开源速度的体现。

高级功能与自定义

通过多种显示模式定制状态栏，适配你的工作流。

可自定义段落：

• Git 信息：当前分支与变更状态
• 代码统计：本会话新增/删除行数
• 会话计时器：工作时长
• 系统工具：MCP 等协议支持

性能优化：

• 占用极小：守护进程 CPU <1%
• 智能缓存：仅变更时更新
• 延迟加载：跳过未用模块

项目根据社区反馈持续演进。未来计划：更多监控协议、UI 优化和开发工具集成。

— Editorial Team