SuperAPI AI 工具集

claude-api

编程与开发

查看项目

更新于 10-24 16:19

技能介绍

用途

该技能用于帮助开发者使用 Claude 构建 LLM 驱动的应用。核心流程是:根据需求选择合适的接入方式(surface),检测项目语言,然后阅读对应语言的文档。

主要能力

  • 语言检测:根据项目文件推断语言,例如 .py、requirements.txt、pyproject.toml 等对应 Python;.ts、.tsx、package.json 对应 TypeScript;.js、.jsx(无 .ts 文件)也归入 TypeScript;.java、pom.xml、build.gradle 对应 Java;.kt、.kts、build.gradle.kts 归入 Java;.scala、build.sbt 归入 Java;.go、go.mod 对应 Go;.rb、Gemfile 对应 Ruby;.cs、.csproj 对应 C#;.php、composer.json 对应 PHP。若检测到多种语言,会询问用户当前文件或问题涉及哪种语言;若无法推断,则通过 AskUserQuestion 提供 Python、TypeScript、Java、Go、Ruby、cURL/raw HTTP、C#、PHP 选项;若 AskUserQuestion 不可用,默认展示 Python 示例。
  • 输出要求:当用户要求添加、修改或实现 Claude 功能时,代码必须通过官方 Anthropic SDK(如 anthropic、@anthropic-ai/sdk、com.anthropic.* 等)调用 Claude;仅当用户明确要求 cURL/REST/raw HTTP、项目本身是 shell/cURL 项目,或该语言没有官方 SDK 时,才使用原始 HTTP。不得混用两者,也不得回退到 OpenAI 兼容层。
  • 防止猜测 SDK 用法:函数名、类名、命名空间、方法签名和导入路径必须来自明确文档(技能内的 {lang}/ 文件,或 shared/live-sources.md 中列出的官方 SDK 仓库或文档链接)。若所需绑定未在技能文件中明确记录,应先 WebFetch 相关 SDK 仓库再写代码。不得从 cURL 形态或其他语言 SDK 推断 Ruby/Java/Go/PHP/C# API。若 WebFetch 或仓库访问失败,不要反复重试,而应依据 {lang}/ 文件中的模式和命名空间/包表编写代码,运行编译器或解释器,并根据错误输出迭代。
  • 默认设置:除非用户另有要求,Claude 模型版本默认使用 Claude Opus 4.8,模型字符串为 claude-opus-4-8;对任何稍复杂的任务默认使用自适应思考(thinking: {type: "adaptive"});对可能涉及长输入、长输出或高 max_tokens 的请求默认使用流式,以避免请求超时,可用 SDK 的 .get_final_message() / .finalMessage() 辅助方法获取完整响应。
  • API 漂移提醒:2025–2026 年间若干常见 Claude API 形态发生变化,例如扩展思考在 Claude 4.6+ 模型上使用 thinking: {type: "adaptive"},budget_tokens 在 Opus 4.6 / Sonnet 4.6 上已弃用,在 Fable 5 / Sonnet 5 / Opus 4.8 / 4.7 上会返回 400;Web 搜索/抓取工具类型更新为 web_search_20260209、web_fetch_20260209;PHP 参数名顶层为 camelCase;Managed Agents 凭据可使用 Vault environment_variable。技能内的 {lang}/ 文件优先于记忆中的模式。
  • 子命令:若用户请求是裸子命令字符串,会搜索文档中所有 Subcommands 表并执行对应 Action。例如 migrate 会立即读取 shared/model-migration.md 并按其顺序执行:Step 0 确认范围,Step 1 分类每个文件,然后按目标模型的破坏性变更章节处理;若用户未指定目标模型,会在同一轮询问。

使用方式

技能会先扫描目标文件(若无目标文件则扫描提示词和项目)中是否存在非 Anthropic 提供商标记,如 import openai、from openai、langchain_openai、OpenAI(、gpt-4、gpt-5、agent-openai.py 或 *-generic.py 等文件名,或任何要求保持提供商中立的明确指令。若发现,会停止并告知用户该技能生成的是 Claude/Anthropic SDK 代码,询问是否切换文件到 Claude 或需要非 Claude 实现,不会用 Anthropic SDK 调用编辑非 Anthropic 文件。

适用场景

技能提供了接入方式选型表:分类、摘要、抽取、问答等单次 LLM 调用使用 Claude API;批处理或嵌入使用 Claude API 的专用端点;代码控制逻辑的多步流水线使用 Claude API + 工具调用;自定义工具智能体使用 Claude API + 工具调用;服务端管理的有状态智能体使用 Managed Agents;持久化、版本化的智能体配置使用 Managed Agents;带文件挂载的长时多轮智能体使用 Managed Agents;按计划运行的智能体使用 Managed Agents 的 scheduled deployments。

构建智能体有四种方式:手动循环(自己编写 while stop_reason == "tool_use" 循环)、Tool Runner(client.beta.messages.tool_runner + @beta_tool / betaZodTool)、Managed Agents(REST,beta)、Claude Agent SDK(claude-agent-sdk / @anthropic-ai/claude-agent-sdk)。其中 Tool Runner 与 Claude Agent SDK 容易混淆:Tool Runner 是常规 Anthropic API SDK 的一部分,通过 client.beta.messages.tool_runner 访问,只自动化用户定义工具的请求→执行→循环,没有内置工具、文件系统访问或沙箱;Claude Agent SDK 是 Claude Code 打包成的库,自带文件读写编辑、bash、grep、Web 搜索等内置工具、完整智能体循环、上下文管理、hooks、子智能体和会话。两者都只提供 harness,部署由用户自己负责;只有 Managed Agents 同时提供 harness 和托管部署。该技能覆盖 Claude API 和 Managed Agents(方式 1–3),不生成 Claude Agent SDK 代码。

限制

是否构建智能体需检查四项标准:复杂性、价值、可行性、错误成本;若任一为否,应停留在更简单的层级。所有请求都通过 POST /v1/messages。用户定义工具、服务端工具、结构化输出(output_config.format,推荐 client.messages.parse(),旧的 output_format 参数已弃用)都是该单一端点的特性。支持端点包括 Batches、Files、Token Counting、Models。当前模型列表(缓存于 2026-06-24)包含 Claude Fable 5、Claude Mythos 5(仅 Project Glasswing)、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5,并列出上下文长度与输入/输出价格。云提供商访问方面,Claude Platform on AWS 由 Anthropic 运营并保持同日 API 对等;各功能在 Claude Platform on AWS、Amazon Bedrock、Google Vertex AI、Microsoft Foundry 上的可用性以 shared/platform-availability.md 为唯一权威来源。