Claude OpenAI 兼容 API — 用 OpenAI SDK 调用 Claude

什么时候用这个兼容层

• 如果你的现有代码已经基于 OpenAI SDK 或 Chat Completions payload，这条路线最省迁移成本。
• 如果你希望获得更原生、更直接的 Claude 行为与排障体验，请使用原生 /v1/messages。
• 对于 Cursor、Cline、Roo Code、Kilo Code 这类 OpenAI 风格工具，通常默认就应该走这条兼容路线。

端点

POST https://api3.claudestore.store/v1/chat/completions

Headers:
  Authorization: Bearer sk-cs2-...
  content-type: application/json

Python — OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-cs2-...",
    base_url="https://api3.claudestore.store/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4.6",
    messages=[
        {"role": "user", "content": "你好，介绍一下你自己"}
    ]
)
print(response.choices[0].message.content)

TypeScript — openai 包

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-cs2-...",
  baseURL: "https://api3.claudestore.store/v1",
});

const completion = await client.chat.completions.create({
  model: "claude-sonnet-4.6",
  messages: [{ role: "user", content: "你好" }],
});

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

迁移指南

重要兼容性说明

• 必须使用 Authorization: Bearer YOUR_API_KEY，并且 base URL 要带 /v1。这条路和原生 Anthropic 格式不是同一个端点。
• system / developer 指令可能会被当作一条合并后的顶层指令来处理，而不是完全独立的多轮消息。
• 某些只属于 OpenAI 生态的参数，如果在 Claude 原生行为里没有直接对应关系，可能会被忽略。
• 即使 OpenAI 客户端暴露了 strict tool schema 等开关，也不要默认认为它一定能带来严格模式保证。
• 如果某个能力通过 Chat Completions 表达起来很别扭，最直接的做法通常是改用原生 /v1/messages。