很多开发者上手 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)