mcpField
C
cco-budget

cco-budget

github.com/egorfedorovAgent 工作流125208 次安装1 天前更新
代码仓库

关于 cco-budget

cco-budget 是面向 Claude Code 会话的模型感知型 Token 预算管理技能。它可查看和调整预算上限、备用模型设置及自动压缩阈值，并分别估算输入与输出成本。

主要功能

  1. 01查看预算和自动压缩设置
  2. 02设置 Token 预算上限
  3. 03配置成本估算用的备用模型
  4. 04启用或关闭自动压缩
  5. 05分别估算输入与输出成本

适用场景

  1. 01检查当前会话的预算配置
  2. 02调整会话的 Token 上限
  3. 03设置成本估算的备用模型
  4. 04启用或关闭自动压缩

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-budget

安装后在 Claude Code 中输入/cco-budget确认已加载。

详细介绍

上下文预算管理器

管理 Claude Code 会话的 token 预算。支持感知模型，会根据模型选择合适的有效上下文窗口和价格。预算钩子会从转录记录中读取会话的真实模型；config.model 仅用作回退值。Sonnet 4.6 及以上版本均为 1M；Haiku 4.5 为 200K。

解析 $ARGUMENTS：

status（或不带参数）

显示当前预算配置和自动压缩设置：读取 ~/.claude-context-optimizer/config.json 和 ~/.claude-context-optimizer/budget-config.json（文件可能不存在）。 如果没有配置，显示默认值（在 1M 窗口上使用 200K 工作预算，回退模型为 opus-5.5，在 50%/70%/85%/95% 时发出警告）。

set <tokens>

更新预算上限。解析 token 数量（200K、1M、500000 均可）。 更新 ~/.claude-context-optimizer/config.json（用户会批准此次写入）：

{
  "budgetTokens": <parsed_number>,
  "warnAt": [50, 70, 85, 95],
  "autoCompactAt": 90,
  "model": "opus-5.5"
}

如果 budgetTokens 超过所选模型的上下文窗口，则向用户发出警告。

model <name>

设置用于成本估算的回退模型（仅当会话的转录记录尚无模型 ID 时使用）。支持的键：

  • haiku-4.5（别名 haiku）——每百万 token 输入/输出 $1/$5，200K
  • sonnet-4.6（别名 sonnet）——每百万 token 输入/输出 $3/$15，1M
  • sonnet-5——每百万 token 输入/输出 $2/$10，1M
  • sonnet-5.5——每百万 token 输入/输出 $2/$10，1M
  • opus-4.7 / opus-4.8——每百万 token 输入/输出 $5/$25，1M
  • opus-5（别名 opus）——每百万 token 输入/输出 $5/$25，1M
  • opus-5.5（默认值）——每百万 token 输入/输出 $4/$20，1M，缓存读取价格为 0.05×
  • fable-5——每百万 token 输入/输出 $10/$50，1M
  • fable-5.1（别名 fable）——每百万 token 输入/输出 $10/$50，1M，缓存读取价格为 0.025×（其他模型为 0.1×）

opus-4.8-1m / opus-4.7-1m / opus-extended 仅为向后兼容别名——没有 1M 附加费；1M 窗口按标准价格 $5/$25 提供。

更新 config.json 中的 model 字段。切换到 1M 上下文模型时，如果当前 budgetTokens 低于 500K，则询问用户是否要将其提高到 1M。

auto <on|off>

切换是否在阈值（80% / 90%）触发自动压缩。更新 ~/.claude-context-optimizer/budget-config.json：

  • auto on → autoCompactEnabled: true
  • auto off → autoCompactEnabled: false

文件缺失时的默认值：

{
  "autoCompactEnabled": true,
  "autoCompactThreshold": 80,
  "criticalThreshold": 90
}

成本计算

预算监控器现在会分别估算输入 + 输出 token，并采用模型实际的输入/输出价格。例如，Edit 中含有 200 个字符的 new_string 大约计为 54 个输出 token，并按模型的输出价格计费。

有效预算倍数

当预算使用率达到 50% 及以上时，监控器会显示 CCO 将有效预算提高了多少倍——例如，如果读取缓存 + 文件摘要减少了足够多的重复读取，使你的 200K 上下文发挥出约 320K 的效果，就会显示“有效性提高了 1.6 倍”。

评论

支持 Markdown