Claude Fable 5 由 OneHop 提供
← 全部文章
Ecosystem

Claude Agent SDK 额度：6 月 15 日后，claude -p、GitHub Actions 和第三方 Agent 工具会发生什么变化

2026年6月15日 5 分钟阅读

A cream-background editorial illustration of a developer workflow split into two lanes: interactive Claude Code on one s

2026 年 6 月 15 日，Anthropic 改写了无界面 Claude 的经济账。claude -p、Claude Agent SDK 调用、Claude Code GitHub Actions，以及基于 Agent SDK 构建的第三方应用，不再消耗普通 Claude 订阅限制，而是改为消耗单独的每月 Agent SDK 额度（Anthropic Help Center）。

这听起来像一条账单脚注。不是。如果你有 cron 任务、CI 评审、本地脚本、Zed 风格的 agent 集成，或者套在 claude -p 外面的 CLI 包装器，这就是“套餐里包含”变成“按美元额度计量”的分界线。

我的看法：这个产品边界是对的，但 Anthropic 的推出方式会让太多开发者通过崩掉的心智模型和 Reddit 帖子才发现它。交互式编码和自动化 agents 是不同负载。它们不该共用同一个配额。但如果你的团队已经悄悄围绕订阅认证的 Claude Code 搭了自动化，6 月 15 日是迁移截止日，不是价格公告。

一张前后对比流程图，展示 6 月 15 日前交互式 Claude Code、claude -p、Agent SDK 和 GitHu 的使用方式

到底哪些会迁到新额度

Anthropic 的帮助文章把边界说得很明确。从 6 月 15 日开始，Claude 订阅计划中的 Agent SDK 和 claude -p 使用量，会消耗新的每月 Agent SDK 额度，和交互式使用限制分开计算（Anthropic Help Center）。Agent SDK 文档也在概览页顶部重复了同样的提醒（Claude Docs）。

新额度覆盖这些：

工作流是否计入 Agent SDK 额度？备注
claude -p "..."是Print 模式，非交互式
Python 或 TypeScript Claude Agent SDK是使用订阅计划的 Agent SDK 额度时
Claude Code GitHub Actions是Anthropic 表示这个集成基于 Agent SDK 构建
基于 Agent SDK 构建、并通过你的 Claude 订阅认证的第三方应用是工具集成的高风险区
终端或 IDE 里的交互式 Claude Code否仍使用普通订阅限制
Claude 网页、桌面端、移动端聊天否仍使用普通订阅限制
Claude Cowork否不属于这个额度
使用 Claude Platform API key 的 Agent SDK无变化继续按原来的即用即付方式计费

各计划的额度以美元计：

计划每月 Agent SDK 额度
Pro$20
Max 5x$100
Max 20x$200
Team Standard seats$20
Team Premium seats$100
Enterprise usage-based$20
Enterprise seat-based Premium seats$200

Anthropic 还说，额度按用户计算，不合并共享；会随账单周期刷新；未用完的额度不会结转；额度需要领取一次，之后会自动刷新（Anthropic Help Center）。

最后这一点对团队很关键。一个有 20 名符合条件工程师的 Team 账号，不会得到一个共享的自动化额度池。每个人都有自己的额度。如果某个共享 GitHub Action 以一个用户身份认证，那这个用户的额度就是瓶颈。

实际断点：claude -p 不再只是“CLI 使用”

最容易让人意外的命令是 claude -p。

Anthropic 的 CLI 参考把 --print / -p 描述为“Print response without interactive mode”，并提供了适合自动化的参数，比如 --output-format json、--output-format stream-json、--max-turns、--json-schema 和 --max-budget-usd（Claude Code CLI reference）。这让它成了脚本里的完美胶水：

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

6 月 15 日之后，在订阅认证账号上，这就是 Agent SDK 额度使用。它不是交互式 Claude Code 使用。不是普通聊天使用。也不是通往你套餐配额的免费侧门。

这就是为什么社区反应这么强烈。在当前一个 r/ClaudeCode 帖子里，开发者在问这个额度是不是按 token/模型计算，$200 实际能撑多久，是否必须 opt-in，prompt caching 怎么算，以及 GitHub Actions 是否包含在内（Reddit）。有个评论说“oh… I didn’t realise it was GH actions too”，这正是风险所在：大家把这个变化理解成 SDK 库的变化，而不是所有无界面的 Claude Code 工作流。

关于 token 的问题，答案实际上是肯定的：Anthropic 表示，如果启用了 usage credits，超出额度的使用会按标准 API 费率转入 usage credits。当前 Claude API 定价页列出，Fable 5 是每百万 token 输入 $10 / 输出 $50，Opus 4.8 是 $5 / $25，Sonnet 4.6 是 $3 / $15，Haiku 4.5 是 $1 / $5（Claude API pricing）。具体消耗取决于模型、轮次、工具使用、缓存读取、缓存写入，以及 agent 加载了多少仓库上下文。

不要把 $20 或 $200 换算成“小时”。这是错的单位。应该把你的真实任务换算成 token 和成本轨迹。

GitHub Actions：同样的 YAML，不同的预算

Claude Code GitHub Actions 明确在范围内。Anthropic 的 GitHub Actions 文档说，这个 action 构建在 Claude Agent SDK 之上，可以响应 @claude 提及、创建 PR、实现功能、修 bug，或运行自定义自动化（Claude Code GitHub Actions docs）。文档还提醒，每次 Claude 交互都会消耗 API tokens，并建议使用 --max-turns、超时和并发控制来管理成本。

现在，这些建议更重要了。

像这样的每日定时报表：

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

有两种可能的计费故事：

  1. 如果它使用 Claude Platform API key，Anthropic 说没有变化。它仍然是正常的即用即付 API 计费。
  2. 如果它使用订阅认证的 Agent SDK 额度，那它现在会先消耗按用户分配的 Agent SDK 额度，然后在启用时转向 usage credits。

action 设置文档仍然强调用 ANTHROPIC_API_KEY 进行直接 API 使用，也提供 Bedrock 和 Vertex AI 的云服务商选项（Claude Code GitHub Actions docs）。对生产 CI 来说，这比把仓库自动化绑到某个真人订阅上干净得多。Anthropic 在管理员指南里也说了同样的话：规模化的生产自动化应该使用带 API key 的 Claude Platform，以获得可预测的即用即付计费（Anthropic Help Center）。

我的建议：如果某个工作流能合并代码、评论 PR，或者按计划无人值守运行，就把它放到带明确预算的 API key 上。把订阅里的 Agent SDK 额度留给个人自动化、实验和本地工具。

一张 CI 架构草图，展示 GitHub issue 评论、pull requests 和定时工作流流入 Claude Code

第三方 Agent 工具：Zed 风格的问题

最容易混乱的是第三方工具。开发者在问：如果一个编辑器、本地 harness 或 coding assistant 通过 Agent SDK 集成，并让我用 Claude 订阅登录，它会使用新额度吗？

Anthropic 的帮助文章说，这个额度覆盖“通过 Agent SDK 使用你的 Claude 订阅进行认证的第三方应用”（Anthropic Help Center）。Agent SDK 概览也说，除非此前获批，Anthropic 通常不允许第三方开发者提供 claude.ai 登录或速率限制，并要求开发者改用 API-key 认证方式（Claude Docs）。

这给出了一条实用规则：

  • 如果工具使用你的 Claude Platform API key，这次变化不会给它一笔免费的每月额度。它仍然走 API 计费。
  • 如果工具是获批的订阅认证 Agent SDK 应用，它会消耗 Agent SDK 额度。
  • 如果工具试图通过 Claude Code 登录、OAuth tokens、隐藏 PTY 或订阅限制走 Anthropic 未批准的通道，就把它视为脆弱方案。

社区已经在围绕这种模糊地带构建东西了。一个 r/ClaudeCode 帖子描述了一个基于 hook 的“即插即用 -p 替代品”，它把工作留在交互式 Claude Code 里，并声称可以避开 SDK 额度（Reddit）。另一个 r/ClaudeAI 帖子介绍了 clarp，一个本地 CLI，会在底层启动交互式 Claude Code 来模拟 claude -p 输出（Reddit）。作者把它描述为本地兼容方案，而评论区立刻开始追问账号风险。

这才是真正的争议：这是合理地保留本地工作流，还是披着工具外衣绕过配额？我不会把公司基础设施建在这些包装器上。即使它们今天能用，它们也把一个 Anthropic 正在主动移除的计费假设写进了系统。

今天就该怎么审计自己的工作流

别等任务失败了再做。

先搜索 claude -p 和 Agent SDK 导入：

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

然后搜索 CI：

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

给每个命中分类：

类别示例推荐操作
个人一次性本地 claude -p helper保留，添加 --max-budget-usd 和日志
个人定时任务cron job、launchd、systemd timer迁到 API key，或强力限制
团队 CIPR review、issue triage使用 Claude Platform API key、仓库 secrets、并发控制
第三方编辑器/工具Agent SDK 集成确认认证模式和计费路径
包装器或绕路方案hidden PTY、hook loop、OAuth relay避免用于生产；检查政策风险

对 SDK 用户，把成本追踪接到结果流里。Anthropic 的成本追踪文档说，total_cost_usd 和 costUSD 是客户端估算，不是权威账单数据，但对开发期洞察很有用（Claude Docs）。同一页还说，SDK 会暴露每步 token 使用量、按模型使用量、缓存读取 tokens、缓存创建 tokens 和累计总量。

用这些建立消耗画像：

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

不要用客户端成本估算来给你自己的用户计费。Anthropic 明确说，权威计费应使用 Usage and Cost API 或 Claude Console（Claude Docs）。

还要加硬性停止条件。对 claude -p，使用 --max-turns 和 --max-budget-usd。对 GitHub Actions，使用 workflow timeouts、GitHub concurrency controls 和更窄的 prompts。对 SDK agents，限制工具。一个只读 reviewer 默认不该拥有 Bash、Edit 和 Write。

一张紧凑的审计清单图，包含五行：本地脚本、SDK imports、CI workflows、第三方工具和共享

Opt-In 和超额问题

最重要但尚未完全解决的运营问题是 opt-in。Anthropic 说，这个额度需要一次性 opt-in，通过你的 Claude 账号领取一次，之后自动刷新。对于 Team 和 Enterprise 管理员，符合条件的用户会在 2026 年 6 月 15 日前收到包含详情和说明的邮件（Anthropic Help Center）。

当前一个 r/Anthropic 帖子问出了显而易见的后续问题：如果你不 opt in，会发生什么？claude -p 会继续按普通订阅限制工作，暂停到你领取为止，还是失败后转入 usage credits？文章没有把这个 fallback 说清楚（Reddit）。

所以别围绕猜测的 fallback 做设计。如果你符合条件，就领取额度。如果你是管理员，告诉用户去哪里领取，以及哪些自动化允许使用它。如果你运行共享工作流，把它们迁到 API key。

对超额部分，Anthropic 说得更清楚。Agent SDK 使用会先消耗每月额度。之后，只有在启用 usage credits 时，使用量才会按标准 API 费率转入 usage credits。如果没有启用 usage credits，Agent SDK 请求会停止，直到额度刷新（Anthropic Help Center）。

从支出控制角度看，这是好事。但这也意味着你的自动化可能会 fail closed。要按这个现实来构建。CI 应该把“Agent SDK 额度耗尽”显示为账单/配置失败，而不是随机模型错误。本地脚本应该打印清晰消息并以非零状态退出。长时间运行的 agents 应该在每个昂贵轮次前 checkpoint 工作。

给开发者的结论

这次变化不是 claude -p 的死亡。它终结的是一种假装：无界面的 agent 循环和坐在 IDE 前的人类有同样的成本曲线。

对个人开发者来说，新额度有用。Pro 用户每月有 $20 可用于脚本。Max 20x 用户有 $200。这足够做有节制的自动化，但不是无限常驻 agents。

对团队来说，答案无聊但正确：生产自动化用 API keys。订阅里的 Agent SDK 额度留给个人。添加成本日志。限制轮次。不需要前沿模型的任务，优先用 Haiku 或 Sonnet。把绕过新边界的包装器工具当实验，不要当基础设施。

6 月 15 日的拆分解决了一个真实问题：你的夜间脚本不该悄悄吃掉你交互式编码需要的同一份配额。它也制造了另一个问题：只要 Claude 在无人参与的情况下运行，开发者就必须像 API 用户一样思考。

这是一笔公平交易。但前提是你要在计量表开始咬人之前完成审计。

一张小型决策树图，视觉标题只用图标表示：“interactive”、“headless local”、“CI”和“third-party too”

想亲自试试 Claude Fable 5 的读者，可以通过 OneHop 使用：一个可直接替换的 endpoint，比标价低约 30%，新账号赠送 $10，且无需银行卡。查看 Claude Fable 5 on OneHop 或 start with $10 free。

延伸阅读：Claude Fable 5 入门.