claude-api – Claude API 集成开发 Skill

3周前更新 8 0 0 0

claude-api 是 Anthropic 官方提供的 Claude API 开发指导型 Skill,帮助 AI Agent 编写、调试和迁移 Claude API 代码,涵盖 messages 接口调用、流式输出、工具调用、报错排查及模型参数说明等任务。

Skill 安装

多 Agent 安装
npx skills add https://github.com/anthropics/skills --skill claude-api

使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

anthropics/skills#claude-api 是 Anthropic 官方 skills 仓库中的一个 Skill,定位是 Claude API 开发指导。它让 Agent 在编写、调试、迁移和排查 Claude API 相关代码时,能够引用官方 API 规范、模型能力、参数含义、SDK 用法和常见错误处理方式。

它是什么

Anthropic 官方维护的一套面向 Claude API 的开发指导内容,以 Skill 形式交付给 AI Agent 使用。内容以文本指导为主,不是独立运行的软件,不是需要单独安装依赖的库,不是运行时 SDK,也不提供包或服务。

它不是什么

– 不是可执行程序,不发起 API 请求,不携带 API Key
– 不代替用户调用 Claude API
– 不提供 npm / pip 包
– 不是权威文档本身,最终参数以 Anthropic 官方文档为准

核心用途

– 生成使用 Claude API 的代码:messages 接口调用、流式输出、工具调用、多轮对话、系统提示词等
– 解释 Claude API 的参数、返回结构、消息格式和常见限制
– 排查调用错误,比如参数问题、token 超限、模型名称错误、工具调用格式问题
– 帮助从其他 LLM API(如 OpenAI Chat Completions)迁移到 Claude API,或做 API 对比
– 帮助理解 Claude 模型系列、上下文窗口、定价层级、模型选择等与 API 使用直接相关的问题

工作方式

安装后,Agent 在用户提出 Claude API 相关任务时加载对应指导内容,把这些官方信息作为上下文的一部分来辅助回答或生成代码。真正发起网络请求、消耗 token、产生费用的,是用户后续用代码调用 Claude API 的行为,而不是这个 Skill。

典型场景

– 写一个调用 Claude messages 接口的 Python / TypeScript 脚本
– 实现流式响应、工具调用、结构化输出等高级用法
– 把现有 OpenAI API 代码迁移到 Claude API
– 排查接口报错,理解错误信息含义
– 对比 Claude 各模型的上下文窗口、价格和使用限制

不适合的需求

– 直接替代 Claude 官方文档做权威查询
– 非 Claude 的 API 场景(OpenAI、Gemini 等),可能做概念类比,但核心内容围绕 Claude API
– 当成运行时 SDK

安装后 Agent 增加的能力

安装前,Agent 只能凭自身训练知识回答 Claude API 问题;安装后,Agent 会加载 Anthropic 官方整理的 Claude API 指导,在生成代码、排查错误和做迁移对比时基于官方规范作答。它增加的是“Claude API 开发指导”这一层能力,不是新增一个可调用的接口。

Skill 安全评估

总体判断

该 Skill 来自 Anthropic 官方仓库,本身是多份 Markdown 形式的知识与指导内容,不携带可执行程序、不内置 API Key、不自动发起网络请求。从 Skill 自身构成看,风险很低。

来源可信度

– 仓库来自 Anthropic 官方组织,渠道可信
– 内容以文本指导为主,不是脚本、二进制或打包产物

它不会做的事

– 不会自动向 Claude API 或任何第三方服务发送请求
– 不会自动读取或写入本地文件
– 不会自动执行 Shell 命令
– 不会自动收集或外传 API Key

需要注意的真实风险

– API Key 泄露风险来自使用过程,不是 Skill 本身。如果让 Agent 生成包含 API Key 的代码片段,并把代码粘贴到公开位置或提交到仓库,Key 可能泄露。建议把 API Key 放在环境变量中,代码只读取 `process.env.ANTHROPIC_API_KEY` 或 `os.environ[ANTHROPIC_API_KEY]` 之类的变量。
– 生成的代码可能被 Agent 自动执行。如果 Agent 具备自动运行 Shell 的能力,生成的调用代码一旦执行就会真实消耗 token 并产生费用。可以在需要时关闭 Agent 自动执行 Shell 的权限,由自己手动运行。
– 提示词注入风险。如果结合其他会读取外部内容的 Skill 或工具使用,外部内容可能试图影响 Agent 输出。这属于通用 Agent 风险,不是该 Skill 特有的问题。
– 过度依赖风险。Agent 生成的代码可能在某些参数或边界情况下与最新官方文档存在差异。涉及生产环境的关键调用,建议对照官方文档核对一次。

降低风险的建议

– 只让 Agent 生成代码,不自动执行;执行环节自己控制
– API Key 一律走环境变量,不要硬编码进代码
– 生成后先在本地小规模测试,再接入生产
– 涉及计费敏感的场景,先在 Anthropic 控制台确认模型定价和用量上限

Skill 使用要求

一、Agent / 客户端

该 Skill 属于 Anthropic 官方 skills 仓库,与 Claude Code 适配度最高,建议优先在 Claude Code 中使用。官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式来看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境中,通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。不同 Agent 的 Skill 加载方式和兼容程度可能不同,具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

Skill 本身是指导内容,不需要特定运行时语言或依赖。使用它生成的代码时,环境需求取决于你实际运行的语言和 SDK。

| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先,其他兼容 Agent 可尝试 |
| Node.js | 仅在运行 TypeScript / JavaScript 版 Claude SDK 代码时需要 |
| Python | 仅在运行 Python 版 Claude SDK 代码时需要 |
| 网络 | 仅在实际调用 Claude API 时需要 |
| Git | 仅在从 GitHub 拉取 Skill 源码时需要 |

Skill 本身不需要 Node.js、Python、Docker 或任何额外 CLI。

三、权限

– 文件读取:可选。安装后 Agent 读取 Skill 内容时需要
– 文件写入:可选。生成代码文件时需要
– Shell:可选。仅当想让 Agent 自动运行生成的代码时需要;不需要自动执行时可以关闭
– 网络:可选。仅当 Agent 需要访问 Anthropic 官方文档,或你运行调用代码时需要
– 浏览器、Docker、GitHub:不需要

四、账号 / API Key

– Skill 本身不需要 Anthropic 账号,也不需要 API Key
– 使用它生成的代码如果真要调用 Claude API,才需要 Anthropic API Key,并且会产生费用
– Key 是否使用、放在哪里,取决于后续运行代码的方式,与 Skill 安装无关

最小使用条件

1. 一个支持 Skill 或自定义指令加载机制的 AI Agent(优先 Claude Code)
2. 能读取该 Skill 的安装方式(如通过 LemonAIKit 的安装指令)
3. 如果只是生成代码,到此即可;如果要实际调用 Claude API,再加一个有效的 Anthropic API Key 和网络环境

Skill 安装、使用与卸载教程

一、安装

LemonAIKit 的 Skill 详情页已经提供该 Skill 的安装指令。直接复制本页面提供的安装指令,粘贴到对应 Agent 或终端执行即可。

如果不确定当前 Agent 应该如何安装,可以直接询问它:

如何安装 anthropics/skills#claude-api?

也可以指定 Agent:

如何在 Claude Code 中安装 anthropics/skills#claude-api?

如何在 Codex 中安装 anthropics/skills#claude-api?

如何在 Cursor 中安装 anthropics/skills#claude-api?

让当前 Agent 根据自己的 Skill 加载 / 管理机制指导安装,通常比手动复制目录更稳妥。该 Skill 本身没有已知的特殊官方安装前置条件。

二、安装后如何使用

安装后不需要手动触发命令。只要任务和 Claude API 相关,Agent 通常会自动加载该 Skill 的指导内容。直接用自然语言描述需求即可。

示例一:生成调用代码

使用 claude-api,帮我写一个 Python 脚本,调用 Claude messages 接口,支持流式输出,并且能接收命令行传入的 prompt。

示例二:排查错误

使用 claude-api,帮我看看这段调用 Claude API 的报错,告诉我为什么会出现,以及应该怎么改。

示例三:迁移与对比

使用 claude-api,把下面这段 OpenAI Chat Completions 的调用改写成 Claude API 的写法,并说明关键差异。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。通常有两种做法:

– 使用对应 Agent 或 Skill 管理器提供的删除 / 移除功能,删除该 Skill
– 直接询问当前 Agent,让它根据自己实际的 Skill 存放位置和加载机制告知移除方式

如何卸载 anthropics/skills#claude-api?

如果没有统一的官方卸载命令,建议以询问当前 Agent 为准,通常比自行猜测路径更可靠。

常见问题

1. 安装后 Agent 好像没识别这个 Skill,怎么办?

先在对话里直接问 Agent:“你现在是否能使用 anthropics/skills#claude-api?”如果 Agent 表示无法使用,检查 Skill 是否真的被复制到了当前 Agent 的 Skill 目录,或者该 Agent 是否需要重启 / 重新加载 Skill 列表。不同 Agent 加载机制不同,也可以在 Claude Code 中重新执行安装指令。

2. 这个 Skill 会不会自动去调用 Claude API,产生费用?

不会。它本身只是指导内容,不会主动发起请求。只有你运行它生成的代码、并且代码里真的调用了 Claude API,才会产生费用。

3. 可以同时安装到多个 Agent 吗?

可以。它本质上是内容型 Skill,可以分别安装到 Claude Code、Codex、Cursor 等不同 Agent 中,彼此独立。不同 Agent 的加载效果可能不同,建议各装一份,按需使用。

4. Skill 更新后需要重新安装吗?

一般需要。Skill 内容更新后,本地版本不会自动同步。如果发现 Agent 给出的信息偏旧,可以重新执行一次安装指令,或者询问当前 Agent 如何更新已安装的 Skill。

5. 中国大陆使用有网络要求吗?

Skill 本身是文本内容,只要已经装到本地,使用它生成代码不需要访问外网。但如果生成的代码要实际调用 Claude API,就需要能访问 Anthropic API 的网络环境。

6. 它可以完全替代 Anthropic 官方文档吗?

不建议完全替代。它提供的是面向 Agent 的开发指导,方便快速生成和排查,但具体参数、模型名、限制和定价以 Anthropic 官方文档为准。生产环境上线前建议对照官方文档再核对一遍。

7. 生成的代码可以用于生产环境吗?

可以参考,但不建议不经审核直接投产。它适合作为开发和排查的第一版参考,生产环境还需要自行补充错误重试、限流、日志、监控、密钥管理、成本控制等工程内容。

Skill 更新日志

版本列表
无版本号
更新 claude-api 技能:将拒绝计费链接到文档 (#1825) 将每条拒绝计费语句指向“拒绝如何计费”文档章节,而不是在技能中重述规则。 同时修正两处说法以匹配该章节:任何输出之前的拒绝会计入速率限制,而流中途的拒绝会同时计入输入 token 和已流式传输的输出。
无版本号
更新 claude-api 技能:Managed Agents `auto` 权限策略和 `ant beta:sessions connect` (#1750) 新增第三种 Managed Agents 权限策略 `auto`,与 `always_allow` / `always_ask` 并列:三种结果(运行、被判定为高风险并返回错误工具结果但会话继续运行、不确定时暂停等待批准)、配置示例、评估所信任的内容,以及“不是人工检查点”的警告。记录了 `agent.tool_use` / `agent.mcp_tool_use` 上的 `evaluated_permission` 和 `evaluation` 字段,并更新客户端模式和多智能体指南,改为基于 `evaluated_permission === 'ask'` 而非配置的策略进行门控。 在 CLI 指南中新增 `ant beta:sessions connect`:终端查看器键位绑定、允许/拒绝提示,以及 `--web` 本地会话查看器。 修正拒绝示例,改用 `deny_message`(真实字段)而非 `message`。 Claude-Session: https://claude.ai/code/session_01UkZpc4FqLFPLBJF2Zcuq3a Co-authored-by: Claude
无版本号
更新 claude-api 技能:Claude Fable 5.1 / Mythos 5.1、Managed Agents 更新、cost-optimize (#1704) * 更新 claude-api 技能:Managed Agents 自托管内存存储和 web 工具域名设置、cost-optimize 子命令、Admin API 参考、纯 ASCII 文本 Managed Agents:自托管沙箱现在可以通过 SDK worker 附加内存存储(handle_item、ANTHROPIC_WORK_SECRET、同步选项、故障排除);web_search/web_fetch 在 toolset 配置项上接受 allowed_domains/blocked_domains/user_location/max_content_tokens,且不受环境网络管控;按工具的类型化配置联合;Console 会话查看器说明;受限网络下的包注意事项;AWS 上 Claude Platform 的自托管 worker 认证。 新增 shared/cost-optimization.md 支撑 cost-optimize 子命令,并新增 shared/admin-api.md,涵盖所有 SDK 和 CLI 中的 client.beta.organization。提示缓存新增 TTL 选择、自动与显式断点指导、工作区隔离和验证指导。Sonnet 5 定价为永久 $2/$10 标价。Advisor 配对不再将 Claude Fable 5 排除在 Managed Agents 之外。仅审阅者可见的 HTML 注释会从发布文件中剥离。 所有文件的正文现在均为纯 ASCII(长破折号、箭头、emoji 标注和制表符已替换为 ASCII 等价物),与源文件保持一致,以便未来同步时差异清晰。 No-Verification-Needed: documentation-only change to skill reference content * 更新 claude-api 技能:Claude Fable 5.1 / Mythos 5.1 目录行、Files 和 Skills API 脱离 beta Claude Fable 5.1 (claude-fable-5-1) 和 Claude Mythos 5.1 (claude-mythos-5-1) 成为整个技能中默认的 Fable 层级模型;Claude Fable 5 和 Mythos 5 仍可通过 id 选择,并保留各自的目录行。原先写 Fable 5 的功能支持列表现在写为 Fable 5/5.1。 Files API 和 Skills API 已脱离 beta:示例使用 client.files.* / client.skills.*,不带 beta 头,API 漂移表指向 beta 到 GA 的迁移文档。 No-Verification-Needed: documentation-only change to skill reference content * 更新 claude-api 技能:Claude Fable 5.1 / Mythos 5.1 迁移章节和 API 变更 在 shared/model-migration.md 中新增“从 Claude Fable 5 迁移到 Claude Fable 5.1”章节:三项破坏性变更(强制 tool_choice any/tool 返回 400;thinking 块仅对产生它们的模型或更新的模型保留;且仅在产生它们的对话中保留,因此用 thinking 块重放的已编辑历史会被拒绝)、从 Fable 5 延续的内容、Opus 5 路径、Mythos 5.1 说明、能力改进、可通过提示调整的行为变化,以及迁移检查清单。 记录的新 API 功能:按消息的 effort(mid-conversation-output-config beta)、带 clear_at 的轮次作用域对话中途系统消息、通过 thinking.display "updates" 在工具调用之间提供进度更新、thinking block_binding 控制,以及 Fable 5.1 上 0.025x 缓存读取费率,配合 max_tokens: 0 保活,通常优于 1 小时 TTL。 错误目录、提示缓存、工具使用、平台可用性、成本优化和提示审计均已相应更新;SKILL.md 将迁移和提示问题路由到新章节。 No-Verification-Needed: documentation-only change to skill reference content * 更新 claude-api 技能:Claude Fable 5.1 发布日保留说明和迁移路径表行 在迁移路径和模型 ID 映射表中新增 claude-fable-5 -> claude-fable-5-1 和 claude-mythos-5 -> claude-mythos-5-1 行(包括 Bedrock ID),并将拒绝回退示例更新为 5.1 模型 id。 对三项说法暂作保留,直到发布文档确认:Claude Fable 5.1 上的 Task Budgets 支持、Claude Mythos 5.1 是否共享 0.025x 缓存读取费率,以及回退额度措辞。block_binding 错误行现在说明仅在该 beta 提供的地方发送 controls beta 头,其他地方回退到剥离并重试。迁移章节内的交叉引用直接指向历史编辑检查。 No-Verification-Needed: documentation-only change to skill reference content
无版本号
更新 claude-api 技能:Python SDK 0.x -> 1.x 升级指南 (#1623) 新增 `upgrade` 子命令,引导项目从 anthropic 0.x 升级到 1.x(httpx2 HTTP 层、Python 3.10 最低版本、移除已弃用接口)。 - 新增 python/claude-api/sdk-upgrade.md:范围和版本检查、受影响调用点的可 grep 清单、每个破坏性变更一节、验证,以及报告格式。 - SKILL.md:`upgrade` 子命令行和阅读指南条目。 - python/claude-api/README.md:超时使用 anthropic.Timeout,自定义客户端注明 httpx2,链接到 SDK MIGRATION.md。 - shared/live-sources.md:SDK 主版本升级指南表。
无版本号
更新 claude-api 技能:prompt-audit 子命令 (#1557) * 为 claude-api 技能新增 prompt-audit 子命令 新增 shared/prompt-audit.md:一种非交互式审计,盘点提示面、为每条指令标注日期、对照带日期的模式表进行扫描,并生成发现报告和拟议 diff。SKILL.md 新增子命令行、来自 migrate 的交叉引用、针对非交互式契约在提供方检查和语言检测中的例外,以及阅读指南条目。model-migration.md 在其提示行为章节指向该审计。 No-Verification-Needed: markdown-only skill content, no runtime surface * 将 prompt-audit 例外标注替换为语言检测中的意图检查 No-Verification-Needed: markdown-only skill content, no runtime surface
无版本号
更新 claude-api 技能:Managed Agents 八月发布浪潮 (#1532) 同步 8 月 5 日 Managed Agents 发布浪潮的最新捆绑技能内容: - 会话预算:会话创建时的 budget 对象(最小单位美分字符串)、budget_reached 暂停语义、结算事件允许列表、session.usage 事件、更改/移除以恢复、多智能体共享上限 - 部署预算:部署上的相同 budget 对象,复制到每个触发的会话,可清除并可重新添加 - 推理地理固定:agent model 对象上的 inference_geo、按会话覆盖、名册一致性、永不祖父条款 - 来自 GitHub 仓库的 Skills:会话启动时发现根 .claude/skills(仅云沙箱)、信任边界警告 - Advisor:{type: "advisor", model} 多智能体名册条目、保留的 anthropic.advisor 线程、明文与脱敏投递;advisor 工具 max_uses/max_tokens/缓存选项和错误结果变体 - 多智能体:新的何时使用指导(从自身开始、添加更便宜的 worker、专职专家)、委派工具、文档 URL 重命名 - 更正:agent 版本是连续整数、Files API 上传接受 purpose 参数、stop_details 拒绝类别是开放集合、Sonnet 5 加入移除预填充列表、vault_ids 在会话上仅创建时可用、部署新增更新端点 No-Verification-Needed: markdown-only skill content sync
无版本号
更新 claude-api 技能:Claude Opus 5 (#1476) * 更新 claude-api 技能:Claude Opus 5 - 在所有 SDK 示例、模型表、定价和迁移指导中新增 Claude Opus 5 (`claude-opus-5`) 作为默认模型。 - 新增 Opus 5 迁移章节,涵盖随之而来的 API 变更,并将 Opus 4.8 移入上一代位置。 - 删除不再适用的 Opus 4.7 快速模式指导。 - 将服务端回退 beta 头限定为当前版本。 * 更新 claude-api 技能:Opus 5 快速跟进更正 - 服务端拒绝回退在 AWS 上的 Claude Platform 也可用,而不仅是 Claude API。更正 SKILL.md、迁移指南和平台可用性表中的可用性说明。 - 简化 effort 指导:从 `high`(API 默认值)开始并向下扫描,而不是为编码工作从 `xhigh` 开始。 - 新增首 token 时间章节,包含可减少延迟敏感路由上回答前思考的提示指令。 - 将两个单独的禁用 thinking 缓解措施替换为一条涵盖两种失败模式的合并指令。
无版本号
更新 claude-api 技能:Managed Agents 七月发布浪潮、合作伙伴定价、工具运行器更正 (#1463) 将 claude-api 技能与当前上游源同步。 ## Managed Agents — 五项新功能 - agent 的 `model` 对象上的 `effort`(级别字符串或 `{"type": ""}`)。 它仅属于 agent 配置:在按会话的 `model` 覆盖中设置它会被 静默忽略。 - agent 更新上的可选 `version`,用于乐观并发。省略它则 最后写入胜出。 - 会话创建时的 `initial_events`,将创建和首次发送合并为一次 调用。验证是全有或全无,且仅接受 `user.message` 和 `user.define_outcome`。 - 环境和内存存储 webhook:四个 `environment.*` 事件和三个 `memory_store.*` 事件。 - 按线程流的事件增量。预览是线程作用域的,因此子 线程的预览永远不会到达会话级流。 ## 对技能已记录行为的更正 - 工具输出卸载在 100,000 个字符(约 25k token)时触发,而不是 100K token,并且涵盖内置工具,而不仅是 MCP。 - `system.message` 在四个模型上可用,仅检查主模型,追加 系统上下文而不是替换提示,并且在 `requires_action` 空闲期间、当它尾随同一请求中的工具结果时被接受。 - Vault 到 MCP 的凭据匹配是规范化的(scheme 和 host 转为小写、 去除默认端口和尾部斜杠),而不是字节精确。 - 多智能体深度大于 1 是验证错误,而不是被静默忽略。 - 结果 `interrupted` 即使在评估从未开始时也会触发,然后 携带空字符串 `outcome_evaluation_start_id`。 - 部署抖动为运行间隔的 15%,下限 5 秒,上限 9 分钟。 - Webhook 重试三次,采用 5-120 秒的抖动退避,然后静默丢弃。 自动禁用基于持续时间,有三个命名触发器。 - `session.status_terminated` 表示完成或错误。 - `agent.thinking` 是进度信号,不携带 thinking 内容。 - 对于 `user.define_outcome`、`user.custom_tool_result` 和 `user.tool_result`,`processed_at` 在首次出现时已填充。 - 会话创建不会预置沙箱。 - Skill `version` 也适用于 Anthropic 编写的技能。 - Console 创建的 vault 凭据仅用于头注入,且 vault 环境变量替换会跳过 URL 路径中的机密。 - 当 API 密钥不在 Default 工作区时,Console 跟踪 URL 需要真实的工作区 ID。 ## 技能其他部分 - 在第一方价格表下注明合作伙伴定价:Microsoft Foundry 按标准 API 费率计费,而 Amazon Bedrock 和 Vertex AI 是 合作伙伴运营,定价单独计算。 - 更正工具运行器的人在环指导,此前它让读者 对运行器按轮次钩子已覆盖的批准门控使用手动循环。 - 将链接从已退役的文档主机重新指向。 - 去重 SKILL.md 中已被各章节文件覆盖的急切加载内容。
无版本号
更新 claude-api 技能:Claude Sonnet 5 和 Managed Agents 七月更新 (#1373)
无版本号
更新 claude-api 技能:按 SDK 拆分文档、code_execution_20260521、平台可用性、入门流程精简 (#1363)
无版本号
更新 claude-api 技能:计划部署、vault 环境变量凭据、system.message 事件 (#1297) - 新增 Managed Agents 计划部署:新增 shared/managed-agents-scheduled-deployments.md(cron 计划、部署 运行、暂停/自动暂停)、Deployments 和 Deployment Runs API 参考、 beta 头覆盖,以及 SKILL.md 路由 - Vault environment_variable 凭据:机密在出口处替换,配合 网络允许列表;工具、客户端模式和入门文档中的机密指导围绕它们重写;注明自托管沙箱注意事项 - 在事件指南和 API 参考中新增用于会话中途系统提示更新的 system.message 事件(仅 Opus 4.8)
无版本号
更新 claude-api 技能:Claude Fable 5 和 Claude Mythos 5 (#1294) - 将 Claude Fable 5 和 Claude Mythos 5 加入模型表,包含定价、 上下文窗口和模型选择指导 - 记录 Fable 特有的 API 行为:始终开启的自适应思考(显式 禁用返回 400)、受保护 thinking 的显示和重放规则、新 分词器(约多 30% token)、带服务端回退的拒绝停止原因 和 SDK 回退中间件、30 天数据保留要求 - 新增完整的“迁移到 Claude Fable 5”指南章节和检查清单, 包括 Mythos Preview 迁移路径 - 刷新技能触发描述、effort/压缩/任务预算说明、 缓存最小值、结构化输出和动态过滤支持表
无版本号
更新 claude-api 技能:认证、云提供商、Managed Agents 修复、token 计数 (#1276) * 将 claude-api 技能与最新上游更新同步 - 新增 token-counting.md 和 SKILL.md 触发描述更新 - 新增认证指导:环境凭据解析、ant auth login、OAuth/WIF 文档链接、401 原因 - 将对话中途系统消息(beta)加入提示缓存、agent-design、SKILL.md、Python/TS README - 在提示缓存中新增缓存预热(max_tokens: 0)章节 - 在入门和概览中新增 Managed Agents 预检可行性检查 - 在 model-migration 中新增 Bedrock 模型 ID 章节;在 live-sources 中新增 Bedrock 行 - 新增 /claude-api migrate 子命令行和 migrate 条目标注 - 修复 MA 网络配置:带 allow_package_managers/allow_mcp_servers 的 limited 类型 - 将 MA 创建操作速率限制提升至 300 RPM - 修复 MA SDK 漂移:sessions.events.stream()、event.name、类型化事件数组 - 新增 SDK 覆盖:stop_details、error .type、C# 工具运行器 + MA 支持、Go 模型常量、Java 2.34.0、客户端配置、响应辅助函数、自动分页、advisor 工具 - 在 models.md 中将 Sonnet 4 / Opus 4 移至已弃用 * 将 Anthropic CLI 和 AWS 上 Claude Platform 文档加入 claude-api 技能 - 新增 shared/anthropic-cli.md:安装、认证配置文件、OAuth 作用域、命令 结构、版本控制的 Managed Agents 资源、凭据陷阱 - 新增 shared/claude-platform-on-aws.md:AnthropicAWS 客户端、SigV4 认证、 workspace_id、区域、功能可用性 - 在 SKILL.md 和 managed-agents 文档中恢复对这两个文件的交叉引用(此前被改写为 live-sources.md 指针) - 在 SKILL.md、迁移指南章节和 live-sources 行中恢复 AWS 上 Claude Platform 的提供商分类
无版本号
向 claude-api 技能添加 Opus 4.8 迁移指南和模型更新 (#1216) * 向 claude-api 技能添加 Managed Agents 自托管沙箱 + 会话中途 agent 更新 + MCP 工具输出卸载 自托管沙箱:新增 shared/managed-agents-self-hosted-sandboxes.md,用于 config:{type:"self_hosted"} — agent 循环在 Anthropic 的编排上运行,工具执行通过出站轮询 worker 在客户基础设施上运行。涵盖 EnvironmentWorker.run()/.run_one()(Py/TS)、ant beta:worker poll/run、中层 work.poller()/WorkPoller(仅 Py/TS/Go;Go 没有 auto_stop 退出选项)、AgentToolContext/beta_agent_toolset/tool_runner()、监控(environments.work.stats/stop — x-api-key,从 worker 主机外部调用)、运行时依赖、云与 self_hosted 差异表、凭据、安全责任划分。在 environments.md、overview.md(阅读指南 + 重写仅云陷阱)、api-reference.md(SDK 行 + 命名怪癖 + schema + work REST 行)、tools.md(谁运行它的例外)、onboarding.md、live-sources.md 中交叉引用。 会话中途 agent 更新:sessions.update(session_id, agent={tools, mcp_servers}, vault_ids=[...]) — 会话本地覆盖(不会提升 agent 版本)、完全替换语义、会话必须空闲。新增 core.md 章节 + tools.md、api-reference.md(UpdateSession 行)、overview.md 中的指引。 大型 MCP 工具输出 → 文件:>100K token → 自动卸载到沙箱文件;agent 获得截断预览 + 路径。另外:无效 vault 凭据不会阻止 sessions.create() — 触发 session.error 事件,认证在下次 idle→running 时重试。两者均在 tools.md 中。 * 将 ant CLI 安装引用指向 live-sources.md(OSS 没有 anthropic-cli.md) * 向 claude-api 技能添加 Opus 4.8 模型迁移指南 * 向 claude-api 技能添加 Opus 4.8 的规范性工具描述指导
无版本号
添加 CMA claude-api 技能更新 (#1164) * 向 claude-api 技能添加 Managed Agents 自托管沙箱 + 会话中途 agent 更新 + MCP 工具输出卸载 自托管沙箱:新增 shared/managed-agents-self-hosted-sandboxes.md,用于 config:{type:"self_hosted"} — agent 循环在 Anthropic 的编排上运行,工具执行通过出站轮询 worker 在客户基础设施上运行。涵盖 EnvironmentWorker.run()/.run_one()(Py/TS)、ant beta:worker poll/run、中层 work.poller()/WorkPoller(仅 Py/TS/Go;Go 没有 auto_stop 退出选项)、AgentToolContext/beta_agent_toolset/tool_runner()、监控(environments.work.stats/stop — x-api-key,从 worker 主机外部调用)、运行时依赖、云与 self_hosted 差异表、凭据、安全责任划分。在 environments.md、overview.md(阅读指南 + 重写仅云陷阱)、api-reference.md(SDK 行 + 命名怪癖 + schema + work REST 行)、tools.md(谁运行它的例外)、onboarding.md、live-sources.md 中交叉引用。 会话中途 agent 更新:sessions.update(session_id, agent={tools, mcp_servers}, vault_ids=[...]) — 会话本地覆盖(不会提升 agent 版本)、完全替换语义、会话必须空闲。新增 core.md 章节 + tools.md、api-reference.md(UpdateSession 行)、overview.md 中的指引。 大型 MCP 工具输出 → 文件:>100K token → 自动卸载到沙箱文件;agent 获得截断预览 + 路径。另外:无效 vault 凭据不会阻止 sessions.create() — 触发 session.error 事件,认证在下次 idle→running 时重试。两者均在 tools.md 中。 * 将 ant CLI 安装引用指向 live-sources.md(OSS 没有 anthropic-cli.md)
无版本号
修复 managed-agents API 参考中的模型配置形状 (#1145) agent 创建时的 model 字段接受 {id, speed},而不是 {type: "model_config", id, speed}。与 managed-agents-core.md 中其他位置记录的 形状以及请求体表保持一致。
无版本号
向 claude-api 技能添加 Managed Agents 结果、多智能体和 webhook (#1096)
无版本号
从 Files API 示例中移除不存在的 purpose 字段 (#1081) Files API 上传端点不接受 purpose 参数。 从 managed-agents 技能示例(TS 和 curl)中删除它。
无版本号
向 claude-api 技能添加 Managed Agents 内存存储页面 (#1014) 新增 shared/managed-agents-memory.md,涵盖 managed-agents-2026-04-01 下的 Memory Stores 公开 beta:对象模型(memstore_/mem_/ memver_)、创建 + 播种、在会话创建时通过 resources[] 附加、 在 /mnt/memory// 处 FUSE 挂载、主机侧 CRUD,包含按路径创建 与按 id 更新、content_sha256 前置条件,以及版本/脱敏。 将其接入所有交叉引用:SKILL.md beta 头命名空间 和阅读指南;api-reference SDK 方法行、删除/归档怪癖 要点、AddResource 说明,以及三个新端点章节;core.md 架构图和 resources[] 枚举;environments.md Resources 简介;overview.md beta 头表、阅读指南行,以及 归档即永久要点。
无版本号
填写 claude-api LICENSE.txt 中的 Apache 2.0 版权声明 (#990) 将 [yyyy] [name of copyright owner] 占位符替换为 实际版权持有者,使许可证归属明确。
无版本号
chore: 更新 claude-api 技能 (#956) 新增 shared/model-migration.md,并刷新所有语言指南中的模型引用、managed agents 文档和技能描述。
无版本号
修复技能 yaml 渲染 (#898) Made-with: Cursor
无版本号
为 claude-api 的 SKILL.md 添加正确的 front-matter (#897) * 为 claude-api 的 SKILL.md 添加正确的 front-matter 添加包含 name、description 和 license 信息的元数据部分。 * 应用来自 @ericharmeling 的建议 --------- Co-authored-by: Eric Harmeling
无版本号
用 Managed Agents 指导更新 claude-api 技能 (#891) * 用 Managed Agents 指导更新 claude-api 技能 * 在 claude-api 技能中将 OPUS_ID 占位符替换为具体模型字符串 * 将剩余模型占位符替换为具体模型名称和 ID
无版本号
chore: 更新 claude-api 技能 [auto-sync] (#730) Co-authored-by: github-actions[bot]
无版本号
chore: 更新 claude-api 技能 [auto-sync] (#729) co-sign Co-authored-by: github-actions[bot]
无版本号
添加 claude-api 技能 (#515) 用于使用 Claude API 和 Agent SDK 构建应用程序的文档技能。涵盖 Python、TypeScript、Java、Go、Ruby、C#、PHP 和 cURL,并提供针对以下内容的语言特定指南: - Messages API 基础、流式传输和错误处理 - 工具使用(工具运行器和手动智能体循环) - 结构化输出和自适应思考 - Batches 和 Files API - Agent SDK 模式(Python/TypeScript) - 模型目录和选择指导

暂无评论

none
暂无评论...