Claude Code 设置：开发中防止回归问题的保护

# 配置 Claude Code 实现安全开发：三层回归防护

Claude Code 拥有高达 100 万 token 的超大上下文窗口，但这并不能神奇地杜绝代码回归问题。开发者经常发现 AI 代理会重写正常运行的代码、删除测试用例，或引入不必要的依赖。为了实现顺畅操作而无需全程监督，你需要构建一个多层防御体系，基于配置文件、子代理和自动化钩子。

CLAUDE.md：项目“宪法”

CLAUDE.md 文件是 Claude Code 配置的核心支柱。它在每个会话开始时重新加载，并在上下文压缩时保留，确保你始终使用最新信息。其主要职责？强制执行代码处理的铁律。

CLAUDE.md 的关键部分包括：

• 项目架构：详细说明技术栈
• 关键命令：构建、测试和代码检查
• 强制代码规则
• 工作流风格 和流程指南
• 子代理列表：用于专项任务

关键规则部分明确列出禁止事项和必须执行的操作：

• 绝不 在无明确指示下删除或重写通过的测试
• 绝不 未确认即删除文件
• 始终 在任何代码变更后运行测试
• 始终 在重大重构前创建 Git 检查点
• 一次只处理一个任务——禁止并行变更
• 遇到歧义时寻求澄清，而非自行假设

为节省上下文窗口空间，详细规则存放在 .claude/rules/ 下的模块化文件中。这些文件仅在处理匹配文件类型时加载——对 Sonnet 和 Pro 用户（上限 20 万 token）来说，这是救星。

子代理：独立专家

子代理在独立的上下文窗口中运行，仅将摘要反馈给主会话。这能实现深度代码库探索，而不 clutter 主上下文。每个子代理专注单一严格功能。

规划代理 扫描代码库并制定分步实施计划。核心规则：绝不编写代码——仅分析和规划。它标记风险、定位受影响文件，并建议测试策略。

测试代理 编写并运行测试。它研究项目现有测试模式，并据此创建新测试。金科玉律：始终运行完整测试套件，而非仅新测试——回归问题爱藏在旧测试中。

代码审查代理 检查变更中的回归、安全问题和风格合规性。它验证错误处理、可读性、DRY 原则遵守以及测试覆盖充分性。

子代理文件置于 .claude/agents/，包含清晰功能描述、可用工具和规则集。主 CLAUDE.md 应始终提醒使用它们。

自动化钩子：安全关卡

Claude Code 中的钩子在生命周期事件上触发，进行自动质量检查。通过 .claude/settings.json 配置，主要有两种类型。

PreToolUse 钩子 在工具使用前触发。明星钩子是阻止测试失败提交的那个。Python 项目示例：

{
  "matcher": "Bash(git commit*)",
  "hooks": [
    {
      "type": "command",
      "command": "python -m pytest tests/ -x --timeout=60 || (echo '{\"block\": true, \"message\": \"测试失败。请修复后再提交。\"}' 1>&2 && exit 2)",
      "timeout": 120
    }
  ]
}

PostToolUse 钩子 在操作后触发，作为温和提醒。例如，每次文件变更后提醒运行测试。

优化你的工作流

高效使用 Claude Code 需要严格的上下文管理和工具利用。

上下文窗口管理：

• 定期用 /cost 检查 token 使用
• 对于 20 万 token 模型，在 60-70% 满时运行 /compact，指定保留关键信息
• 对于 Opus 的 100 万 token，监控长会话
• 话题切换时用 /clear 清空上下文

努力级别： Opus 4.6 引入低、中、高、最大设置。复杂架构用 /effort high，快速修复用 /effort low 节省 token。

Git 策略： 大变更前频繁创建检查点，便于快速回滚。提交格式：git commit -m "checkpoint: before [变更描述]"。

MCP 服务器 通过本地集成扩展 Claude Code。热门选项：

• Playwright 用于浏览器自动化
• GitHub 用于 PR 和问题跟踪

用 /mcp 检查已连接 MCP。

关键要点

• CLAUDE.md 强制执行严格规则，每会话重新加载
• 子代理隔离任务，保护主上下文
• 钩子阻止测试失败的提交
• 即使 100 万 token，也需重视上下文管理
• Git 检查点实现快速回滚

— Editorial Team