<!-- Lazu · Claude Code 接 GPT 和 DeepSeek：Lazu 的协议层怎么转换请求 · https://lazu.ai/zh/blog/lazu-protocol-layer -->

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

2026-10-21 · Lazu 团队

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

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

## 你能直接用到的

### Claude Code 用 GPT 或 DeepSeek

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

```bash
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：

```bash
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 会在发请求之前拒绝，并告诉你是哪个字段：

```json
{
  "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 网关的对比](https://lazu.ai/docs/zh/compare/overview#协议) 的“协议”一节。

