ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Claude Code Router 监控实操指南:从零配置终端状态栏与 LLM 调用观测

Claude Code Router 监控实操指南:从零配置终端状态栏与 LLM 调用观测 Claude Code Router 监控实操指南从零配置终端状态栏与 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、Codex 这类编码 Agent 时最让人头大的问题往往不是代码本身而是现在到底在跑什么请求打到了哪个供应商用的哪个模型这一轮吃了多少 Token出了错是哪一跳的锅Claude Code Router下称 CCR把这类信息分两层暴露出来一层是终端里的状态栏Status Line随 Agent 会话实时刷新模型名和 Token 用量另一层是管理面板里的请求日志与观测数据记录每次 LLM 调用的路由结果、耗时和成本估算。这篇指南走一遍从安装到自定义模块、再到日志采样的完整路径。状态栏到底显示了什么CCR 接管 Agent 后会向 Claude Code 的~/.claude/settings.json写入一条statusLine配置让终端底部挂上一个常驻的信息条。它不占用额外的后台进程数据来自当前会话的上下文所以刷新没有延迟{ statusLine: { type: command, command: ccstatusline } }状态栏由若干组件块拼成每个块可以独立设置图标、文本模板和配色。开箱即用的组件有五个Working Directory当前工作目录名、Git BranchGit 分支、Model当前生效的模型名形如Claude Sonnet 4、UsageToken 用量区分输入和输出、Script指向自定义脚本用于扩展指标。文本模板支持变量占位符这是定制的核心{{workDirName}}工作目录名{{gitBranch}}当前 Git 分支{{model}}路由后实际使用的模型{{inputTokens}}/{{outputTokens}}本会话累计的输入、输出 Token安装并看到第一条状态栏从安装到出效果最短路径是git clone https://gitcode.com/GitHub_Trending/cl/claude-code-router cd claude-code-router npm install npm run dev服务起来后进入任意 Agent 会话以 Claude Code 为例。CCR 会完成接管并把statusLine段写入~/.claude/settings.json重启会话后终端底部就能看到目录、分支、模型和 Token 数字。此时如果图标显示成方框不用怀疑配置——大概率是终端没有 Nerd Font后文有解法。更换主题、模块顺序与配色配置入口在 CCR 界面的 Status Line 设置里改动即时反映在 Preview 区域。三个值得动手的点主题风格。Theme Style 可选默认主题也可切换 Powerline 风格色块之间带箭头衔接。字体下拉框选择Hack Nerd Font Mono之类的 Nerd Font 后Nerd 图标才能正常渲染终端不支持 Nerd Font 时会自动降级为纯文本样式不会报错。模块顺序。Components 列表里的组件按排列顺序渲染到状态栏。把 Model 拖到最前就是先看模型、再看分支的布局不需要 Usage 的会话可以直接移除状态栏会更紧凑。颜色与图标。选中某个组件后右侧 Properties 区可以改 Icon支持直接粘贴 Nerd 字符、Text 模板、前景色十六进制值和背景色。例如给 Model 块设置深色背景加亮青色字长会话里一眼就能定位当前模型。用 Script 组件扩展自定义指标Script 组件允许挂一个本地脚本把任意数值塞进状态栏。写一个输出单行文本的脚本比如读一个本地统计文件拼出CPU 23%这样的字符串然后在组件配置里指定脚本路径即可。注意两点脚本输出应控制在一行内避免污染终端渲染CCR 更新settings.json时会保留已有的statusLine段手动改过的配置不会被覆盖。请求日志监控告警配置的另一半状态栏解决当前这次日志解决最近这些。在设置 → 日志与观测打开请求日志和Agent 观测两个开关。请求日志记录每条经过 CCR 的模型请求时间、请求 ID、客户端、路径、请求的模型、最终命中的供应商与模型、状态码、耗时、Token 与成本估算以及请求体和响应体。面板支持按状态、供应商、模型、凭据、请求 ID 或正文内容筛选。两个行为需要提前知道。一是留存策略普通请求日志只保留当天数据跨天后在下次读写时清理适合当日排查不适合当审计归档长期留存要靠导出。二是正文采集由三个配置项控制默认值适合多数场景{ requestLogBodyCapture: all, requestLogMaxBodyBytes: 52428800, requestLogSuccessSampleRate: 1 }requestLogBodyCapture取all、errors、none三档高流量环境建议降到errors只留失败请求的正文requestLogSuccessSampleRate是成功请求采样率0.1表示约每十条记一条能明显降低存储压力。观测面板则记录 Agent 的执行链路——每步调了什么工具、耗时多久、是否出错用来定位Agent 卡在哪一步这类问题。三个最容易踩的坑图标是方框终端字体未启用 Nerd Font。macOS 可安装Hack Nerd FontLinux 用发行版字体包安装对应 Nerd Font 变体然后在终端设置里选中它。改了 settings.json 没生效statusLine由 CCR 在接管时写入Agent 会话需要重启才会重新加载配置。日志第二天消失了这是按天清理的预期行为不是丢失。需要留档的请求当天导出或把requestLogBodyCapture调低后按需长期开启。往哪深入CCR 的监控分两层状态栏看当下日志看历史。想改状态栏的变量与渲染逻辑看 状态栏核心逻辑想看 Token 统计与成本估算怎么落到每条请求上从 请求日志运行时 入手面板层的完整开关说明在 docs/src/content/docs/zh/configuration/observability.md。先让状态栏跑起来再按需开日志采样是成本最低的起步方式。【免费下载链接】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),仅供参考
返回列表