Skip to content
Published on

Claude Code 团队工作流实战指南：安全运行终端优先 Agent 的方法

🇰🇷KO🇺🇸EN🇯🇵JA🇨🇳ZH
필사 모드
分享
Authors

为什么 Claude Code 对团队很重要

Claude Code 是 Anthropic 的 agentic coding tool，运行在终端之中。这一点是核心。许多 AI 编码工具止步于再开一个聊天窗口，而 Claude Code 会直接进入开发者已经在使用的终端，直接编辑文件、执行命令、创建提交，需要时还能用 claude -p 像脚本一样被调用。

也就是说，与其说这是一个对话式助手，不如说它更接近附着在终端工作流上的执行型 agent。

Claude Code 能做什么

按官方文档的说法，Claude Code 可以做到以下几点。

  • 直接编辑文件
  • 执行命令
  • 创建提交
  • 使用 MCP 连接外部工具
  • 通过 claude -p 像脚本一样被调用

正因为如此，Claude Code 更擅长实际执行工作，而非单纯回答问题。它与本地验证、重构、修复 lint、准备 PR 这类流程很契合。

设置应当分层管理

Claude Code 的设置具有层级结构。

  • ~/.claude/settings.json 是用户全局设置
  • .claude/settings.json 是团队共享的项目设置
  • .claude/settings.local.json 是个人实验或仅限本地的设置

这种结构的好处在于，能把团队规则和个人偏好分开。团队用项目设置统一基本行为，个人只需用本地设置调整自己的工作风格即可。

memory 应按团队、个人、组织划分

Claude Code 的 memory 文档对用好这个工具非常重要。

  • ./CLAUDE.md 是项目 memory
  • ~/.claude/CLAUDE.md 是用户 memory
  • enterprise policy memory 适用于整个组织

实务上，在 ./CLAUDE.md 里写清项目结构、构建方法、测试命令、提交规则、常见易错点是最有效的做法。个人 memory 则用来保存各自常用的工具或风格即可。

subagents 用于隔离上下文

Claude Code 文档中 subagents 的优势很明确。每个 subagent 使用独立的 context window，并可以配置成只拥有特定的 tools。这在团队运营中相当有力。

  • 专门做审查的 subagent
  • 专门写测试的 subagent
  • 专门写文档的 subagent
  • 专门做迁移的 subagent

这样划分之后，可以减少一个 agent 什么都做、导致上下文被污染的问题。尤其在大型仓库中，subagent 的划分会直接影响质量。

hooks 很强大，但要谨慎使用

hooks 能让你在执行过程中的特定节点运行 shell command，对验证、日志记录、安全检查、工作流自动化都很有用。但官方文档也明确说明：在添加 hook command 之前，必须先审查并理解它。

实务原则很简单。

  • 先读懂再添加
  • 文件路径使用绝对路径
  • 排除敏感文件
  • 不要把验证用的 hook 和破坏性 hook 混在一起

hook 不应被当作自动化的终点，而应被当作受管控自动化的起点。

团队推广的关键在于 shared memory 与 policy

要在团队里用好 Claude Code，运营规则要先于功能。

  1. 为每个项目创建 ./CLAUDE.md
  2. 基本设置放在 .claude/settings.json
  3. 个人偏好用 .claude/settings.local.json 分离出来
  4. 危险命令用 permissions 或 deny 规则限制
  5. 添加 hooks 之前必须设置审查流程
  6. 重复性工作用 subagent 分离

遵循这个顺序，团队整体可以共享相同的基本行为，同时个人的实验也能安全地保留下来。

Claude Code 与以 GitHub 为中心的 cloud agent 有何不同

Claude Code 是终端优先的，它在开发者已经所在的地方直接工作。相反，GitHub Copilot cloud agent 是 GitHub 优先的，把 issue、分支、PR、review 都整合在 GitHub 内部。

两者的差异可以这样概括。

  • 需要快速的本地修改与命令执行时，Claude Code 更合适
  • 想在 GitHub 内异步委托工作时，cloud agent 更合适
  • 需要精细处理团队规则和执行策略时，Claude Code 的 settings 与 hooks 更有优势

与其说这两个工具是竞争关系，不如说它们处在开发流程的不同环节。

常见错误

引入 Claude Code 时常见的错误如下。

  • 把 CLAUDE.md 只当作个人笔记，不写入团队规则
  • 把 settings.local.json 和共享设置混在一起
  • 不使用 subagent，把所有事情都塞进一个大的上下文里
  • 不经审查就添加 hooks
  • 过快扩大 MCP 工具的使用范围，导致权限过大

尤其是 hooks，虽然方便，但用错了就不是自动化，而会变成事故的源头。

推广顺序

安全的引入顺序大致如下。

  1. 用 CLAUDE.md 确定项目基准
  2. 分离共享设置与本地设置
  3. 把经常重复的工作做成 subagent
  4. 只在需要时才连接 MCP 工具
  5. hooks 从验证用途开始慢慢引入
  6. 明确限制危险命令与敏感文件的访问

这样一来，既能保持终端自动化的速度，又能维持团队整体的安全性。

参考资料

Discuss on Twitter • View on GitHub