Appearance
本页提供向工程团队推广 Claude Code 的现成素材,包括发布公告、分批推送的技巧消息和常见问题回答。发送前请完成检查清单,根据场景选择标准公告、高管赞助或试点组消息,并替换占位符。关键验证:团队成员收到消息后能否在 2 分钟内安装并运行 claude。
Claude Code 团队推广通信工具包
面向工程组织发布公告、推送滴灌战役消息和回复 FAQ,帮助你在团队中铺开 Claude Code。
本页面向负责在团队中推广 Claude Code 的管理员和工程负责人。内容包含可直接复制的发布公告、技巧与窍门滴灌战役,以及针对最常被问到的问题的单行 FAQ 回复。
以下所有内容均为草稿,非最终文案。请根据你组织的口吻重写每一条消息,将示例任务替换为你代码库中的真实 bug 和模块,并在发送前替换掉
[方括号占位符]。那些读起来像你们公司内部人员撰写的公告才能真正推动采纳。
发布公告
一个公告提供两种格式,外加两种可选变体。选择适合你推广方式的那一个,然后据此重写。
发送前
在公告发出前,逐项核对以下清单。每一项都能堵住一个会在发布当天变成支持线程的缺口。
| 项目 | 为什么重要 |
|---|---|
创建 #claude-code 频道并在消息中链接 | 为问题提供一个集中的落脚点 |
| 在环境中至少一台机器上测试过安装命令 | 防止代理或防火墙问题在全员同时遇到时爆炸 |
| 准备好安全和数据处理链接(数据使用 或你内部的类似页面) | “我的代码去了哪里?”会是第一个回复 |
| 选定一项具体的第一任务——你代码库中的一个真实 bug 或文件 | 泛泛的示例无法转化;“修复 auth_test.go 中的不稳定测试”才有效 |
| 在前 48 小时内指定一个频道负责人 | 发布日无人回答的问题会扼杀 momentum |
| 安排一位高管支持者来发送或联署该公告 | 高管发出的公告在一周内采纳率始终高于管理员发出的 |
标准公告
用作你组织层面的推广消息。涵盖 Claude Code 是什么,提供两分钟安装路径,让读者尝试一个具体任务,并在任何人提问前回答“我的代码去了哪里?”
text
Subject: Claude Code is live for [Engineering / your team]
Team,
As of today you have access to Claude Code, an AI coding agent that runs in
your terminal, reads your actual codebase, and works through real tasks end
to end: debugging, refactors, tests, PRs. It is not autocomplete and it is
not a chat window. It edits files, runs your commands, and asks permission
before anything risky.
Get running in two minutes:
curl -fsSL https://claude.ai/install.sh | bash
cd <your-repo>
claude
Then run /init once. Claude reads your project and writes a CLAUDE.md with
your build commands and conventions, so you stop re-explaining the basics.
Then try one of these on the repo you are already in:
- "The test in [file] is flaky. Figure out why and fix it"
- "Walk me through how [module] handles [X]"
- "Look at my working diff and tell me what's risky before I push"
Where your code goes: Claude Code runs in your terminal and talks directly
to Anthropic's API, with no third-party servers in the loop. It asks before
editing files or running commands. Under our Enterprise agreement, Anthropic
does not use your code or prompts to train its models.
Details: https://code.claude.com/docs/en/data-usage
https://code.claude.com/docs/en/security
Where to go with questions: #claude-code. [Owner name] is watching it
this week.
- [Name]
P.S. Prefer your editor? There is a VS Code extension and a JetBrains
plugin. Same agent, no terminal required.markdown
🚀 *Claude Code is live for [team]*
AI coding agent, runs in your terminal, reads your repo, does real work:
bugs, refactors, tests, PRs. Asks before it touches anything.
`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` → `claude`
*First thing to try* → run `/init`, then: "the test in [file] is flaky,
figure out why and fix it."
🔒 Runs in your terminal, talks only to Anthropic's API. Under our
Enterprise plan your code and prompts are not used to train models.
Data usage → https://code.claude.com/docs/en/data-usage
📚 Quickstart · VS Code · Free 1-hr course
https://code.claude.com/docs/en/quickstart
https://code.claude.com/docs/en/vs-code
https://anthropic.skilljar.com/claude-code-in-action
Questions → this thread. [Owner] is on point.高管赞助变体
从你的支持高管(如 CTO、CIO 或 SVP 工程)那里以他们的名义和账户发送。以高管名义发出的推广在打开率和首周激活方面始终高于管理员或工具团队发出的同一消息。它表明这是一项公司优先级,而非一个可选的实验。
这个版本有意精简为一项任务:安装并在一个真实任务上运行它。高管的任务是让这个要求落地;标准公告和 #claude-code 负责处理如何操作的问题。
text
Subject: One thing I'd like every engineer to try this week
Team,
We have turned on Claude Code for all of engineering. It is an AI agent
that works directly in your terminal, on your actual codebase, and the
early results from teams already using it are strong enough that I want
everyone on it this week.
I am asking for ten minutes:
curl -fsSL https://claude.ai/install.sh | bash
cd <your-repo>
claude
Then hand it one real task: the bug you have been putting off, or "walk me
through how [module] works."
That is the whole ask. [Owner name] and team are in #claude-code for
anything you hit along the way.
- [Exec Name]
[Title]markdown
📣 *From [Exec Name]: one thing to try this week*
We have turned on *Claude Code* for all of engineering. Early results are
strong enough that I am asking everyone to give it ten minutes on real
work this week.
`curl -fsSL https://claude.ai/install.sh | bash` → `cd your-repo` →
`claude` → hand it one real task.
That's it. Questions → #claude-code.试点组变体
用于分阶段推广。仅发送给试点组。
text
Subject: You're in the Claude Code pilot
[Name / team],
You are in the first wave of Claude Code at [company]. We picked this group
because you will put it on real problems and tell us the truth about it.
The ask: use it on at least one real task this week, then drop a note in
#claude-code-pilot covering what worked, what was annoying, and what
surprised you. That feedback decides how we roll it out to everyone else.
[Continue with "Get running in two minutes" from the standard announcement]
One extra thing for pilots: on your first multi-file change, press Shift+Tab
until you see "plan". Claude will lay out exactly what it intends to do
before it touches a file. It is the fastest way to calibrate how much to
trust it.冠军招募私信
在发布后,私信给 #claude-code 中最活跃的两三个人。
text
Hey [name], your #claude-code posts are doing more for adoption than my
announcement did. A couple of people told me your [thread / screenshot]
was why they actually tried it.
Want to make that semi-official? Low lift: mostly keep posting what you
are posting, plus first crack at new features and a direct line to the
Anthropic team. I can share a short playbook if you're in.技巧与窍门战役
准备好直接粘贴到 Slack 或 Teams 的消息,旨在推动发布后的功能激活。每条都遵循相同的模式:钩子、收益、“现在试试”提示和文档链接。每周在 #claude-code 中推送一到两条,或者挑选适合你团队差距的几条。它们彼此独立,没有固定的顺序。
直接复制每个块的消息正文到 Slack 或 Teams。在发送前替换 [方括号占位符]。
入门
选择合适的模型
markdown
🎯 *Tip: Match the model to the moment*
Using Opus to fix a typo burns compute. Using Haiku for a 12-file refactor
is asking for a re-do.
Claude Code runs on the same models as the Claude app, and you can switch
mid-session. *Sonnet* is the workhorse default for everyday feature work,
bugs, tests, and reviews. Reach for *Opus* on large refactors, gnarly
debugging, or anything high-stakes. Drop to *Haiku* for quick questions,
formatting, and mechanical edits where speed wins.
*Try it now:* type `/model` and pick Sonnet if you haven't already. It is
the right default for most tasks.
📖 Model configuration → https://code.claude.com/docs/en/model-config| 模型 | 最佳用途 |
|---|---|
| Opus | 大型重构、复杂调试、架构决策、高风险变更 |
| Sonnet | 日常功能开发、漏洞修复、测试、文档、代码审查。推荐的默认模型。 |
| Haiku | 快速问答、格式化、机械性编辑、快速迭代 |
十分钟快速上手指南
markdown
🚀 *Tip: Three things to try in your first 10 minutes*
Installed Claude Code but not sure what to actually ask it? Start with the
stuff that has been bugging you all week.
- Fix something annoying: "the test in [file] is flaky, figure out why"
- Get oriented in code you didn't write: "walk me through how [module] works"
- Sanity-check before you push: "look at my working diff and tell me what
looks risky"
None of these need setup. Just `cd` into your repo and run `claude`.
*Try it now:* pick the bug you have been avoiding and paste the error
message in.
📖 Quickstart → https://code.claude.com/docs/en/quickstart项目记忆
/init 与 CLAUDE.md
markdown
📁 *Tip: Stop re-explaining your repo every session*
Telling Claude "we use pnpm, not npm" for the fifth time? There is a
one-time fix.
Run `/init` once per repo. Claude reads your project structure and writes a
CLAUDE.md file with your build commands, architecture, and conventions.
Every future session in that repo starts from this file automatically. Keep
it under two screens. It is a cheat sheet, not documentation.
*Try it now:* open your main repo, run `claude`, type `/init`. Thirty
seconds, pays off every session after.
📖 CLAUDE.md and project memory → https://code.claude.com/docs/en/memory@-引用
markdown
📎 *Tip: Stop pasting file contents into the chat*
Copying 200 lines of a component into your prompt so Claude can "see" it?
You don't have to.
Type `@` then a file path. Claude pulls the file directly into context.
Works for whole directories too.
> the styles in @src/components/Button.tsx look off, check against
> @docs/design-system.md
*Try it now:* type `@` then Tab. Autocomplete shows you every file in reach.
📖 Referencing files → https://code.claude.com/docs/en/common-workflows控制与安全
权限模式
markdown
🛡️ *Tip: One keystroke between "look but don't touch" and "just do it"*
Sometimes you want Claude to ask before every edit. Sometimes you just want
it to ship. You shouldn't have to pick one forever.
*Shift+Tab* cycles through how much leash Claude gets: *default* asks before
risky stuff, *acceptEdits* lets file edits and common filesystem commands
flow through while still checking before other shell commands, and *plan*
proposes changes for your approval before anything is touched. Plan mode is
the trust-builder, so start there for anything touching multiple files.
*Try it now:* on your next refactor, hit Shift+Tab until you see "plan",
then describe the change. You'll get a full proposal before a single file
moves.
📖 Permission modes → https://code.claude.com/docs/en/permissions检查点与 /rewind
markdown
⏪ *Tip: There is an undo button for the whole conversation*
Claude went down the wrong path three turns ago and now you're untangling
it? You don't have to fix forward.
`/rewind` rolls back to an earlier point in the conversation, including the
file changes Claude made along the way. Checkpointing is automatic; you
don't set anything up.
*Try it now:* press *Esc* twice to open the rewind menu, or type `/rewind`.
Pick the point before things went sideways.
📖 Checkpointing → https://code.claude.com/docs/en/checkpointing连接你的工具
MCP 连接器
markdown
🔌 *Tip: Let Claude read your issue tracker so you don't have to paste tickets*
Copy-pasting Jira tickets into the terminal feels like a step backward.
It is.
One config file (`.mcp.json` at your project root) wires Claude into GitHub,
Jira, Linear, or whatever tracker you use. Then "what's the top-priority
issue assigned to me?" and "go ahead and fix it" happen in the same
conversation.
*Try it now:* ask Claude "set up an MCP connector for [GitHub/Jira/Linear]
in this repo". It will write the config for you.
📖 MCP connectors → https://code.claude.com/docs/en/mcp自动化你的工作流
技能
markdown
⚡ *Tip: Turn that prompt you keep retyping into a command*
Typed "summarize what I worked on today from git log, format it for standup"
three times this week? That's a slash command waiting to happen.
A SKILL.md file in `.claude/skills/<name>/` becomes a reusable prompt; type
`/name` to run it. Make one the second time you type a multi-step prompt
you've typed before. Easiest path: ask Claude to make it for you.
*Try it now:* type "make me a /standup skill that summarizes what I worked
on today from git log", then run `/standup` tomorrow morning.
📖 Skills → https://code.claude.com/docs/en/skills钩子
markdown
🔔 *Tip: Get pinged when your refactor finishes*
Sitting at your desk watching Claude work through a long task? You've got
better things to do for those eight minutes.
Hooks are shell commands that fire on Claude Code events. A Stop hook that
sends a desktop notification means you can kick off a long refactor, walk
away, and get pinged the moment it's done.
*Try it now:* ask Claude "add a Stop hook that sends a desktop notification
when you finish". It will write the script and wire it up.
📖 Hooks guide → https://code.claude.com/docs/en/hooks-guide日常开发
截图与图片
markdown
📸 *Tip: Stop describing the error dialog. Just show it.*
Typing out "there's a red box that says something about a null reference
and it's pointing at line 47-ish"? Screenshot it.
Drag a screenshot straight into the terminal and Claude sees it: error
dialogs, UI mockups, whiteboard photos, Figma exports. *Ctrl+V* pastes from
clipboard (use Ctrl+V on macOS too, not Cmd+V).
*Try it now:* next time something visual breaks, screenshot it and paste it
right into the prompt. Then just type "what's wrong here?"
📖 Working with images → https://code.claude.com/docs/en/common-workflowsGit 工作流
markdown
🌿 *Tip: Hand off the whole git ceremony*
The fix took 5 minutes. The commit message, branch, and PR description
took 15. That ratio is wrong.
Claude handles the full git flow: commits with conventional messages,
branches, PRs with proper summaries. One ask: "fix the off-by-one, commit
with a conventional commit message, and open a PR." Reviewing someone
else's work? Paste the PR URL and ask Claude to walk you through the diff.
*Try it now:* after your next fix, instead of switching to your git client,
just type "commit this with a good message and open a PR".
📖 Creating pull requests → https://code.claude.com/docs/en/common-workflows分享与扩展
插件
markdown
📦 *Tip: Someone probably already built that skill*
About to spend an hour building a `/deploy` command? Check if it
already exists.
Skills get bundled and shared as plugins. `/plugin` browses what's
available and installs in one step. Five minutes of browsing can save an
hour of building.
*Try it now:* type `/plugin` and scroll through. You'll find at least one
thing you didn't know you wanted.
📖 Plugins → https://code.claude.com/docs/en/plugins安全与管理员
安全架构
markdown
🔐 *Tip: The answer to "is this safe?" for the next time you're asked*
Someone on your team is going to ask "wait, where does my code go?"
Here's the short version you can paste.
Permission-first by design. Every file edit, shell command, and external
call is gated by your approval. The CLI runs in your terminal and talks
directly to Anthropic's API, with no third-party servers, and supports
optional OS-level sandboxing for shell commands. Under our Enterprise plan,
Anthropic does not use your code or prompts to train its models.
*Try it now:* save these two links for the next time the question comes up.
They answer most security-review questions.
📖 https://code.claude.com/docs/en/security
📖 https://code.claude.com/docs/en/data-usage最佳实践
markdown
✅ *Tip: The 4 habits that separate "tried it once" from "use it daily"*
Most people who bounce off Claude Code skipped one of these. Most people
who stick did all four in week one.
- Start in plan mode for anything touching multiple files
- Run /init early; context compounds
- Review diffs before committing; Claude can be confidently wrong
- Verify changes that touch critical paths; treat it like a sharp
junior, not an oracle
*Try it now:* if you've only done one or two of these, pick the one you're
missing and do it on your next task. Post what changed in #claude-code.
📖 Best practices → https://code.claude.com/docs/en/best-practices快速参考
FAQ 回复
针对你最常被问到的问题的单行回复。
| 问题 | 回复 |
|---|---|
| “它在 VS Code 里能用吗?” | 是的。有 VS Code 扩展和 JetBrains 插件,功能相同,内嵌在编辑器中。VS Code → |
| “我需要先配置什么吗?” | 不需要。安装后在任何 repo 中运行 claude 即可。运行一次 /init 就配置好了。Quickstart → |
| “我的代码去了哪里?” | CLI 在你的终端中运行,将上下文发送到 Anthropic 的 API 用于推理,没有第三方服务器。根据你的企业计划,你的代码和提示不会用于训练模型。数据使用 → |
| “它能看到我整个 repo 吗?” | 它能读取你授权访问的内容。工作目录内的文件读取不会触发提示;编辑、shell 命令和工作目录外的操作会触发权限提示。权限 → |
| “它和 Copilot 有什么不同?” | Copilot 补全代码行。Claude Code 是一个能够读取文件、运行命令并进行多文件编辑的代理。概述 → |
| “我应该先尝试什么?” | 一个你一直因为太繁琐而推迟的 bug。“[文件] 中的测试不稳定,找出原因并修复。”Quickstart → |
提示模板
将这些入门提示分享给已安装但不确定要问什么的工程师。每条都用实际会话中会键入的方式表达;将方括号内的内容替换为你自己 repo 中的文件。
| 任务 | 提示 |
|---|---|
| 修复一个 bug | “the tests in [file] are failing, figure out why and fix it” |
| 理解代码 | “walk me through how [module] works, then tell me where the entry point is” |
| 安全重构 | “refactor [module] to [goal], use plan mode so I can review first” |
| 编写测试 | “write tests for [file] that cover the edge cases around [scenario]” |
| 提交前审查 | “look at my working diff and tell me what looks risky” |
| 发起 PR | “fix [issue], write a conventional commit, and open a PR with a summary” |
| 创建技能 | “make me a /ship skill that runs tests and lint before commit” |
| 调试堆栈跟踪 | “here's the stack trace, find the root cause, don't just paper over it” |
Claude Code 频繁发布新版本。在内部分发前,请对照文档首页核实版本特定细节。
常见问题
我将 Claude Code 推广给团队时,应该先发送哪个公告?
先发送标准公告(邮件或 Slack 格式)。如果可能,让一位高管(CTO/CIO)用自己的名义发送高管赞助变体,这会显著提高首周采纳率。试点组变体仅用于分阶段推出。
发送公告前必须完成哪些检查项?
必须完成 6 项:创建 #claude-code 频道、在至少一台机器上测试安装命令、准备好数据使用链接、选定一项真实的第一任务、指定前 48 小时频道负责人、安排高管支持者。
“技巧与窍门战役”应该按什么顺序推送?
没有固定的顺序,推荐按以下主题分组并每周推送 1-2 条:入门模型选择与快速上手 → 项目记忆(/init 和@引用) → 控制与安全(权限模式和检查点) → 连接工具(MCP) → 自动化工作流(技能和钩子) → 日常开发(截图、Git 工作流) → 分享与扩展(插件) → 安全与管理。