OpenAI SDK 兼容性

Anthropic 提供了一个兼容层，使您能够使用 OpenAI SDK 来测试 Claude API。只需少量代码更改，即可快速评估 Anthropic 模型的能力。

OpenAI SDK 入门

要使用 OpenAI SDK 兼容功能，您需要：

1. 使用官方 OpenAI SDK
2. 更改以下内容
   • 更新您的基础 URL 以指向 Claude API
   • 将您的 API 密钥替换为 Claude API 密钥
   • 更新您的模型名称以使用 Claude 模型
3. 查阅以下文档了解支持的功能

快速开始示例

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-4-7",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "ANTHROPIC_API_KEY", // Your Claude API key
  baseURL: "https://api.anthropic.com/v1/" // Claude API endpoint
});

const response = await openai.chat.completions.create({
  messages: [{ role: "user", content: "Who are you?" }],
  model: "claude-opus-4-7" // Claude model name
});

console.log(response.choices[0].message.content);

重要的 OpenAI 兼容性限制

API 行为

以下是使用 OpenAI 时最显著的差异：

• 函数调用的 strict 参数会被忽略，这意味着工具使用的 JSON 不保证遵循提供的模式。如需保证模式一致性，请使用原生 Claude API 的结构化输出。
• 不支持音频输入；它将被忽略并从输入中移除
• 不支持提示缓存，但在 Anthropic SDK 中支持
• System/developer 消息会被提升并拼接到对话的开头，因为 Anthropic 仅支持单个初始系统消息。

大多数不支持的字段会被静默忽略而不是产生错误。以下均有文档记录。

输出质量考虑

如果您对提示进行了大量调整，它很可能专门针对 OpenAI 进行了优化。考虑使用 Claude 控制台中的提示改进器作为良好的起点。

System / developer 消息提升

OpenAI SDK 的大多数输入都可以直接映射到 Anthropic 的 API 参数，但一个显著的差异是 system / developer 提示的处理。这两个提示可以通过 OpenAI 放置在整个聊天对话中。由于 Anthropic 仅支持初始系统消息，API 会将所有 system/developer 消息拼接在一起，中间用单个换行符 (\n) 分隔。然后将此完整字符串作为单个系统消息提供在消息的开头。

扩展思考支持

您可以通过添加 thinking 参数来启用扩展思考功能。虽然这可以改善 Claude 在复杂任务中的推理能力，但 OpenAI SDK 不会返回 Claude 的详细思考过程。如需完整的扩展思考功能，包括访问 Claude 的逐步推理输出，请使用原生 Claude API。

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),
    base_url="https://api.anthropic.com/v1/",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)

const response = await openai.chat.completions.create({
  messages: [{ role: "user", content: "Who are you?" }],
  model: "claude-sonnet-4-6",
  // @ts-expect-error
  thinking: { type: "enabled", budget_tokens: 2000 }
});

速率限制

速率限制遵循 Anthropic 对 /v1/messages 端点的标准限制。

详细的 OpenAI 兼容 API 支持

请求字段

简单字段

tools / functions 字段

Show fields

messages 数组字段

Show fields

响应字段

错误消息兼容性

兼容层保持与 OpenAI API 一致的错误格式。但是，详细的错误消息不会等效。仅将错误消息用于日志记录和调试。

请求头兼容性

虽然 OpenAI SDK 会自动管理请求头，但以下是 Claude API 支持的完整请求头列表，供需要直接处理它们的开发者参考。