跳转到主要内容

我如何使用 Workbench?

我们最近更新了 Workbench。新的 Workbench 使开发者能够直接在 Claude 控制台中尝试 Claude 模型和 API 功能,但不再支持保存提示历史或评估提示。

Workbench(旧版)不再向新用户开放,将于 2026 年 8 月 17 日对所有用户停用。如果您仍在使用旧版本,请参阅下面的部分 我如何使用 Workbench(旧版)?,如果您希望保留任何提示、完成或评估,请考虑在 2026 年 8 月 17 日之前导出您的数据。

什么是 Workbench?

Workbench 直接基于公开的 Messages API 构建,因此您在 Workbench 中构建的请求与您在代码中发送的请求相同。

使用它来:

  • 在编写任何代码之前尝试模型或新的 API 功能

  • 迭代提示并检查完整响应

  • 了解 API 请求和响应的结构

  • 将您的工作导出为可在您自己的应用程序中运行的代码片段

Workbench 不会在 Anthropic 的服务器上存储您的提示或对话。您当前的草稿保留在您的浏览器中,您可以转到"代码"选项卡以保留任何请求的副本。

打开 Workbench

  1. 登录到 Claude 控制台

  2. 在导航中选择"Workbench"。

  3. 如果您的组织使用工作区,请选择您想要使用的工作区。

编写并运行请求

  1. 在提示区域中输入用户消息。您也可以添加系统提示来设置说明或上下文。

  2. 单击"运行"以发送请求。

  3. 查看 Claude 的响应,以及为请求显示的令牌计数和使用情况。

  4. 编辑您的提示并再次运行它以继续迭代。

Workbench 还包括您可以加载和修改的示例模板。

选择模型并调整设置

使用模型选择器在 Claude 模型之间切换,并打开模型设置以调整温度和最大输出令牌等参数。

使用不同的模型或设置运行相同的提示是快速查看响应如何变化的方法。当您考虑使用 Messages API 构建应用程序时,使用 Workbench 来了解模型的强大功能。

使用工具和结构化输出

将工具定义添加到您的请求中以测试工具使用,并使用结构化输出让 Claude 以您定义的形状返回数据。Workbench 在响应中显示工具调用和工具结果,因此您可以准确看到它们在 API 中的表示方式。

查看原始请求和响应

Workbench 可以显示原始 API 请求和响应,包括完整的消息结构、停止原因和使用情况。这与您的应用程序发送和接收的形状相同,是尝试 Messages API 功能的实用方法。

将您的工作转换为代码

单击"代码"切换以将您当前的请求导出为代码片段。该片段准确反映您在 Workbench 中测试的内容,因此您可以将其粘贴到您的项目中并使用您自己的 API 密钥运行它。

我们文档中的代码示例包括"在 Workbench 中打开"选项,该选项将示例加载到 Workbench 中,以便您可以运行和修改它。


我如何使用 Workbench(旧版)?

注意:Workbench(旧版)不再向新用户开放,将于 2026 年 8 月 17 日对所有用户停用。在此日期之后,Workbench(旧版)和存储在其中的任何已保存提示、提示版本和评估将不再可访问。使用导出选项在此之前下载您的数据。

Workbench(旧版)允许您在 Claude 控制台帐户中创建和测试提示。您可以将提示输入"Human"对话框并单击"Run"来测试 Claude 的输出。单击左上角的 + 图标以创建新提示,或单击项目符号列表图标以查看您过去测试过的提示:

Workbench(旧版)还允许您在提示 Claude 时配置多个设置。您可以单击滑块图标来查看您的模型设置。这允许您选择模型、温度和最大令牌来采样:

制作完提示后,单击"Get code"按钮以使用我们的 Python 和 Typescript SDK 生成示例:

我如何在 Workbench(旧版)中访问我之前的工作和提示历史?

您可以按照以下步骤在控制台帐户上访问您之前的 Workbench 提示:

1. 在 platform.claude.com 登录。

2. 导航到您的 Workbench

3. 单击页面左上角的"List prompts"按钮,在"+"按钮旁边以创建新提示:

4. 您之前保存的提示列表将出现。

5. 如果您在寻找特定内容,可以使用提示列表顶部的搜索栏。

重要:当您在 Workbench(旧版)上运行提示时,Claude 的响应默认不会被保存。您需要通过单击输出底部的"Add to Conversation"手动将 Claude 的响应添加到 Workbench 上的当前提示。如果您在历史记录中看不到您期望的内容,可能是因为它没有被添加到对话中。

我如何从 Workbench(旧版)导出我的数据?

  1. 在 Claude 控制台中打开 Workbench(旧版)

  2. 在页面顶部的横幅中,选择"Export data"。

  3. Export Workbench data 对话框中,选择要与您的提示一起包含的内容:

    • Model completions — 来自过去运行的已保存响应

    • Uploaded files — 附加到您的提示的图像和 PDF

      注意:包含任何一个可能会显著增加导出大小。

  4. 选择"Export"。您的数据被打包为 JSON,当准备好时我们会向您发送下载链接。

2026 年 8 月 17 日之前导出您的数据。在 Workbench(旧版)停用后将无法访问。


常见问题

Workbench 中有什么变化?

我们正在刷新 Workbench,使其成为在控制台中尝试 Claude 模型和 API 功能的更简单、无状态的方式。主要区别是它现在:

  • 它不会在 Anthropic 的服务器上存储您的工作。您当前的草稿保留在您的浏览器中,您可以将任何请求导出为代码。使用 Workbench(旧版),您能够保存提示、提示历史和运行评估。

  • 它直接基于公开的 Messages API 构建并显示完整的请求和响应,因此您看到的内容与您的代码发送和接收的内容相匹配。

  • 已保存的提示、提示版本、评估和提示共享不是刷新后的 Workbench 的一部分。使用旧版本中的导出功能下载您的数据。

Workbench(旧版)现在对我继续工作吗?

Workbench(旧版)不再向新用户开放,将于 2026 年 8 月 17 日对所有用户停用。如果您在 2026 年 6 月 16 日之前使用过 Workbench(旧版),您将继续有权访问直到停用日期,并将在 Workbench 中看到一个横幅链接到旧版本,以便您可以导出您的数据。在 2026 年 6 月 16 日或之后开始使用 Workbench 的帐户无法访问 Workbench(旧版)。在 2026 年 8 月 17 日之后,Workbench(旧版)将不再对任何人可用。

我保存的提示和评估会发生什么?

它们保留在 Workbench(旧版)中,直到它在 2026 年 8 月 17 日停用。使用 Workbench(旧版)中的导出选项在该日期之前下载它们。刷新后的 Workbench 不包括已保存的提示或评估,因此请将您导出的副本保留在您自己的工具中,例如应用程序代码所在的存储库。

我如何获得对 Workbench(旧版)中现有数据的访问权限?

您保存的提示和完成在 Workbench(旧版)中可用,直到 2026 年 8 月 17 日。您将在 Workbench(旧版)中看到一个导出选项,该选项允许您下载已保存的提示、提示修订和完成。在停用日期之前导出您的数据,因为之后将无法访问。

我可以将 Workbench(旧版)数据导入到刷新后的 Workbench 中吗?

不可以。Workbench 的刷新版本不保存提示或对话,因此没有什么可以导入的。导出为您提供 Workbench 数据的副本,以便您可以保留它或将其移动到您自己的工具中。

这是否解答了您的问题?