Headroom + DeepSeek api + Claude Code 配置指南
Claude Code 调用 DeepSeek 模型，Headroom 上下文压缩

🔧 准备工作

1. 安装 Claude Code

npm install -g @anthropic-ai/claude-code

2. 安装 Headroom（完整版）

pip install "headroom-ai[all]"

要求 Python ≥ 3.10。

3. 获取 DeepSeek API Key
   访问 DeepSeek 平台 → 注册/登录

进入 API Keys → 创建新密钥，复制保存（格式 sk-…）

⚠️ 请勿将密钥公开分享，泄露后立即在后台删除重建。

🚀 一键启动脚本
在电脑桌面新建两个文本文件，分别保存为 .bat 格式（Windows）。

📡 脚本 1：Headroom_Proxy.bat

@echo off
title Headroom Proxy (DeepSeek)
set ANTHROPIC_TARGET_API_URL=https://api.deepseek.com/anthropic
set ANTHROPIC_API_KEY=这里填你的DeepSeek_API_Key
echo Starting Headroom proxy on port 8787...
headroom proxy --port 8787
pause

🤖 脚本 2：Claude_Code.bat

@echo off
title Claude Code (via Headroom)
set ANTHROPIC_BASE_URL=http://127.0.0.1:8787
set ANTHROPIC_API_KEY=这里填你的DeepSeek_API_Key
set ANTHROPIC_AUTH_TOKEN=
echo Launching Claude Code...
claude --model deepseek-v4-pro
pause

📖 使用方法
步骤 操作
1️⃣ 双击 Headroom_Proxy.bat，保持黑色窗口运行
2️⃣ 双击 Claude_Code.bat，等待 Claude Code 界面出现
3️⃣ 正常提问，所有请求将经过 Headroom 压缩后发往 DeepSeek
4️⃣ 用完先关 Claude 窗口，再按 Ctrl+C 关闭代理

验证：
浏览器打开 http://localhost:8787/stats，查看 api_requests 是否增加

❓ 常见问题
现象 解决方法
403 Forbidden API Key 无效或过期 → 重新生成并替换脚本中的密钥
显示 Opus 模型并要求登录 代理未指向 DeepSeek → 检查 ANTHROPIC_TARGET_API_URL 是否设置正确
端口 8787 被占用 关闭占用进程，或修改两个脚本中的端口号（需保持一致）
‘headroom’ 不是内部命令 未安装或 Python Scripts 目录不在 PATH → 使用绝对路径或重新安装

⚠️ 特别提醒：如果你之前使用过 CC Switch 或其他工具配置过 Claude Code 的环境变量，请务必先清理残留配置！

CC Switch 会修改 %USERPROFILE%.claude\settings.json 文件，其中 env 字段中的 ANTHROPIC_BASE_URL 等变量会覆盖 Headroom 代理的设置，导致请求绕过 Headroom 直接发给 DeepSeek（无法使用压缩功能）。

解决方法（二选一）：

临时禁用：重命名配置文件（可随时恢复）

rename "%USERPROFILE%\.claude\settings.json" settings.json.bak

手动编辑：用记事本打开 %USERPROFILE%.claude\settings.json，删除或清空 “env”: { … } 部分（保留其他插件配置）。

完成清理后，再按本文的脚本启动 Headroom 和 Claude Code 即可正常使用代理。如需恢复 CC Switch 配置，将备份文件改回原名即可。