用途:把现有 OpenAI/GPT 集成迁移到 Anthropic/Claude,梳理 API 差异、SDK 替换与工具调用改造。资料给出完整的 API 映射(端点、模型、响应结构)、SDK 前后代码对比、五个关键差异、工具调用迁移与 grep 查找替换步骤。
主要能力:一是 API 映射,如 openai.chat.completions.create() 对应 anthropic.messages.create(),模型 ID 由 gpt-4o 换为 claude-sonnet-4-20250514,响应路径由 response.choices[0].message.content 改为 response.content[0].text,system 从 messages 数组改为独立顶层参数;json_object 无原生 JSON 模式,改由系统提示要求仅输出 JSON;OpenAI embeddings 无对应接口,资料建议使用 Voyage 或 Cohere。二是 SDK 替换,import OpenAI from 'openai' 改为 import Anthropic from '@claude-ai/sdk',并给出调用前后对照。三是关键差异:max_tokens 必填;system 为顶层参数;首条消息必须为 user;消息须交替;响应结构与流式事件不同。四是工具定义改为 { name, input_schema } 的扁平结构。
使用方式:先定位 OpenAI 引入与响应访问模式,资料给出 grep -rn "from 'openai'" --include=".ts" .、grep -rn "import OpenAI" --include=".ts" .、grep -rn "choices[0]" --include="*.ts" . 等命令,再逐项替换响应路径、把系统提示移到 system 参数、为所有调用补上 max_tokens、重构工具定义。
适用场景:已有可迁移的 OpenAI 集成、代码库可搜索、且有测试套件可对比两家输出的项目。限制:资料未提供依赖安装命令、具体错误码细节及性能或收费信息,错误排查仅指向 clade-common-errors,生产模式另见 clade-sdk-patterns;未提供的内容暂未明确。