Claude Code 接 GPT 和 DeepSeek:Lazu 的协议层怎么转换请求

Guide Claude Code 接 GPT 和 DeepSeek claude-sonnet-5-5gpt-6-luna Lazu

先说结论:同一把 Lazu Key,Claude Code 可以用 GPT 和 DeepSeek,OpenAI 的 SDK 可以用 Claude,工具调用和流式输出都照常工作。这背后是我们这个月重写的协议层:三种 API 格式之间的转换,现在走同一套规则。

这篇讲三件事:你能直接用到什么、这套设计守的三条原则、我们怎么确认它没有转错。

你能直接用到的 #

Claude Code 用 GPT 或 DeepSeek #

Claude Code 只会说 Anthropic 的 Messages 协议。把它指向 Lazu 之后,模型名换成别家的就行:

export ANTHROPIC_BASE_URL=https://api.lazu.ai
export ANTHROPIC_AUTH_TOKEN=sk-lazu-...
claude --model deepseek-flash

读文件、改代码这些工具调用会正常发出和返回,流式输出不卡顿。我们在上线后用同样的工具定义测了 claude-haiku-5-5、deepseek-flash 和 gpt-6-luna,三个模型都正确调用了工具。

GPT-6 有个限制:在 Chat Completions 接口上,它要求关掉推理才能调用工具。Claude Code 的请求如果点名要了推理强度,而渠道支持 Responses 接口,Lazu 会改走 Responses,推理和工具都保留。只有在只支持 Chat 的渠道上,才会关掉推理来完成这次工具调用。

OpenAI SDK 用 Claude #

用 OpenAI 的 Responses 接口,现在可以直接选 Claude:

curl https://api.lazu.ai/v1/responses \
  -H "Authorization: Bearer sk-lazu-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-haiku-5-5", "input": "hi"}'

流式输出、函数调用、推理摘要都会按 Responses 的事件格式返回。用 Chat Completions 的 SDK 调 Claude 也一样,reasoning_effort 会换算成 Claude 的思考设置。

Codex 接 Claude 目前还不行。Codex 默认会带上 web_search 这类由 OpenAI 托管的工具,并要求返回加密的推理内容,这两样在 Claude 那边都没有对应。Lazu 会直接拒绝,并在报错里写明是哪个字段,不会悄悄去掉它们。

用量和你的账单对得上 #

  • 命中的缓存会算进 prompt_tokens,这是 OpenAI 格式的口径。结算仍按 Anthropic 的分项计价,缓存读取按缓存价收。
  • Chat 流式请求开了 stream_options.include_usage,结尾会单独返回一块 choices 为空的用量,和 OpenAI 的格式一致。
  • 上游没报用量时,Lazu 按输出估算,工具调用的函数名、参数和每次调用的固定开销都会算进去。

三条原则 #

一次转换,不做两两翻译 #

以前每对协议之间各有一份手写的转换器。三种协议两两组合就是六份,每份都要处理同样的细节,改一处容易漏一处。

现在所有请求先解析成同一份中间表示,再按上游的协议写出去。响应也一样:先解析成一串统一的事件,再按客户端的协议写回去。计费、重试、退款这些逻辑只在中间写一次,三种协议共用。

能等价转换才转换,转不了就说清楚 #

协议之间有些东西没有对应。比如 Claude 一次只生成一个回答,而 Chat Completions 可以用 n 要多个。以前遇到这种情况,转换器常常悄悄丢掉字段,请求照样成功,结果却不是你要的。

现在 Lazu 会在发请求之前拒绝,并告诉你是哪个字段:

{
  "error": {
    "message": "unsupported feature sampling.n at n: a Messages bridge supports exactly one output",
    "code": "protocol_bridge_unsupported",
    "param": "n"
  }
}

拒绝发生在路由阶段。如果同一个模型有别的渠道能原样处理这个请求,Lazu 会先换渠道,而不是直接报错。

降级有登记,而且一定告诉你 #

有一种情况我们允许降级:渠道明确不支持某个功能,而有一个公认可靠的替代办法。目前登记在案的只有一类:渠道不支持 json_schema,就退成 json_object,把 schema 写进提示词;连 json_object 也不支持,就只写进提示词。

每条降级规则都写明了理由和出处。降级发生时,响应头 X-Lazu-Warning 会写明用了哪条规则,请求详情里也看得到。没登记的情况一律不降级,按上一条原则拒绝。

改走另一个接口也会写进这个响应头。比如 DeepSeek 的 Chat 接口不接受 json_schema,它的 Responses 接口接受。带 json_schema 的 Chat 请求发到 deepseek-flash,Lazu 会改走 Responses,结果照常返回,响应头里写着:

X-Lazu-Warning: endpoint_bridge:output.json_schema

怎么确认没有转错 #

  • 录下来的真实响应。 我们从各家上游录了真实的流式响应,覆盖文本、思考、工具调用、结构化输出和出错的情况。每次改动都要用这些录音跑一遍。
  • 新旧对照。 旧转换器下线之前,新协议层的每一项输出都要和旧转换器对比,结果必须一致;不一致的地方要么是旧代码的 bug,要么新代码得改。
  • 上线后实测。 每次发版后,用真实请求把三种协议和四家模型交叉测一遍,包括流式和工具调用。

第三条是这次真用上的。协议层第一次上线时,所有测试都通过了,上线后的实测却发现:配置了参数覆盖(param_override)的 Claude 渠道,会拒绝 Chat 格式的请求。原因是新代码把渠道的参数覆盖当成了 OpenAI 格式,但这些渠道的覆盖本来就是按 Anthropic 格式写的。我们在 8 分钟内回滚,修好后重新发布。那段时间的请求全部来自我们自己的测试 Key,没有影响到用户。

还没做完的 #

  • Codex 接 Claude:要先给托管工具和加密推理找到可靠的对应方式。
  • Gemini 格式的客户端(比如用 Google SDK 直接调 Lazu)还走旧的转换路径。新的 Gemini 转换代码已经写好,正在和旧路径做对照,接上之后会单独说明。
  • 有些边界情况,我们暂时选择照常转发而不是拒绝。比如 Claude 的 JSON schema 发到 OpenAI 时,不会自动打开 OpenAI 的严格模式,因为严格模式要求的条件更多,会让一部分合法的 schema 报错。

有转换结果不对的请求,把响应里的 request_id 发给我们,我们会逐条查。

其他网关怎么处理协议、哪些会在格式之间转换,见 Lazu 与其他 LLM 网关的对比 的“协议”一节。

相关文章
2026-11-18OpenCode 接入第三方模型:一把 Key 切换 Claude、GPT 与 DeepSeek 2026-11-18网关对 Claude Code 的契约:十件会让它卡住或静默出错的事 2026-09-30国内怎么用 Claude API:直连、支付宝充值与价格

拿一个 Key 试试

免费开始