沟通资料包
面向工程组织推广 Claude Code 时使用的发布公告、系列推送消息和 FAQ 回复。
本页适用于负责向团队推广 Claude Code 的管理员和工程负责人。其中提供了可直接使用的发布公告、技巧系列推送,以及针对最常见问题的一句话 FAQ 回复。
请将本页所有内容视为文案草稿,而不是最终版本。请使用您组织的语气重写每条消息,将示例任务换成您自己代码库中的真实 bug 和模块,并在发送前替换所有 [方括号中的占位内容]。真正能够推动采用的公告,读起来应当像是由您公司的同事亲自撰写。
发布沟通
一份公告提供两种格式,另有两个可选变体。请选择最适合您推广计划的版本,并以此为基础进行改写。
发送前的准备
公告发出前,请逐项完成以下清单。每一项都能补上一个缺口,避免在发布当天演变成支持问题讨论串。
公告正文
可将以下内容作为面向全组织推广的标准消息。它会说明 Claude Code 是什么,提供两分钟安装步骤,给出一个可立即尝试的具体任务,并在有人提问之前解答“我的代码会发送到哪里?”
主题:Claude Code 已面向 [工程部门/您的团队] 正式启用
各位同事:
从今天起,大家可以使用 Claude Code 了。它是一款 AI 编程智能体,能够在
终端中运行、读取实际代码库,并端到端完成调试、重构、测试和 PR 等真实任务。
它不是自动补全工具,也不是聊天窗口。它可以编辑文件、运行命令,并会在执行
任何有风险的操作前征求您的许可。
两分钟即可开始使用:
curl -fsSL https://claude.ai/install.sh | bash
cd <your-repo>
claude
然后运行一次 /init。Claude 会读取您的项目,并生成一份 CLAUDE.md,其中
记录构建命令和开发约定,以后就不必反复解释这些基本信息。
接着,在当前代码库中尝试以下任一任务:
- “[文件] 中的测试不稳定。请找出原因并修复”
- “给我讲解一下 [模块] 如何处理 [X]”
- “检查我当前的 diff,并在推送前指出其中的风险”
代码会发送到哪里:Claude Code 在您的终端中运行,并直接与 Anthropic API
通信,不经过任何第三方服务器。编辑文件或运行命令前,它会先征求您的许可。
根据我们的 Enterprise 协议,Anthropic 不会使用您的代码或 Prompt 训练模型。
详情:https://code.claude.com/docs/en/data-usage
https://code.claude.com/docs/en/security
如有问题,请前往 #claude-code。本周由 [负责人姓名] 负责关注该频道。
- [姓名]
附言:更习惯使用编辑器?您可以安装 VS Code 扩展或 JetBrains 插件。
使用的是同一个智能体,无需打开终端。
🚀 *Claude Code 已面向 [ 团队 ] 正式启用*
这款 AI 编程智能体在终端中运行,可以读取代码库并完成真实工作:
修复 bug、重构、测试、处理 PR。执行任何操作前都会先征求您的许可。
`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` → `claude`
*建议先试试* → 运行 `/init` ,然后输入:“[ 文件 ] 中的测试不稳定,
请找出原因并修复。”
🔒 在您的终端中运行,仅与 Anthropic API 通信。根据我们的
Enterprise 方案,您的代码和 Prompt 不会用于训练模型。
数据使用 → https://code.claude.com/docs/en/data-usage
📚 快速入门 · VS Code · 一小时免费课程
https://code.claude.com/docs/en/quickstart
https://code.claude.com/docs/en/vs-code
https://anthropic.skilljar.com/claude-code-in-action
有问题 → 请在本讨论串中提出。由 [ 负责人 ] 负责跟进。
请由支持该项目的高管(例如 CTO、CIO 或工程高级副总裁)使用本人的姓名和账号发送此版本。相比由管理员或工具团队发送相同消息,以高管名义发布通常能获得更高的打开率,并更快推动首周启用。它传达的是公司层面的优先事项,而不是一项可选实验。
此版本刻意只保留一个诉求:安装 Claude Code,并用它完成一项真实任务。高管的职责是让这一号召得到响应;具体使用方法则由标准公告和 #claude-code 频道承接。
主题:本周希望每位工程师都尝试的一件事
各位同事:
我们已为整个工程团队启用 Claude Code。它是一款直接在终端中操作实际
代码库的 AI 智能体。已经开始使用它的团队取得了很好的初步成果,因此
我希望大家都能在本周试用一次。
只需要投入十分钟:
curl -fsSL https://claude.ai/install.sh | bash
cd <your-repo>
claude
然后交给它一项真实任务:例如那个您一直搁置的 bug,或者“给我讲解一下
[模块] 的工作原理。”
我的要求仅此而已。如果在使用过程中遇到任何问题,[负责人姓名] 及其团队
会在 #claude-code 中提供帮助。
- [高管姓名]
[职务]
📣 *来自 [ 高管姓名 ]:本周请尝试一件事*
我们已为整个工程团队启用 *Claude Code* 。目前的初步成效很好,因此我希望
大家本周能花十分钟,用它处理一项真实工作。
`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` →
`claude` → 交给它一项真实任务。
就这么简单。如有问题 → #claude-code。
试点组版本
用于分阶段推广。仅发送给试点用户群。
主题:您已加入 Claude Code 试点
[姓名/团队]:
您是 [公司] 首批试用 Claude Code 的成员。我们选择这个小组,是因为相信
大家会用它解决真实问题,并坦诚分享实际体验。
我们的请求是:本周至少用它完成一项真实任务,然后在 #claude-code-pilot
中留言,告诉我们哪些地方好用、哪些地方令人困扰,以及哪些表现出乎您的意料。
这些反馈将决定我们如何向其他人推广 Claude Code。
[接上标准公告中的“两分钟即可开始使用”部分]
试点成员还可以多尝试一项功能:第一次修改多个文件时,按 Shift+Tab,
直到看到“plan”。Claude 会在改动任何文件之前,清楚列出打算执行的操作。
这是快速判断您可以在多大程度上信任它的最佳方式。
招募推广大使的私信
发布后,请向 #claude-code 中最活跃的两三位成员发送私信。
嗨 [姓名],你在 #claude-code 中发的帖子,对推动大家采用 Claude Code
比我的公告还有效。已经有几位同事告诉我,正是你分享的
[讨论串/截图] 让他们真正开始尝试。
愿意把这件事做得稍微正式一点吗?不会增加多少工作:基本上只需继续分享,
同时你还能优先体验新功能,并直接联系 Anthropic 团队。如果你愿意加入,
我可以发你一份简短的行动指南。
技巧系列推送
以下 Slack 或 Teams 消息可直接粘贴使用,旨在发布后推动团队采用各项功能。每条消息结构相同:引起注意、说明收益、给出“立即尝试”的 Prompt,再附上文档链接。您可以每周在 #claude-code 中推送一两条,也可以只选择符合团队使用短板的几条。各条消息相互独立,无需按顺序发送。
请将每个块中的消息正文直接复制到 Slack 或 Teams。发送前请替换 [方括号中的占位内容]。
开始使用
选择合适的模型
🎯 *技巧:根据任务选择合适的模型*
用 Opus 修复拼写错误会浪费算力;用 Haiku 重构 12 个文件,则很可能需要
返工。
Claude Code 使用与 Claude 应用相同的模型,您可以在会话途中切换。 *Sonnet*
是日常功能开发、bug 修复、测试和审查的主力默认模型。遇到大规模重构、
棘手调试或高风险任务时,请选择 *Opus* 。对于快速问答、格式调整和重复性
编辑等速度优先的任务,可改用 *Haiku* 。 *Fable 5* 是处理最困难、耗时最长
任务的最强模型;它不是默认模型,请通过 `/model fable` 选择。请注意,
网络安全和生物学内容会自动回退到 Opus。
*立即尝试:* 输入 `/model` ;如果尚未选择 Sonnet,请选择它。对于大多数
任务来说,它都是合适的默认模型。
📖 模型配置 → https://code.claude.com/docs/en/model-config
适合首先尝试的快速任务
🚀 *技巧:开始使用后的十分钟内,可以尝试这三件事*
安装了 Claude Code,却不知道该让它做什么?不妨从那些困扰了您一整周的
问题入手。
- 解决一个烦人的问题:“[ 文件 ] 中的测试不稳定,找出原因”
- 熟悉并非由您编写的代码:“给我讲解一下 [ 模块 ] 的工作原理”
- 推送前做一次快速检查:“检查我当前的 diff,告诉我哪些地方
可能有风险”
这些任务都不需要额外设置。只需用 `cd` 进入代码库并运行 `claude` 。
*立即尝试:* 选一个您一直回避的 bug,把错误消息粘贴进去。
📖 快速入门 → https://code.claude.com/docs/en/quickstart
项目记忆
/init 和 CLAUDE.md
📁 *技巧:不必在每次会话中重新介绍代码库*
已经第五次告诉 Claude“我们使用 pnpm,而不是 npm”?这个问题一次就能
彻底解决。
在每个代码库中运行一次 `/init` 。Claude 会读取项目结构,并生成一份
CLAUDE.md,记录构建命令、架构和开发约定。以后在该代码库中启动的每个
会话都会自动从这个文件开始。文件内容最好控制在两屏以内:它是速查表,
不是完整文档。
*立即尝试:* 打开您的主要代码库,运行 `claude` ,然后输入 `/init` 。
花费三十秒,此后的每次会话都能从中受益。
📖 CLAUDE.md 与项目记忆 → https://code.claude.com/docs/en/memory
@ 引用
📎 *技巧:不必再把文件内容粘贴到对话中*
为了让 Claude“看到”某个组件,您还在把其中 200 行代码复制到 Prompt
里吗?其实不必如此。
输入 `@` ,再输入文件路径,Claude 就会直接将该文件载入上下文。整个
目录同样适用。
> @src/components/Button.tsx 中的样式似乎不对,请对照
> @docs/design-system.md 检查
*立即尝试:* 输入 `@` ,然后按 Tab。自动补全会列出所有可用文件。
📖 引用文件 → https://code.claude.com/docs/en/common-workflows
控制与安全
权限模式
🛡️ *技巧:按一个键,即可在“只看不动”和“直接执行”之间切换*
有时您希望 Claude 每次编辑前都先询问,有时则希望它直接完成工作。
您不必永远固定使用其中一种方式。
按 *Shift+Tab* 可以循环切换 Claude 无需询问即可执行的操作范围: *Manual*
(对应 `default` 设置值)会在每项操作前询问; *acceptEdits* 允许直接执行
文件编辑和常见文件系统命令,但仍会在运行其他 shell 命令前询问; *plan*
则会先提出变更方案,待您批准后才开始修改。Plan 模式有助于建立信任,
因此涉及多个文件时,建议先从该模式开始。
*立即尝试:* 下次重构时,按 Shift+Tab 直到看到“plan”,然后描述所需
变更。在任何文件被改动前,您都会先看到一份完整方案。
📖 权限模式 → https://code.claude.com/docs/en/permissions
检查点与 /rewind
⏪ *技巧:整个对话也有撤销按钮*
Claude 三轮之前走错了方向,而您正在收拾局面?不必硬着头皮继续修正。
`/rewind` 可以回退到对话中的某个较早节点,包括撤销 Claude 在此过程中
所做的文件变更。检查点会自动创建,无需任何设置。
*立即尝试:* 按两次 *Esc* 打开回退菜单,或者输入 `/rewind` 。选择
事情偏离预期之前的节点。
📖 检查点 → https://code.claude.com/docs/en/checkpointing
MCP 连接器
🔌 *技巧:让 Claude 读取问题跟踪系统,不必再粘贴工单*
把 Jira 工单复制粘贴到终端,感觉像是倒退了一步。确实如此。
只需一个配置文件(项目根目录中的 `.mcp.json` ),即可将 Claude 接入
GitHub、Jira、Linear 或您使用的任何问题跟踪系统。之后,“分配给我的
最高优先级问题是什么?”和“继续修复它”可以在同一次对话中完成。
*立即尝试:* 对 Claude 说“在这个代码库中为 [ GitHub/Jira/Linear ]
设置 MCP 连接器”。它会为您编写配置。
📖 MCP 连接器 → https://code.claude.com/docs/en/mcp
自动化工作流
Skills
⚡ *技巧:把反复输入的 Prompt 变成命令*
本周已经三次输入“根据 git log 总结我今天完成的工作,并整理成站会汇报
格式”?这正适合做成斜杠命令。
在 `.claude/skills/<name>/` 中放置 SKILL.md 文件,即可将其变成可复用的
Prompt;输入 `/name` 便可运行。再次输入以前用过的多步骤 Prompt 时,就
应该把它做成 Skill。最简单的方法是让 Claude 帮您创建。
*立即尝试:* 输入“为我创建一个 /standup Skill,根据 git log 总结我
今天完成的工作”,然后在明天早上运行 `/standup` 。
📖 Skills → https://code.claude.com/docs/en/skills
Hooks
🔔 *技巧:重构完成时接收通知*
还坐在桌前看着 Claude 处理一项耗时任务?这八分钟完全可以用来做更有
价值的事。
Hooks 是在 Claude Code 事件发生时触发的 shell 命令。配置一个发送桌面
通知的 Stop Hook 后,您可以启动一项耗时重构,然后暂时离开;任务完成
时会立即收到通知。
*立即尝试:* 对 Claude 说“添加一个 Stop Hook,在任务完成时发送桌面
通知”。它会编写脚本并完成配置。
📖 Hooks 指南 → https://code.claude.com/docs/en/hooks-guide
日常开发
截图和图像
📸 *技巧:不必描述错误对话框,直接展示即可*
还在输入“有个红框提示空引用之类的错误,好像指向第 47 行”?截张图
即可。
将截图直接拖入终端,Claude 就能看到其中的内容:错误对话框、UI 模型、
白板照片、Figma 导出图均可。按 *Ctrl+V* 可从剪贴板粘贴(macOS 上也请
使用 Ctrl+V,而不是 Cmd+V)。
*立即尝试:* 下次遇到界面显示异常时,截取屏幕并直接粘贴到 Prompt 中,
然后只需输入“这里有什么问题?”
📖 使用图像 → https://code.claude.com/docs/en/common-workflows
Git 工作流
🌿 *技巧:把整套 git 流程交给 Claude*
修复问题只花了 5 分钟,编写提交消息、创建分支和撰写 PR 描述却花了
15 分钟。这个时间分配并不合理。
Claude 可以处理完整的 git 流程:使用规范的提交消息进行提交、创建分支,
以及创建带有恰当摘要的 PR。只需提出一个请求:“修复 off-by-one 错误,
使用规范的提交消息提交,然后创建 PR。”要审查他人的工作?粘贴 PR URL,
让 Claude 为您逐项讲解 diff。
*立即尝试:* 下次修复完成后,不必切换到 git 客户端,只需输入“用一条
合适的消息提交这些变更,并创建 PR”。
📖 创建拉取请求 → https://code.claude.com/docs/en/common-workflows
分享与规模化
插件
📦 *技巧:您需要的 Skill,很可能已经有人做好了*
准备花一小时构建 `/deploy` 命令?不妨先看看它是否已经存在。
Skills 可以打包成插件并共享。通过 `/plugin` 浏览可用插件,一步即可
完成安装。花五分钟浏览,可能省下一小时的构建时间。
*立即尝试:* 输入 `/plugin` 并浏览列表。您至少会发现一个此前未曾想到、
但确实想要的功能。
📖 插件 → https://code.claude.com/docs/en/plugins
安全与管理
安全架构
🔐 *技巧:下次有人问“这安全吗?”时,可以这样回答*
团队里一定会有人问:“等等,我的代码会发送到哪里?”下面是一段可以
直接粘贴的简短回答。
系统在设计上以权限为先。每次文件编辑、shell 命令和外部调用都需要您的
批准。CLI 在您的终端中运行,并直接与 Anthropic API 通信,不经过第三方
服务器;同时支持为 shell 命令启用可选的操作系统级沙箱。根据我们的
Enterprise 方案,Anthropic 不会使用您的代码或 Prompt 训练模型。
*立即尝试:* 保存以下两个链接,以便下次有人问起时使用。大多数安全审查
问题都能从中找到答案。
📖 https://code.claude.com/docs/en/security
📖 https://code.claude.com/docs/en/data-usage
最佳实践
✅ *技巧:从“试过一次”到“每天使用”,关键在于这四个习惯*
没有坚持使用 Claude Code 的人,大多忽略了其中某个习惯;而坚持下来的人,
通常在第一周就做到了以下四点。
- 任何涉及多个文件的任务都从 plan 模式开始
- 尽早运行 /init;上下文会不断积累并产生复利效应
- 提交前审查 diff;Claude 也可能十分自信地犯错
- 验证涉及关键路径的变更;把它当作聪明的初级工程师,
而不是无所不知的神谕
*立即尝试:* 如果您只做到了其中一两点,请选出尚未养成的一个习惯,
在下个任务中付诸实践,并在 #claude-code 中分享它带来的变化。
📖 最佳实践 → https://code.claude.com/docs/en/best-practices
快速参考
FAQ 回复
针对最常见问题的一句话回复。
Prompt 模板
请将以下起步 Prompt 分享给已经安装 Claude Code、但不确定该输入什么的工程师。每条 Prompt 都采用真实会话中的输入方式;请将方括号部分替换为您自己代码库中的文件。
Claude Code 更新频繁。在组织内分发资料前,请对照文档主页 核实与版本有关的详细信息。