[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-anthropics--claude-agent-sdk-typescript":3,"tool-anthropics--claude-agent-sdk-typescript":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":65,"owner_location":65,"owner_email":65,"owner_twitter":65,"owner_website":76,"owner_url":77,"languages":78,"stars":83,"forks":84,"last_commit_at":85,"license":65,"difficulty_score":32,"env_os":86,"env_gpu":86,"env_ram":86,"env_deps":87,"category_tags":93,"github_topics":65,"view_count":32,"oss_zip_url":65,"oss_zip_packed_at":65,"status":17,"created_at":94,"updated_at":95,"faqs":96,"releases":125},6315,"anthropics\u002Fclaude-agent-sdk-typescript","claude-agent-sdk-typescript",null,"claude-agent-sdk-typescript 是 Anthropic 推出的 TypeScript 开发工具包，旨在帮助开发者以编程方式构建具备自主能力的 AI 智能体。它继承了 Claude Code 的核心能力，让智能体不仅能理解复杂的代码库结构，还能直接执行文件编辑、运行终端命令以及处理多步骤的复杂工作流，从而将原本需要人工干预的开发任务转化为自动化流程。\n\n这款工具主要解决了传统脚本难以应对非结构化任务和复杂逻辑判断的痛点。通过集成大模型的推理能力，开发者可以创建出能够像人类工程师一样思考并操作开发环境的智能助手，大幅提升软件研发与运维的效率。\n\n它专为熟悉 Node.js 环境（需 18+ 版本）的软件工程师、全栈开发者及技术研究人员设计。如果你希望在自己的应用中嵌入能独立完成任务的 AI 代理，或者想要探索自动化编码的新范式，这是一个理想的选择。其独特的技术亮点在于无缝衔接了对话式 AI 与实际系统操作权限，并提供了从旧版 SDK 平滑迁移的路径。此外，项目拥有活跃的社区支持，并通过严格的数据隐私策略保障用户信息安全，让企业在构建商业化产品时更加安心。","# Claude Agent SDK\n\n![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-18%2B-brightgreen?style=flat-square) [![npm]](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@anthropic-ai\u002Fclaude-agent-sdk)\n\n[npm]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@anthropic-ai\u002Fclaude-agent-sdk.svg?style=flat-square\n\nThe Claude Agent SDK enables you to programmatically build AI agents with Claude Code's capabilities. Create autonomous agents that can understand codebases, edit files, run commands, and execute complex workflows.\n\n**Learn more in the [official documentation](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fapi\u002Fagent-sdk\u002Foverview)**.\n\n## Get started\n\nInstall the Claude Agent SDK:\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk\n```\n\n## Migrating from the Claude Code SDK\n\nThe Claude Code SDK is now the Claude Agent SDK. Please check out the [migration guide](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fsdk\u002Fmigration-guide) for details on breaking changes.\n\n## Reporting Bugs\n\nWe welcome your feedback. File a [GitHub issue](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues) to report bugs or request features.\n\n## Connect on Discord\n\nJoin the [Claude Developers Discord](https:\u002F\u002Fanthropic.com\u002Fdiscord) to connect with other developers building with the Claude Agent SDK. Get help, share feedback, and discuss your projects with the community.\n\n## Data collection, usage, and retention\n\nWhen you use the Claude Agent SDK, we collect feedback, which includes usage data (such as code acceptance or rejections), associated conversation data, and user feedback submitted via the \u002Fbug command.\n\n### How we use your data\n\nSee our [data usage policies](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fdata-usage).\n\n### Privacy safeguards\n\nWe have implemented several safeguards to protect your data, including limited retention periods for sensitive information, restricted access to user session data, and clear policies against using feedback for model training.\n\nFor full details, please review our [Commercial Terms of Service](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fcommercial-terms) and [Privacy Policy](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fprivacy).\n\n## License and terms\n\nUse of this SDK is governed by Anthropic's [Commercial Terms of Service](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fcommercial-terms), including when you use it to power products and services that you make available to your own customers and end users, except to the extent a specific component or dependency is covered by a different license as indicated in that component's LICENSE file.\n\n","# Claude 代理 SDK\n\n![](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FNode.js-18%2B-brightgreen?style=flat-square) [![npm]](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@anthropic-ai\u002Fclaude-agent-sdk)\n\n[npm]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@anthropic-ai\u002Fclaude-agent-sdk.svg?style=flat-square\n\nClaude 代理 SDK 使您能够以编程方式利用 Claude Code 的能力构建 AI 代理。您可以创建能够理解代码库、编辑文件、运行命令并执行复杂工作流的自主代理。\n\n**更多信息请参阅[官方文档](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fapi\u002Fagent-sdk\u002Foverview)**。\n\n## 开始使用\n\n安装 Claude 代理 SDK：\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk\n```\n\n## 从 Claude Code SDK 迁移\n\nClaude Code SDK 现已更名为 Claude 代理 SDK。有关重大变更的详细信息，请参阅[迁移指南](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fsdk\u002Fmigration-guide)。\n\n## 报告错误\n\n我们欢迎您提出反馈。请通过提交 [GitHub 问题](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues) 来报告错误或请求新功能。\n\n## 加入 Discord 社区\n\n加入 [Claude 开发者 Discord](https:\u002F\u002Fanthropic.com\u002Fdiscord)，与其他使用 Claude 代理 SDK 进行开发的开发者交流。在这里您可以获得帮助、分享反馈，并与社区成员讨论您的项目。\n\n## 数据收集、使用和保留\n\n当您使用 Claude 代理 SDK 时，我们会收集反馈信息，其中包括使用数据（例如代码接受或拒绝）、相关对话数据以及通过 \u002Fbug 命令提交的用户反馈。\n\n### 我们如何使用您的数据\n\n请参阅我们的[数据使用政策](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fdata-usage)。\n\n### 隐私保护措施\n\n我们已实施多项保护措施来 safeguard您的数据，包括对敏感信息设定有限的保留期限、限制对用户会话数据的访问，以及明确禁止将反馈用于模型训练。\n\n有关完整详情，请查阅我们的[商业服务条款](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fcommercial-terms)和[隐私政策](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fprivacy)。\n\n## 许可证与条款\n\n本 SDK 的使用受 Anthropic 的[商业服务条款](https:\u002F\u002Fwww.anthropic.com\u002Flegal\u002Fcommercial-terms)约束，包括在您将其用于支持向您自己的客户和最终用户提供产品和服务时，除非特定组件或依赖项受其 LICENSE 文件中注明的其他许可证所覆盖。","# Claude Agent SDK (TypeScript) 快速上手指南\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n- **Node.js**: 版本 18 或更高 (`Node.js 18+`)\n- **包管理器**: npm、yarn 或 pnpm\n- **API 密钥**: 您需要拥有 Anthropic API 密钥才能使用此 SDK\n\n## 安装步骤\n\n使用 npm 安装 Claude Agent SDK：\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk\n```\n\n> **提示**：如果您在国内遇到下载速度慢的问题，可以配置淘宝镜像源加速安装：\n> ```sh\n> npm config set registry https:\u002F\u002Fregistry.npmmirror.com\n> npm install @anthropic-ai\u002Fclaude-agent-sdk\n> ```\n\n## 基本使用\n\n安装完成后，您可以创建一个简单的 AI Agent 来执行代码库理解、文件编辑或命令运行等任务。以下是一个最基础的使用示例：\n\n```typescript\nimport { Agent } from \"@anthropic-ai\u002Fclaude-agent-sdk\";\n\nasync function main() {\n  \u002F\u002F 初始化 Agent\n  const agent = new Agent({\n    apiKey: process.env.ANTHROPIC_API_KEY,\n  });\n\n  \u002F\u002F 定义任务：例如让 Agent 分析当前目录的代码结构\n  const result = await agent.run(\"Analyze the codebase structure in the current directory\");\n\n  console.log(result.output);\n}\n\nmain().catch(console.error);\n```\n\n**使用说明：**\n1. 确保已设置环境变量 `ANTHROPIC_API_KEY`。\n2. 上述示例展示了如何初始化 SDK 并运行一个简单的自然语言指令。\n3. 该 SDK 支持更复杂的自主工作流，包括多步命令执行和文件操作，详细用法请参考[官方文档](https:\u002F\u002Fdocs.claude.com\u002Fen\u002Fapi\u002Fagent-sdk\u002Foverview)。","某电商平台的后端团队需要在每晚自动执行代码库的健康检查，包括识别未使用的依赖、修复常见的类型错误并生成重构建议报告。\n\n### 没有 claude-agent-sdk-typescript 时\n- 开发人员必须手动编写大量正则脚本和静态分析工具的组合，难以理解复杂的业务逻辑上下文，导致误报率极高。\n- 当发现潜在问题时，无法自动执行文件编辑或运行测试命令，只能生成日志供人工次日排查，严重拖慢迭代节奏。\n- 整个流程被割裂为“检测 - 记录 - 人工修复 - 验证”多个独立环节，缺乏自主闭环能力，维护成本随代码量增加呈指数级上升。\n- 遇到跨文件的复杂重构需求时，传统脚本完全无能为力，只能依赖资深工程师花费数小时进行人工代码审查。\n\n### 使用 claude-agent-sdk-typescript 后\n- 利用 Claude 的代码理解能力，智能体能够精准识别上下文相关的冗余代码和类型隐患，将误报率降低至接近零。\n- 智能体可直接调用系统命令运行单元测试，并在确认安全后自动编辑文件修复问题，实现从发现问题到解决问题的全自动闭环。\n- 通过编排复杂工作流，系统能自主完成“扫描 - 修复 - 验证 - 报告”全流程，无需人工干预，释放了团队夜间和周末的运维压力。\n- 面对跨模块重构任务，智能体能像资深工程师一样分析调用链，自动生成并应用多文件协同的修改方案，大幅提升代码质量。\n\nclaude-agent-sdk-typescript 将原本需要人工深度介入的碎片化运维工作，转化为具备自主决策与执行能力的智能化工作流，显著提升了研发效能。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fanthropics_claude-agent-sdk-typescript_b9f76f9e.png","anthropics","Anthropic","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fanthropics_1ed37989.png","","https:\u002F\u002Fanthropic.com","https:\u002F\u002Fgithub.com\u002Fanthropics",[79],{"name":80,"color":81,"percentage":82},"Shell","#89e051",100,1261,140,"2026-04-10T08:55:14","未说明",{"notes":88,"python":89,"dependencies":90},"该工具是基于 TypeScript\u002FNode.js 的 SDK，而非本地运行的 AI 模型，因此无需 GPU 或特定内存配置。主要运行环境要求为 Node.js 18 及以上版本。使用时需遵循 Anthropic 的商业服务条款，且会收集使用反馈数据。","不适用",[91,92],"Node.js >= 18","@anthropic-ai\u002Fclaude-agent-sdk",[35,13],"2026-03-27T02:49:30.150509","2026-04-11T00:44:59.818477",[97,102,107,112,117,121],{"id":98,"question_zh":99,"answer_zh":100,"source_url":101},28588,"如何在 SDK 中禁用调试日志输出（DEBUG 消息）？","默认情况下，只有当环境变量 DEBUG_CLAUDE_AGENT_SDK=1 时才会输出详细调试日志。如果您看到大量调试信息，请检查是否设置了该环境变量。SDK 会继承 process.env 中的设置。\n\n若要显式禁用调试标志，可以在 query 调用中传入自定义的 env 对象来覆盖环境变量：\n\nconst iterator = query({\n  prompt: 'Hello',\n  options: {\n    env: {\n      ...process.env,\n      DEBUG_CLAUDE_AGENT_SDK: undefined \u002F\u002F 或设为 '0'\n    }\n  }\n});\n\n注意：早期版本中存在一个 Bug，导致生成进程的消息无条件发送到 stderr，该问题已在后续版本中修复。","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues\u002F45",{"id":103,"question_zh":104,"answer_zh":105,"source_url":106},28589,"为什么升级 SDK 版本后 API 使用成本大幅增加？","成本增加通常是因为旧版本（如 v0.1.30 之前）存在 Bug，导致客户端统计的成本被低估，而实际账单（Anthropic 控制台）一直是准确的。新版本修复了此统计错误，因此显示的成本回归真实值。\n\n此外，请检查是否无意中切换了模型（例如从 Sonnet 切换到更贵的 Opus），或者新版本是否默认引入了更多上下文信息导致 Token 消耗增加。如果成本差异巨大，建议对比 Anthropic 官方控制台的账单数据以确认真实用量。","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues\u002F93",{"id":108,"question_zh":109,"answer_zh":110,"source_url":111},28590,"SDK 中是否支持 LSP（语言服务器协议）工具？","是的，LSP 工具现已在 SDK 中可用。早期版本中该功能未暴露或被忽略，但在更新至最新版本（如 v0.2.72 或更高）后，LSP 功能（如 goToDefinition, findReferences 等）已正常工作。\n\n如果您仍无法使用，请确保：\n1. 升级到最新的 SDK 版本。\n2. 系统中已安装并启用了兼容的 LSP 插件（如 pyright-lsp, typescript-lsp 等）。\n3. 在调用时正确使用 preset: 'claude_code' 配置。","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues\u002F123",{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},28591,"Max 订阅用户能否在开源工具中使用 Agent SDK 而不购买额外的 API Token？","关于 Max 订阅与 Agent SDK 的结合使用，官方政策较为模糊且可能存在变动。虽然有社区成员反馈曾成功使用 Max 订阅生成的 Token 运行 SDK，但也有观点认为根据服务条款，SDK 的自动化用途可能被视为违规（非人类操作）。\n\n目前官方没有明确的书面保证允许将 Max 订阅用于构建自动化工具。建议：\n1. 个人本地实验通常风险较低。\n2. 若用于生产环境或分发工具，最稳妥的方式仍是使用正式的 Anthropic API Key 以避免账号被封禁的风险。\n3. 密切关注官方文档和条款更新，不要仅依赖社交媒体上的非正式声明。","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-agent-sdk-typescript\u002Fissues\u002F11",{"id":118,"question_zh":119,"answer_zh":120,"source_url":101},28592,"为什么在传递 stderr 回调参数时进程启动会失败？","在某些版本中，直接传递 stderr 处理函数可能导致进程生成失败，特别是当环境变量配置冲突时。\n\n解决方案：\n1. 尝试移除 stderr 参数，看是否能正常运行。\n2. 如果必须捕获 stderr，请确保同时正确配置 env 对象，避免调试标志（如 DEBUG）干扰。例如：\n\nconst queryResult = claudeCode.query({\n  prompt: '...',\n  options: {\n    env: {\n      DEBUG: '0',\n      \u002F\u002F 其他必要的环境变量\n    }\n  }\n});\n\n如果问题依旧，请检查 SDK 版本是否过旧，升级到最新版本通常能解决此类进程通信问题。",{"id":122,"question_zh":123,"answer_zh":124,"source_url":106},28593,"SDK 中 tools 选项的行为在不同版本间有何变化？","在较旧的 SDK 版本（如 0.1.30）中，tools 选项可能不可用或行为不同。在新版本中，tools 和 allowedTools 选项已被引入以更好地控制代理可用的工具集。\n\n如果您发现升级后成本增加或行为异常，可能是因为新版本默认加载了更多工具或上下文。建议在代码中显式指定 allowedTools 以限制不必要的工具调用，从而控制 Token 消耗：\n\nquery({\n  prompt: '...',\n  options: {\n    allowedTools: ['specific_tool_name'], \u002F\u002F 仅允许特定工具\n    tools: { type: 'preset', preset: 'claude_code' }\n  }\n});",[126,131,136,141,146,151,156,161,166,171,176,181,186,191,196,201,206,211,216,221],{"id":127,"version":128,"summary_zh":129,"released_at":130},195377,"v0.2.98","## 变更内容\n\n- 更新至与 Claude Code v2.1.98 完全一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.98\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.98\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.98\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.98\n```","2026-04-09T19:18:25",{"id":132,"version":133,"summary_zh":134,"released_at":135},195378,"v0.2.97","## 变更内容\n\n- 更新至与 Claude Code v2.1.97 一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.97\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.97\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.97\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.97\n```","2026-04-08T21:52:33",{"id":137,"version":138,"summary_zh":139,"released_at":140},195379,"v0.2.96","## 变更内容\n\n- 更新至与 Claude Code v2.1.96 完全一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.96\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.96\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.96\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.96\n```","2026-04-08T04:37:31",{"id":142,"version":143,"summary_zh":144,"released_at":145},195380,"v0.2.94","## 变更内容\n\n- 修复了 `getContextUsage()`，使其在 `agents` 统计中包含通过 `options.agents` 传递的代理。\n- 修复了在 stream-json 输入\u002F输出中，当分块边界分割 UTF-8 序列时，CJK 字符及其他多字节文本会损坏并显示为 U+FFFD 的问题。\n- 修复了 SDK `query()` 会话结束时，MCP 服务器子进程未能正确清理的问题。\n- 修复了错误报告写入失败导致 SDK 进程因 `unhandledRejection` 而崩溃的问题。\n- 更新至与 Claude Code v2.1.94 完全一致。\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.94\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.94\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.94\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.94\n```","2026-04-07T21:18:56",{"id":147,"version":148,"summary_zh":149,"released_at":150},195381,"v0.2.92","## 变更内容\n\n- 更新至与 Claude Code v2.1.92 一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.92\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.92\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.92\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.92\n```","2026-04-04T00:41:50",{"id":152,"version":153,"summary_zh":154,"released_at":155},195382,"v0.2.91","## 变更内容\n\n- 在结果消息中添加了可选的 `terminal_reason` 字段，用于说明查询循环终止的原因（例如 `completed`、`aborted_tools`、`max_turns`、`blocking_limit` 等）。\n- 向公共的 `PermissionMode` 类型中添加了 `'auto'` 选项。\n- 将 `sandbox` 选项在传入 `enabled: true` 时的默认值从 `failIfUnavailable: false` 改为 `true` — 如果沙箱依赖项缺失，`query()` 将发出错误结果并退出，而不是静默地以非沙箱模式运行。若希望实现优雅降级，请将 `failIfUnavailable: false`。\n- 更新至与 Claude Code v2.1.91 完全一致。\n\n## 更新方法\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.91\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.91\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.91\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.91\n```","2026-04-02T23:45:21",{"id":157,"version":158,"summary_zh":159,"released_at":160},195383,"v0.2.90","## 变更内容\n\n- 更新至与 Claude Code v2.1.90 一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.90\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.90\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.90\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.90\n```","2026-04-01T23:41:34",{"id":162,"version":163,"summary_zh":164,"released_at":165},195384,"v0.2.89","## 变更内容\n\n- 添加了 `startup()` 方法，在调用 `query()` 之前预热 CLI 子进程，从而在可以提前支付启动成本的情况下，使首次查询速度提升约 20 倍。\n- 为 `getSessionMessages()` 添加了 `includeSystemMessages` 选项，可选择性地在会话历史中包含系统消息。\n- 添加了 `listSubagents()` 和 `getSubagentMessages()` 函数，用于从会话中获取子代理的对话历史。\n- 添加了 `includeHookEvents` 选项，以启用所有钩子事件类型的生命周期消息（`hook_started`、`hook_progress`、`hook_response`）。\n- 修复了当使用 SDK MCP 服务器或钩子进行单轮查询时，控制响应在结果消息之后到达而导致的 `ERR_STREAM_WRITE_AFTER_END` 错误。\n- 修复了 Zod v4 字段 `.describe()` 元数据在 `createSdkMcpServer` 工具模式中被丢弃的问题。\n- 修复了在第一轮结束前恢复时，`side_question` 返回 `null` 的问题。\n- 修复了 `settingSources` 为空数组导致 `--setting-sources \"\"` 消耗下一个 CLI 标志的问题。\n- 修复了错误结果消息（`error_during_execution`、`error_max_turns`、`error_max_budget_usd`），使其正确设置 `is_error: true` 并附带描述性消息。\n- 修复了 MCP 服务器在连接竞争后永久陷入失败状态的问题——现在它们会在下一条消息时重试。\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.89\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.89\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.89\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.89\n```\n","2026-04-01T01:07:06",{"id":167,"version":168,"summary_zh":169,"released_at":170},195385,"v0.2.87","## 变更内容\n\n- 更新至与 Claude Code v2.1.87 完全一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.87\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.87\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.87\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.87\n```","2026-03-29T02:16:59",{"id":172,"version":173,"summary_zh":174,"released_at":175},195386,"v0.2.86","## 变更内容\n\n- 添加了 `getContextUsage()` 控制方法，用于按类别获取上下文窗口使用情况的细分\n- 将 `SDKUserMessage` 类型中的 `session_id` 设置为可选——调用方在发送用户消息时无需再提供会话 ID，SDK 会自动分配一个\n- 通过添加 `@anthropic-ai\u002Fsdk` 和 `@modelcontextprotocol\u002Fsdk` 作为依赖项，修复了 TypeScript 类型解析为 `any` 的问题\n- 更新至与 Claude Code v2.1.86 完全一致\n\n## 更新\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.86\n# 或\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.86\n# 或\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.86\n# 或\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.86\n```","2026-03-27T21:42:20",{"id":177,"version":178,"summary_zh":179,"released_at":180},195387,"v0.2.85","## What's changed\n\n- Added `reloadPlugins()` SDK method to reload plugins and receive refreshed commands, agents, and MCP server status\n- Fixed PreToolUse hooks with `permissionDecision: \"ask\"` being ignored in SDK mode\n- Updated to parity with Claude Code v2.1.85\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.85\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.85\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.85\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.85\n```\n","2026-03-26T22:52:11",{"id":182,"version":183,"summary_zh":184,"released_at":185},195388,"v0.2.84","## What's changed\n\n- Added `taskBudget` option for API-side token budget awareness, allowing the model to pace tool use within a token limit\n- Added `enableChannel()` method and `capabilities` field on `McpServerStatus` for SDK-driven MCP channel activation\n- Exported `EffortLevel` type (`'low' | 'medium' | 'high' | 'max'`) for consumers to reference effort values directly\n- Fixed showing \"[Request interrupted by user]\" for errors that were not caused by user interruption\n- Updated to parity with Claude Code v2.1.84\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.84\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.84\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.84\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.84\n```\n","2026-03-26T00:30:53",{"id":187,"version":188,"summary_zh":189,"released_at":190},195389,"v0.2.83","## What's changed\n\n- Added `seed_read_state` control subtype to seed `readFileState` with `{path, mtime}` so `Edit` works after the originating `Read` was removed from context\n- Changed `session_state_changed` events to opt-in: set `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS=1` to receive them\n- Updated to parity with Claude Code v2.1.83\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.83\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.83\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.83\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.83\n```\n","2026-03-25T06:08:09",{"id":192,"version":193,"summary_zh":194,"released_at":195},195390,"v0.2.81","## What's changed\n\n- Fixed `canUseTool` not providing a working `addRules` suggestion when a write under `.claude\u002Fskills\u002F{name}\u002F` hits the bypass-immune safety check\n- Updated to parity with Claude Code v2.1.81\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.81\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.81\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.81\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.81\n```\n","2026-03-20T22:24:46",{"id":197,"version":198,"summary_zh":199,"released_at":200},195391,"v0.2.80","## What's changed\n\n- Fixed `getSessionMessages()` dropping parallel tool results — sessions with parallel tool calls now return all tool_use\u002Ftool_result pairs\n- Updated to parity with Claude Code v2.1.80\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.80\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.80\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.80\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.80\n```\n","2026-03-19T22:08:49",{"id":202,"version":203,"summary_zh":204,"released_at":205},195392,"v0.2.79","## What's changed\n\n- Added `'resume'` to the `ExitReason` type for distinguishing resume-triggered session ends in hooks\n- Updated to parity with Claude Code v2.1.79\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.79\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.79\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.79\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.79\n```\n","2026-03-18T22:27:41",{"id":207,"version":208,"summary_zh":209,"released_at":210},195393,"v0.2.77","## What's changed\n\n- Added `api_retry` system messages when retrying transient API errors, exposing attempt count, max retries, delay, and error status\n- Updated to parity with Claude Code v2.1.77\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.77\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.77\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.77\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.77\n```\n","2026-03-17T00:28:05",{"id":212,"version":213,"summary_zh":214,"released_at":215},195394,"v0.2.76","## What's changed\n\n- Added `forkSession(sessionId, opts?)` for branching conversations from a point\n- Added `cancel_async_message` control subtype to drop a queued user message by UUID before execution\n- Added `planFilePath` field to `ExitPlanMode` tool input for hooks and SDK consumers\n- Added MCP elicitation hook types and `SDKElicitationCompleteMessage` system message for handling MCP server input requests programmatically\n- Updated to parity with Claude Code v2.1.76\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.76\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.76\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.76\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.76\n```\n","2026-03-14T01:23:34",{"id":217,"version":218,"summary_zh":219,"released_at":220},195395,"v0.2.75","## What's changed\n\n- Updated to parity with Claude Code v2.1.75\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.75\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.75\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.75\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.75\n```\n","2026-03-13T17:09:00",{"id":222,"version":223,"summary_zh":224,"released_at":225},195396,"v0.2.74","## What's changed\n\n- Added `renameSession(sessionId, title, opts?)` for renaming session files\n- Fixed `import type` from `@anthropic-ai\u002Fclaude-agent-sdk\u002Fsdk-tools` failing under NodeNext\u002FBundler module resolution (missing exports map entry since v0.2.69)\n- Fixed skills with `user-invocable: false` being included in `supportedCommands()` and the `system:init` message's `slash_commands` \u002F `skills` lists\n- Updated to parity with Claude Code v2.1.74\n\n## Update\n\n```sh\nnpm install @anthropic-ai\u002Fclaude-agent-sdk@0.2.74\n# or\nyarn add @anthropic-ai\u002Fclaude-agent-sdk@0.2.74\n# or\npnpm add @anthropic-ai\u002Fclaude-agent-sdk@0.2.74\n# or\nbun add @anthropic-ai\u002Fclaude-agent-sdk@0.2.74\n```\n","2026-03-12T00:34:17"]