安全性

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

我们如何处理安全性

​

安全基础

您的代码安全至关重要。Claude Code 以安全为核心构建，按照 Anthropic 的全面安全计划开发。在 Anthropic Trust Center 了解更多信息并访问资源（SOC 2 Type 2 报告、ISO 27001 证书等）。

​

基于权限的架构

Claude Code 默认使用严格的只读权限。当需要额外操作时（编辑文件、运行测试、执行命令），Claude Code 会请求明确的权限。用户可以控制是否批准一次性操作或自动允许操作。 我们设计 Claude Code 是为了透明和安全。例如，我们要求在执行 bash 命令前获得批准，让您拥有直接控制权。这种方法使用户和组织能够直接配置权限。 有关详细的权限配置，请参阅 Permissions。

​

内置保护

为了降低代理系统中的风险：

• 沙箱化 bash 工具：使用文件系统和网络隔离的 Sandbox bash 命令，减少权限提示同时保持安全性。使用 /sandbox 启用以定义 Claude Code 可以自主工作的边界
• 写入访问限制：Claude Code 只能写入启动它的文件夹及其子文件夹——它不能在没有明确权限的情况下修改父目录中的文件。虽然 Claude Code 可以读取工作目录外的文件（对于访问系统库和依赖项很有用），但写入操作严格限制在项目范围内，创建了清晰的安全边界
• 提示疲劳缓解：支持按用户、按代码库或按组织的白名单常用安全命令
• Accept Edits 模式：自动批准文件编辑和一组固定的文件系统 Bash 命令，如 mkdir、touch、rm、mv、cp 和 sed，用于工作目录中的路径。其他 Bash 命令和超出范围的路径仍然会提示

​

用户责任

Claude Code 只拥有您授予它的权限。您负责在批准前审查建议的代码和命令的安全性。

​

防止提示注入

提示注入是一种攻击者试图通过插入恶意文本来覆盖或操纵 AI 助手指令的技术。Claude Code 包括针对这些攻击的多项防护措施：

​

核心保护

• 权限系统：敏感操作需要明确批准
• 上下文感知分析：通过分析完整请求来检测潜在有害指令
• 输入清理：通过处理用户输入来防止命令注入
• 命令黑名单：默认阻止从网络获取任意内容的风险命令，如 curl 和 wget。显式允许时，请注意 权限模式限制

​

隐私保护

我们实施了多项保护措施来保护您的数据，包括：

• 敏感信息的有限保留期（请参阅 Privacy Center 了解更多）
• 对用户会话数据的受限访问
• 用户对数据训练偏好的控制。消费者用户可以随时更改其 隐私设置。

有关完整详情，请查看我们的 Commercial Terms of Service（适用于 Team、Enterprise 和 API 用户）或 Consumer Terms（适用于 Free、Pro 和 Max 用户）以及 Privacy Policy。

​

其他保护措施

• 网络请求批准：进行网络请求的工具默认需要用户批准
• 隔离的上下文窗口：Web fetch 使用单独的上下文窗口以避免注入潜在恶意提示
• 信任验证：首次代码库运行和新 MCP servers 需要信任验证
  • 注意：使用 -p 标志以非交互方式运行时，信任验证被禁用。例外是 --worktree，它仍然要求已接受该目录的信任
• 命令注入检测：即使之前已白名单，可疑的 bash 命令也需要手动批准
• 故障关闭匹配：不匹配的命令默认需要手动批准
• 自然语言描述：复杂的 bash 命令包括用户理解的说明
• 安全凭证存储：API 密钥和令牌已加密。请参阅 Credential Management

处理不受信任内容的最佳实践：

1. 在批准前审查建议的命令
2. 避免直接将不受信任的内容通过管道传递给 Claude
3. 验证对关键文件的建议更改
4. 使用虚拟机 (VM) 运行脚本并进行工具调用，特别是在与外部 Web 服务交互时
5. 使用 /feedback 报告可疑行为

​

MCP 安全性

Claude Code 允许用户配置 Model Context Protocol (MCP) servers。允许的 MCP servers 列表在您的源代码中配置，作为 Claude Code 设置的一部分，工程师将其检入源代码控制。 我们鼓励编写您自己的 MCP servers 或使用来自您信任的提供商的 MCP servers。您能够为 MCP servers 配置 Claude Code 权限。Anthropic 在将连接器添加到 Anthropic Directory 之前，会根据其 列表标准 审查连接器，但不对任何 MCP server 进行安全审计或管理。

​

IDE 安全性

有关在 IDE 中运行 Claude Code 的更多信息，请参阅 VS Code security and privacy。

​

云执行安全性

使用 Claude Code on the web 时，会实施额外的安全控制：

• 隔离的虚拟机：每个云会话在隔离的、由 Anthropic 管理的 VM 中运行
• 网络访问控制：网络访问默认受限，可以配置为禁用或仅允许特定域
• 凭证保护：身份验证通过安全代理处理，该代理在沙箱内使用作用域凭证，然后转换为您的实际 GitHub 身份验证令牌
• 分支限制：Git push 操作限制在当前工作分支
• 审计日志：云环境中的所有操作都被记录以用于合规和审计目的
• 自动清理：会话完成后，云环境会自动终止

有关云执行的更多详情，请参阅 Claude Code on the web。 Remote Control 会话的工作方式不同：Web 界面连接到在您本地机器上运行的 Claude Code 进程。所有代码执行和文件访问都保持本地，任何本地 Claude Code 会话期间流动的相同数据通过 TLS 上的 Anthropic API 传输。不涉及云 VM 或沙箱。连接使用多个短期的、范围狭窄的凭证，每个凭证限制于特定目的并独立过期，以限制任何单个受损凭证的影响范围。

​

安全最佳实践

​

处理敏感代码

• 在批准前审查所有建议的更改
• 为敏感存储库使用项目特定的权限设置
• 考虑使用 dev containers 以获得额外隔离
• 使用 /permissions 定期审计您的权限设置

​

团队安全

• 使用 managed settings 来强制执行组织标准
• 通过版本控制共享批准的权限配置
• 培训团队成员了解安全最佳实践
• 通过 OpenTelemetry metrics 监控 Claude Code 使用情况
• 使用 ConfigChange hooks 审计或阻止会话期间的设置更改

​

报告安全问题

如果您在 Claude Code 中发现安全漏洞：

1. 不要公开披露
2. 通过我们的 HackerOne program 报告
3. 包括详细的复现步骤
4. 在公开披露前给我们时间来解决问题

​

相关资源

• Sandboxing - bash 命令的文件系统和网络隔离
• Permissions - 配置权限和访问控制
• Monitoring usage - 跟踪和审计 Claude Code 活动
• Development containers - 安全、隔离的环境
• Anthropic Trust Center - 安全认证和合规