10分钟内将 Claude Code 配置为有纪律的 AI 开发团队

Claude Code 设置套件的作用

Claude Code 设置套件通过添加项目记忆、工程规则、辅助代理、测试、代码检查和部署保护措施，将 Claude Code 转变为一支结构更完善的开发团队。它适用于企业主、氛围编程者、IT 专业人员以及希望 Claude Code 更加规范地工作的开发者。

否则，Claude Code 可能会在不同会话之间遗忘重要的项目上下文，在缺乏一致约束的情况下工作，或将存在问题的更改推送到线上应用。该套件通过单个设置文件生成可运行的项目结构，解决这些问题。

它适用于新建和已有的代码仓库。该套件尤其适合 Cloudflare Workers，也能适配 Vercel、Node 和 Python 等技术栈。

主要功能

• 项目记忆：CLAUDE.md 和 docs/ 目录会保留当前线上状态、后续计划以及已作出的决策。
• 团队规则：.claude/rules/ 中的文件定义安全、测试、整洁代码和通俗沟通方面的要求。
• 七个辅助代理：更便宜、更快速的模型可以执行搜索、构建、测试和检查工作，而主模型负责规划和审查。
• 基于风险的通道：小型、中型和大型更改会逐步接受更严格的检查。
• 推送保护：设置可以阻止推送到错误目标、强制推送以及检查失败时的推送。
• 自动测试和代码检查：更改在触达用户之前会经过检查。
• 文档更新：/update-docs 命令会记录进展，供下一次会话使用。
• 可选功能：包括公开代码仓库泄露检查、适用于每个项目的安全网推送保护，以及带有经过测试的恢复流程的 Claude 设置备份。

安装设置套件

第 1 步：下载设置文件

在代码仓库中打开 SETUP-CLAUDE-STRUCTURE.md，然后选择下载原始文件。最初只需添加这一个文件。

第 2 步：将文件放入项目

将 SETUP-CLAUDE-STRUCTURE.md 复制到项目的根目录。你可以使用已有代码仓库，也可以从一个新的空文件夹开始。

第 3 步：运行 Claude Code

在同一个项目文件夹中打开 Claude Code，并告诉它遵循设置说明：

Follow SETUP-CLAUDE-STRUCTURE.md

Claude 会提出五个简短问题，展示一份计划，并在进行结构性更改前等待你的批准。准备好后，请查看计划并明确确认。

Claude Code 会保护 .claude/ 文件夹，因此在写入其中的单个文件前可能会请求权限。批准这些设置操作时，请选择允许。

设置过程中会发生什么

Claude 首先会询问项目情况并确定技术栈，然后围绕现有代码构建适当的结构，而不会改变应用的工作方式。

设置的目标是增加组织结构、文档、检查和测试，不会改变应用的行为。如果你已经有 CLAUDE.md 文件，Claude 会保留其中的内容，将其移到适当位置，并在 Git 历史中保留之前的版本。

如果不适用，Cloudflare 专属部分会被跳过。例如，Node 或 Python 项目会根据检测到的技术栈获得相应的检查和规则，而不是仅适用于 Cloudflare 的配置。

基本用法

开始新的工作会话

设置完成后，在项目目录中打开 Claude Code，并描述你想完成的任务。生成的项目记忆会为 Claude 提供当前状态、后续工作和过往决策等上下文。

Help me add the next feature listed in the project documentation.

Claude 会使用项目规则和基于风险的通道，确定该更改需要多少规划、实施、测试和审查。

请求小型更改

对于范围有限的更改，请明确说明预期结果，并要求 Claude 进行验证：

Make this small UI text change, run the relevant checks, and report what changed.

小型工作会在绿色通道中处理，而规模更大或风险更高的更改会接受更全面的检查。

记录会话之间的进展

在工作会话结束时，运行文档命令，让项目记忆反映最新进展：

/update-docs

这会保存当前状态，供下一次会话使用，帮助 Claude 从有用的上下文开始，而不是从头开始。

安全与审批规则

该套件围绕明确审批和最小访问权限原则设计：

• Claude 在进行结构性更改前会先询问。
• Claude 在询问前绝不会推送，因为推送可能会发布应用。
• 可以记录密钥名称，但绝不会存储密钥值。
• 规则会阻止 Claude 打开 .env 和 .dev.vars 等敏感文件。
• 测试使用空白密钥，因此无法访问真实服务。
• 推送保护可以阻止强制推送、推送到错误目标，以及检查失败时的推送。

当 Claude 请求访问受保护的设置文件时，请检查请求的操作，只批准你希望它执行的工作。

高级技巧

使用通道，让审查力度匹配风险

将这三条通道视为一个轻量级变更管理系统。绿色用于小型变更，黄色用于中型变更，红色用于大型变更。随着潜在影响增加，在变更被视为就绪之前，应进行更多规划、验证和审查。

保持项目记忆最新

在完成有意义的工作后使用 /update-docs，不要等到漫长项目结束时再更新。最新的文档能让未来的会话更加可靠，并使决策保持可见。

为公开项目或活跃项目启用可选的安全措施

如果项目是公开的，可以考虑启用可选的泄漏检查。对于担心意外部署的项目，请使用安全网推送保护。备份选项可以保留你的 Claude 设置，并包含经过测试的恢复流程。

根据现有的提供商和技术栈调整工具包

该工具包推荐将 OpenRouter 用于 AI 应用，因为一个密钥即可访问多个模型，但不会强制使用该提供商。如果你的项目已经使用其他提供商，则保留现有选择。

在 Windows 上，推送保护是一个 Bash 脚本。请使用 WSL 或 Git Bash，并遵循 Claude 关于所需安装步骤的指导。

结语

Claude Code Setup Kit 为 Claude Code 提供了可重复的项目工作流，无需你自行设计结构。下载一个文件，将其放入项目中，然后要求 Claude 遵循它。获得批准后，你将拥有持久的项目记忆、明确的规则、辅助代理、基于风险的通道、自动化检查、文档更新以及更安全的推送行为。

如需获取最新版本，请查看仓库的 CHANGELOG.md，并浏览可用的 版本发布。本项目采用 CC BY 4.0 许可证，允许在注明 Abdo Samy 并附上指向仓库的链接的情况下使用、分享和改编。