Claude Code 项目起步包

由 Mindket 上架工具包开发

新上架第 1 版 · 更新于 2026-11-03

适用于你在 Claude Code 里打开的任何仓库。里面有一份待填写的 CLAUDE.md、一个权限设得谨慎的设置文件，以及 /plan-task 和 /review-changes 两个斜杠命令。

Claude Code 项目起步包是一款工具包，属于开发类，由 Mindket 上架。可免费获取。当前为第 1 版，最近更新于 2026-11-03。在本页下载，是一个装着它全部文件的 zip 压缩包。这些文件不会自己运行。

速览

用在

Claude Code：设置文件和两个命令遵循它自己的格式
其他 AI 工具：CLAUDE.md 是普通 Markdown，它的结构也能当作给这些工具的说明来用
团队的仓库：提交一次，每个人都从同样的起点开始

平台

Claude Code编程智能体

关于

它是什么

给你用 Claude Code 开发的任何仓库准备的起步文件夹。里面有一份待填写的 CLAUDE.md、一个权限设得谨慎的项目设置文件，以及两个斜杠命令：/plan-task 和 /review-changes。有了它，不用在每个项目里重复写同样的配置。Claude Code 还会收到指示：先跑你的测试和 linter，再说任务完成。

README.md
CLAUDE.md
.claude/settings.json
.claude/commands/plan-task.md
.claude/commands/review-changes.md

每个文件的作用

文件	作用
CLAUDE.md	Claude Code 每次会话开始时读取的项目说明。把每一行尖括号里的内容换成你自己的。
.claude/settings.json	规定 Claude Code 哪些事可以不问你就做，哪些事绝不能做
.claude/commands/plan-task.md	添加 /plan-task：改任何文件之前先出一份计划
.claude/commands/review-changes.md	添加 /review-changes：审查还没提交的改动，找 bug，不管代码风格
README.md	说明里面有什么，以及设置步骤

适合谁

在多个仓库里用 Claude Code、总在手动重复写同样配置的开发者。团队负责人从中受益最多，因为只要提交一份，共用代码库上的每个会话就都遵循同一套规则。

谁在用，怎么用

行业	谁在用	怎么用	例子
软件公司	负责共用代码库的团队负责人	把这个工具包提交一次，让每位开发者的 Claude Code 都遵循同一套规则	团队负责人把它提交到主仓库，让每位开发者的 Claude Code 在汇报之前都运行同样的测试和 lint。
外包和自由职业	自由职业者和外包公司的开发者	放进每个新项目，再填上那个客户的命令	自由职业者把它加进新客户的仓库，填上那个客户的安装、测试和 lint 命令。
开源	接收用 Claude Code 写的贡献的维护者	提交 CLAUDE.md，让贡献者的智能体在改任何东西之前先读项目规则	维护者在里面写明测试命令和值得先读的文件夹，贡献者的会话一开始就有这些信息。
金融和其他敏感数据	必须让密钥远离智能体的团队	保留针对 .env 文件、secrets 文件夹、git push 和 rm -rf 的 deny 规则	一个支付团队提交了这份设置，Claude Code 不能读取 .env，也不能推送，团队仍然不把密钥放进仓库。

如果你只是偶尔在临时项目里用 Claude Code，它的默认设置就够了。

用在哪里

任何你用 Claude Code 打开的 Git 仓库，从周末小项目到团队代码库都行。

Claude Code：设置文件和两个命令遵循它自己的格式
其他 AI 工具：CLAUDE.md 是普通 Markdown，它的结构也能当作给这些工具的说明来用
团队的仓库：提交一次，每个人都从同样的起点开始

如何设置

点“获取”会把一个 zip 压缩包存进你的下载文件夹。里面没有任何东西会自行运行。

先准备好这些

需要	说明
Claude Code	已安装，并在你要设置的仓库里打开
你项目的命令	安装、运行、测试和 lint 命令，用来填 CLAUDE.md
能看到点开头文件夹的方法	.claude 文件夹以点开头，所以有些文件管理器会把它隐藏起来

解压后，把 CLAUDE.md 和 .claude 文件夹复制到仓库根目录。
打开 CLAUDE.md，把每一行尖括号里的内容换成你项目的实际情况，先填命令。
如果你用 pnpm、yarn 或其他运行工具，改一下 .claude/settings.json 里的 npm 那几行。
把这两样都提交，让项目里每个人都从同样的起点开始。

命令最要紧，因为 Claude Code 要靠运行它们来检查自己的工作。

如何使用

在仓库里启动 Claude Code。它会在每次会话开始时读取 CLAUDE.md，所以你还没输入，项目的命令和规则就已经在它那里了。改动之前先要一份计划，提交之前先做一次审查。

两个命令

命令	什么时候用	做什么
/plan-task	做一处有风险的改动之前	读取这项任务可能改到的文件，每个文件写一行计划，然后停下来等你点头
/review-changes	提交 Claude Code 写的代码之前	读取 git diff 和 git diff --staged，按文件和行号列出每个问题，最严重的排在前面。没发现问题，就用一句话说明。

/review-changes

你输入 /plan-task 加上你的需求
Claude Code 读取它可能会改到的文件
每个文件写一行计划，并列出用来验证的检查
它停下来，等你点头

示例

你想给订单页加一个 CSV 导出，先要一份计划。

/plan-task add a CSV export to the orders page

Claude Code 会说明它读了哪些文件，再给每个打算修改的文件各写一行。它会说明要添加或运行哪些测试、用户会看到什么，以及哪些地方不动。然后它停下来。这时还没有任何文件被改动，你可以在它动手之前改计划。

新手与专家

新手：Claude Code 会读一个叫 CLAUDE.md 的文件，了解你的项目怎么运作。设置文件则告诉它哪些事可以不问你就做。这个工具包把这两样都准备好了，结构已经排好，另外还附了两个现成的命令。把它复制进一个小项目，只填测试命令，然后在一个很小的改动上试试 /plan-task。

专家：设置文件用的是 Claude Code 的 allow 和 deny 列表，原样如下。不在 allow 列表里的操作仍会先问你。这点麻烦就是要付出的代价，等你逐渐信任这个智能体，可以逐个项目放宽列表。

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(npm test:*)",
      "Bash(npm run lint:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(git push:*)",
      "Bash(rm -rf:*)"
    ]
  }
}

两个命令是 .claude/commands 下的提示词文件，开头各有一行描述。像对待代码一样审查和编辑它们。/plan-task 会把你输入的话作为 $ARGUMENTS 传进去。

CLAUDE.md 一开始就写好了五条工作规则，你可以保留，也可以改：

改任何东西之前，先读任务点名的文件
每处改动只做要求的事，发现别的问题就说出来，不要顺手去改
说任务完成之前，先跑测试和 linter，并给出它们的输出
添加依赖、改公开 API 或修改数据库迁移之前，先问
绝不把密钥或密码写进代码或提交

注意事项

只有文本：没有脚本，也没有密钥
不问就能做：查看 git status、读取 diff 和日志、运行 npm test 和 npm run lint
禁止的操作：读取 .env 文件和 secrets 文件夹、git push 和 rm -rf
deny 规则：只是一道防护，不是沙盒，所以密钥还是别放进仓库
在 Mac 上：Finder 会隐藏 .claude 文件夹，直到你设置显示隐藏文件

README 和文件

README