# API 和数据保留

了解 Anthropic 的 API 和相关功能如何保留数据，包括零数据保留（ZDR）和 HIPAA 就绪 API 访问的信息。

---

<Note>
有关 Anthropic 标准保留策略的信息，请参阅 [Anthropic 商业数据保留策略](https://privacy.claude.com/en/articles/7996866-how-long-do-you-store-my-organization-s-data)和[消费者数据保留策略](https://privacy.claude.com/en/articles/10023548-how-long-do-you-store-my-data)。

Anthropic 为 Claude API 提供两种数据处理安排：
- **零数据保留（ZDR）：** API 响应返回后，客户数据不会存储在静态存储中，除非需要遵守法律或防止滥用。
- **HIPAA 就绪：** 对于处理受保护健康信息（PHI）的组织，Anthropic 提供具有签署的商业伙伴协议（BAA）的 HIPAA 就绪 API 访问。请参阅 [HIPAA 就绪](#hipaa-就绪)。
</Note>

## Anthropic 的数据保留方法

不同的 API 和功能有不同的存储和保留需求。当 API 或功能不需要存储客户提示或响应时，它可能有资格获得 ZDR。当 API 或功能必须存储客户提示或响应时，Anthropic 设计为尽可能小的保留占用空间。对于这些功能：

- 未经您明确许可，保留的数据永远不会用于模型训练。
- 只保留 API 和功能工作所必需的技术数据。除非明确说明，否则永远不会保留对话内容（您的提示和 Claude 的输出）。
- 数据在最短的实际 TTL 上清除，Anthropic 旨在让客户控制数据保留多长时间。保留的内容以及适用特定 TTL 的保留期限在每个功能的页面上记录。

通过 [Compliance API](/docs/en/manage-claude/compliance-api) 可访问的数据遵循其自己的保留模型。[活动订阅源](/docs/en/manage-claude/compliance-activity-feed)保留数据 6 年。来自 claude.ai 的聊天、文件和项目内容遵循您组织的保留策略，在 [claude.ai > 组织设置 > 数据和隐私](https://claude.ai/admin-settings/data-privacy-controls)中设置。

在[功能资格表](#功能资格)中，某些功能在 ZDR 资格列中标记为"是（有条件）"。如果您的组织有 ZDR 安排，您可以放心使用这些功能，Anthropic 保留的内容是有限的，并且是最佳性能所必需的。

## 零数据保留（ZDR）范围

**ZDR 涵盖的内容**

- **某些 Claude API：** ZDR 适用于 Claude Messages 和 Token Counting API
- **Claude Code：** 当与商业组织 API 密钥一起使用或通过 Claude Enterprise 使用时，ZDR 适用（请参阅 [Claude Code ZDR 文档](https://code.claude.com/docs/en/zero-data-retention)）

**ZDR 不涵盖的内容**

- **控制台和工作台：** 控制台或工作台上的任何使用
- **Claude 托管智能体：** Claude 托管智能体是有状态资源。您可以删除会话记录，但没有自动删除。
- **Claude 消费者产品：** Claude Free、Pro 或 Max 计划，包括这些计划的客户使用 Claude 的 Web、桌面或移动应用程序或 Claude Code
- **Claude Teams 和 Claude Enterprise：** Claude Teams 和 Claude Enterprise 产品界面**不符合 ZDR 资格**，除非通过 Claude Enterprise 使用 Claude Code 并为组织启用 ZDR。对于其他产品界面，只有商业组织 API 密钥有资格获得 ZDR。
- **第三方集成：** 由第三方网站、工具或其他集成处理的**数据不符合 ZDR 资格**，尽管某些可能有类似的产品。当将外部服务与 Claude API 结合使用时，请务必审查这些服务的数据处理实践。

<Note>
有关哪些产品和功能符合 ZDR 资格的最新信息，请参阅您的合同条款或联系您的 Anthropic 客户代表。
</Note>

## HIPAA 就绪

Claude API 支持处理受保护健康信息（PHI）的组织进行 HIPAA 就绪集成。通过签署的 BAA 和启用 HIPAA 的组织，您可以使用支持的 API 功能来处理 PHI，同时支持您组织的 HIPAA 合规性。

以前，需要 Claude API HIPAA 就绪的组织需要启用 ZDR。HIPAA 就绪 API 访问消除了这一要求，并为 Anthropic 逐步启用更多功能提供了基础，因为它们经过 HIPAA 就绪审计。

<Note>
本页介绍 Claude API 的 HIPAA 就绪。有关涵盖 Claude Enterprise 和配置要求的完整 HIPAA 实施指南，请参阅 [Anthropic 信任中心](https://trust.anthropic.com/resources)。
</Note>

### 开始使用

要设置 HIPAA 就绪 API 访问：

<Steps>
<Step title="签署商业伙伴协议">
联系 [Anthropic 销售团队](https://claude.com/contact-sales)签署涵盖 API 使用的 BAA。
</Step>
<Step title="配置启用 HIPAA 的组织">
Anthropic 配置一个专用组织，启用 HIPAA 就绪控制。此组织自动强制执行功能限制，阻止使用非合格功能的 API 请求。
</Step>
<Step title="使用合格功能构建">
使用[功能资格表](#功能资格)确认支持哪些功能。审查 [PHI 处理指南](#phi-处理指南)中需要对 PHI 出现位置进行特定限制的功能。有关详细的配置和合规要求，请参阅 [HIPAA 实施指南](https://trust.anthropic.com/resources)。
</Step>
</Steps>

<Warning>
HIPAA 就绪在组织级别强制执行。如果您同时需要 HIPAA 就绪和通用 API 访问，请为每个使用单独的组织。
</Warning>

### HIPAA 就绪范围

**HIPAA 就绪涵盖的内容**

- **Claude API：** HIPAA 就绪适用于 [功能资格表](#功能资格)中列出的合格功能的 Claude API（`api.anthropic.com`）。

**HIPAA 就绪不涵盖的内容**

- **Claude 消费者产品：** Claude Free、Pro 或 Max 计划
- **控制台和工作台：** 通过 Claude 控制台界面使用
- **合作伙伴运营的平台：** Amazon Bedrock 或 Vertex AI（请参阅这些平台的合规文档）
- **Claude Platform on AWS 和 Microsoft Foundry：** HIPAA 就绪不可用
- **第三方集成：** 由连接到您应用程序的外部工具或服务处理的数据
- **Claude Code：** Claude Code 不在 HIPAA 就绪范围内
- **Beta 功能：** Beta 中的功能通常不在 BAA 范围内，除非在[功能资格表](#功能资格)中明确列为合格

### PHI 处理指南

受保护健康信息（PHI）包括任何可单独识别的健康信息。在 Claude API 的上下文中，PHI 通常出现在：

- 消息内容（来自 Claude 的提示和响应）
- 附加文件（图像、PDF）
- 与消息内容关联的文件名和元数据

以下字段在 BAA 下不预期包含 PHI：工作区名称、用户信息（姓名、电子邮件、电话号码）、计费数据和支持工单。

#### 架构和工具定义限制

当使用[结构化输出](/docs/en/build-with-claude/structured-outputs)或具有 `strict: true` 的工具时，API 将 JSON 架构编译为语法，这些语法与消息内容分开缓存。这些缓存的架构不会获得与提示和响应相同的 PHI 保护。

**不要在 JSON 架构定义中包含 PHI。** 此限制适用于：

- 架构属性名称
- `enum` 值
- `const` 值
- `pattern` 正则表达式

患者特定信息应仅出现在消息内容中，在那里受到 HIPAA 保护。

### HIPAA 错误处理

您签署的 BAA 是哪些功能被涵盖的官方事实来源。API 也会自动强制执行这些限制：当启用 HIPAA 的组织发送包含非合格功能的请求时，API 返回 `400` 错误以防止意外使用 BAA 未涵盖的功能：

```json
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "The requested features are not available for HIPAA-regulated organizations without Zero Data Retention: code_execution."
  }
}
```

错误消息列出了在请求中检测到的非合格功能。从您的请求中移除这些功能并重试。

## 功能资格

下表列出了哪些 Claude API 功能有资格获得 ZDR 和 HIPAA 就绪安排。对于启用 HIPAA 的组织，HIPAA 列中标记为"否"的功能会被自动阻止，包含它们的请求返回 `400` 错误。

| 功能 | 端点 | ZDR 资格 | HIPAA 资格 | 详细信息 |
|------|------|----------|------------|----------|
| [Messages API](/docs/en/build-with-claude/working-with-messages) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 用于生成 Claude 响应的标准 API 调用。 |
| [Token 计数](/docs/en/build-with-claude/token-counting) | `/v1/messages/count_tokens` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 在发送请求前计算 token。 |
| [网络搜索](/docs/en/agents-and-tools/tool-use/web-search-tool) | `/v1/messages`（使用 `web_search` 工具） | <Eligible>是</Eligible><sup>1</sup> | <Eligible>是</Eligible><sup>1</sup> | API 响应中返回的实时网络搜索结果。 |
| [网络获取](/docs/en/agents-and-tools/tool-use/web-fetch-tool) | `/v1/messages`（使用 `web_fetch` 工具） | <Eligible>是</Eligible><sup>1</sup> <sup>2</sup> | <Eligible status="no">否</Eligible> | API 响应中返回的获取的网络内容。 |
| [顾问工具](/docs/en/agents-and-tools/tool-use/advisor-tool) | `/v1/messages`（使用 `advisor` 工具） | <Eligible>是</Eligible> | <Eligible status="no">否</Eligible> | 顾问模型输出在 API 响应中返回；响应后不会在服务器端存储任何内容。 |
| [记忆工具](/docs/en/agents-and-tools/tool-use/memory-tool) | `/v1/messages`（使用 `memory` 工具） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 客户端记忆存储，您控制数据保留。 |
| [上下文管理（压缩）](/docs/en/build-with-claude/compaction) | `/v1/messages`（使用 `context_management`） | <Eligible>是</Eligible> | <Eligible status="no">否</Eligible> | 服务器端压缩结果通过 API 响应无状态返回/往返。 |
| [上下文编辑](/docs/en/build-with-claude/context-editing) | `/v1/messages`（使用 `context_management`） | <Eligible>是</Eligible> | <Eligible status="no">否</Eligible> | 上下文编辑（工具使用清除 + 思考清除）实时应用。 |
| [快速模式](/docs/en/build-with-claude/fast-mode) | `/v1/messages`（使用 `speed: "fast"`） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 相同的 Messages API 端点，推理更快。无论速度设置如何，ZDR 都适用。 |
| [1M token 上下文窗口](/docs/en/build-with-claude/context-windows) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 扩展上下文处理使用标准 Messages API。 |
| [自适应思考](/docs/en/build-with-claude/adaptive-thinking) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 动态思考深度使用标准 Messages API。 |
| [引用](/docs/en/build-with-claude/citations) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 来源归属使用标准 Messages API。 |
| [数据驻留](/docs/en/manage-claude/data-residency) | `/v1/messages`（使用 `inference_geo`） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 地理路由使用标准 Messages API。 |
| [Effort](/docs/en/build-with-claude/effort) | `/v1/messages`（使用 `effort`） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | Token 效率控制使用标准 Messages API。 |
| [扩展思考](/docs/en/build-with-claude/extended-thinking) | `/v1/messages`（使用 `thinking`） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 逐步推理使用标准 Messages API。 |
| [PDF 支持](/docs/en/build-with-claude/pdf-support) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | PDF 文档处理使用标准 Messages API。HIPAA 资格适用于通过 Messages API 内联发送的 PDF，而不是通过 Files API。 |
| [搜索结果](/docs/en/build-with-claude/search-results) | `/v1/messages`（使用 `search_results` 来源） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | RAG 引用支持使用标准 Messages API。 |
| [Bash 工具](/docs/en/agents-and-tools/tool-use/bash-tool) | `/v1/messages`（使用 `bash` 工具） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 在您的环境中执行的客户端工具。 |
| [文本编辑器工具](/docs/en/agents-and-tools/tool-use/text-editor-tool) | `/v1/messages`（使用 `text_editor` 工具） | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 在您的环境中执行的客户端工具。 |
| [计算机使用](/docs/en/agents-and-tools/tool-use/computer-use-tool) | `/v1/messages`（使用 `computer` 工具） | <Eligible>是</Eligible> | <Eligible status="no">否</Eligible> | 客户端工具，其中截图和文件在您的环境中捕获和存储，而不是由 Anthropic。请参阅[计算机使用](/docs/en/agents-and-tools/tool-use/computer-use-tool#data-retention)。 |
| [细粒度工具流](/docs/en/agents-and-tools/tool-use/fine-grained-tool-streaming) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 流式工具参数使用标准 Messages API。 |
| [提示缓存](/docs/en/build-with-claude/prompt-caching) | `/v1/messages` | <Eligible>是</Eligible> | <Eligible>是</Eligible> | 您的提示和 Claude 的输出不会被存储。KV 缓存表示和加密哈希在缓存 TTL 内存中保留，并在过期后立即删除。请参阅[提示缓存](/docs/en/build-with-claude/prompt-caching#data-retention)。 |
| [结构化输出](/docs/en/build-with-claude/structured-outputs) | `/v1/messages` | <Eligible status="qualified">是（有条件）</Eligible> | <Eligible>是</Eligible><sup>3</sup> | 您的提示和 Claude 的输出不会被存储。仅缓存 JSON 架构，自上次使用以来最多 24 小时。这还包括[严格工具使用](/docs/en/agents-and-tools/tool-use/strict-tool-use)（工具上的 `strict: true`），它使用相同的语法管道。请参阅[结构化输出](/docs/en/build-with-claude/structured-outputs#data-retention)。 |
| [缓存诊断](/docs/en/build-with-claude/cache-diagnostics) | `/v1/messages`（使用 `diagnostics`） | <Eligible status="qualified">是（有条件）</Eligible> | <Eligible status="no">否</Eligible> | 您的提示和 Claude 的输出不会被存储。加密哈希和 token 计数估计的指纹会短暂保留以启用与下一个请求的比较。请参阅[缓存诊断](/docs/en/build-with-claude/cache-diagnostics#data-retention)。 |
| [工具搜索](/docs/en/agents-and-tools/tool-use/tool-search-tool) | `/v1/messages`（使用 `tool_search` 工具） | <Eligible>是</Eligible> | <Eligible status="no">否</Eligible> | 工具搜索使用标准 Messages API。 |
| [批处理](/docs/en/build-with-claude/batch-processing) | `/v1/messages/batches` | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 29 天保留；需要异步存储。请参阅[批处理](/docs/en/build-with-claude/batch-processing#data-retention)。 |
| [代码执行](/docs/en/agents-and-tools/tool-use/code-execution-tool) | `/v1/messages`（使用 `code_execution` 工具） | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 容器数据保留最多 30 天。请参阅[代码执行](/docs/en/agents-and-tools/tool-use/code-execution-tool#data-retention)。 |
| [程序化工具调用](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) | `/v1/messages`（使用 `code_execution` 工具） | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 基于代码执行容器构建；数据保留最多 30 天。请参阅[程序化工具调用](/docs/en/agents-and-tools/tool-use/programmatic-tool-calling#data-retention)。 |
| [Files API](/docs/en/build-with-claude/files) | `/v1/files` | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 文件保留直到显式删除。请参阅 [Files API](/docs/en/build-with-claude/files#data-retention)。 |
| [智能体技能](/docs/en/agents-and-tools/agent-skills/overview) | `/v1/messages`（使用 `skills`）/ `/v1/skills` | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 技能数据按标准策略保留。请参阅[智能体技能](/docs/en/agents-and-tools/agent-skills/overview#data-retention)。 |
| [MCP 连接器](/docs/en/agents-and-tools/mcp-connector) | `/v1/messages`（使用 `mcp_servers`） | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 数据按标准策略保留。请参阅 [MCP 连接器](/docs/en/agents-and-tools/mcp-connector#data-retention)。 |
| [Claude 托管智能体](/docs/en/managed-agents/overview) | `/v1/agents`、`/v1/sessions`、`/v1/environments` | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 会话是有状态资源；记录会持续到您删除它们。适用于所有托管智能体子功能，包括[自托管沙箱](/docs/en/managed-agents/self-hosted-sandboxes)。 |
| [MCP 隧道](/docs/en/agents-and-tools/mcp-tunnels/overview) | `/v1/organizations/tunnels` | <Eligible status="no">否</Eligible> | <Eligible status="no">否</Eligible> | 研究预览。有关数据流边界和子处理器详细信息，请参阅 [MCP 隧道安全](/docs/en/agents-and-tools/mcp-tunnels/security)。 |

<sup>1</sup> [动态过滤](/docs/en/agents-and-tools/tool-use/web-search-tool#dynamic-filtering)不符合 ZDR 或 HIPAA 资格。

<sup>2</sup> 虽然网络获取符合 ZDR 资格，但网站发布者可能会根据其自己的策略保留请求数据（如获取的 URL 和请求元数据）。

<sup>3</sup> PHI 不得包含在 JSON 架构定义中。请参阅 [PHI 处理指南](#phi-处理指南)。

## 限制和排除

### ZDR 不支持 CORS

**跨源资源共享（CORS）**不适用于具有 ZDR 安排的组织。如果您需要从基于浏览器的应用程序进行 API 调用，您必须：

- 使用后端代理服务器代表您的前端进行 API 调用
- 在代理服务器上实现您自己的 CORS 处理
- 永远不要在浏览器 JavaScript 中直接暴露 API 密钥

### 违反策略和法律要求的数据保留

即使有 ZDR 或 HIPAA 安排，Anthropic 也可能在法律要求或为了打击违反使用策略和恶意使用 Anthropic 平台的情况下保留数据。因此，如果聊天或会话因此类违规被标记，Anthropic 可能会保留输入和输出最多 2 年。

## 常见问题

<section title="我如何知道我的组织是否有 ZDR 安排？">

检查您的合同条款或联系您的 Anthropic 客户代表，确认您的组织是否有 ZDR 安排。

</section>

<section title="我可以在我的 ZDR 安排下使用 ZDR 合格（有条件）功能吗？">

是的。这些功能保留最小的、有文档记录的技术数据集，而不是您的提示或 Claude 的输出。有关管理这些功能的承诺，请参阅 [Anthropic 的数据保留方法](#anthropics-approach-to-data-retention)。

</section>

<Accordion title={'如果我在 ZDR 下使用标记为"否"的功能会怎样？'}>
在 ZDR 下标记为"否"的功能本质上是有状态的：Batch API 存储您的作业，Files API 存储您的文件，代码执行在持久容器中运行。这些功能的数据按功能的文档化策略保留。使用它们是选择退出该特定数据的 ZDR 安排。
</Accordion>

<section title="我可以请求从不符合 ZDR 资格的功能中删除数据吗？">

联系您的 Anthropic 客户代表讨论非 ZDR 功能的删除选项。

</section>

<section title="HIPAA 就绪与 ZDR 有何不同？">

ZDR 防止客户数据在 API 响应返回后存储在静态存储中。HIPAA 就绪涉及更广泛的隐私和安全保护措施，在整个生命周期内保护 PHI，包括加密、访问控制和审计日志。HIPAA 就绪 API 访问为逐步启用更多功能提供了基础，因为数据可以在有适当保护措施的情况下保留，而不是要求立即删除。

</section>

<section title="如果我有 HIPAA 就绪，我还需要 ZDR 吗？">

不需要。HIPAA 就绪 API 访问是为处理 PHI 的组织设计的 ZDR 替代方案。启用 HIPAA 就绪后，您可以访问支持的 API 功能，同时保持 HIPAA 要求的隐私和安全保护。

</section>

<section title="如果我在 HIPAA 下使用非合格功能会怎样？">

API 返回一个 `400` 错误，类型为 `invalid_request_error`。错误消息标识哪些功能不可用。从您的请求中移除非合格功能并重试。

</section>

<section title="我可以用同一个组织进行 HIPAA 和非 HIPAA 工作负载吗？">

不可以。HIPAA 就绪在组织级别强制执行，并自动阻止所有非合格功能。为不需要 HIPAA 就绪的工作负载使用单独的组织。

</section>

<section title="我如何请求 HIPAA 就绪 API 访问？">

联系 [Anthropic 销售团队](https://claude.com/contact-sales)讨论 HIPAA 就绪 API 访问并签署商业伙伴协议。

</section>

<section title="这适用于 Amazon Bedrock 或 Vertex AI 吗？">

不适用。本页描述的 ZDR 和 HIPAA 安排适用于 Claude API，Anthropic 是数据处理者。在 Bedrock 和 Vertex AI 上，云提供商是数据处理者；请参阅这些平台的数据保留和合规策略了解其等效控制。

</section>

<section title="Claude Platform on AWS 是否符合 ZDR 或 HIPAA 就绪资格？">

Claude Platform on AWS 遵循与第一方 Claude API 相同的数据保留策略。ZDR 可应要求提供；联系您的 Anthropic 客户代表启用它。HIPAA 就绪在 Claude Platform on AWS 上不可用。有关详细信息，请参阅 [Claude Platform on AWS](/docs/en/build-with-claude/claude-platform-on-aws)。

</section>

<section title="Claude Code 是否符合 ZDR 资格？">

Claude Code 通过两种途径符合 ZDR 资格：

- **API 密钥：** 与商业组织的按需付费 API 密钥一起使用的 Claude Code
- **Claude Enterprise：** 通过 Claude Enterprise 使用并为组织启用 ZDR 的 Claude Code

ZDR 按组织启用。每个新组织需要您的客户团队单独启用 ZDR。ZDR 不会自动应用于在同一账户下创建的新组织。

此外，如果您在 Claude Code 中启用了指标日志记录，生产力数据（如使用统计）将免除 ZDR 并可能被保留。

有关 Claude Enterprise 上 Claude Code 的 ZDR 完整详细信息，包括禁用的功能和如何请求启用，请参阅 [Claude Code ZDR 文档](https://code.claude.com/docs/en/zero-data-retention)。

</section>

<section title="Claude for Excel 是否支持 ZDR？">

不支持，Claude for Excel 目前不符合 ZDR 资格。

</section>

<section title="我如何请求 ZDR？">

要请求 ZDR 安排，请联系 [Anthropic 销售团队](https://claude.com/contact-sales)。

</section>

## 相关资源

- [隐私政策](https://www.anthropic.com/legal/privacy)
- [结构化输出](/docs/en/build-with-claude/structured-outputs)
- [提示缓存](/docs/en/build-with-claude/prompt-caching)
- [批处理](/docs/en/build-with-claude/batch-processing)
- [Files API](/docs/en/api/files-create)
- [信任中心](https://trust.anthropic.com/resources)