Claude Code 團隊協作怎麼配:共享 settings.json、CLAUDE.md 與插件規範

搜「claude code 團隊 協作」?按官方文檔整理研發團隊統一落地清單:哪些文件該提交進 Git(.claude/settings.json、CLAUDE.md、.mcp.json、子代理與插件市場)、哪些放進 .gitignore,以及權限合併與帳號合規要點。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Team / 企業 帳號

結論先說

  1. 團隊協作的核心是把「公共契約進 Git」和「私人偏好進 .gitignore」徹底分開。
  2. 必須提交進 Git 的五樣東西:項目 CLAUDE.md(及 .claude/rules/)、.claude/settings.json、.mcp.json、以及 .claude/agents/ 與 .claude/skills/。
  3. 必須留在本地不提交的兩樣東西:.claude/settings.local.json 和 CLAUDE.local.md,專門給成員覆蓋個人習慣。
  4. 共享權限的生效前提:項目 .claude/settings.json 裏的 deny 和 ask 規則拉下代碼立刻生效,但 allow 自動放行規則要等每位同事在本機首次打開並點擊「信任此文件夾」後才啟用。
  5. 跨多個倉庫複用擴展時,搭一個團隊內部 Git 插件市場,配合 extraKnownMarketplaces 和 enabledPlugins 讓新成員開箱即裝。

Claude Code 團隊倉庫文件分工表

圖:本站根據 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 四步法

圖:本站根據 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
  }
}

寫團隊配置時要特別避開三個常見坑:

  1. 鉤子路徑一律用 ${CLAUDE_PROJECT_DIR},千萬別寫死某個人電腦上的 /Users/zhangsan/... 絕對路徑;如果組裏既有 macOS 又有 Windows 同事,鉤子腳本優先用倉庫自帶的 node 或 python 腳本保證跨系統能跑。
  2. 列表是合併而不是覆蓋:如果某位同事在自己的用戶級或 settings.local.json 裏對某條命令寫了 deny,哪怕團隊 settings.json 寫了 allow,最終仍按 deny 拒絕——官方規定 deny 永遠最先判定。
  3. 跨倉庫插件市場與 .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 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

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    MCP 收費嗎:開源協議免費邊界、第三方 API 帳單與隱形 Token 開銷說明

    搜「mcp 收費 嗎」的人常擔心裝多了插件會被扣費。MCP(模型上下文協議)本身和官方 SDK 採用 MIT 協議完全免費;實際使用中可能產生費用的只有兩處:掛載過多工具佔用的大模型上下文 Token,以及部分外部商業數據源自帶的 API 套餐。

    Claude其他 AI 工具0
  2. 02

    MCP 協議最新版本更新了什麼:無狀態架構、OAuth 2.1、結構化輸出與異步 Tasks 詳解

    搜「mcp 重大 更新」「mcp 協議 更新」想補齊規範演進脈絡?本文對照 modelcontextprotocol.io 官方規範更新日誌,梳理從 Streamable HTTP 到無狀態優先架構、OAuth 2.1 資源伺服器、Elicitation 交互補參與異步 Tasks 擴展的核心變化。

    Claude其他 AI 工具0
  3. 03

    A2A 和 MCP 有什麼區別:工具連接協議與智能體通信協議的邊界和配合

    很多人問「有了 MCP 為什麼還要出 A2A,兩者是不是二選一的競爭關係」。兩份官方規範都明確寫明它們是上下互補關係:MCP 負責給單個智能體掛載工具與數據源,A2A 負責讓多個獨立黑盒智能體跨團隊、跨框架互相派單協作。

    Claude其他 AI 工具0
  4. 04

    LangGraph 怎麼使用 MCP:用 langchain-mcp-adapters 接入本地與遠程工具

    想讓自建的 LangGraph 狀態圖直接調用現成的 MCP 伺服器,官方標準方案是安裝 langchain-mcp-adapters 並使用 MultiServerMCPClient。本文講清 stdio 與 streamable_http 兩種配置寫法、異步圖運行及按節點分工具技巧。

    Claude其他 AI 工具0
  5. 05

    LangGraph 入門教學:Python 安裝、核心概念與跑通第一個狀態圖智能體

    面向搜「python 安裝 langgraph」和「langgraph 中文 文檔」的初學者:本文按 LangChain 官方最新 Graph API 規範,講清安裝步驟、State/Node/Edge 四大概念,並從零寫出第一個帶工具調用循環的 StateGraph。

    Claude其他 AI 工具0
  6. 06

    Claude Agent SDK 子代理怎麼寫:AgentDefinition 配置、權限收斂與 Python/TS 示例

    在 Python 或 TypeScript 裏用 Claude Agent SDK 編排多角色協作,核心是配置 ClaudeAgentOptions 的 agents 字段與 AgentDefinition。本文講清必開的 Agent 委派權限、工具收斂、模型分級與完整代碼示例。

    Claude0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~