在使用 Claude Code 进行复杂的多步骤代码生成或系统操作时，子代理（Sub-agents）机制极大地提升了任务的并行处理能力和模块化效率。然而，这种强大的自动化能力也伴随着潜在的安全风险：如果子代理拥有过高的系统权限，恶意代码或意外错误可能导致数据泄露、文件损坏甚至系统被控。因此，正确配置子代理的权限边界是每一位开发者必须掌握的核心技能。本文将通过清晰的步骤清单，指导你如何在本地环境中安全地部署和管理 Claude Code 的子代理权限。
第一步：理解权限模型与沙箱机制
在开始配置之前，首先需要明确 Claude Code 的权限执行逻辑。默认情况下，CLI 工具运行在与主进程相同的用户上下文环境中，这意味着子代理可以访问当前用户的所有敏感文件和可执行程序。为了隔离风险，建议启用沙箱模式或限制特定的文件系统路径。你需要检查项目根目录下的配置文件，确认是否启用了“受限执行”选项。这一层防护旨在防止子代理随意读取家目录中的 SSH 私钥、环境变量中的 API Key 或其他非项目相关的机密信息。理解这一基础架构有助于你在后续步骤中做出更精准的策略选择。
第二步：配置 .claude/settings.json 安全参数
权限控制的核心在于配置文件。请在项目根目录下找到或创建 .claude/settings.json 文件。在此文件中，重点配置 allowedTools 和 disallowedTools 数组。对于子代理而言，应严格限制其调用 shell 命令的能力，仅保留必要的文件读写权限。例如，你可以禁止子代理执行 rm -rf 或修改系统级配置的工具。此外，设置 maxTokensPerTurn 可以有效防止无限循环导致的资源耗尽攻击。务必确保这些设置以 JSON 格式正确书写，并通过命令行验证配置加载无误。这一步骤是建立安全基线的关键，任何疏忽都可能导致权限绕过。
第三步：实施最小权限原则与审计日志
完成基础配置后，下一步是细化权限粒度并建立监控机制。遵循最小权限原则（Least Privilege），仅为子代理分配完成任务所需的最小权限集。例如，如果子代理仅需读取文档，则不应赋予其写入权限。同时，开启详细的审计日志功能，记录每一次子代理的请求来源、执行命令及返回结果。定期检查这些日志，识别异常行为模式，如频繁尝试访问未授权目录或执行可疑脚本。通过结合静态配置与动态监控，你可以构建一个闭环的安全管理体系。定期更新 Claude Code 版本以获得最新的安全补丁，也是维持长期安全的重要措施。通过以上三个步骤的系统化实施，你将能够在享受 AI 辅助开发便利的同时，牢牢掌控代码环境的安全边界。
本文链接：https://ai-claudecode.cn/doubao/claude-codezdlqxaqszwzzn/