---
title: "Claude Agent SDK 5h 额度计量 bug"
author: "陈成"
author_url: "https://research.sorrycc.dev/@sorrycc"
question: "为什么 Agent SDK / claude -p 消耗 Claude 订阅 5 小时额度比 TUI 快 1.7–2.9 倍，怎么绕过？"
url: "https://research.sorrycc.dev/@sorrycc/claude-sdk-5h-metering"
emoji: "⏳"
published: 2026-10-28T01:31:26Z
updated: 2026-10-28T01:31:25Z
version: 3
cite: "https://research.sorrycc.dev/@sorrycc/claude-sdk-5h-metering.bib"
---

# Claude Agent SDK / `claude -p` 消耗 5h 额度约快 1.7–2.9 倍

By [陈成](https://research.sorrycc.dev/@sorrycc) · Published October 28, 2026

> 为什么 Agent SDK / claude -p 消耗 Claude 订阅 5 小时额度比 TUI 快 1.7–2.9 倍，怎么绕过？

> 起点：[@orca_build 的推文](https://x.com/orca_build/status/2114842810939772994)（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](https://github.com/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](https://github.com/stablyai/orca/issues/34297)，建议用户在上游修复前改用 TUI。

### 评论区要点

| 观点 | 代表评论 |
|---|---|
| 给出绕过方案：改 `CLAUDE_CODE_ENTRYPOINT` | [@TomQ296214](https://x.com/TomQ296214/status/2114867887576150467)，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](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`*

由 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](https://github.com/kler/claude-usage-ab) | 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-header` system block 里的 `cc_entrypoint=sdk-cli` vs `cli`
- User-Agent
- `redact-thinking-2026-02-12` beta 只有交互客户端会发

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

kler 从代码层面补充：

- TS Agent SDK（`@anthropic-ai/claude-agent-sdk` 0.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`

```mermaid
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 额度](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 万浏览）。
2. **有意为之**：Reddit 上不少人认为“不是 bug，是故意的”。oviano 在 issue 里提到 Anthropic 6 月曾宣布、后来撤回一项与 SDK 订阅用量相关的调整，担心这是“第一步”。@RumNCodeDev 也持类似看法。

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

## 4. 绕过方案

```bash
# 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](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。

### yetone/magpie：尚未修复（截至 v0.1.1788，2026-10-28）

[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`。

- **代码现状**：`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](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%，没有复现。
- **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 无关。
- **10-27 的新进展**：有人在 #606 里贴出 #97074 的 workaround，请 yetone 评估 `CLAUDE_CODE_ENTRYPOINT`，目前还没有回复。同一天又有人开了 [#3908](https://github.com/yetone/magpie/issues/3908)，请求允许给内层子进程注入环境变量，比如 `CLAUDE_CODE_ENTRYPOINT=magpie`。这个 issue 状态 open，没有评论。
- **结论**：magpie 用户目前**无法自行绕过**，只能等 #3908 落地，或者暂时让 Claude Code 选它自己的模型（不经 magpie 网关，直接用 Claude Code 自己的登录，标签是 `cli`）。这里有一处有意思的张力：magpie 删掉这个变量本来是为了“看起来像 Claude Code 自己”，结果恰好让它落进了被加权的 `sdk-cli` 标签。

## 5. 对我们的实际影响

- **Qoder / 任何自研 Claude 前端**：只要底层走 `claude -p` stream-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 原推](https://x.com/orca_build/status/2114842810939772994)（本文起点）
- [@claudeai 5 月：5h 限额翻倍](https://x.com/claudeai/status/2052060693269008586)：背景，5h 额度此前多次调整
- [@SataEricUX：“20x”只作用于 5h 窗口，周额度仅约 2x](https://x.com/SataEricUX/status/2094121392229028236)：理解 5h 与周额度的关系
- [@AaronYiaazw：claude-pro-pool，把子 Agent 派到其他 Pro 账号](https://x.com/AaronYiaazw/status/2112141459419734440)：另一种对付 5h 墙的办法
- [@birjuvachhani：Moxie，撞 5h 墙后一键切账号](https://x.com/birjuvachhani/status/2105470252964544749)
- [@nic0203：多开 Pro 还是升 Max](https://x.com/nic0203/status/2113050199438590381)
- [@zqkrq：ADE & multiplexer tier list v2](https://x.com/zqkrq/status/2111296531470889444)：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

**Reddit**

- 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/
