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