很多开发者上手 Claude Agent SDK 后，第一个问题就是：这个 SDK 只能用 Anthropic 的模型吗？能不能接国内大模型？
毕竟国内场景里，DeepSeek 性价比、Qwen 的中文理解、MiniMax 的多模态能力，都有不可替代的场景。
这篇文章从架构到代码，把接入路径讲清楚。
先给结论
Claude Agent SDK 没有强制绑定 Claude 模型——但它做了三个重要的假设，直接换国产模型会踩坑：
- 工具调用格式：SDK 期望模型输出特定的 XML 格式工具调用
- 推理能力：Agent Planner 需要模型能做结构化推理和分步规划
- 上下文格式：消息历史、系统 prompt 的编排是针对 Claude 优化的
好消息是：这三层都可以通过适配层解决。DeepSeek V4、Qwen 3.5、MiniMax 01 都能跑通完整的 Agent 工作流。
架构上怎么接入
Claude Agent SDK 内部有三层抽象，你可以替换任意一层：
┌─────────────────────────────────────────┐ │ Agent Runtime (工具调用、状态) │ ├─────────────────────────────────────────┤ │ Model Provider (LLM 接口) │ ← 替换这一层 ├─────────────────────────────────────────┤ │ Transport (HTTP / 本地) │ └─────────────────────────────────────────┘最简单的做法是实现自定义的 Model Provider，保持上层 Agent Runtime 不动。
方案一：OpenAI 兼容接口适配
大部分国产大模型（DeepSeek、Qwen、MiniMax、Zhipu）都提供 OpenAI 兼容的 API 接口。
你只需要写一个 Provider 包装器：
fromanthropic_agent.providersimportBaseProviderfromopenaiimportOpenAIclassOpenAICompatProvider(BaseProvider):"""兼容国产大模型的 Provider"""def__init__(self,api_key:str,base_url:str,model:str):self.client=OpenAI(api_key=api_key,base_url=base_url)self.model=modeldefchat(self,messages,tools=None,**kwargs):# 将 Claude 格式转换为 OpenAI 格式openai_messages=self._convert_messages(messages)openai_tools=self._convert_tools(tools)iftoolselseNoneresponse=self.client.chat.completions.create(model=self.model,messages=openai_messages,tools=openai_tools,temperature=kwargs.get("temperature",0)
