尧图网站设计 尧图网站设计YAOTU DESIGN
ARTICLE DETAIL

资讯详情

深耕网站设计与一线实操的经验洞察。

Weave Router cc-statusline状态栏完整指南:Claude Code如何实时显示路由模型与成本节省

Weave Router cc-statusline状态栏完整指南:Claude Code如何实时显示路由模型与成本节省 Weave Router cc-statusline状态栏完整指南Claude Code如何实时显示路由模型与成本节省【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/routerWeave Router 是一款面向 Agentic 系统的模型路由器能在 50ms 内把每个 prompt 路由到最合适的模型整体成本降低 40–70%。它的cc-statusline 状态栏脚本install/cc-statusline.sh会把 Claude Code 终端底部变成一块实时仪表盘当前请求实际被路由到的模型、你原本选择的模型、本会话累计节省的费用以及输入 / 输出 / 缓存 Token 的消耗一目了然。本文带你从零上手这个状态栏安装、读懂输出、排障一篇讲透。一、cc-statusline 状态栏是什么Claude Code 每完成一轮对话都会调用你配置的状态栏命令并通过 stdin 传入一段 JSON包含当前会话的transcript_path和你选择的模型。cc-statusline.sh 接收这段输入后做三件事解析会话记录JSONL transcript找到最新一轮实际由上游返回的message.model也就是路由后的真实模型对照内置价目表把路由模型成本与你手动选择模型的成本逐轮对比算出会话累计节省渲染一行状态同时把/force-model等指令产生的[forced]钉选状态标注出来。它无需 sidecar、无需数据库、无需额外鉴权本地 Docker 自托管和托管云端路由都能直接用。二、状态栏长什么样逐字段解读一次典型输出品牌色 #FF6C47WEAVE ROUTER — claude-sonnet-4-5 ← claude-opus-4-7 · saved $1.23 · 12.4k in / 3.1k out / 45.2k cache read字段含义WEAVE ROUTER品牌标识终端支持 24-bit 真彩时显示橙色claude-sonnet-4-5本轮实际服务的模型路由器选的← claude-opus-4-7你在 Claude Code 里选择的模型saved $1.23会话累计节省若路由器没赢过你的选择显示$0.00而非负数12.4k in / 3.1k out会话累计输入 / 输出 Token45.2k cache read缓存读取 Token按 0.1× 输入价计费单独展示x.xk cache write缓存写入 Token按 1.25× 输入价计费几种特殊形态同样值得一认识手动钉选执行/force-model后显示WEAVE ROUTER — gpt-5.6-terra [forced] · …因为节省金额描述的是自动路由对手动钉选没有意义失败轮次Claude Code 本地合成的错误占位轮次会显示failure不会把内部哨兵值泄漏到状态栏新会话transcript 还不存在时脚本静默退出exit 0状态栏留空。三、一键安装两条命令接入 Claude Code最简单的安装方式是运行官方安装器它会自动写好状态栏配置npx weave-os/router --claude安装器会做两件事见 install/README.md在~/.claude/settings.json中设置ANTHROPIC_BASE_URL、路由密钥头以及statusLine配置把状态栏脚本落到~/.weave/cc-statusline.sh项目级安装则放在repo/.claude/cc-statusline.sh并加入.gitignore不污染仓库。验证是否生效启动claude完成一轮对话后底部应出现WEAVE ROUTER — 路由模型 ← 选择模型多轮之后会追加· saved $X和 Token 统计。手动配置最快方法如果想手动接入只需在~/.claude/settings.json中加一段{ statusLine: { type: command, command: /abs/path/to/cc-statusline.sh } }前提系统 PATH 中需要jq。若状态栏一直不出现用claude --debug查看 stderr 中调用脚本的报错。四、成本是怎么算的揭秘节省金额的来源状态栏里的saved $X不是估算而是逐轮精确计价价目表内置在脚本中cc-statusline.sh#L461-L707覆盖 Claude、GPT、Gemini、DeepSeek、Kimi、Qwen 等几十种模型的输入 / 输出 / 缓存读取单价由 cmd/genprices/ 从价格源自动生成价格变更时运行make generate即可同步不要手改每轮对比你的选择模型成本 − 路由模型成本累加即会话节省缓存读取按各模型自己的倍率计价缓存写入固定 1.25×模型 ID 会先做归一化去掉[1m]变体标签和日期后缀逻辑见 cc-statusline.sh#L454-L456保证新旧 ID 都能命中价目表。智能自愈如果路由到了一个价目表里没有的新模型显示saved $0.00脚本会在后台提前触发一次刷新下载最新价目表下一轮即可恢复真实节省金额——不用干等 7 天的定期更新。五、进阶能力状态栏不只是显示定期自更新每 7 天WEAVE_STATUSLINE_UPDATE_INTERVAL_DAYS可调在后台子进程中检查并原子替换脚本自身与.claude/commands/*.md斜杠命令包装器不阻塞任何一轮对话你手动改过的包装器永远不会被覆盖删除过的也不会被复活组织级开关管理员可通过路由器的hide_terminal_surfaces设置一键隐藏终端展示面——判断只依赖本地缓存文件缓存失效时放行网络故障永远不会卡死状态栏逻辑见 cc-statusline.sh#L324-L436一键关闭网络行为export WEAVE_STATUSLINE_UPDATE0即可禁用所有后台网络路径适合离线或受管环境配套斜杠命令/force-model、/unforce-model、/router-feedback、/router-status、/router-models等与状态栏联动例如 router-models.md 可以在对话里直接勾选路由器可选的模型。六、常见问题速查现象原因与对策状态栏完全空白检查jq是否在 PATHclaude --debug看 stderr一直显示saved $0.00新模型未入价目表等待一次后台刷新或确认路由器确实发生了模型替换出现负数不会。路由器升级到了更贵模型时显示被钳制为$0.00表示跑过了但没赢想完全离线使用设WEAVE_STATUSLINE_UPDATE0所有后台下载与刷新即刻停用团队项目级安装npx weave-os/router --claude --scope project脚本与个人密钥均进.gitignore只提交settings.json自托管 fork 用户用WEAVE_STATUSLINE_URL/WEAVE_COMMANDS_URL_BASE指向你自己的源七、核心文件索引状态栏脚本含价目表与渲染逻辑install/cc-statusline.sh全量离线回归测试覆盖刷新、锁、门控等边界install/tests/cc-statusline_test.sh安装器与写入路径说明install/README.md、install/install.sh价目表生成器cmd/genprices/main.go价格与模型目录internal/router/catalog/、internal/observability/otel/pricing.go配置参考docs/CONFIGURATION.md装上 cc-statusline 之后每一次模型替换带来的美元收益都会直接躺在你的终端底部——路由器的价值从看得见开始。【免费下载链接】routerModel router for agentic systems. Routes every prompt to the right model in 50ms. Cut costs 40-70% with just an endpoint change.项目地址: https://gitcode.com/GitHub_Trending/router101/router创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表