結論先說
- 團隊協作的核心是把「公共契約進 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 條評論
還沒有評論,來搶沙發~