技能包

claude-api:用官方 SDK 接 Claude,先避开已废弃参数

适合要在项目里接 Claude API 的人,须走当前语言的官方 Anthropic SDK,默认 claude-opus-5 与 adaptive thinking,且不要再传会返回 400 的 budget_tokens。

官方来源 · claude-api

安装

Call Claude through the official Anthropic SDK for the project's language

适合谁

claude-api 面向提示里点名 Claude 或 Anthropic、要查模型、参数、流式、工具或缓存等参考的人。它是 Claude API / Anthropic SDK 的参考,不是又一个安装器。当提示以任何形式点名 Claude/Anthropic 时,应先读这份说明,不要因为“看起来像一句话”就跳过。

更贴的用法是:你要在现有项目里新增或改一段调用 Claude 的代码,并且项目语言已有官方 Anthropic SDK。说明要求:实现 Claude 功能时,必须通过该语言的官方 SDK 来调用。它不适合你只想随手编一段未指定 SDK 的伪代码、或把页面路径当成安装命令的人。

默认模型写成 Claude Opus 5,精确字符串是 claude-opus-5。稍复杂的请求默认用 adaptive thinking。说明没有给出安装命令,若当前助手还不能按这份参考改代码,现有说明到此为止,不要从地址反推技能目录。

3 分钟完成第一次尝试

官方第一次路径是按参考检查或改一处调用,而不是安装。说明页是 https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md 请只按这一页的约束做。不要编写未出现的安装句,也不要在代码里写入密钥占位。

前置条件:当前助手已经能按 claude-api 工作,你手头有一份可丢弃的调用片段或空函数,并且本机已有该语言的官方 Anthropic SDK。没有安装命令,因此“位置”就是这段项目代码,而不是某个推测出来的技能目录。

低风险第一次任务:先做只读检查。让助手看现有调用是否走官方 SDK,模型是否为 claude-opus-5,thinking 是否为 adaptive,以及有没有已废弃的 budget_tokens。不要先对真实账号发长请求。成功信号是助手指出上述四点中任何偏差,并在改代码前停下来让你确认。

若需要改,只改模型字符串和 thinking 形状:thinking: {type: "adaptive"}。说明写明在 Claude 4.6+ 上 budget_tokens 已废弃,在 Opus 4.6 / Sonnet 4.6 会被拒绝并返回 400。看到写入提示时先确认没有把密钥写进仓库。

使用案例

案例一:给项目加一个 Claude 功能。提示点名 Claude/Anthropic 时先读参考,实现时通过项目语言的官方 Anthropic SDK 调用,模型用 claude-opus-5,稍复杂的请求默认 adaptive thinking。适合你已经选定语言、只差把调用写对的时候。说明在现有句子里只展开了“官方 SDK”这一条路径,没有写其它 SDK 名字;因此不要自行换用未点名的封装。对照页是 https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

案例二:排掉会 400 的旧 thinking 参数。在 Claude 4.6+ 上应使用 thinking: {type: "adaptive"};budget_tokens 在 Opus 4.6 / Sonnet 4.6 已废弃,会被拒绝并返回 400。适合你刚从旧示例拷了 thinking 配置、请求直接 400 的时候。先只改这一处再决定是否发真实请求。说明没有列出全部已废弃字段,因此只能确认 budget_tokens 这一条。

使用边界

没有安装命令:不能把页面路径当成安装器。触发边界:提示以任何形式点名 Claude/Anthropic 时先读,不要当一句话跳过。调用边界:实现功能须走项目语言的官方 Anthropic SDK;现有句子没有展开其它并列方式。模型边界:默认 Claude Opus 5,字符串 claude-opus-5;复杂请求默认 adaptive thinking。参数边界:budget_tokens 在点名的 4.6 型号上会 400。密钥边界:不要编写密钥占位或把密钥写进代码。这份参考还覆盖定价、流式、工具等主题,但现有句子没有给出这些主题的逐步示例。