【windows】cc + cc switch + headroom
背景headroom 能极大程度的压缩上下文节省token的消耗。本文在已有claude code cc switch ds 的情况下使用headroom进行中转。前提根据网上教程下载并安装好 ccswitch 和 headroom过程1. 确认是否正确安装headroomheadroom--version2. cc switch 开启本地路由服务地址默认http://127.0.0.1:157213. 编写headroom 启动脚本新建headroom-start.ps1写入如下内容$env:ANTHROPIC_TARGET_API_URLhttp://127.0.0.1:15721$env:HEADROOM_HOST127.0.0.1if(-not$env:HEADROOM_OUTPUT_SHAPER){$env:HEADROOM_OUTPUT_SHAPER0}$env:HEADROOM_SKIP_UPSTREAM_CHECK1# 启动headroomheadroom proxy--port8787--host127.0.0.14. 将headroom启动脚本设置为开机自启动【图形化配置方法】按下 Win S 搜索「任务计划程序」并打开点击右侧 创建任务不要选「创建基本任务」功能不全。常规 选项卡名称HeadroomProxy 开机自启自定义可识别名称勾选 只在用户登录时运行本地日常使用选这个最稳妥勾选 使用最高权限运行避免端口绑定权限不足配置为Windows 10 / Windows 11触发器 选项卡 → 点击「新建」开始任务登录时默认选中「特定用户」即当前登录用户无需修改高级设置建议勾选 延迟任务时间30 秒给系统网络、上游代理服务留启动时间避免 headroom 因上游未就绪而启动失败点击确定。操作 选项卡 → 点击「新建」操作启动程序程序或脚本powershell.exe添加参数必填把路径替换为你脚本的真实绝对路径-WindowStyleHidden-ExecutionPolicyBypass-NoProfile-FileC:\Users\你的用户名\headroom-start.ps1参数说明-WindowStyle Hidden隐藏命令行窗口后台静默运行-ExecutionPolicy Bypass临时绕过系统执行策略限制避免脚本被默认安全规则禁止运行-NoProfile不加载用户配置文件启动更快且避免环境干扰-File 后必须跟绝对路径不能用 ~ 或相对路径起始于可选但建议填脚本所在文件夹路径例如 C:\Users\你的用户名\避免脚本内相对路径执行异常。5. 条件 选项卡取消勾选「只有计算机使用交流电源时才启动此任务」笔记本用户必改否则断电状态不启动取消勾选「唤醒计算机运行此任务」6. 设置 选项卡勾选「允许按需运行任务」勾选「如果任务失败按以下频率重新启动」间隔 1 分钟尝试 3 次取消勾选「如果任务运行时间超过以下时间停止任务」headroom 是常驻后台服务不能被系统自动终止点击确定保存。配置完成后右键任务 → 「运行」先手动测试一次再用 curl.exe --noproxy “*” http://127.0.0.1:8787/livez 验证服务是否正常启动。5. 修改cc的base url找到.claude\setttings.json将ANTHROPIC_BASE_URL的值修改为 http://127.0.0.1:8787这个是headroom的监听接口我们希望的链路是 cc - headroom (完成compression) - cc switch - ds6. 验证headroom是否正常工作新建request.json写入以下内容:{model:deepseek-v4-pro[1m],max_tokens:16,messages:[{role:user,content:say ok}]}在powershell中输入curl.exe--noproxy*-s-XPOST http://127.0.0.1:8787/v1/messages-Hx-api-key: PROXY_MANAGED-Hanthropic-version: 2023-06-01-Hcontent-type: application/json-drequest.json若有返回则正常工作可以自行观察缓存命中率token消耗debug等对比使用前后效果