用途：管理 Claude Code 会话的 token 预算，按模型选择有效上下文窗口并计算价格。会话真实模型由预算 hook 从 transcript 读取，config.model 仅作回退。Sonnet 4.6 及以上为 1M，Haiku 4.5 为 200K。
主要能力与用法： status（或无参数）：读取 ~/.claude-context-optimizer/config.json 与 budget-config.json，显示当前预算与自动压缩设置；无配置时显示默认值（1M 窗口上 200K 工作预算、opus-5.5 回退模型、50/70/85/95% 警告）。 set <tokens>：更新预算上限，支持 200K、1M、500000 等写法，写入 config.json（需用户批准），字段含 budgetTokens、warnAt、autoCompactAt、model；若超出所选模型上下文窗口会警告。 model <name>：设置用于成本估算的回退模型，支持 haiku-4.5、sonnet-4.6、sonnet-5、sonnet-5.5、opus-4.7/4.8、opus-5、opus-5.5（默认）、fable-5、fable-5.1 等键；切换到 1M 模型且当前预算低于 500K 时会询问是否提升到 1M。 auto <on|off>：切换阈值自动压缩（80%/90%），写入 budget-config.json 的 autoCompactEnabled；文件缺失时默认 autoCompactEnabled 为 true、autoCompactThreshold 为 80、criticalThreshold 为 90。
成本计算：预算监控分别估算输入与输出 token，并使用模型真实输入/输出价格。有效预算倍数：预算使用达 50% 以上时，显示 CCO 对有效预算的放大倍数，例如 Read Cache 与文件摘要节省冗余读取后，200K 上下文可表现为约 320K。
限制：具体安装方式、依赖与平台支持资料暂未提供；价格与模型信息以资料所列为准。