想为团队共享 Claude Code 的配置和经验，最落地的方法就是通过 Git 管理一个“团队规范仓库”，再结合 Claude Code 内置的配置加载机制。这样既能保证团队规范一致，又能让成员保留个人偏好。

整个流程的核心，就是利用 Claude Code 的分层配置特性。我们将创建一个团队共享的规范仓库，团队成员克隆后，通过符号链接（symbolic link） 把它“植入”到自己的 Claude Code 全局配置中，从而实现共享。

第一步：建立团队规范仓库 (Team Config Repo)

首先，你需要创建一个新的 Git 仓库（在 GitHub、GitLab 或公司内部 Git 服务上均可），这个仓库将作为你们团队所有 Claude Code 配置的“中央集散地”。仓库的推荐结构如下：

team-claude-config/
├── README.md                     # 说明文档
├── CLAUDE.md                     # 团队全局规范
├── .claude/
│   ├── settings.json             # 团队共享的 MCP、权限等配置
│   ├── skills/                   # 存放团队共享的技能
│   │   └── code-review/
│   │       └── SKILL.md
│   ├── rules/                    # 分门别类的项目规则
│   │   ├── api-conventions.md
│   │   └── testing.md
│   └── commands/                 # 自定义斜杠命令
│       └── deploy.md

将这份仓库结构提交到 Git 后，就完成了第一步。

第二步：成员配置与“挂载”

接下来，每个团队成员都需要在自己的电脑上进行一次性的配置，将刚才的团队仓库“挂载”到 Claude Code 的配置中。

1. 克隆团队规范仓库
   在自己的电脑上选择一个统一的位置，例如 ~/workspace/team-claude-config，运行 git clone 命令将团队仓库拉取到本地。
2. 创建符号链接
   这是最关键的一步。通过创建符号链接，把团队仓库里的 .claude 目录，链接到 Claude Code 的全局配置目录 ~/.claude/skills/ 下。

ln -s ~/workspace/team-claude-config/.claude ~/.claude/skills/team-settings

1. 测试验证
   启动 Claude Code，输入 /skills 命令查看是否能看到团队共享的技能。或者直接向 Claude 提问：“请列出项目根目录下的文件”。如果它能正确响应，说明配置已生效。

第三步：核心配置文件详解

在第一步创建的仓库中，有几个核心文件是实现团队共享的关键。下面我们一一说明。

CLAUDE.md：团队的“项目备忘录”

这是 Claude Code 在每次对话开始时都会自动加载的系统指令，相当于给 AI 的“永久记忆”。建议在仓库根目录放一个，用于定义所有项目的通用规范。

• 作用：统一团队的编码风格、项目架构、常用命令等核心信息。
• 优势：内容会被持久化，即使对话上下文被清空（/compact），这份记忆也依然存在。

CLAUDE.md 内容示例：

# 团队通用规范

## 编码风格
- 使用 ES 模块 (import/export) 而非 CommonJS (require)
- 所有函数必须包含 JSDoc 注释
- 优先使用 `const` 和 `let`，避免使用 `var`

## 常用命令
- `npm run build`：构建生产环境代码
- `npm run test`：运行单元测试
- `npm run typecheck`：执行 TypeScript 类型检查

## 工作流程
- 完成代码更改后，请确保通过所有测试
- 提交前必须进行类型检查

 .claude/rules/：模块化的规则宝库

当 CLAUDE.md 变得臃肿时，可以将不同模块的规则拆分到 .claude/rules/ 目录下的多个文件中。你可以通过 paths 字段，让规则只在处理特定文件时加载，从而节省宝贵的上下文窗口 Token。

.claude/rules/api-conventions.md 示例：

---
paths: "src/api/**"
---
# API 开发规范

- 所有 API 接口必须定义在 `src/api/routes/` 目录下
- 使用 `async/await` 处理异步操作
- 错误处理统一使用 `ApiError` 类

 .claude/skills/：团队的专业技能

Skills 是 Claude 的“可插拔”技能包，它会根据任务描述自动调用，让 AI 拥有解决特定问题的“专家”能力。

创建 Skill 的步骤：

1. 在 .claude/skills/ 下创建技能目录，如 code-review。
2. 在该目录中创建 SKILL.md 文件，并按规定格式编写内容。

.claude/skills/code-review/SKILL.md 示例：

---
name: code-review
description: 按照团队标准进行代码审查。当用户要求"审查代码"或"code review"时使用。
---

# 代码审查指南

作为代码审查专家，请遵循以下流程：

1. **功能性检查**：代码是否实现了预期功能？是否有逻辑错误？
2. **可读性审查**：变量/函数命名是否清晰？是否需要添加注释？
3. **性能评估**：是否存在性能瓶颈或不必要的计算？
4. **安全性扫描**：检查常见的安全漏洞，如 SQL 注入、XSS 等。
5. **测试覆盖**：核心逻辑是否有对应的单元测试？

 .claude/commands/：自定义斜杠命令

Commands 可以让你创建简单的自定义斜杠命令（例如 /deploy），用于执行重复性任务或运行脚本。

.claude/commands/deploy.md 示例：

---
description: 执行项目构建和部署流程
---
请执行以下部署步骤：
1. 运行 `npm run build` 进行项目构建
2. 检查构建产物是否生成在 `dist/` 目录
3. 确认无误后，执行 `npm run deploy:staging` 部署到预发布环境

 .claude/settings.json：团队的权限策略

settings.json 是 Claude Code 的核心配置文件，用于定义权限策略、MCP 服务器等团队级行为。

.claude/settings.json 示例：

{
  "permissions": {
    "allow": ["Read", "Edit", "Bash(npm run test)"],
    "deny": ["Edit(.env)", "Bash(rm -rf /)", "Read(/etc/passwd)"],
    "ask": ["Bash(git push)", "Bash(npm publish)"]
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/security-guard.sh"
          }
        ]
      }
    ]
  }
}

• allow：白名单，允许的操作。
• deny：黑名单，直接拒绝的操作，且无法被个人配置覆盖。
• ask：敏感操作，每次执行前都会询问用户。
• hooks：强大的钩子系统，可以在特定事件（如工具调用前后）执行自定义脚本，实现安全审计、代码自动格式化等。

第四步：完善个人配置与安全

为了避免个人偏好影响团队，以及防止敏感信息泄露，需要做好个人配置的管理。

1. 忽略个人配置：在每个项目的根目录下，务必在 .gitignore 文件中添加以下两行，防止团队成员的个人配置被误提交到项目仓库中。

.claude/settings.local.json
CLAUDE.local.md

1. 个人化设置：团队成员如果想在项目中有自己的特殊配置（如添加个人文档目录），可以在项目根目录创建 CLAUDE.local.md 或 .claude/settings.local.json 文件。这些文件不会被 Git 跟踪，只会影响本人。

总结

通过以上四个步骤，你就成功地为团队建立了一套可维护、可扩展的 Claude Code 共享方案。其核心思路就是：将团队的智慧沉淀为代码化的配置，并通过 Git 进行统一管理和分发。

这个方案有以下几个好处：

• 规范统一：确保所有成员的 AI 助手遵循相同的最佳实践。
• 知识沉淀：将团队的开发经验和规范固化下来，成为可复用的资产。
• 高效协作：新人上手更快，老成员同步规范更简单。
• 保持灵活：在共享规范的同时，也保留了成员个人定制的空间。