Claude Agent SDK / claude -p 消耗 5h 额度约快 1.7–2.9 倍
By 陈成 · Published October 28, 2026
为什么 Agent SDK / claude -p 消耗 Claude 订阅 5 小时额度比 TUI 快 1.7–2.9 倍,怎么绕过?
起点:@orca_build 的推文(2026-10-27,3.9 万浏览) 整理日期:2026-10-28
TL;DR
- 现象:同样的 token、同一个模型,走 Agent SDK 或
claude -p(headless)时,Claude 订阅 5 小时窗口的消耗速度是交互式 TUI、VS Code 插件、Desktop 的 约 1.7–2.9 倍。多名用户各自做了对照 A/B,结论一致。 - 根因(社区推断):计量按请求里的
cc_entrypoint标签加权,和 headless 本身无关。sdk-cli、sdk-ts、sdk-py这几个标签走更贵的系数;cli、claude-vscode、claude-desktop和任意自定义标签都按正常速率计。 - 周额度:多数测量(Theo、elmariodev 等)显示基本不受影响,只是 5h 墙来得更早。也有个别人认为周额度同样变快,没有定论。
- 临时绕过:给 Claude 进程设
CLAUDE_CODE_ENTRYPOINT=<你自己工具的名字>,实测消耗回到 TUI 水平。不要冒用cli、claude-vscode这类官方标签。 - 官方态度:issue 开了一个多月(2026-09-25 至今),52 条评论、97 个 reaction,Anthropic 至今没有在 issue 里正式回应,没给 assignee,也没说这是 bug 还是有意为之。
1. 原推文说了什么
Orca(开源 agent 编排桌面端,stablyai/orca)发推提醒:
Anthropic has a metering bug where Agent SDK chat UIs burn your Claude Code 5h limit ~1.7x faster than the TUI. … right-click → move your live session into the Claude Code TUI, full context.
意思是 Orca 同时支持 Chat UI(基于 Agent SDK)和真正的 Claude Code TUI,可以右键把正在进行的会话连同完整上下文迁移到 TUI,额度紧张时用 TUI,想要漂亮界面时用 Chat UI。Orca 官方也开了 issue #34297,建议用户在上游修复前改用 TUI。
评论区要点
| 观点 | 代表评论 |
|---|---|
给出绕过方案:改 CLAUDE_CODE_ENTRYPOINT |
@TomQ296214,Orca 官方回 💡👍 |
| 长任务本来就放 TUI 跑 | @loneherd、@xerysee、@iJimmyChan |
| 质疑这是“bug”还是早就计划好的 | @RumNCodeDev:“他们很早就宣布过要这么做,也许不是 bug” |
| 这是计费问题,不是体验问题 | @a1254766624:“that's an invoice bug wearing a ui skin” |
| 周额度会不会也被多扣? | @Foxfire1st(没有人给出确定答案) |
| Orca 驱动 TUI 会不会被封号 | @niicholas1、@vfonic 提问;Orca 回复“safe,不违反 ToS”(只是 Orca 自己的说法) |
| 其他 SDK 套壳也中招 | @codermatt 怀疑 AmpCode,@uaaxn 问 capy |
| 用 Opus 5.5 做总调度消耗很快 | @lnlng262721(中文) |
2. 关键证据:GitHub issue #97074
anthropics/claude-code#97074 —— Headless claude -p (entrypoint sdk-cli) uses ~1.8× more of the 5-hour window per token than interactive cli
由 qvarker 于 2026-09-25 提交,标签 bug、area:cost、has repro,状态 open。
各方独立测量汇总
| 测量者 | 平台 / 套餐 | 对比 | 倍率 |
|---|---|---|---|
| qvarker(原帖) | Linux / Max, Opus 5 | sdk-cli vs cli |
~1.8× |
| qvarker(抓包代理复测) | 同上 | 同上 | 0.69 vs 1.59 $/1%,约 2.3× |
| Z3l20 | Linux / Pro, Opus 5.5 low | sdk-cli vs cli |
~2.0× |
| futin(被动数据) | Mac | sdk-cli vs claude-desktop |
1.3–1.5× |
| kler | Team, Opus 5.5 high | sdk-ts/sdk-cli vs claude-vscode |
2.8–3.0× |
| elmariodev | Linux / Max 5x, 两轮相隔 4 周 | sdk-ts/sdk-cli vs cli/claude-desktop |
~2.4×(版本 2.1.280→2.1.307 未变) |
| t3dotgg(Theo) | Max | SDK / -p vs TUI |
1.6–1.7×,周额度不变 |
| erikmackinnon | Team, 专用账号, 70 个会话 | sdk-cli vs cli |
1.86×(90% 区间 1.51–2.31) |
| frostfire575 | Win11, Opus 5.5 | sdk-cli / 自定义标签 / TUI |
1.7× / 0.8× / 1.0× |
| oviano | macOS | sdk-cli vs 自定义标签 |
~2.4× |
| jv2222 | macOS, Max 20x | 无缓存时 ~2.4×;真实负载(大量 cache read)下没有可测差异 | 有分歧 |
已经排除的因素
原帖和后续测量依次排除了:
- auto-mode 分类器(全程
--dangerously-skip-permissions,基本没有工具调用) - headless 的 harness 更大(实际上 headless 首个请求更小,约 66K vs 88K)
- transcript 漏记、重试、429/529(抓包代理确认没有隐藏请求)
- prompt cache TTL / cache 失效(
DISABLE_PROMPT_CACHING=1下差距依旧,Reddit 上 97–98% cache read 的数据也一样) - subagent、其他机器的用量
抓包发现的唯一差异
qvarker 用 ANTHROPIC_BASE_URL 指向本地日志代理后发现,两种模式发出的请求只有这几处不同:
x-anthropic-billing-headersystem block 里的cc_entrypoint=sdk-clivscli- User-Agent
redact-thinking-2026-02-12beta 只有交互客户端会发
模型、effort、thinking、context_management 和其他 beta 完全相同。headless 的 token 更少,窗口反而用得更多。
kler 从代码层面补充:
- TS Agent SDK(
@anthropic-ai/claude-agent-sdk0.3.276)在没有设置时会自动写CLAUDE_CODE_ENTRYPOINT="sdk-ts" - VS Code 插件同样是 headless stream-json 会话,只是自己设了
claude-vscode,因此“headless vs 交互”解释不了这个差距 - CLI 内部把
sdk-ts、sdk-cli、sdk-py映射为同一类claude_code_sdk,claude-vscode映射为claude_code_vscode
flowchart LR
subgraph 客户端
TUI["claude (TUI)"]
VSC[VS Code 插件]
DESK[Claude Desktop]
P["claude -p"]
SDK["Agent SDK 应用<br/>T3 Code / Orca Chat / Paseo…"]
CUSTOM["claude -p<br/>+ CLAUDE_CODE_ENTRYPOINT=my-tool"]
end
TUI -->|cc_entrypoint=cli| N[正常系数 ~1×]
VSC -->|claude-vscode| N
DESK -->|claude-desktop| N
CUSTOM -->|my-tool| N
P -->|sdk-cli| H["claude_code_sdk 类<br/>5h 窗口 ~1.7–2.9×"]
SDK -->|sdk-ts / sdk-py| H
N --> W5[5h 窗口]
H --> W5
N --> WK[周额度]
H -.->|多数测量:不受影响| WK
3. 为什么会这样:两种猜测
- Theo 的猜测(他说自己“95% 确定”):Anthropic 在 2026-09-23 宣布提高 5h 额度,但这次提升没有应用到 Agent SDK 流量。issue 恰好在几天后(09-25)出现,历史数据也显示 09-23 前后
sdk-cli的 $/1% 明显下降。参见 Theo 的推文(24.5 万浏览)。 - 有意为之:Reddit 上不少人认为“不是 bug,是故意的”。oviano 在 issue 里提到 Anthropic 6 月曾宣布、后来撤回一项与 SDK 订阅用量相关的调整,担心这是“第一步”。@RumNCodeDev 也持类似看法。
两种说法都没有官方证实。Theo 说已经直接向 Anthropic 报告。
4. 绕过方案
# headless / 自研前端:给 Claude 进程打上你自己工具的标签
CLAUDE_CODE_ENTRYPOINT=my-tool claude -p ...
注意事项(来自 frostfire575、qvarker、Z3l20):
- 要覆盖,而不是“没设置才设”。从另一个 Claude Code / SDK 会话里启动的进程会继承
sdk-cli或sdk-ts。 - tmux 坑:如果 tmux server 是在某个 Claude 会话里首次启动的,它的全局环境会带上
CLAUDE_CODE_ENTRYPOINT,之后在里面开的 TUI 也会记成sdk-cli。解决办法是在exec claude前unset CLAUDE_CODE_ENTRYPOINT。 - 验证:看
~/.claude/projects/.../<session>.jsonl里的entrypoint字段,或看~/.claude/sessions/<pid>.json。 - 不要用
cli或claude-vscode,这是冒用其他客户端的身份。 - 如果你的代码用
entrypoint == "sdk-cli"判断是否为 headless 会话,改标签后会失效,应改为匹配entrypoint == "cli"来识别交互会话。 - 这只是绕过,不是修复。Anthropic 随时可能调整,而且官方没说这么做是否合规。
已跟进的项目
t3code#25597(设为 t3-code,仍未合并)、Paseo 0.14 beta(PR #7976)、caxri、claude-agents-dashboard、octant 等。Peteralm 还给 opencodex、claudecodeui、goose、claude-mem、paperclip、openclaw 批量提了同类 PR。
yetone/magpie:尚未修复(截至 v0.1.1788,2026-10-28)
magpie(2.3 万 ⭐,菜单栏多 Agent / 多模型网关)用 Claude 订阅时,会启动真正的 Claude Code 二进制,以 claude -p --input-format stream-json 驱动。yetone 解释这样做是为了让请求被识别为 Claude Code 自己的流量,而不是第三方流量,避免被转进 Extra Usage。所以这条路径的标签正是 sdk-cli。
- 代码现状:
internal/gateway/claude_subscription.go的cleanClaudeEnv()会把CLAUDE_CODE_ENTRYPOINT列进黑名单直接删掉(internal/provider/claude_signin.go的登录流程同样会删)。这意味着在启动 magpie 的 shell 里 export 这个变量也没用,内层claude -p仍是sdk-cli。最新 release v0.1.1788 里这行没变,magpie 也没有任何提交或 PR 涉及 entrypoint 改标签。 - #606(2026-10-02,open):《Claude 订阅经 Magpie 使用时 5h 额度消耗疑似过快,可能与 claude -p 有关》。用户实测一个 5h 窗口只对应约 $11.56–17 API 等值,换成交互 TUI 或 CPA 约 $30–35,即约 2 倍,与 #97074 吻合。也有反例:isjiajia01 统计约 70 个窗口,
-p路径为 $25–35/100%,没有复现。 - yetone 的立场:Anthropic 没公开说过 headless 有不同权重,所以不做 PTY/交互后端。Guuuu233 提的 tmux 驱动 TUI 后端 #707 被拒,理由是“让自动请求看起来像人在操作”有封号风险。Guuuu233 随后把它做成了独立插件 claude-tui-boost(非官方,有同样的风险)。yetone 另外修了一处确定会多耗额度的问题:后台 Sonnet 请求被误改成 Opus,导致大量 1h cache write(#2187,429698f96)。这和 entrypoint 无关。
- 10-27 的新进展:有人在 #606 里贴出 #97074 的 workaround,请 yetone 评估
CLAUDE_CODE_ENTRYPOINT,目前还没有回复。同一天又有人开了 #3908,请求允许给内层子进程注入环境变量,比如CLAUDE_CODE_ENTRYPOINT=magpie。这个 issue 状态 open,没有评论。 - 结论:magpie 用户目前无法自行绕过,只能等 #3908 落地,或者暂时让 Claude Code 选它自己的模型(不经 magpie 网关,直接用 Claude Code 自己的登录,标签是
cli)。这里有一处有意思的张力:magpie 删掉这个变量本来是为了“看起来像 Claude Code 自己”,结果恰好让它落进了被加权的sdk-cli标签。
5. 对我们的实际影响
- Qoder / 任何自研 Claude 前端:只要底层走
claude -pstream-json 或 Agent SDK,用户的 5h 窗口就会更快耗尽,用户很可能误以为是产品自己“费 token”。 - 长任务和批量任务:在官方修复前,优先用交互 TUI,或者打自定义 entrypoint 标签。
- jv2222 的反例值得注意:在大量 cache read、带工具调用的真实负载下,他没测出差异。系数可能主要作用在某些 token 类型(未缓存 input、cache write)上,自己的负载最好实测一次再下结论。
- 测量方法:读
/api/oauth/usage,或在claude -p的 stream-json 里读rate_limit_event.rate_limit_info.unifiedWindows.five_hour.utilization。读数要等约 2 分钟(meter 有延迟),并且只用一个专用账号。
6. 你的书签里相关的条目
在 x.com/i/history 的书签中搜索到:
- Orca 原推(本文起点)
- @claudeai 5 月:5h 限额翻倍:背景,5h 额度此前多次调整
- @SataEricUX:“20x”只作用于 5h 窗口,周额度仅约 2x:理解 5h 与周额度的关系
- @AaronYiaazw:claude-pro-pool,把子 Agent 派到其他 Pro 账号:另一种对付 5h 墙的办法
- @birjuvachhani:Moxie,撞 5h 墙后一键切账号
- @nic0203:多开 Pro 还是升 Max
- @zqkrq:ADE & multiplexer tier list v2:T3 Code、Orca 等工具横评
参考链接
X
- Orca 原推:https://x.com/orca_build/status/2114842810939772994
- Theo 确认 bug:https://x.com/theo/status/2114166439813017873
- Claude 9-23 提升 5h 额度:https://x.com/claudeai/status/2102435538120691886
- Frostfire 绕过方案实测:https://x.com/frosty575/status/2114812168709497221
- Tom Q 回复(workaround):https://x.com/TomQ296214/status/2114867887576150467
- Kerwin 中文总结:https://x.com/Kerw1n1209/status/2114972394335109542
- tom_knock 中文总结:https://x.com/tom_knockk/status/2114296493947715942
- imnakul 的 X 线程:https://x.com/NAKUL71632061/status/2108039056621965592
GitHub
- 主 issue:https://github.com/anthropics/claude-code/issues/97074
- Orca issue:https://github.com/stablyai/orca/issues/34297
- T3 Code 跟踪 issue:https://github.com/pingdotgg/t3code/issues/24649
- T3 Code 修复 PR:https://github.com/pingdotgg/t3code/pull/25597
- Paseo 修复 PR:https://github.com/getpaseo/paseo/pull/7976
- kler 的 A/B 测试工具与数据:https://github.com/kler/claude-usage-ab
- futin/claude-agents-dashboard:https://github.com/futin/claude-agents-dashboard
- magpie 额度过快 issue:https://github.com/yetone/magpie/issues/606
- magpie 子进程环境变量请求:https://github.com/yetone/magpie/issues/3908
- magpie 被拒的交互后端 PR:https://github.com/yetone/magpie/pull/707
- magpie 删除 entrypoint 的代码:https://github.com/yetone/magpie/blob/main/internal/gateway/claude_subscription.go#L2069-L2075
- claude-tui-boost 插件:https://github.com/Guuuu233/claude-tui-boost
- r/ClaudeCode:Agent-SDK burns 1.7x faster than Claude Code TUI:https://www.reddit.com/r/ClaudeCode/comments/1xet6u2/
- r/ClaudeAI:Measured it: headless eats ~3x more of the 5-hour limit(2026-09-28,比 GitHub issue 更早的独立测量):https://www.reddit.com/r/ClaudeAI/comments/1wsijnv/
- r/ClaudeAI:100% of my 5-hour limit equals 14% of my weekly limit:https://www.reddit.com/r/ClaudeAI/comments/1x7w46m/
- r/ClaudeCode:Am I crazy or is Anthropic dynamically adjusting the limits?:https://www.reddit.com/r/ClaudeCode/comments/1xffwx1/