结论先说
- 团队协作的核心是把「公共契约进 Git」和「私人偏好进
.gitignore」彻底分开。 - 必须提交进 Git 的五样东西:项目
CLAUDE.md(及.claude/rules/)、.claude/settings.json、.mcp.json、以及.claude/agents/与.claude/skills/。 - 必须留在本地不提交的两样东西:
.claude/settings.local.json和CLAUDE.local.md,专门给成员覆盖个人习惯。 - 共享权限的生效前提:项目
.claude/settings.json里的deny和ask规则拉下代码立刻生效,但allow自动放行规则要等每位同事在本机首次打开并点击「信任此文件夹」后才启用。 - 跨多个仓库复用扩展时,搭一个团队内部 Git 插件市场,配合
extraKnownMarketplaces和enabledPlugins让新成员开箱即装。

图:本站根据 Claude Code 官方文档:Settings 与《Memory》整理的示意图
本文根据 Claude Code 官方文档《Settings files and precedence》《How Claude remembers your project》《Discover and install plugins》《Connect Claude Code to tools via MCP》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code 团队 协作」,想让组里五六个程序员拉下同一个 Git 仓库就能共用一套代码规范、常用权限和检查钩子的技术负责人;
- 团队成员手滑把自己的个人本地配置提交进了主分支,把同事的终端配色或路径搞乱过的人;
- 想给全组统一分发内部自定义斜杠命令(Skills)、专职子代理和项目 MCP 服务的人。
一、仓库目录怎么摆:公共提交层与个人隔离层
新项目初始化团队配置时,先把仓库结构按官方约定划清楚(全局用户级文件的分工另见 全局 CLAUDE.md 怎么配 与 settings.json 配置详解):
text
your-repo/
├── CLAUDE.md # 提交:精简的构建/测试命令与架构红线(建议 ≤200 行)
├── CLAUDE.local.md # 忽略:成员自己的沙盒测试账号或临时备忘
├── .mcp.json # 提交:项目共用的 MCP 服务(用环境变量引密钥)
└── .claude/
├── settings.json # 提交:团队统一权限、Hooks、推荐插件与署名规则
├── settings.local.json # 忽略:成员个人在弹窗点「不再询问」攒下的本地规则
├── rules/ # 提交:按前端/后端目录 paths 拆分的细则文档
├── agents/ # 提交:团队共用的测试员、审查员子代理
└── skills/ # 提交:团队统一发版说明、建表迁移等技能
记得在仓库 .gitignore 补上两行,防止同事误提交私人文件:
gitignore
CLAUDE.local.md
.claude/settings.local.json
二、一份可直接抄进仓库的团队 .claude/settings.json

图:本站根据 Claude Code 官方文档:Settings 整理的示意图
把下面这份模板放进 .claude/settings.json 提交到主分支,就能一次性帮全组配好常用命令免确认、禁止读取敏感 .env、拦截带副作用的 git push、挂载内部插件市场,并统一用项目内的相对路径跑检查钩子:
json
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test *)",
"Bash(git status)",
"Bash(git diff *)"
],
"ask": [
"Bash(git push *)"
],
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-cmd.sh"
}
]
}
]
},
"extraKnownMarketplaces": {
"team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
},
"enabledPlugins": {
"api-conventions@team-tools": true
}
}
写团队配置时要特别避开三个常见坑:
- 钩子路径一律用
${CLAUDE_PROJECT_DIR},千万别写死某个人电脑上的/Users/zhangsan/...绝对路径;如果组里既有 macOS 又有 Windows 同事,钩子脚本优先用仓库自带的node或python脚本保证跨系统能跑。 - 列表是合并而不是覆盖:如果某位同事在自己的用户级或
settings.local.json里对某条命令写了deny,哪怕团队settings.json写了allow,最终仍按deny拒绝——官方规定deny永远最先判定。 - 跨仓库插件市场与
.mcp.json不要硬编码密钥:.mcp.json里需要令牌时用环境变量占位符(配法见 Claude Code MCP 配置教程);多仓库共用的规范和技能打包成内部插件仓库(流程见 自己写插件并发布到 marketplace),比在十个仓库里复制粘贴好维护得多。
三、团队账号与席位合规(别共用同一个个人号)
配置可以共享,登录凭据不能共享。Anthropic 官方条款明确禁止多人共用同一个消费者账号或 API 密钥(官方条款拆解见 Claude Code 能共享账号吗:官方条款与 Team 席位):
- 企业或固定研发组应开通官方 Claude Team / Enterprise 席位,或在企业云平台(Anthropic Console、Bedrock、Vertex AI)为每位工程师签发独立密钥,并可通过系统目录部署不可被个人覆盖的
managed-settings.json; - 小团队成员各自维护独立个人订阅时,可在本站查看 Claude Code 订阅充值说明 或高额度的 Claude Max 充值说明。
常见问题
问:新同事拉下代码后说共享的 settings.json 好像没读到,怎么核实?
答:让他在会话里输入 /status,查看 Setting sources 一行是否列出了 Project settings;如果文件里有语法错误(比如不小心写了 // 注释或多了一个末尾逗号),运行 claude doctor 就能定位具体哪一行报错。
问:项目里的 CLAUDE.md 越写越长,每个人每次提问都变费额度怎么办?
答:官方建议单份 CLAUDE.md 控制在 200 行以内。把只在特定模块才用得到的规则拆进 .claude/rules/ 目录,并在文件头加上 paths 前置字段,这样只有改到对应目录的文件时才会按需加载。
问:云端版(claude.ai/code)能读到我们提交进仓库的 .claude/settings.json 吗?
答:可以。官方说明云端会话从克隆你的 Git 仓库起步,提交在仓库里的 CLAUDE.md 和 .claude/settings.json 同样会被读取。
相关教程
- Claude Code settings.json 配置详解
- 全局 CLAUDE.md 怎么配:用户级与项目指令分工
- Claude Code 能共享账号吗:官方条款与 Team 席位
- Claude Code 自己写一个插件并发布到 marketplace
- Claude Code MCP 配置教程
参考资料
- Claude Code 官方文档:Settings files and precedence — https://code.claude.com/docs/en/settings
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
- Claude Code 官方文档:Discover and install plugins — https://code.claude.com/docs/en/discover-plugins
- Claude Code 官方文档:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
0 条评论
还没有评论,来抢沙发~