English ← MyDocs

文档索引

在此获取完整文档索引:https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面,然后再进一步探索。

传播工具包

向工程组织推出 Claude Code 时使用的发布通知、持续培育消息和 FAQ 回复。

本页面面向向团队推出 Claude Code 的管理员和工程负责人。它提供了现成的发布通知、技巧和窍门持续培育活动,以及您最常被问到的问题的单行 FAQ 回复。

Note

将此处所有内容视为草稿,而非最终稿。以您组织的风格重写每条消息,将示例任务替换为您自己代码库中的真实 bug 和模块,并在发送前替换 [括号占位符]。推动采用的通知是那些读起来像您公司内部人员撰写的通知。

发布通知

一种通知的两种格式,加上两个可选变体。选择适合您推出的版本并在此基础上重写。

发送前

在通知发出之前完成此清单。每一项都填补了一个否则会变成发布日支持线程的空白。

项目重要性
已创建 #claude-code 频道并在消息中链接为问题提供一个集中地点
至少在您环境中的一台机器上测试了安装命令在所有人同时遇到代理或防火墙问题之前捕获它们
安全和数据处理链接已准备好(数据使用或您的内部等效项)"我的代码去哪了?"将是第一个回复
选择了具体的第一个任务,您代码库中的真实 bug 或文件通用示例不会转化;"修复 auth_test.go 中的不稳定测试"可以
指定了频道的负责人,负责前 48 小时未回答的发布日问题会扼杀势头
安排了 C 级别的赞助商发送或联合签署通知高管发出的发布活动在第一周的采用率始终高于管理员发出的活动

通知

将此用作您的标准组织范围推出消息。它涵盖了 Claude Code 是什么,提供了两分钟的安装路径,给读者一个具体的任务来尝试,并在任何人提问之前回答了"我的代码去哪了?"。

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.
🚀 *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 Engineering)以其名义和帐户发送。以高管名义发出的发布活动在打开率和第一周激活率方面始终高于来自管理员或工具团队的相同消息。它表明这是公司优先事项,而不是可选实验。

此版本有意精简为一个请求:安装它并在一个真实任务上运行。高管的工作是让请求落地;标准通知和 #claude-code 处理如何做。

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]
📣 *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.

试点组变体

用于分阶段推出。仅发送给试点队列。

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 中最活跃的两三个人发私信。

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 中。发送前替换 [括号占位符]

入门

选择合适的模型

🎯 *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日常功能工作、bug 修复、测试、文档、代码审查。推荐默认。
Haiku快速问题、格式化、机械编辑、快速迭代

首先尝试的快速胜利

🚀 *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

📁 *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

@ 引用

📎 *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

控制和安全

权限模式

🛡️ *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

⏪ *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 连接器

🔌 *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

自动化您的工作流

技能

⚡ *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

钩子

🔔 *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

日常开发

截图和图像

📸 *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-workflows

Git 工作流

🌿 *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

分享和扩展

插件

📦 *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

安全和管理

安全架构

🔐 *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

最佳实践

✅ *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 →
"我必须先配置什么吗?"不需要。安装,然后在任何仓库中运行 claude。运行一次 /init 就可以了。快速入门 →
"我的代码去哪了?"CLI 在您的终端中运行,并将上下文发送到 Anthropic 的 API 进行推理,没有第三方服务器。在您的 Enterprise 计划下,您的代码和提示不会用于训练模型。数据使用 →
"它能看到我的整个仓库吗?"它读取您授予访问权限的内容。工作目录内的文件读取不会提示;权限提示控制编辑、shell 命令和该目录之外的任何内容。权限 →
"这与 Copilot 有什么不同?"Copilot 自动补全代码行。Claude Code 是一个代理,读取文件、运行命令并进行多文件编辑。概览 →
"我应该先尝试什么?"一个因为繁琐而一直推迟的 bug。"[file] 中的测试不稳定,找出原因。"快速入门 →

提示模板

与已安装但不确定问什么的工程师分享这些入门提示。每个提示都以实际会话中的输入方式编写;将括号中的部分替换为您自己仓库中的文件。

任务提示
修复 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"
Tip

Claude Code 更新频繁。在内部分发之前,请对照文档主页验证版本特定的详细信息。