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

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)下没有可测差异 有分歧

已经排除的因素

原帖和后续测量依次排除了:

抓包发现的唯一差异

qvarker 用 ANTHROPIC_BASE_URL 指向本地日志代理后发现,两种模式发出的请求只有这几处不同:

模型、effort、thinking、context_management 和其他 beta 完全相同。headless 的 token 更少,窗口反而用得更多。

kler 从代码层面补充:

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. 为什么会这样:两种猜测

  1. Theo 的猜测(他说自己“95% 确定”):Anthropic 在 2026-09-23 宣布提高 5h 额度,但这次提升没有应用到 Agent SDK 流量。issue 恰好在几天后(09-25)出现,历史数据也显示 09-23 前后 sdk-cli 的 $/1% 明显下降。参见 Theo 的推文(24.5 万浏览)。
  2. 有意为之:Reddit 上不少人认为“不是 bug,是故意的”。oviano 在 issue 里提到 Anthropic 6 月曾宣布、后来撤回一项与 SDK 订阅用量相关的调整,担心这是“第一步”。@RumNCodeDev 也持类似看法。

两种说法都没有官方证实。Theo 说已经直接向 Anthropic 报告。

4. 绕过方案

# headless / 自研前端:给 Claude 进程打上你自己工具的标签
CLAUDE_CODE_ENTRYPOINT=my-tool claude -p ...

注意事项(来自 frostfire575、qvarker、Z3l20):

已跟进的项目

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。

5. 对我们的实际影响

6. 你的书签里相关的条目

在 x.com/i/history 的书签中搜索到:

参考链接

X

GitHub

Reddit

Read this report as Markdown · Cite it (BibTeX)