从 GPT-5 到 Claude 4：API 迁移实战指南
如果你正在使用 OpenAI GPT-5 API 构建应用，你可能已经听说了 Anthropic Claude 4 系列（Opus 4.7 / Sonnet 4.6 / Haiku 4.5）在多项基准测试中取得领先。根据最新的评测数据，Claude 4 系列在代码生成、长文本理解和复杂推理方面均表现优异，价格还比 GPT-5 更亲民。本文将带你完成从 GPT-5 到 Claude 4 的完整迁移流程，包括代码改写、提示词适配和成本优化。
为什么要从 GPT-5 迁移到 Claude 4？
先看核心差异：价格。GPT-5 每百万输入 Token 收费 15 美元，Claude Opus 4.7 只需要 10 美元——便宜了 33%。输出 Token 的差距更大：GPT-5 收 60 美元/百万 Token，Opus 只要 40 美元。
再看能力：
- 代码生成：Claude 4 系列在 SWE-bench、HumanEval 等编程基准中领先，尤其擅长复杂工程任务。
- 长文本理解：Claude 原生支持 200K Token 上下文窗口，且长文本质量衰减比 GPT-5 更慢。
- 工具调用：Claude 的 Tool Use 支持更灵活的 JSON Schema 定义，并行调用也更成熟。
- Prompt Caching：Claude 的缓存机制让重复上下文的成本降低 90%，GPT-5 虽然也有类似功能，但限制更多。
如果你的应用涉及大量代码分析、长文档处理或多轮复杂对话，迁移带来的性价比提升非常明显。
API 设计差异：你需要注意的关键点
两者都是标准的 REST API，但细节不同。最大的差异在请求格式和 Token 处理。
认证方式：OpenAI 用Authorization: Bearer，Anthropic 用x-api-key。如果你在用 LangChain 或 LiteLLM，切换只是一行配置。但如果你直接调 HTTP，以下是核心差异：
| 特性 | GPT-5 (OpenAI) | Claude 4 (Anthropic) |
|---|---|---|
| API 端点 | /v1/chat/completions | /v1/messages |
| 认证头 | Authorization: Bearer sk-xxx | x-api-key: sk-ant-xxx |
| 模型参数 | model: "gpt-5" | model: "claude-opus-4-7" |
| 角色名 | system,user,assistant | user,assistant（system 单独放顶层） |
| 最大 Token | max_completion_tokens | max_tokens |
| 温度 | temperature: 0-2 | temperature: 0-1 |
消息格式是最容易踩坑的地方。OpenAI 的格式是：
{"model":"gpt-5","messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"Hello!"