技能介绍

你在对接什么

把 Claude 接进现有项目时，常见痛点不是「会不会调 HTTP」，而是：该用 Messages 单次调用、自管工具循环，还是托管代理；多语言项目里 SDK 导入路径和方法签名很容易按训练记忆写错；2025–2026 年 API 在 thinking、web_search 工具类型、PHP 参数命名等细节上也有漂移。若目标文件里仍是 OpenAI / LangChain OpenAI 等痕迹，直接改成 Anthropic 调用还可能违背项目意图。

技能如何引导实现

技能要求先扫描目标文件或项目上下文中的非 Anthropic 标记（如 import openai、gpt-4、*-generic.py 等）。发现冲突时停止并说明：本技能产出的是 Claude / Anthropic SDK 代码，由你选择迁移到 Claude 还是保留原栈。

实现 Claude 功能时，代码须通过 项目官方 Anthropic SDK（anthropic、@anthropic-ai/sdk 等）或用户明确要求的 原始 HTTP 调用，且二者不混用；禁止用 OpenAI 兼容层「凑合」。函数名、导入路径须来自技能内 {lang}/ 文档或 shared/live-sources.md 中的官方来源，不凭记忆猜测。

工作流上：按扩展名与项目文件 检测语言，读取对应 python/、typescript/、java/ 等文档；用决策表区分单次调用、工作流 + 工具、托管代理；默认模型为 claude-opus-4-8，复杂场景用 thinking: {type: "adaptive"}，长输入/输出倾向流式。子命令 migrate 会按 shared/model-migration.md 执行迁移（先确认文件范围与目标模型）。

边界与注意点

不支持的语言建议走 curl/ 原始 HTTP，勿臆造社区 SDK API。
Claude Platform on AWS、Bedrock、Vertex、Foundry 的功能差异以技能内 shared/platform-availability.md 为准，勿自行推断。
网络无法拉取官方仓库时，可在本地编译/解释器错误上迭代，尤其对 C#/Java/Go 等静态类型 SDK。
Fable 5（claude-fable-5）与 Opus 层在思考、拒绝回退、数据保留等语义上不同，需单独阅读迁移说明。

截图预览

使用场景

Python 或 TypeScript 服务要新增对话/摘要能力，需按项目语言选用官方 SDK 调用 POST /v1/messages，并默认 claude-opus-4-8 与流式。
代码里仍使用 thinking 的 budget_tokens 或旧版 web_search 工具名，需按 model-migration 迁移到 adaptive thinking 与新工具类型字符串。
多步任务需自定义工具编排，要判断用 Claude API + 工具运行器自管循环，还是改用托管代理与会话工作区。
改文件前发现 import openai 或 gpt-4 相关命名，需先确认是迁移到 Claude SDK 还是保持非 Anthropic 实现不变。

适合人员

维护同时存在 OpenAI 与 Claude 集成路径的后端工程师，要求新代码只走 Anthropic 官方 SDK 或明确约定的原始 HTTP
负责把生产环境从 Opus 4.6/旧 API 形状升级到 4.8 的平台工程师，需要按文件范围执行 migrate 与破坏性变更检查
用 Java/Go/Ruby/C#/PHP 接 Claude 的集成开发，需要按语言子目录文档写对包名、方法签名，避免从 Python SDK 臆造 API
在 AWS Claude Platform、Bedrock 或 Vertex 上部署的团队，需对照 platform-availability 确认思考、工具、托管代理等功能是否可用