SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场claude-api-ops

claude-api-ops

编程与开发

查看项目

更新于 10-13 16:36

技能介绍

用途

claude-api-ops 是一套面向开发者的技能文档，聚焦于「在 Claude 之上构建应用」——即使用 Anthropic API 和 Claude Agent SDK 编写应用与智能体。资料明确指出，它适用于 anthropic api、claude api、messages api、工具调用（tool use / function calling）、提示缓存等场景，而不是用于使用 Claude Code 本身。

主要能力

资料覆盖以下主题：

  • Messages API：请求方式为 POST /v1/messages，请求头包括 x-api-key、anthropic-version: 2023-06-01、content-type: application/json。
  • 工具调用（tool use）：工具定义形状、tool_choice 取值、并行工具结果、pause_turn、is_error、服务端工具、SDK 工具运行器，以及驱动循环的 stop_reason 检查。
  • 提示缓存（prompt caching）：稳定前缀（系统提示、工具定义、大文档）上使用 cache_control: {"type": "ephemeral"}，读取成本约 0.1x，最高可节省约 90%。
  • 结构化输出：output_config.format 等。
  • 批处理（Batches API）：固定 50% 折扣，≤24 小时周转，可与缓存叠加。
  • thinking 与 effort：自适应 thinking 在 Fable 5 / Opus 5 / Sonnet 5 上默认开启；effort 通过 output_config: {"effort": ...} 控制深度。
  • Claude Agent SDK：内置工具、hooks、子智能体、MCP 服务器、会话（resume/fork）、权限模式。
  • 上下文工程：上下文预算、缓存感知排序、工具结果膨胀、压缩（compaction）的取舍。
  • 成本优化与模型分级：按任务难度路由，而非统一默认。

模型与定价（资料中标注核验于 2026-08）

  • Claude Fable 5，ID：claude-fable-5，上下文 1M，最大输出 128K，输入 $10.00/MTok，输出 $50.00/MTok。
  • Claude Opus 5，ID：claude-opus-5，上下文 1M，最大输出 128K，输入 $5.00/MTok，输出 $25.00/MTok。
  • Claude Sonnet 5，ID：claude-sonnet-5，上下文 1M，最大输出 128K，输入 $2.00/MTok，输出 $10.00/MTok。
  • Claude Haiku 4.5，ID：claude-haiku-4-5，上下文 200K，最大输出 64K，输入 $1.00/MTok，输出 $5.00/MTok。

资料强调使用上述别名 ID 原文，不要追加日期后缀；Haiku 4.5 是当前唯一在其别名后带日期快照 ID 的模型。另列出仍可用但已非当前的旧模型，并提供迁移指南与 /claude-api migrate 命令。

使用方式

资料给出 Messages API 的 Python 快速开始示例（注释注明 pip install anthropic，客户端读取 ANTHROPIC_API_KEY），遍历 response.content 时先检查 block.type 再取 .text，并打印 stop_reason 与 usage。TypeScript 与流式版本见 references/sdk-examples.md。资料提醒长输出应使用流式，非流式且 max_tokens 超过约 16K 可能触发 SDK HTTP 超时。Agent SDK 的最小 query() 循环安装方式为：Python 使用 pip install claude-agent-sdk（Python >= 3.10），TypeScript 使用 npm install @anthropic-ai/claude-agent-sdk。

适用场景

资料按需求给出调用面选择：单请求单响应用 Messages API；多步流程且由自己代码控制逻辑用 Messages API + 工具调用；自建工具的自定义智能体用 Messages API + 工具调用（手动循环或 SDK 工具运行器）；需要读写文件、执行命令、搜索的智能体用 Claude Agent SDK；CI/CD 自动化、编码智能体、生产智能体应用用 Claude Agent SDK；可等待 ≤24 小时的大批量非紧急负载用 Batches API；托管智能体由 Anthropic 运行循环与沙箱，使用 Managed Agents（beta）。原则是先从最简单层级开始，任务确实开放（多步、难以完整指定、错误可恢复、价值足以覆盖成本）时才使用智能体。

限制与注意事项

资料列出多项常见错误：使用带日期后缀或猜测的模型 ID 会返回 404；在 Opus 4.7 及之后模型上使用 budget_tokens、temperature/top_p/top_k、assistant 轮次预填会返回 400；Haiku 4.5 不支持 effort；工具循环中重建 assistant 轮次（丢弃空 thinking 块）会导致 400「thinking blocks cannot be modified」；缓存标记小于最小前缀会静默不缓存（最小 512-4096 token，取决于模型）；未处理 stop_reason: "tool_use" 会导致智能体在首次工具调用后「停止」；缺少 tool_use id 对应的 tool_result 会在后续请求返回 400；使用 tiktoken 计数会低估 15-20%；应以 messages.count_tokens 计数，并使用类型化异常而非字符串匹配错误信息。资料还提醒，模型 ID、参数与 beta 变化很快，遇到「最新模型」或价格问题应通过 WebFetch 核对官方文档或查询 Models API。

附带资源

资料列出参考文件清单（messages-api、tool-use、caching-and-cost、structured-outputs、agent-sdk、context-engineering、compaction、context-engineering-quickref、resources、sdk-examples），以及脚本与资产：scripts/check-model-table.py（模型表过期校验）、scripts/context-budget.py（追加与压缩成本计算）、assets/cached-agent-loop.py、assets/recall-probe.py、assets/agentic-loop.py、assets/output-schema.json。