Claude API 技能

claude-api 技能是一个开源的 Agent Skill，为 Claude 提供详细的、最新的参考资料，用于在两个 Anthropic 平台上构建应用程序：

• Messages API — 用于单个请求、流式聊天、工具使用、批处理、提示缓存、结构化输出和自定义 agent 循环的主要平台。
• Claude Managed Agents（测试版） — 一个第一方平台，用于服务器管理的有状态 agent，具有 Anthropic 托管的工具执行、持久 agent 配置和按会话容器。

它涵盖 Messages API 的 8 种编程语言（Python、TypeScript、Java、Go、Ruby、C#、PHP 和 cURL）以及 Managed Agents 的 7 种语言（Python、TypeScript、Java、Go、Ruby、PHP 和 cURL — 目前不支持 C#）。

该技能与 Claude Code 捆绑在一起，也可在开源 Anthropic 技能库 中获得，您可以在任何支持 Agent Skills 的环境中安装它。

该技能使用 渐进式披露 来保持上下文高效：Claude 仅加载与您项目的语言、平台（Messages API 或 Managed Agents）和手头的特定任务（工具使用、流式处理、批处理等）相关的文档，而不是一次性加载所有内容。

技能提供的内容

触发时，该技能为 Claude 提供：

对于 Messages API：

• 特定语言的 SDK 文档： 安装、快速入门、常见模式和针对您项目语言的错误处理
• 工具使用指导： 函数调用的特定语言示例和 概念基础，包括可用的测试版工具运行器
• 流式处理模式： 构建聊天 UI 和处理增量显示的实现细节
• 批处理： 以 50% 成本进行离线批处理
• 提示缓存： 前缀稳定性设计、断点放置和静默失效审计
• 模型迁移： 迁移到更新 Claude 模型的分步指导（包括 Claude Opus 4.7 上的破坏性更改和行为转变）
• 当前模型信息： 模型 ID、上下文窗口大小和定价
• 常见陷阱： 关于在与 API 集成时避免常见错误的详细指导

对于 Managed Agents（测试版）：

• 入门流程： 一个面试驱动的演练，用于从头开始设置新的 Managed Agent，可通过 /claude-api managed-agents-onboard 子命令获得
• 特定语言的 Managed Agents 文档： 为 Python、TypeScript、Java、Go、Ruby、PHP 和 cURL 创建持久 agent、启动会话、流式处理事件和处理工具确认
• 客户端模式： 无损流重新连接、processed_at 排队/已处理门、中断处理、文件挂载陷阱和凭证处理
• 部署约束： Managed Agents 仅限第一方（在 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 上不可用）— 该技能将第三方部署路由到 Messages API + 工具使用

技能何时激活

该技能以两种方式激活：

自动激活 发生在以下情况：

• 您的代码导入 Anthropic SDK（Python 为 anthropic，TypeScript/JavaScript 为 @anthropic-ai/sdk）
• 您要求 Claude 帮助使用 Claude API、Anthropic SDK 或 Managed Agents 构建、调试或优化某些内容
• 您在文件中添加、修改或调整 Claude 功能（提示缓存、自适应思考、压缩、工具使用、批处理、文件、引用、内存）或模型参考

手动调用 通过在安装了该技能的任何环境中键入 /claude-api（带有可选的子命令或散文）。

该技能不会为一般编程任务、ML/数据科学工作或导入其他 AI SDK（如 OpenAI）的代码激活。

支持的语言

该技能通过检查项目文件（例如，Python 的 requirements.txt、TypeScript 的 tsconfig.json、Go 的 go.mod）自动检测您的项目语言，并加载相应的文档。

如果您的项目使用多种语言，Claude 会询问哪一种适用。对于不支持的语言（Rust、Swift、C++），该技能提供 cURL/原始 HTTP 示例。

如何使用该技能

在 Claude Code 中（捆绑）

该技能与 Claude Code 一起提供，无需安装。当您要求 Claude 帮助使用 Claude API 构建某些内容，或当您的项目已导入 Anthropic SDK 时，该技能会自动激活。

您也可以直接调用它：

/claude-api

有关捆绑技能在 Claude Code 中如何工作的更多信息，请参阅 Claude Code 技能文档。

从技能库

技能源代码可在 Anthropic 技能库 中获得。您可以使用 npx 命令安装它：

npx skills add https://github.com/anthropics/skills --skill claude-api

或将其安装为 Claude Code 插件：

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

迁移到更新的 Claude 模型

Claude API 技能可以在整个代码库中执行 Claude 模型迁移。使用 /claude-api migrate 直接调用它：

/claude-api migrate this project to claude-opus-4-7

您也可以提前传递特定范围以跳过范围确认问题：

/claude-api migrate everything under src/ to claude-opus-4-7
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-7

当范围不明确时（例如，一个简单的 /claude-api migrate to claude-opus-4-7），该技能会要求您在编辑任何文件之前在整个工作目录、特定子目录或显式文件列表之间进行选择。这适用于 Messages API 和 Managed Agents 调用者。

该技能处理：

• 模型 ID 交换，包括所有支持的语言中的类型化 SDK 常量（Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7），并在编辑前将每个文件分类为调用者、模型定义者或不透明字符串引用
• 破坏性参数更改，例如为 Claude Opus 4.7 删除 temperature、top_p 和 top_k，以及将 thinking: {type: "enabled", budget_tokens: N} 转换为 thinking: {type: "adaptive"}
• 预填充替换，将助手消息预填充模式转换为 结构化输出（如适用）
• 测试版标头清理，删除在目标模型上为 GA 的标头（例如，effort-2025-11-24、fine-grained-tool-streaming-2025-05-14、interleaved-thinking-2025-05-14）并从 client.beta.messages.create 切换回 client.messages.create
• ，为目标模型推荐 起点（例如，Claude Opus 4.7 上的编码和 agent 用例为 ）

在编辑时，该技能会内联解释每项更改及其动机。完成后，它会生成一个检查清单，列出需要手动验证的项目（通常是集成测试、长度控制提示调整和成本/速率限制重新基准化）。

有关该技能应用的完整模型特定更改列表，请参阅 迁移到 Claude Opus 4.7。

设置 Managed Agent

要从头开始搭建新的 Managed Agent，请调用 managed-agents-onboard 子命令：

/claude-api managed-agents-onboard

该技能运行一个面试，引导您了解 Managed Agents 心智模型（Agent 配置与会话），为 agent 配置创建模板，配置环境和工具，设置会话循环，并为您的语言发出可运行的代码。该技能还涵盖强制性的 Agent（一次）→ Session（每次运行） 流程 — model、system 和 tools 位于 agent 上，从不位于会话上，agent 应创建一次并通过 ID 引用。

Managed Agents 需要 managed-agents-2026-04-01 测试版标头，SDK 会自动为所有 client.beta.agents.*、client.beta.environments.*、client.beta.sessions.* 和 client.beta.vaults.* 调用设置该标头。

使用示例

以下是该技能帮助 Claude 处理的任务示例：

构建聊天应用程序：

Build a streaming chat UI with the Claude API in TypeScript

迁移现有项目：

/claude-api migrate this codebase to claude-opus-4-7 and re-tune effort

入门新的 Managed Agent：

/claude-api managed-agents-onboard

在每种情况下，该技能都会加载相关的特定语言文档，并使用当前 API 模式和最佳实践指导 Claude 完成实现。

后续步骤