完整实操指南：用 Claude Code Router StatusLine 快速搭建 LLM 调用监控面板

完整实操指南用 Claude Code Router StatusLine 快速搭建 LLM 调用监控面板【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router你每天在终端里跑 Claude Code Router 路由不同模型但调用打到哪个模型、烧了多少 Token、请求花了多久往往要到出问题时才去翻日志。其实你只需要打开 StatusLine 状态栏监控就能让每一轮对话的工作目录、Git 分支、当前模型、输入/输出 Token 统计实时显示在终端底部异常一眼可见。本文带你从零完成装好环境、写好 StatusLine 配置、启动服务、确认数据再做两项调优。全程只给最小必要的命令和配置。你将拿到什么一条常驻终端底部的状态栏实时显示 Claude Code Router 的路由结果与 Token 用量一套可复制的config.json模板改几个字段就能切换主题与模块顺序一个自定义指标模块的改法案例照着加 CPU/内存之类的本地数据一份验收清单和避坑清单方便你自查装对没有、哪里出了问题它如何工作状态栏面板的运行机制Claude Code Router 在本地起一个网关服务所有模型请求先经过它做路由再转发给对应供应商。在这个过程中状态栏StatusLine模块从两个地方取数一是请求链路上已经记好的模型名、Token 数、耗时二是终端本地的上下文比如当前工作目录和 Git 分支。取到的数据按你配置的模块顺序拼装成一串带颜色的文本段渲染到终端底部。你在 GUI 的状态栏配置对话框里拖动顺序、换主题只是改了这份拼装规则不动任何采集逻辑。上面这张截图就是配置入口左侧是模块列表右侧是渲染出来的预览所见即所得。分阶段落地准备阶段拿到代码与依赖先克隆仓库并安装依赖这一步为后面所有阶段准备环境。git clone https://gitcode.com/GitHub_Trending/cl/claude-code-router cd claude-code-router npm install配置阶段复制模板并填写 StatusLine 参数复制示例配置文件填入状态栏主题与模块顺序。下面的配置是Powerline 风格 五个基础模块新手建议先原样跑通再去调优阶段做修改。cp config.example.json config.json{ StatusLine: { currentStyle: powerline, fontFamily: Hack Nerd Font Mono, powerline: { modules: [ { type: workDir, icon: , text: {{workDirName}} }, { type: gitBranch, text: {{gitBranch}} }, { type: model, text: {{model}} }, { type: usage, icon: ↑, text: {{inputTokens}} }, { type: usage, icon: ↓, text: {{outputTokens}} } ] } } }模块的显示顺序就是数组顺序删掉数组里某一项该模块就不显示。启动阶段跑起服务npm run dev服务起来后状态栏面板会自动挂到终端输出底部不需要额外开端口或部署。验证阶段确认数据真的在动发一条模型请求随便问一句话即可然后盯一下状态栏模型名应与你请求命中的模型一致输入/输出 Token 数字应随对话增长。如果数字不动跳到下面的高频避坑对照排查。调优实战两项常见改造调优案例一给状态栏加一个本地资源模块改什么在config.json的powerline.modules数组末尾追加一个script类型模块指向你写的采集脚本{ type: script, icon: , text: {{cpuUsage}}% CPU / {{memUsage}}% MEM, scriptPath: ./scripts/system-monitor.js }改完长什么样状态栏末尾多出一段紫色区形如42% CPU / 61% MEM刷新时脚本被重新执行。scripts/system-monitor.js只需输出这两个变量对应的值渲染逻辑由 Claude Code Router 状态栏模块负责你不用碰 packages/core/src/observability/ 里的任何代码。调优案例二设置 Token 阈值提醒改什么在config.json顶层加一个Alerts块给输入/输出 Token 设上限并选择动作{ Alerts: { tokenLimits: { input: 10000, output: 5000, action: notify } } }改完长什么样当单次请求的输入 Token 超过 10000或输出超过 5000时状态栏对应区段变色并触发notify提醒不用你逐条翻日志找大户。验收清单做对了应该长这样逐项对照全部满足才算搭好npm run dev后终端底部出现状态栏无乱码、无半角方块状态栏第一段是当前工作目录名与pwd一致在 Git 仓库目录下分支段显示当前分支非仓库目录时该段不出现发一条请求后模型段显示的是实际命中的模型名不是请求里的别名对话进行中↑/↓ 两个 Token 数字持续变化且方向正确↑ 输入、↓ 输出改modules数组顺序后重启服务状态栏区段顺序随之变化触发tokenLimits后能看到notify提醒动作生效高频避坑现象 → 排查 → 解法图标显示成方块或问号现象Powerline 分隔符或 Nerd Font 图标渲染异常。排查确认终端加载的字体是否支持 Nerd Font 图标。解法安装 Nerd Font 字体如 Hack Nerd Font Mono并在终端字体设置中启用不想装字体时把currentStyle切到简洁主题Claude Code Router 状态栏模块会自动降级为纯文本渲染。状态栏数字不动、数据像卡住现象模型、Token 区段长时间不更新。排查先用一条新请求触发链路再确认请求确实经过了本地网关而不是直连供应商。解法检查 Agent 侧的 base URL 是否指向 Claude Code Router 本地服务地址指向正确后重新发请求数字应即时刷新。改了配置但不生效现象编辑config.json后状态栏没有任何变化。排查确认 JSON 没有语法错误多一个逗号也会让整份配置被回退。解法修正语法后重启npm run dev仍不生效时查看服务启动日志中关于配置加载的报错行按提示补齐字段。下一步延伸状态栏只解决了看得清这一层接下来你可以按顺序做打开请求日志与 Agent 观测对照单条请求的请求体、响应体、耗时定位慢在哪一步参考 开启日志与观测指南需要更细的开关和字段说明时查阅 日志与可观测性配置参考想理解数据从路由到落盘再到面板的完整链路读一读 项目初衷及原理进阶读源码状态栏与请求日志的采集实现都在 packages/core/src/observability/ 目录从request-log-runtime.ts开始顺着读最省事【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考