Python 调用 Claude API 教程：OpenAI SDK 兼容写法

安装 Python 依赖

推荐直接使用 OpenAI 官方 Python SDK 的兼容写法。这样后续从 Claude 切换到 GPT、Gemini 或其他模型时，代码改动更少。

pip install openai

最小可用调用示例

把 api_key 换成你在 ClaudeGPT API 控制台创建的 Key，把 model 换成控制台支持的模型名称。

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://b.onerouter.com/openai/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet",
    messages=[
        {"role": "system", "content": "你是一个严谨的中文技术助手。"},
        {"role": "user", "content": "用三句话解释 RAG 是什么。"}
    ]
)

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

流式输出示例

聊天应用、客服机器人和 AI 编程工具建议使用流式输出，可以更快看到首字响应。

from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="https://b.onerouter.com/openai/v1"
)

stream = client.chat.completions.create(
    model="claude-sonnet",
    messages=[
        {"role": "user", "content": "写一个 Python 读取 CSV 的示例。"}
    ],
    stream=True
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

适合哪些 Python 项目

RAG 知识库问答
客服机器人和微信机器人
批量文本摘要、分类、翻译和改写
AI Agent、LangChain、LlamaIndex 项目
内部自动化脚本和数据处理工具

常见错误排查

401 Unauthorized

通常是 API Key 错误、复制不完整或 Key 被禁用。建议重新创建 Key 后测试。

402 Payment Required

通常是余额不足。先领取测试额度或小额充值，再跑真实业务样本。

429 Rate Limit

请求过快或上游限流。降低并发、增加指数退避重试，必要时切换备用模型。可参考 Claude API 429 解决办法。

成本优化建议

Python 批处理脚本最容易因为循环调用造成成本失控。建议先用 50-100 条真实样本估算单次成本，再扩大调用量。长 prompt 要尽量模板化、压缩化，避免每次请求重复塞入无关上下文。

Python 调用 Claude API：用 OpenAI SDK 兼容接口快速跑通