国内调用 Claude 官方接口，常遇到网络超时和境外支付两个问题。一个通用的工程做法是：通过兼容 OpenAI 接口规范的网关层来调用——这样现有 OpenAI SDK 代码几乎不用改。本文走一遍配置与排错。

1. 原理：为什么用 OpenAI 兼容接口

OpenAI 的 /v1/chat/completions 已是事实标准，很多 SDK、RAG、Agent 框架默认按它对接。只要你的调用入口实现了这套规范，切换底层模型就只是改 model 参数，不必为每家厂商重写请求与解析逻辑。

2. 准备：一个兼容 OpenAI 的入口

你需要一个兼容 OpenAI 接口的调用地址（Base URL）和一把 API Key。这类入口有几种来源：官方/云厂商网关、自建网关（如开源的 OneAPI），或第三方统一接入服务（如 OneAPI、聚合服务 等，按需自行实测选择）。下面用占位地址演示，换成你自己的即可。

3. SDK 配置

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("BASE_URL", "YOUR_BASE_URL/v1"),  # 换成你的入口
    api_key=os.getenv("API_KEY"),
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "把这段函数改成异步实现"}],
)
print(resp.choices[0].message.content)

4. 多模型切换

只改 model，同一套代码即可在不同模型间切换：

for model in ["claude-sonnet-4-6", "gpt-4o", "deepseek-chat"]:
    r = client.chat.completions.create(
        model=model, messages=[{"role": "user", "content": "hello"}])
    print(model, "->", r.choices[0].message.content[:40])

建议把模型名做成配置项，按场景切换。

5. 流式输出

stream = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "写一首五言绝句"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

6. 常见问题排错

• 401/403：检查 API Key 与 Base URL 是否匹配；
• 模型名报错：不同入口对模型名命名略有差异，先确认对方支持的模型列表；
• 超时：调高客户端 timeout，并对失败做重试；
• 乱码/截断：确认编码与 max_tokens 设置。

7. 小结

国内调用 Claude，核心是用兼容 OpenAI 的接口把网络与对接成本降下来：现有 SDK 代码改一个 Base URL 即可跑，多模型切换只改 model。具体入口按你的网络环境与预算自行选型实测。