Claude API Skill

Claude API Skill 是什么？

Claude API Skill 是一份面向 Claude API 和 Anthropic SDK 开发的动态参考资料。它覆盖模型选择、参数、流式输出、工具调用、MCP、缓存、令牌计算、模型迁移和代理开发，并要求在写代码前核对当前文档，避免使用已经变化的接口写法。

主要能力

• 根据项目语言选择官方 Anthropic SDK 或按明确要求使用原始 HTTP。
• 区分普通对话、工具循环、代理 SDK、托管代理和批处理等开发方式。
• 提供 Python、TypeScript、Java、Go、C#、PHP、Ruby 等语言参考。
• 核对认证、流式响应、思考参数、缓存、文件输入和云平台客户端。

开发前检查

Skill 会先检查项目是否已经绑定其他模型供应商。如果发现 OpenAI、Gemini 等明确标记，它不会直接把 Anthropic 调用混入现有代码，而是要求确认是否切换供应商。使用 Claude 时优先采用官方 SDK，只有用户明确要求或语言缺少 SDK 时才使用原始请求。

为什么需要动态参考？

模型名称、工具版本、参数结构和云平台支持会变化。Skill 将随附语言文档作为主要依据，缺少明确用法时再读取官方 SDK 或文档，并通过编译和运行结果修正代码。目录中缓存的模型信息也有日期，不能长期当成不变事实。

限制与安全

它不能替代有效的 API 凭据、账户权限和费用管理。密钥应放在安全环境变量或凭据系统中，不应写入代码和公开日志。价格、限额和最新模型必须在实施时重新核对。

许可证

该目录中的 LICENSE.txt 当前为 Apache-2.0，具体 SDK 及服务仍受各自条款约束。

常见问题 FAQ

1. 支持哪些编程语言？

目录包含多种主流语言的参考，实际支持以当前官方 SDK 为准。

2. 可以使用 requests 或 fetch 吗？

只有明确要求原始 HTTP、项目本身是相关形式或没有官方 SDK 时才优先考虑。

3. 能把 Claude 代码混进 OpenAI 项目吗？

不会默认这样做。发现其他供应商标记后应先确认迁移或保持原实现。

4. 会提供最新模型名称吗？

会读取当前资料，但模型信息仍可能更新，发布代码前需要再次核对。

5. 支持工具调用和 MCP 吗？

支持，包含工具定义、循环处理、MCP 和代理开发等参考。

6. 能处理云平台部署吗？

包含 Bedrock、Microsoft Foundry 和 Vertex AI 等客户端提示，但功能差异需按平台核对。

7. API 密钥可以写进示例吗？

不应写入代码，推荐使用环境变量、工作负载身份或安全凭据存储。

8. 能保证示例一次运行成功吗？

不能保证环境和依赖完全一致，应配合编译、测试和真实错误信息迭代。

来源与核验说明

本条目根据 Anthropic 官方 Skills 仓库中的 claude-api 文档结构整理，易变化的信息应以使用时的官方资料为准。