服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 10月7日新增的是SDK中的beta封装，不是下载安装后就能接管电脑的完整应用，也不等同于托管浏览器服务。
- 你实现导航、截图、点击等方法，SDK再把模型的工具调用交给这些方法；没有实现的成员通常会作为禁用项发送给API。
- URL策略、文件策略和审批回调只有按文档配置后才发挥作用；页面请求拦截、网络隔离和浏览器宿主仍是你的职责。
- 先核对驱动执行结果，再扩大任务范围。流式响应提前执行后，即使响应中断，也不能假定已经开始的操作被撤回。
新 SDK 替你省去了哪一层？
Anthropic 在2026年10月7日的发布说明中宣布，Python 和 TypeScript SDK 已加入浏览器与电脑工具集类，状态为 beta。开发者可以继承对应类，将自己的自动化方法接到 Claude 的工具调用上，而不必从头拼装每个工具结果。
SDK 负责分派调用、运行已传入的策略、调用审批函数并构造 tool_result。你可以使用官方 tool runner，也可以写自己的循环。这是一层开发组件；官方明确没有附带浏览器、桌面、现成驱动或默认 URL 策略。
我已有 Playwright，还需要实现什么？
把自己的浏览器自动化包装为驱动，按需要实现 navigate、screenshot、left_click 等方法，并提供浏览器状态报告。官方示例中的 backend 只是调用方提供的包装对象；它不是SDK帮你安装好的 Playwright 或 Chromium。
将驱动实例作为 tools 的一项交给SDK。未实现的成员通常会被标记为禁用；可以通过 configs 调整成员开关。不要为了让请求看起来完整，启用驱动实际无法执行的动作。官方最小 CDP 示例也明确不是生产代码。
选浏览器工具集，还是电脑工具集？
任务只在浏览器中导航、读取页面、管理标签页或截图时，先考虑 browser toolset。它有浏览器状态报告，以及可传入的 URL、文件策略。需要操作整个桌面时，再评估 computer toolset；后者没有浏览器的 URL 策略和状态报告。
电脑驱动必须处理截图尺寸与显示坐标的换算，也要检查点击、滚动或按键输入是否可执行。SDK 不会替你缩放截图，或把越界参数改成安全值。因此，换一层SDK封装不意味着现有桌面驱动已经适配。
配了 URL 策略，所有网络请求就受控了吗？
没有传入 URL 策略时，SDK 不检查导航网址。配置后，它检查的也只是 navigate 中的 URL；链接点击、重定向和页面自己的请求，仍需驱动拦截及网络层规则处理。网址白名单不是完整的网络隔离。
官方建议把浏览器放在每个会话独立、权限有限的容器或虚拟机里，限制私网、回环及云元数据访问。文件策略检查的是SDK进程所在的文件系统；远程浏览器的上传路径，需要在浏览器实际宿主上另行约束。
审批回调会自动弹出人工确认吗？
不会。confirm 是你提供的函数，SDK 按它的返回值执行或拒绝调用；人工确认界面也由应用实现。发送消息或购买可能只是普通点击、输入动作，不能仅盯着名为“支付”或“发送”的工具来设置审批。
审批基于上一次报告的页面状态，页面随后仍可能变化。官方也提醒，若在 execute 扩展钩子中修改已检查的输入，SDK 不会再次检查修改后的值。需要确认的目标、动作和输入，应由你的实现保持一致。
先验证什么，再扩大任务？
例如，先让代理在隔离浏览器打开一页已知公开资料，返回标题和截图。核对导航结果、当前标签页与来源，再增加点击或文件能力。这是接入建议，并非本站安装或运行实测；不应从演示成功推断真实账号流程已准备好。
工具失败后，官方 runner 会跳过本轮同一工具集后续调用；自己的循环也要正确回应这些未执行调用。ToolError 可作为错误结果继续运行，而配置误用等 ToolsetUsageError 会停止并交回调用方，不能一律当成可重试失败。
启用 run_tools_eagerly 后，调用可能在模型响应结束前开始。之后即使输出达到上限或循环提前退出，已开始的动作仍可能发生。应用需要核对实际结果；停止读取响应，不等于撤回浏览器或桌面操作。
资料来源
常见问题
升级到哪个 Python 或 TypeScript 包版本才包含这些类？
本次核验确认了官方当前SDK文档和10月7日发布记录，但没有独立核实两种包的最低版本号。按所列官方SDK指南检查自己的包与类导出，不把其他日期的SDK版本号移用为此次最低要求。
browser use 与 computer use 可以放在同一请求里吗？
可以传入两个实例，runner 按 toolset_name 分派调用。同一工具集的后续调用会因该工具集本轮失败而被跳过，不等于另一工具集也自动停止；自己的循环须分别维护失败状态。
用托管浏览器服务，还需要这些宿主检查吗？
需要确认服务方的网络可达范围、隔离和录制保留条件。SDK进程中的本地文件路径策略不能自动保护远程浏览器的文件系统；也不要把连接URL、服务密钥或原始异常中的私人路径交给模型或日志。