Claude Code - 26 效率三件套：cc-switch 切模型 · codeburn 算成本 · claude-hud 看状态

一、这套工具解决什么问题？

如果你每天重度使用 Claude Code 写代码，大概率会遇到下面这些场景：

场景 1：模型切换全靠手改环境变量

今天想用官网 Opus 写复杂重构，明天想切到火山引擎的 ark-code-latest 跑批量任务，后天又想换 DeepSeek 便宜模型跑长对话。
每次都要手动 export ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL，改完新终端还不生效，翻来覆去容易错位。

场景 2：费用心里没底

一个会话跑了几百次工具调用，到底花了多少钱？按项目、按模型、按任务拆开分别是多少？月底对账时才发现超支。
用了多家 provider（Claude / Codex / Cursor / Copilot），账单分散在各自的控制台，拼不出一张总账。

场景 3：会话状态不可见

上下文窗口还剩多少？40% 还是 90%？全靠猜。
当前跑的是哪个模型、git 分支改没改、正在调哪个工具？切来切去容易乱。

三件套分工：

工具	定位	解决的核心问题
cc-switch	配置切换器	一键切换多套 Claude API 配置（官网/火山/DeepSeek），并配合 sessions 恢复会话
codeburn	AI 编码支出与使用洞察	按任务 / 工具 / 模型 / 项目维度看清 token 花在哪，预算管理与浪费优化
claude-hud	状态栏插件	常驻显示模型、上下文健康度、使用率、费用、工具/Agent/待办动态

一句话总结：cc-switch 管"切"、codeburn 管"算"、claude-hud 管"看"，三者组合成一套完整的 Claude Code 工作流。

二、cc-switch：模型配置切换

1. 安装

macOS 上推荐 Homebrew 安装：

bash 复制代码

brew install cc-switch-cli
# 验证
cc-switch --help

2. 添加配置

把多套 provider 配置好，每套用一个名字（name）标识，ID 默认由名字生成：

bash 复制代码

# 火山引擎（Ark）
cc-switch provider add \
    --name ark \
    --base-url https://ark.cn-beijing.volces.com/api/coding \
    --api-key sk-xxx \
    --model ark-code-latest

# DeepSeek（Anthropic 兼容端点）
cc-switch provider add \
    --name deepseek \
    --base-url https://api.deepseek.com/anthropic \
    --api-key sk-xxx \
    --model deepseek-v4-flash

# 用内置厂商模板添加（DeepSeek 等有现成模板）
cc-switch provider add --template deepseek --name deepseek --api-key sk-xxx

也可以直接运行 cc-switch（不带参数）进入 TUI 交互模式，可视化添加 / 编辑 / 切换。

常用参数（provider add）：

--name：配置显示名（必填）
--id：provider ID（默认由 name 生成）
--base-url：API 端点
--api-key：鉴权 token
--model：默认模型
--template：内置厂商模板（如 deepseek / claude-official 等）
--opus-model / --sonnet-model / --haiku-model：分别指定各角色模型

3. 基本使用

bash 复制代码

cc-switch provider list              # 列出所有配置（✓ 标记当前生效）
cc-switch provider current           # 查看当前生效配置
cc-switch use ark                    # 切到火山引擎
cc-switch use deepseek               # 切到 DeepSeek
cc-switch provider delete deepseek   # 删除配置

4. 高频命令速查

bash 复制代码

cc-switch use deepseek                    # 切到 DeepSeek（只切配置，不恢复会话）
cc-switch sessions list                   # 列出保存的会话，拿会话 ID
cc-switch sessions resume <会话ID>         # 用当前生效配置恢复指定会话（最常用）
cc-switch sessions search <关键词>         # 按内容搜索历史会话

小贴士：在 shell 里配别名 cs='cc-switch'，日常操作更顺手。

三、codeburn：看清你的 AI 编码 token 花在哪

1. codeburn 是什么

codeburn 是一个 AI 编码支出与使用追踪工具，一句话标语：

See where your AI coding tokens go - by task, tool, model, and project. 看清你的 AI 编码 token 花在哪--按任务、工具、模型、项目四个维度。

它同时支持 Claude Code、Codex、Cursor、Copilot、Gemini 等多家 provider，能把分散在各自控制台的账单拼成一张总账。形态上是一个 CLI，同时提供 TUI 仪表盘、本地 Web 仪表盘、macOS 菜单栏应用、Claude Code 状态栏和 MCP Server。

2. 安装

bash 复制代码

npm install -g codeburn
codeburn --version
codeburn doctor   # 健康检查：确认各 provider 会话能被正确识别

doctor 会列出每个 provider 探测的路径、找到的会话数、解析健康度--数字空就按提示修路径。

3. 核心：Web 仪表盘（最推荐）

codeburn 的能力很多，但最值得日常用的就是 Web 仪表盘。一条命令打开浏览器，所有维度一目了然，比在终端里翻表格直观得多：

bash 复制代码

codeburn web                        # 打开浏览器仪表盘（默认 4747 端口）
codeburn web -p month               # 初始看本月
codeburn web --provider claude      # 只看 Claude Code
codeburn web --project my-app       # 只看某个项目
codeburn web --no-open              # 启动但不自动开浏览器（远程服务器场景）
codeburn web --port 8080            # 换端口

Web 仪表盘里你能看到：

总花费 / 总 token：按今天、本周、本月、自定义区间切换
按项目拆分：哪个项目烧钱最多
按模型拆分：Opus / Sonnet / 第三方模型各自占比
按任务/工具拆分：feature / debugging / refactoring 哪类活儿最耗 token，Read / Edit / Bash 哪个工具回包最大
时间线：每天的花费曲线，定位异常飙升
optimize 建议：直接在页面上看 token 浪费点与修复建议

日常 workflow 就是：开着 codeburn web，写完一段看一眼，发现某项目/模型花费异常就去 drill down。它是 codeburn 的"主面板"，其他命令基本都是给这条做补充的。

远程开发时用 codeburn web --no-open，再通过 SSH 端口转发把 4747 映射到本地浏览器即可。

4. 几个补刀用的高频命令

Web 仪表盘看趋势够了，下面几个命令适合"想精确复制一段数据"或"接脚本/CI"时用：

bash 复制代码

codeburn status                     # 终端里最快看一眼：今天 + 本月
codeburn overview                   # 纯文本概览，可复制粘贴到周报
codeburn overview -p today          # 看今天

codeburn budget --monthly 50        # 设月预算 50 美元
codeburn budget --check             # 检查是否超额（超额则退出码 1，可接 CI）

codeburn optimize                   # 找 token 浪费点 + 给精确修复
codeburn optimize --apply --dry-run # 先看修复计划不改文件

codeburn currency CNY               # 切换显示货币为人民币

其余 models / sessions / context / devices / menubar / guard 等命令按 codeburn --help 自行探索，本文不逐一展开。

5. 计价说明：codeburn 数字与第三方官网账单可能有出入

codeburn 的费用是基于内置模型定价表 + 本地会话 token 计数估算出来的，和第三方 provider 官网最终结算的账单可能存在偏差，常见原因：

模型名对不上 ：走火山 / DeepSeek 等第三方端点时，模型名（如 ark-code-latest、deepseek-v4-flash）不在 codeburn 内置价表里，会被按默认价或 0 处理。需要手动映射：
bash 复制代码
```
codeburn model-alias ark-code-latest claude-sonnet-4-6   # 映射到规范名复用内置价
codeburn price-override my-model --input 0.27 --output 1.1  # 或直接覆盖定价（USD/百万 token）
```
缓存 token 计费口径不同：Anthropic 的 prompt caching、各家的 cached input token 折扣比例不同，codeburn 的估算未必能与官网逐 token 对齐。
汇率与货币 ：codeburn currency CNY 按 codeburn 内部汇率换算，与发卡行实际汇率略有差异。
订阅/代理路径 ：走订阅代理（如 Claude Code over GitHub Copilot）的项目，用 codeburn proxy-path <目录> 标记后，codeburn 会把 API 速率成本作为"原价"展示但记为订阅覆盖、净自掏腰包为 0；如果没标记，这部分会被算成实际花费，导致偏高。

结论：codeburn 的数字适合做趋势分析、异常发现和优化效果对比 ，不推荐直接拿来做对公报销/精确对账的最终依据。需要严格对账时以 provider 官网账单为准，codeburn 用 codeburn audit 命令可以输出原始 token 字段与估算成本的对照表辅助核对。

四、claude-hud：会话状态尽收眼底

1. 安装

在 Claude Code 会话内依次执行：

text 复制代码

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins

终端直接执行也行：

bash 复制代码

claude plugin marketplace add jarrodwatts/claude-hud
claude plugin install claude-hud@claude-hud

2. 初始化状态栏

text 复制代码

/claude-hud:setup

setup 会把 HUD 注册为 Claude Code 的 statusLine（写入 ~/.claude/settings.json），发送下一条消息后 HUD 即出现，无需重启。

3. 按需配置

text 复制代码

/claude-hud:configure

引导式配置支持：选择预设（完整 Full / 核心 Essential / 极简 Minimal）、切换中英文、开关各元素、预览后保存。

极简：只显示模型名 + 上下文进度条
核心：活动行 + git 状态
完整：工具、Agent、待办、git、使用率、时长全开

4. 常驻显示什么

开启后，状态栏类似：

perl 复制代码

[Opus] │ my-project git:(main*)
上下文 █████░░░░░ 45% │ 使用率 ██░░░░░░░░ 25%（1小时30分 / 5小时）│ 费用 $2.35

一眼看清模型、上下文健康度、订阅使用率、本次会话费用、当前工具/Agent/待办动态。

5. 让 HUD"动起来"：自动刷新

Claude Code 只在交互后才重绘状态栏，倒计时类信息会停更。想让费用/倒计时持续跳动，给 statusLine 加 refreshInterval：

jsonc 复制代码

// ~/.claude/settings.json
{
  "statusLine": {
    "type": "command",
    "command": "...",           // 保持 /claude-hud:setup 生成的内容
    "refreshInterval": 5        // 秒，推荐 5
  }
}

6. 临时关闭

某次会话不想看 HUD，不用删配置：

bash 复制代码

CLAUDE_HUD_DISABLE=1 claude

claude-hud 与 codeburn 的分工：claude-hud 负责"会话内实时状态常驻显示"，codeburn 负责"跨会话/跨项目/跨 provider 的花费汇总与深度分析"。两者互补，不冲突。

五、高频命令速查表

目的	命令
列出所有配置	`cc-switch provider list`
查看当前配置	`cc-switch provider current`
切到某配置	`cc-switch use <ID>`
添加配置	`cc-switch provider add --name <名称> --base-url <URL> --api-key <KEY> --model <模型>`
删除配置	`cc-switch provider delete <ID>`
列出已保存会话	`cc-switch sessions list`
恢复会话	`cc-switch sessions resume <会话ID>`
搜索会话	`cc-switch sessions search <关键词>`
打开 Web 仪表盘	`codeburn web`
终端快速看一眼	`codeburn status`
纯文本概览	`codeburn overview`
设月预算	`codeburn budget --monthly <amt>`
找 token 浪费	`codeburn optimize`
健康检查	`codeburn doctor`
切换显示货币	`codeburn currency CNY`
HUD 初始化	会话内 `/claude-hud:setup`
HUD 按需配置	会话内 `/claude-hud:configure`
临时关闭 HUD	`CLAUDE_HUD_DISABLE=1 claude`

六、相关文件位置

项目	路径 / 命令
cc-switch 配置存储	`~/.cc-switch/cc-switch.db`（SQLite）
用户级 Claude 设置	`~/.claude/settings.json`
claude-hud 配置	`~/.claude/plugins/claude-hud/config.json`
会话记录目录	`~/.claude/projects/`（按项目目录隔离，codeburn 默认从这里读 Claude Code 会话）
环境变量注入	`ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL`
codeburn 全局安装	`npm install -g codeburn`
codeburn 项目主页	getagentseal/codeburn

七、结语

把 cc-switch（模型切换）+ codeburn（成本洞察）+ claude-hud（状态栏） 组合起来：

切：cc-switch use 一键在官网 / 火山 / DeepSeek 之间切换，cc-switch sessions resume 无缝接着上次会话；
算：codeburn web 打开仪表盘，按任务 / 工具 / 模型 / 项目看清 token 花在哪，多 provider 一张总账；
看：模型、上下文、git 分支、工具/Agent/待办一目了然，心里有底。

这套组合最大的价值，是把 Claude Code 从"黑盒终端"变成"仪表盘化的工作台"--尤其适合日常在多模型、多项目之间来回切换、需要严控成本的开发者。