大模型应用开发实战(9)——一文搞懂Claude Code、ChatGPT 的 SDK

张开发
2026/4/15 20:14:53 15 分钟阅读

分享文章

大模型应用开发实战(9)——一文搞懂Claude Code、ChatGPT 的 SDK
‍♂️ 个人主页小李同学_LSH的主页✍ 作者简介LLM学习者 希望大家多多支持我们一起进步如果文章对你有帮助的话欢迎评论 点赞 收藏 加关注目录一、先把最基础的词讲清楚SDK 到底是什么二、Claude Code 是什么它首先是一个产品不是 SDK三、 Claude Code 的 SDK 是什么四、“ChatGPT 的 SDK”这个说法其实不够准确五、OpenAI SDK最基础、最通用的那一层六、OpenAI Agents SDK不是普通 SDK而是“造 Agent 的 SDK”这几年很多人第一次接触 AI 开发时都会被一堆名字绕晕Claude CodeClaude Code SDKChatGPT SDKOpenAI SDKAgents SDKApps SDK看起来都像“开发工具”但它们其实不是同一层东西。最容易混淆的一点是有的是“产品”有的是“开发包”有的是“协议或应用框架”。Anthropic 官方把 Claude Code 定义成一个 agentic coding tool可以读代码库、改文件、跑命令并且能在终端、IDE、桌面端和浏览器里使用OpenAI 官方则把自己的开发体系拆成 API Platform、Agents SDK 和 Apps SDK 等不同部分。docs.anthropic.comhttps://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview?utm_sourcechatgpt.com这篇文章就只回答一个问题Claude Code、ChatGPT 的“SDK”到底是什么意思它们之间有什么区别一、先把最基础的词讲清楚SDK 到底是什么SDK 是Software Development Kit中文通常叫“软件开发工具包”。它不是一个单独的软件产品而是一组给开发者用的能力集合通常包括调接口的库类型定义身份认证和重试处理一些更高层的封装示例代码和文档Anthropic 在 Claude API 的 Client SDK 文档里明确说官方 SDK 的作用是简化 API 集成处理认证、请求格式、错误处理等OpenAI 官方也把 SDK 描述成“用你喜欢的语言接入 API 的官方库”并在 Quickstart 里分别给出 JavaScript 和 Python 的安装方式。产品是给用户直接用的SDK 是给开发者拿来“造东西”的。二、Claude Code 是什么它首先是一个产品不是 SDKAnthropic 官方对 Claude Code 的定义非常清楚它是一个AI-powered coding assistant也是一个agentic coding tool。它能读取你的代码库、编辑文件、运行命令并和开发工具集成官方文档还强调它可以运行在终端、IDE、桌面应用和浏览器里。换句话说Claude Code 首先是一个现成可用的编码产品。你可以把它理解成Claude Code Anthropic 做好的“AI 编程助手”它面对的是开发者“直接使用”的场景比如理解陌生代码库修 Bug重构写测试跑命令管理开发会话Anthropic 的 Common Workflows 文档就是按这些真实开发任务来组织的。三、 Claude Code 的 SDK 是什么这里最容易搞混。Anthropic 官方现在已经把Claude Code SDK更名为Claude Agent SDK。官方说明是这个 SDK 把“驱动 Claude Code 的同一套工具、agent loop 和上下文管理能力”以 Python 和 TypeScript 的形式开放给开发者让你可以“像调用库一样”把 Claude Code 背后的 agent 能力嵌进自己的程序。这句话非常关键。它的意思不是“Claude Code SDK”而是Claude Code一个现成产品Claude Agent SDK把这个产品背后的 agent 能力做成开发包Anthropic 还明确写了这个 SDK 能让你构建会读文件跑命令搜网页改代码的 AI agents。四、“ChatGPT 的 SDK”这个说法其实不够准确很多人会说“ChatGPT 的 SDK”但从 OpenAI 官方文档看这其实不是最准确的官方叫法。在开发者语境里OpenAI 更常见的官方说法是OpenAI SDKOpenAI Agents SDKApps SDK而不是笼统地说“ChatGPT SDK”。OpenAI 的 Libraries 页面讲的是官方语言 SDKQuickstart 里安装的是openai包Agents SDK 文档讲的是构建 agentic AI apps 的 SDKApps SDK 则明确写成“构建 ChatGPT apps 的框架”。所以如果有人问你“ChatGPT 的 SDK 是啥”更准确的回答通常是你到底是在问 OpenAI 的 API SDK、Agents SDK还是给 ChatGPT 扩展应用的 Apps SDK五、OpenAI SDK最基础、最通用的那一层OpenAI 官方 Quickstart 里给出的最基础开发路径就是安装官方 SDK然后直接调用 API。在 Python 里是安装openai用OpenAI()创建客户端调 Responses APIOpenAI 官方 Python 库文档还明确写了与 OpenAI 模型交互的主要 API 是 Responses API。同时Responses API 官方迁移文档把它定义成一个统一接口支持内置工具、多轮交互、远程 MCP 和多模态。所以如果你只是想调模型生成文本做结构化输出调用内置工具那你最先接触的通常就是OpenAI SDK。六、OpenAI Agents SDK不是普通 SDK而是“造 Agent 的 SDK”OpenAI Agents SDK 的官方定义也非常明确它是一个轻量、易用、抽象很少的包用来构建agentic AI apps而且是之前实验项目 Swarm 的生产级升级版。官方文档还说Agent 是它的核心构建块一个 agent 本质上就是“配置了指令、工具和可选运行时行为”的 LLM。这意味着OpenAI SDK更像“调模型”OpenAI Agents SDK更像“造会做事的系统”OpenAI 官方文档里还专门写了 tools、sessions、handoffs、human-in-the-loop、streaming 等能力这说明它不是只帮你发请求而是在帮你搭 agent 系统的基本骨架。Claude Code 是现成的 AI 编程产品Claude Agent SDK 是把它背后的 agent 能力开放给开发者。所谓“ChatGPT 的 SDK”通常不是单一官方名词开发者更常接触的是 OpenAI SDK、OpenAI Agents SDK 和 Apps SDK。

更多文章