第 11 章

团队采用模式

作为个人采用 Claude Code 是一次个人实验。在整个团队中采用它是一次组织变革。机制是不同的。个人采用是关于学习提示词模式和建立肌肉记忆。团队采用是关于共享配置、合规执行、知识复合,以及发现"开发者工具"是错误的类别——因为受益最大的人中有一半不是开发者。

引导式采用路径

成功使用 Claude Code 的团队遵循一致的进展。各阶段不是任意的——每个阶段建立的信心和机构知识使下一阶段富有成效。

阶段 1:代码库问答

首先将 Claude Code 用作你自己代码库的搜索引擎。让它解释认证系统如何工作。问数据库连接在哪里配置。问部署管道做什么。

这个阶段是零风险的。Claude 在阅读,不是在编写。但它完成了两件事:开发者学习如何与智能体工具交互,他们发现他们的代码库对 Claude 是否可读。如果 Claude 不能有效地导航你的代码库,那是关于你的代码库的信号,不是关于 Claude 的。

阶段 2:小修复

进阶到小的、有边界的更改。有清晰复现步骤的 bug 修复。未覆盖函数的测试添加。文档更新。格式更改。

这些任务有一个关键属性:它们容易验证。你可以判断 bug 是否修复了,测试是否通过了,文档是否正确了。反馈循环很紧。开发者学习提供验证标准(如第八章所述)并批判性地审查 AI 生成的代码。

阶段 3:Plan Mode

对更大的任务使用 plan mode。Claude 研究并提出方法而不做更改。开发者审查计划、提供反馈,在任何代码编写之前迭代。

Plan mode 是完全自主的训练轮。它将"Claude 理解任务吗?"与"Claude 能实现任务吗?"分开。大多数实现失败可以追溯到误解,plan mode 在误解变成代码之前就捕获了它们。

阶段 4:完全自主

凭借前三个阶段的经验,开发者已经校准了他们的期望。他们知道哪些任务 Claude 处理得好,哪些需要密切监督,哪些最好手动完成。他们对适当的任务使用 auto-accept 模式。他们委派多文件更改。他们运行后台 subagent 进行并行工作。

这种进展通常每个开发者需要两到四周。试图跳过阶段——从安装直接跳到完全自主——会产生让团队放弃的不均匀结果。

/init 命令加速了阶段 1。在仓库中运行它会分析代码库以检测构建系统、测试框架和代码模式,然后生成一个起始 CLAUDE.md 文件。对于同时入职多个开发者的团队,/init 提供了一个一致的起点,捕获了代码库的基本结构,而不需要任何人手动编写初始文档。它不是团队积累知识的替代品——那来自上面的渐进阶段——但它消除了第一天的空白页面问题。

共享 CLAUDE.md

项目的 CLAUDE.md 文件提交到版本控制,是团队采用中最有价值的共享工件。如第三章所述,CLAUDE.md 提供了始终在线的上下文,塑造了 Claude 与代码库的每次交互。团队维度增加了复合价值。

复合如何工作

开发者 A 发现 Claude 一直在从一个弃用模块导入。他们在 CLAUDE.md 中添加一行:"永远不要从 src/legacy/utils 导入,使用 src/core/utils 代替。"开发者 B 从未遇到这个问题。开发者 C、D 或任何未来的团队成员也不会。修复被写了一次就永远防止了错误。

几周和几个月后,CLAUDE.md 积累了团队关于代码库的来之不易的知识。偏离惯例的构建命令。从代码中不明显的测试模式。限制实现选择的架构决策。导致静默失败的环境怪癖。

每次添加花费三十秒。跨团队、跨月份的累积价值是可观的。维护 CLAUDE.md 文件超过五次以上开发会话的团队报告 Claude Code 有效性显著提升。

应该提交什么

将项目级 CLAUDE.md 提交到版本控制。像任何其他代码更改一样审查对其的更改。这确保团队就 Claude 接收的指令达成一致。一个与团队实践相矛盾的流氓 CLAUDE.md 条目会在每个开发者的 Claude 会话中造成混乱。

不要提交个人偏好。那些属于用户级配置或被 gitignore 的本地 CLAUDE.md 文件。共享 CLAUDE.md 代表团队共识,不是个人意见。

用于合规的托管设置

企业采用需要策略执行。托管设置通过一个不能被任何其他作用域覆盖的配置层提供这一点,如第二章详述。

由 IT 部署到系统目录的 managed-settings.json 文件执行组织策略:

  • Claude Code 可以使用哪些工具
  • 哪些权限始终被拒绝
  • 允许或阻止哪些 MCP server
  • 是否可以在托管作用域之外定义 hook
  • 信任哪些插件市场

这些设置对开发者是不可见的,他们无法从 Claude Code CLI 检查或修改它们。一个发现某项功能不可用的开发者可能无法立即知道这是配置问题还是托管策略。这是有意为之的——安全策略不应该通过开发者工具来协商。

配置缺口

"在我的个人机器上能用"和"在办公室不能用"之间的差距几乎总是托管设置。如果你在帮助企业环境中采用 Claude Code,尽早验证托管设置。最优雅的项目配置在托管层覆盖它时就变得无关紧要了。

插件市场

插件将 skill、agent、hook、MCP server 和 LSP 配置打包成分发捆绑包。对于团队,市场系统提供受控分发。

私有市场

组织可以在内部基础设施上托管私有插件市场。来源包括主要版本控制平台上的私有仓库、git URL、内部包注册表、文件路径和主机模式。这让团队分发自定义插件而无需公开发布。

一个团队可能构建一个插件来捆绑他们的内部 MCP server、项目特定的 skill、编码标准 hook 和 LSP 配置。新团队成员启用一个插件就获得了完整配置的开发环境。

市场限制

托管配置中的 strictKnownMarketplaces 设置限制插件安装只能从已批准的市场来源。这防止开发者从任意 URL 或仓库安装插件——一种防止通过插件系统进行供应链攻击的安全措施。

当严格市场执行启用时,Claude Code 在任何网络请求或文件系统操作之前验证插件来源是否在允许列表中。未批准的市场来源不仅被阻止——它从未被联系过。

通过 VCS 共享项目设置

提交到版本控制的 .claude/settings.json 文件共享的不仅是权限。它跨团队共享 hook、插件启用、环境变量默认值和工具配置。

这为每个在项目上工作的人创建了一致的 Claude Code 体验。相同的 hook 为每个开发者运行。相同的权限适用。相同的插件激活。新团队成员的入职成本从"配置一切"降至"克隆仓库"。

项目 vs. 本地插件作用域

项目作用域安装的插件通过版本控制共享。本地作用域安装的插件被 gitignore,只在该机器上可见。

这种区别对于偏好异构的团队很重要。团队可能标准化一个项目作用域的插件用于代码质量 hook 和 MCP server 连接。个别开发者可能添加本地作用域的插件用于个人生产力工具、替代语言服务器或实验功能。

项目作用域是团队的标准。本地作用域是个人的扩展。两者无冲突共存。

Skill 作为共享标准

Skill——按需加载的基于文件夹的指令包——作为跨团队的便携式工作流标准。与项目特定的 CLAUDE.md 条目不同,skill 可以通过插件分发,跨项目和团队成员工作。

一个团队可能为以下内容创建 skill:

  • 代码审查标准:一个指定审查应该如何结构化、检查什么以及如何格式化发现的 skill。
  • 迁移模式:一个编码团队数据库迁移约定的 skill,包括命名、测试和回滚要求。
  • 发布流程:一个逐步走完团队发布清单、程序化验证每个步骤的 skill。

Skill 对团队采用有一个特定优势:它们是跨 agent 兼容的。一个 skill 无论 Claude 在终端、IDE 扩展还是 CI 管道中运行都有效。工作流无论界面如何都相同。这种可移植性使 skill 成为团队范围工作流标准化的正确载体,补充了 CLAUDE.md 填充的始终在线上下文角色(如第三章所述)。

企业托管策略

在组织层面,托管策略与项目级设置组合创建分层治理模型。

组织设置边界:哪些工具可用、哪些 MCP server 被批准、哪些权限被强制执行。在这些边界内,每个团队配置他们项目特定的设置。在这些设置内,每个开发者有用于机器特定需求的本地覆盖。

allowManagedHooksOnly 设置是一个值得强调的特定企业控制。启用后,只有托管配置中定义的 hook 执行。项目级和用户级 hook 被忽略。这防止受损仓库安装以用户权限运行的 hook——鉴于 hook 执行任意命令,这是一个有意义的安全控制,如第二章所述。

基于角色的工具分配

不同团队功能从 Claude Code 获得不同价值。认识到这一点可以防止将采用视为跨角色统一的错误。

产品经理

产品经理通常将 Claude Code 用于自然语言任务:编写规范、生成文档、分析需求。他们的交互是对话式的。他们很少使用 auto-accept 模式或自主执行。Plan mode 是他们的主要工作流——他们审查和精化而非实现。

后端工程师

后端工程师是主要的重度用户。架构决策、实现、测试编写、数据库迁移、API 开发——这些是 Claude Code 的核心优势。后端工程师从完整采用路径中受益最多,通常最快达到完全自主。

前端工程师

前端工作是分裂的。组件实现、样式、状态管理——Claude 处理这些很好。实时交互功能、复杂动画和像素级精确的视觉工作需要更多人工干预。前端工程师通常维持混合工作流,使用 Claude 处理结构性工作并手动实现视觉细节。

DevOps 工程师

基础设施即代码是天然的匹配。Claude 有效地生成配置文件、部署清单、CI 管道定义和基础设施配置脚本。DevOps 工程师报告使用 Claude Code 作为基础设施工作的主要工具有很高的生产力提升。

非工程角色

这是非显而易见的采用模式。团队一致发现非工程部门从 Claude Code 中提取了显著价值,通常是全新的能力而非增强速度。

法务团队使用 Claude Code 分析合同、生成合规清单和起草政策文件。他们的工作流是对话式的:在聊天界面中规划,然后让 Claude 生成结构化文档。

营销团队生成内容变体、分析活动数据,并构建以前需要工程资源的内部工具。

设计团队报告大部分时间同时打开 Claude Code 和他们的设计应用程序,使用 Claude 进行原型制作和设计规范的实现。

财务和数据团队使用 Claude Code 进行分析自动化、报告生成和数据标准化任务。

非技术采用的模式是一致的:这些团队不是更快地做现有工作。他们是在做以前没有工程支持就不可能做的工作。这是与工程师体验的速度增强根本不同的价值主张。

两种不同的用户体验

这种区别——速度增强与全新能力——值得单列一节。

对于开发者,Claude Code 让现有工作更快。需要一天的重构变成两小时。需要一下午的测试套件变成二十分钟。工作是相同的;时间线压缩了。这有价值但是增量的。

对于非技术用户,Claude Code 实现了以前不可能的工作。一个不会写代码的营销团队成员现在可以构建内部仪表板。一个不会查询数据库的法务团队成员现在可以程序化地分析合同数据。工作是新的;能力是新颖的。

仅以开发者速度衡量采用成功率的团队错过了一半价值。非技术采用创造了全新的组织能力。一个构建了自己第一个内部工具的团队成员不是更快地做旧工作。他们在做一个根本不同的工作。

跨团队知识共享

团队报告的最有效的采用模式是结构化知识共享:演示会话,团队互相展示他们如何使用 Claude Code。

后端团队演示他们的多 agent 测试工作流。设计团队展示他们如何用截图做原型。安全团队展示他们的自定义斜杠命令库。数据团队走完他们的分析管道。

这些会话有机地传播最佳实践。它们还暴露了其他团队未曾考虑的用例。法务团队看到后端团队的代码审查 skill 并意识到它可以改编用于合同审查。营销团队看到数据团队的分析工作流并意识到他们可以在活动数据上使用相同方法。

内部演示比文档更有说服力。看到同事有效使用工具创造了入门指南无法创造的采用动力。

十个团队的实际工作方式

通用类别——后端、前端、DevOps——掩盖了真实故事。当你看一个大型工程组织中不同团队实际如何使用 Claude Code 时,工作流戏剧性地分歧。以下内容来自一家大型 AI 公司记录的逐团队采用情况,经过泛化以保护具体信息。

数据基础设施

数据基础设施团队管理整个组织的业务数据管道。他们最令人惊讶的贡献不是技术性的:他们教会财务同事编写描述数据工作流的纯文本文件,然后将这些文件加载到 Claude Code 中进行全自动执行。非编码人员编写 Claude Code 端到端执行的自然语言工作流描述——这是任何以开发者为中心的入职计划都不会预测到的采用。

在他们自己的团队中,他们使用 CLAUDE.md 替代传统数据目录和可发现性工具。新数据科学家被指导让 Claude Code 导航代码库,它读取 CLAUDE.md 文件,识别特定任务的相关文件,解释数据管道依赖,帮助新人理解哪些上游数据源输入到哪些仪表板。他们跨不同仓库运行并行 Claude Code 实例处理长时间运行的任务,每个实例在数小时或数天后切换回来时仍保持完整上下文。

他们的一个独特实践是大规模监控。Claude Code 处理大量数据并识别异常——比如扫描两百个仪表板——这是任何人都无法手动审查的。他们还举行队内使用会话,成员互相演示 Claude Code 工作流,有机地传播最佳实践。在每次会话结束时,他们让 Claude 总结完成的工作并建议工作流本身的改进,创建一个持续改进循环,不仅精化项目知识,还精化团队的流程。

产品开发

产品开发团队管理核心平台能力和智能体功能。他们在两种不同模式下运作,模式之间的选择是经过深思熟虑的。

对于原型设计和外围功能,他们使用 auto-accept 模式设置自主循环。Claude 编写代码,运行测试,持续迭代,工程师在大约 80% 完成时审查解决方案,然后接手进行最终精化。对于核心业务逻辑和关键功能,他们同步工作,给出详细提示词并实时监控 Claude 的输出,以确保代码质量、风格指南合规和适当的架构。

这种分法很重要。他们最成功的异步项目之一涉及一个复杂功能实现,大约 70% 的最终代码来自 Claude 的自主工作,只需要几次迭代来完成。他们的任务分类标准值得复制:产品边缘的任务(外围功能、原型设计、探索性代码)进入 auto-accept 模式。触及核心功能的任务获得带详细提示词的同步监督。学会快速做出这种区分本身就是一种需要数周发展的技能。

安全工程

安全团队专注于保护软件开发生命周期和供应链。他们占整个组织单体仓库中所有自定义斜杠命令的一半——一种非凡的密度,揭示了 Claude Code 深度嵌入到他们的实践中。

他们将基础设施即代码计划复制到 Claude Code 中并问,实质上是"这会做什么,我会后悔吗?"这为基础设施更改的安全审查创造了更紧密的反馈循环,消除了开发者等待安全团队批准的瓶颈。他们还让 Claude 摄取多个文档来源并将其综合成 markdown runbook 和故障排除指南,然后将这些精简文档作为调试真实事故的上下文。

他们最具变革性的改变是工作流:他们替换了设计功能、编写粗略代码、重构、最终放弃测试的模式,改为测试驱动开发方法,其中 Claude 先写伪代码,他们引导它通过 TDD,并定期检查。他们将规范作为 markdown 存储在代码库中,由 Claude 编写、审查和执行,在几天内实现有意义的项目贡献,而不是以前所需的数周上下文建设。

他们的操作哲学与众不同:他们不是提出针对性问题,而是告诉 Claude Code 自主工作并随进度提交,然后定期检查。这种"随做随提交"模式比微观管理的交互产生更全面的解决方案。

推理

推理团队管理内存系统和模型服务。没有机器学习背景的团队成员使用 Claude Code 解释模型特定的函数和设置,将研究时间减少 80%——原本需要一小时搜索文档和阅读论文的工作现在需要十到二十分钟。

当测试不同编程语言的功能时,他们描述想要测试什么,Claude 用所需语言编写逻辑,消除了仅为测试目的学习新语言的需要。团队本质上将 Claude Code 用作他们的领域专业知识与实现所需任何语言之间的通用翻译器。

数据科学与 ML 工程

这个团队需要复杂的可视化工具来理解模型性能和训练数据。尽管对前端 Web 开发知之甚少,他们使用 Claude Code 从头构建整个应用程序——用他们不深入理解的语言编写的五千行应用程序。这之所以可行是因为可视化应用程序相对低上下文,不需要理解整个单体仓库,允许快速原型制作否则需要雇佣前端开发者的工具。

从一次性到持久性的转变是重要的。团队现在不再构建在单次分析后就被丢弃的一次性笔记本,而是构建可以在未来模型评估中重用的永久交互式仪表板。理解模型性能是他们工作的核心,持久化工具改变了那种理解的质量。

他们报告常规重构任务有两到四倍的时间节省。他们对不确定开发工作的流程是务实的:提交状态,让 Claude 自主工作三十分钟,然后要么接受结果要么重新开始。他们发现用干净会话重新开始比试图修复有缺陷的首次尝试产生更好的结果。

API 知识

这个团队将 Claude Code 用作任何任务的第一站,在做任何事情之前先让它识别要检查的文件。工作流是即时的:不是手动搜索仓库或问同事,而是让 Claude 找到调用特定功能的文件,几秒钟内获得结果。

对他们来说最重要的采用成果是信心。他们现在独立处理代码库陌生部分的 bug,而不是寻求他人帮助。之前工作流的上下文切换开销——将代码片段复制到单独界面、拖入文件、大量解释问题——已经被消除了。团队报告在日常工作中减少了摩擦,明显更快乐、更高效。

增长营销

一个人的非技术团队构建了一个智能体工作流,处理包含数百个现有广告及绩效指标的 CSV 文件,识别表现不佳的广告,并生成满足严格字符限制的新变体。系统使用两个专门的子代理——一个负责标题,一个负责描述——在几分钟内生成数百个新广告,而不是需要跨多个活动手动创建。广告文案创建从两小时降至十五分钟,释放了用于战略工作的时间。

他们还构建了一个设计工具插件,通过交换标题和描述程序化生成多达一百个广告变体,将需要数小时手动工作的时间减少到每批半秒。这实现了十倍的创意产出。他们创建了一个与社交媒体广告 API 集成的 MCP server,直接在 Claude 中查询活动表现、支出数据和广告效果,消除了在平台之间切换进行分析的需要。

模式是一致的:识别涉及对有 API 的工具进行重复操作的工作流,然后围绕它们构建自动化。这个一个人的团队处理传统上需要专门工程资源的任务,像更大的团队一样运作。

产品设计

设计师现在直接在代码库中进行大型状态管理更改——那种你通常不会看到设计师做的更改。他们不再创建大量设计文档并与工程师进行多轮反馈来调整视觉效果,而是使用 Claude Code 直接实现更改,达到他们设想的精确质量。

他们将模型图粘贴到 Claude Code 中生成完全功能的原型,工程师可以立即迭代,取代了需要大量解释和转换为工作代码的静态设计循环。他们使用 Claude Code 映射错误状态、逻辑流和系统状态,在设计阶段而非开发中发现边缘情况。

一个项目说明了时间压缩:在代码库中协调文案更改同时与法务审查实时协作——这个过程用了两个三十分钟的电话,而不是一周的来回协调。团队描述了两种不同的用户体验:开发者获得增强的工作流速度,而非技术用户发现了以前不可能的全新能力。

他们对非开发者的采用建议很实际:让工程队友帮助初始仓库设置和权限。技术入职对非开发者来说具有挑战性,但一旦配置好就是变革性的。他们还建议创建自定义内存文件,告诉 Claude 用户是编码经验有限的设计师,需要详细解释和更小的、增量的更改。

法务

法务团队的一位成员仅用一小时就为一位有语言障碍的家人构建了一个自定义通讯助手。应用程序使用原生语音转文本、建议回复,并使用语音库朗读——解决了专家推荐现有无障碍工具的不足。一个非开发者,在六十分钟内构建了自定义无障碍解决方案。

团队创建了法务部门咨询的原型路由系统,将团队成员与合适的专家连接。经理们构建了办公套件应用程序,自动化每周团队更新并跟踪跨产品的法务审查状态,允许团队成员通过简单的按钮点击而非电子表格管理来快速标记需要关注的事项。他们构建功能原型向领域专家展示以进行验证,然后再投入更多时间。

他们的工作流桥接了两个界面:他们先在对话式 AI 中头脑风暴和规划,然后转到 Claude Code 进行实现,要求它放慢速度并逐步工作,以便他们能跟上。他们大量使用截图来展示他们想要界面的样子——一种视觉优先的方法,避开了用文字描述功能的需求。

他们强调分享不完美的原型。克服隐藏未完成或看似微不足道项目的冲动很重要,因为这些演示激发了他人看到他们未曾考虑的可能性的灵感,促进了通常不互动的部门之间的创新。作为产品律师,他们也立即识别出深度 MCP 集成的安全影响,认识到保守的安全态势将随着能力扩展而创造障碍。他们的营销审查周转从两到三天降至二十四小时,通过构建在问题到达法务队列之前进行分类的工作流。

RL 工程

强化学习团队使用"尝试并回滚"的方法论。他们频繁提交 checkpoint 来测试 Claude 的自主实现尝试,如果需要就回滚。他们承认 Claude 在首次尝试时大约三分之一的时间能成功。他们的升级模式是务实的:给 Claude 一个快速提示词让它尝试完整实现。如果成功了——大约三分之一的时间——你节省了大量时间。如果不成功,切换到更协作的、引导的方法。在成功的三分之一尝试上节省的时间超过了失败的三分之二的代价。

自定义斜杠命令作为团队约定

自定义斜杠命令将团队特定的工作流编码为单次调用。一个以安全为中心的团队占其组织单体仓库中所有自定义斜杠命令的一半——这表明斜杠命令可以多深地嵌入团队实践。

团队特定斜杠命令的示例:

  • /security-review——使用团队特定清单运行安全聚焦的代码审查。
  • /migration-plan——按照团队的约定生成数据库迁移计划。
  • /deploy-checklist——逐步走完部署前验证步骤。
  • /onboard——向新团队成员介绍代码库架构。

斜杠命令是可发现的。新团队成员输入 / 就能看到团队的工作流词汇。每个命令编码了否则存在于没人读的文档或资深工程师头脑中的机构知识。

复合效应与 CLAUDE.md 相呼应:每个斜杠命令创建一次,被整个团队无限期使用。创建成本是一小时。不创建的成本是每个团队成员独立重新发明工作流。

大规模企业采用

大规模采用 Claude Code 的大型组织报告了一致的指标。在一家主要通信技术公司,团队创建了超过一万三千个自定义 AI 解决方案,同时工程代码发布速度提高 30%,总共节省超过五十万小时。一个大型金融科技平台在整个组织中实现了 89% 的 AI 采用率,内部部署了八百多个 AI agent。另一个服务超过一千五百万用户的金融科技平台,在整个开发生命周期中将执行速度翻倍。在一家主要金融科技公司,75% 的工程师使用 Claude Code 处理 SQL 查询生成等任务每周节省八到十小时以上。这些不是试点数据。它们是组织规模的结果。

企业规模的采用曲线遵循可预测的形状。早期采用者在第一周内展示结果。中间多数在两到三个月内采用,因为他们看到同事的生产力提升。落后者当团队的速度期望已经转变为假设使用 Claude Code 时才加入。

不采用的组织风险正在变得可见。未采用 AI 辅助开发的团队越来越多地与采用了的团队相比不利,不是因为他们的工程师技能较差,而是因为基线生产力期望已经转移了。

企业部署基础设施

在企业中部署 Claude Code 涉及选择计费模型、配置网络基础设施和建立组织策略。这个层面的决策决定了采用是顺利扩展还是在安全审查处停滞。

部署选项

Claude Code 通过多种部署路径提供,每种路径在计费、认证、区域可用性和成本跟踪方面有不同的权衡。

按席位订阅计划是自助服务的,包括协作功能、管理工具和计费管理。企业计划增加了单点登录、域名捕获、基于角色的权限、合规 API 访问,以及部署组织范围托管策略的能力。对于需要通过自己的云基础设施路由的组织,主要云提供商通过各自的 AI 服务平台提供 Claude Code 访问,具有基础设施管理的计费、区域部署、prompt caching 支持以及与现有云认证和成本跟踪系统的集成。

选择不纯粹是经济性的。有严格数据驻留要求的组织可能需要云提供商部署以获得区域控制。想要最简单路径的组织应该从按席位计划开始,只有当基础设施需求要求时才转移到云提供商路由。

LLM 网关配置

LLM 网关位于 Claude Code 和云提供商之间,处理认证和路由。组织使用网关进行跨团队的集中使用跟踪、自定义速率限制和预算,以及集中认证管理。

配置很简单:设置适当的基础 URL 环境变量将 Claude Code 指向你的网关而不是直接指向提供商。网关透明地处理认证和路由,Claude Code 正常运行。这适用于直接 API 访问、云提供商路由以及任何支持标准 API 接口的提供商。

企业代理配置

要求所有出站流量通过代理服务器以进行安全监控、合规或网络策略执行的组织配置标准的 HTTPS_PROXYHTTP_PROXY 环境变量。企业代理和 LLM 网关是不同的配置,可以一起使用——通过企业代理路由流量到达 LLM 网关,然后由网关处理到提供商的认证和路由。

组织范围的 CLAUDE.md

除了项目级 CLAUDE.md 文件外,组织可以在系统目录部署 CLAUDE.md 文件。在 macOS 上,部署到 /Library/Application Support/ClaudeCode/CLAUDE.md 应用组织范围的标准。在 Linux 上,等效路径在 /etc/claude-code/ 下。这些系统级文件应用于机器上的每个 Claude Code 会话,建立没有项目级配置可以覆盖的组织编码标准、安全策略和架构约束。

这创建了一个三层 CLAUDE.md 层级:系统级的组织范围标准,仓库级的团队特定约定,以及用户级的个人偏好。分层意味着组织可以在系统级规定"永远不要提交密钥",团队可以在仓库级添加"始终使用我们的内部认证库",开发者可以在用户级添加"我偏好制表符而非空格"。

简化部署

成功扩展采用的组织出现了两个最佳实践。

第一,创建简化的安装路径。如果你有自定义开发环境,"一键"安装方法是增长采用的关键。初始设置中的摩擦越多,能通过的人就越少。将认证配置、代理设置、托管策略和默认插件打包成一个安装步骤。

第二,从引导使用开始。鼓励新用户从代码库问答开始,然后转向较小的 bug 修复和功能请求,然后让 Claude Code 制定计划,然后在逐渐增加智能体自主性之前检查其计划。这映射了分阶段采用路径,但框定为组织策略而非个人建议。

用于标准化环境的开发容器

对于需要一致、安全环境的团队,参考开发容器设置提供了预配置的容器,包含 Node.js、限制网络访问仅限已批准域名的自定义防火墙,以及包括容器隔离和网络限制在内的安全功能,提供针对 prompt 注入和其他威胁的纵深防御。

开发容器在三种场景中特别有价值:隔离不同的客户项目,使代码和凭据永远不会在环境之间混合;入职新团队成员,可以立即在一致的环境中开始工作;以及创建镜像开发设置的一致 CI/CD 环境。

集中化 MCP 配置

组织受益于让一个中央团队配置已批准的 MCP server 并将 .mcp.json 文件检入代码库。这确保每个连接到项目的开发者获得相同的 MCP server 和相同的已批准连接,而不是每个开发者独立配置到数据库、API 和内部服务的连接。结合限制允许哪些 MCP server 的托管设置,这创建了一个受控但功能齐全的集成层。

SSO 与域名捕获

企业计划支持单点登录和域名捕获,确保每个从公司电子邮件域认证的员工自动被路由到组织的计费和策略结构中。这消除了个别开发者使用个人账户注册并绕过组织控制的场景。

团队结构与工具分配

对于构建复杂系统的团队,记录的角色到角色工具分配澄清了期望。产品经理或领域专家使用 Claude Code 进行自然语言策略输入和规范编写。后端工程师使用 Claude Code 作为他们的主要开发工具,可能辅以内联完成工具用于日常编码速度。前端工程师使用 Claude Code 处理结构性更改和组件生成,更多使用内联完成工具进行快速 UI 迭代。DevOps 或 QA 工程师使用 Claude Code 作为基础设施即代码、部署自动化和测试生成的主要工具。

使这些分配显式化可以防止每个人以相同方式使用相同工具的困惑。不同角色从不同交互模式中提取不同价值。

维护到规模化进展

团队采用不是一个单一事件。使用模式随着团队与工具的成熟而演变,认识到各个阶段可以防止过早优化和过早放弃。

第一到三个月是 MVP 维护。Claude Code 处理 bug 修复、小功能和优化。CLAUDE.md 文件成为代码库决策的真相来源。Pull request 流程进入节奏:bug 报告、Claude 生成修复、开发者审查并提交 PR、合并。团队正在学习什么有效什么无效。

第三到六个月是功能扩展。Claude Code 生成新的功能类型、分析仪表板和工作流自动化。Skill 变得标准化——测试优先模式、代码审查清单和部署程序编码到斜杠命令和 skill 中。多会话工作流开始利用前几周的上下文。团队的 CLAUDE.md 文件已经足够成熟,新功能从积累的知识中受益。

第六个月及以后是规模化和加固。Claude Code 处理重构——提取共享逻辑、优化性能、偿还技术债务。团队可能添加补充性内联完成工具用于日常开发速度。专门的工具仅在 Claude Code 无法满足需求的组件上替代它,如超低延迟路径。到这个时候,团队已经校准了期望、标准化了工作流,并在 CLAUDE.md 和 skill 中建立了足够的机构知识,新团队成员在几天而非几周内就能达到生产力。

动态增员

成熟 Claude Code 采用中出现的一种组织能力是动态增员。因为 Claude Code 将陌生代码库的入职时间从数周压缩到数小时,组织可以将工程师增派到需要深度代码库知识的任务上,而没有传统的生产力下降。专家可以跨项目动态转移。在一家企业,一个其技术领导估计需要四到八个月的项目,由对代码库陌生但使用 Claude Code 加速上手的工程师在仅仅两周内完成了。

这改变了公司对人才部署和项目资源配置的思考方式。约束不再是"谁了解这个代码库?"而是"谁有架构判断力和领域专业知识来指导工作?"

要点总结
  • 遵循引导式采用路径(问答、小修复、plan mode、完全自主)在两到四周内,而不是立即跳到完全自主。
  • 将 CLAUDE.md 提交到版本控制;它随着团队添加学习成果而复合增值,为每个未来开发者防止错误。
  • 不同团队以根本不同的方式使用 Claude Code:安全团队的"随做随提交"自主模式看起来与产品开发团队对核心业务逻辑的同步监督完全不同。
  • 非技术团队(法务、营销、设计、财务)提取了根本不同的价值:一个律师在一小时内构建自定义无障碍工具,一个营销团队将广告创建从两小时压缩到十五分钟,一个设计师直接在代码库中进行状态管理更改。
  • 企业部署需要选择按席位和云提供商计费、配置 LLM 网关用于集中使用跟踪,以及将组织范围的 CLAUDE.md 部署到系统目录。
  • 维护到规模化进展(第一到三个月 MVP 维护,第三到六个月功能扩展,六个月以后加固和重构)防止过早优化和过早放弃。
  • 动态增员——将工程师移至陌生代码库而没有传统生产力下降——在 Claude Code 将入职时间从数周压缩到数小时时成为可能。
  • 自定义斜杠命令将团队工作流编码为可发现的、可重用的约定;一个安全团队占其组织整个单体仓库中所有自定义斜杠命令的一半。
  • 通过 VCS 共享项目设置(.claude/settings.json),以便克隆仓库就能配置整个 Claude Code 环境。