团队用法一套规则、各自的 Key、可追溯的账
一个人用 Claude Code 靠习惯,一个团队用要靠仓库里的约定。规则放进 .claude/ 目录,每人每项目一把 Key,再把它接进 CI,团队的产出才可复制、可审查、可算账。
全部章节
本页
先说结论
- 把
.claude/目录、CLAUDE.md和.mcp.json一起提交进仓库,团队用同一套规则、命令和护栏。 - 每个成员、每个自动化任务各用一把 Key,费用和行为都能按 Key 追溯;有人离开,停用他的 Key 即可。
- 它写的代码和人写的代码走同一套评审。把 Claude Code 接进 CI,用来做初审和机械性修复,而不是替代评审。
仓库里该有什么
.claude/
├── settings.json # 权限规则、默认模式、Hooks(团队共识)
├── skills/ # /commit-msg、/team-review 等团队命令与流程
└── agents/ # reviewer、tester 等子代理定义
.mcp.json # 团队共用的 MCP 服务器(凭据走环境变量)
CLAUDE.md # 项目说明与规范个人偏好放在各自的 ~/.claude/ 下,不进仓库。.claude/settings.local.json 用于本机覆盖,记得加进 .gitignore。
这些文件和代码一样走评审。有人想放宽某条命令的权限,就提一个修改 settings.json 的合并请求,大家看过再合。
权限怎么定
团队仓库建议的默认:
defaultMode用acceptEdits:改文件自动通过,其余命令按规则走。allow:测试、构建、lint、git status、git diff、只读的数据库查询。deny:git push、部署脚本、删除云资源、读取.env。deny 在任何模式下都生效。
个人在自己的终端里可以用 auto 模式;要用 bypass,先看 权限模式 里的风险边界,最好放在容器里。原则是团队配置保持保守,个人按需放宽,而不是反过来。
Key 的管理
在控制台为每个人、每个用途各建一把 Key,名字写清楚,比如「张三-笔记本」「CI-主仓库」「夜间批处理」。好处有三个:
- 账分得清:使用日志可以按 Key 筛选,谁在哪个项目花了多少一目了然。
- 出事好止损:Key 泄露或有人离职,停用那一把,不影响其他人。
- 自动化可控:给 CI 用的 Key 单独设额度上限,循环失控时最多只会烧掉这一把的额度。
Key 只放在环境变量或 CI 的密钥管理里,不写进仓库,不发在群里。
接进 CI
claude -p 是非交互模式:执行一段指令,输出结果后退出,适合放进流水线。CI 是干净环境,要注入两个变量:ANTHROPIC_BASE_URL 和这条流水线专用的 ANTHROPIC_AUTH_TOKEN。两个常见用法:
# 合并请求初审:只报确定的问题,结果交给评审人参考
claude -p "审查本分支相对 main 的改动,只报告确定的正确性与安全问题,每条给出文件与行号" \
--output-format json > review.json
# 机械性修复:lint 不过时自动修,提交交给流水线的下一步
claude -p "运行 npm run lint,修复所有错误,不改变行为" \
--permission-mode acceptEdits --allowedTools "Bash(npm run lint *)"-p 模式下没有人可以确认,所以要用 --allowedTools 或 settings.json 的 allow 规则明确放行它需要的命令,没放行的会被直接拒绝。初审结果给人看,是否合并仍由人决定。用 GitHub 的团队也可以直接用官方的 GitHub Action。
评审它写的代码
- 要求每次改动附一句总结:改了哪些文件、为什么、怎么验证的。把这条写进团队的
/commit-msg命令。 - 小步提交:让它每完成一个可验证的步骤就提交一次,评审时看得懂,回退时退得准。
- 测试是硬门槛:用 Hooks 保证测试不过就不收尾,评审时不必再怀疑它到底跑没跑测试。
常见问题
新人怎么上手?
clone 仓库后,CLAUDE.md 和 .claude/skills/ 就是最好的入职文档。让新人先输入 / 看一遍团队命令。
多人同时让它改同一个模块怎么办?
和多人同时手写一样会冲突。按 子代理与并行 里的方法,每人一个分支或 worktree,按模块分工。
怎么判断团队用得值不值?
看使用日志里的费用分布,再对照合并请求的数量和返工率,而不是只看 tokens 总量。