通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

Use Claude Code

常见干活套路

常见干活套路 这一页讲的,就是 常见干活套路 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

常见干活套路

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这一页讲的是常见活路该怎么派给 Claude Code。

不是空谈能力,而是把常见任务拆成顺手套路。

新项目摸底、修 bug、补测试、整理说明、做代码审查,这些都是日常高频活。

按套路派活,比临场乱说更稳,也更容易复用。

先从“让它先看,再让它改,再让它验”这个固定节奏开始。

如果是复杂活,就把活拆成几段,一段一段验,不要一口吞整头牛。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Prompt recipes

这一块主要是在说"Prompt recipes"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Understand new codebases

看到这里,就把"Understand new codebases"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

关键片段

Understand new codebases 1

先看下面这块原始片段,等会儿再回头看解释会顺得多。

cd /path/to/project
直接对 Claude 说

Understand new codebases 2

这一步不用你自己动手配什么,把下面这句话交出去就行。

what are the key data models?
直接对 Claude 说

Understand new codebases 3

这一步不用你自己动手配什么,把下面这句话交出去就行。

how is authentication handled?

Fix bugs efficiently

这里不是让你背"Fix bugs efficiently"这个词,而是让你看它真干活时怎么使。

直接对 Claude 说

Fix bugs efficiently

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Fix bugs efficiently"这一段的意思去办。

I'm seeing an error when I run npm test

Refactor code

这一块主要是在说"Refactor code"真到手上该怎么用,哪里最容易踩坑。

Work with tests

这里不是让你背"Work with tests"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Create pull requests

这一块主要是在说"Create pull requests"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Handle documentation

这里不是让你背"Handle documentation"这个词,而是让你看它真干活时怎么使。

Work in notes and non-code folders

这一段主要是在把"Work in notes and non-code folders"讲实,不是只摆个标题给你看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Work with images

这一块主要是在说"Work with images"真到手上该怎么用,哪里最容易踩坑。

直接对 Claude 说

Work with images 1

到这里其实就剩一句话,把下面这句发出去就行。

What does this image show?
直接对 Claude 说

Work with images 2

到这里其实就剩一句话,把下面这句发出去就行。

Describe the UI elements in this screenshot
直接对 Claude 说

Work with images 3

到这里其实就剩一句话,把下面这句发出去就行。

Are there any problematic elements in this diagram?
直接对 Claude 说

Work with images 4

到这里其实就剩一句话,把下面这句发出去就行。

Here's a screenshot of the error. What's causing it?

Reference files and directories

这一段就是给你查规矩的,像看说明书那样一项项对着来。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

关键片段

Reference files and directories 1

下面这块是这一段最值钱的原文样板,先对着看一眼。

Explain the logic in @src/utils/auth.js
直接对 Claude 说

Reference files and directories 2

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Reference files and directories"这一段的意思去办。

What's the structure of @src/components?
关键片段

Reference files and directories 3

下面这块是这一段最值钱的原文样板,先对着看一眼。

Show me the data from @github:repos/owner/repo/issues

Run Claude on a schedule

这里不是让你背"Run Claude on a schedule"这个词,而是让你看它真干活时怎么使。

Ask Claude about its capabilities

这里不是让你背"Ask Claude about its capabilities"这个词,而是让你看它真干活时怎么使。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

直接对 Claude 说

Ask Claude about its capabilities 1

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Ask Claude about its capabilities"这一段的意思去办。

can Claude Code create pull requests?
直接对 Claude 说

Ask Claude about its capabilities 2

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Ask Claude about its capabilities"这一段的意思去办。

how does Claude Code handle permissions?
直接对 Claude 说

Ask Claude about its capabilities 3

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Ask Claude about its capabilities"这一段的意思去办。

what skills are available?
直接对 Claude 说

Ask Claude about its capabilities 4

这里不用敲命令,直接把下面这句话发给 Claude 就行,让它按"Ask Claude about its capabilities"这一段的意思去办。

how do I use MCP with Claude Code?

Resume previous conversations

这一段更像在讲判断条件,什么时候该上,什么时候先别急。把触发条件看清,比背标题更重要。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Resume previous conversations

先别急着往下翻,下面这条命令跑完,心里才有底。

claude --continue

Run parallel sessions with worktrees

看到这里,就把"Run parallel sessions with worktrees"当成一件真要上手的活来看。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Run parallel sessions with worktrees

这一段不是只让你理解意思,下面这条命令就是现在要跑的。

claude --worktree feature-auth

Plan before editing

这里不是让你背"Plan before editing"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

终端里敲

Plan before editing

真到动手的时候了,下面这条直接敲一遍,看它回什么。

claude --permission-mode plan

Delegate research to subagents

看到这里,就把"Delegate research to subagents"当成一件真要上手的活来看。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Pipe Claude into scripts

这一段是在把 Claude non-interactively for CI, pre-commit hooks, or batch processing. Stdin and stdout work like any Unix tool. 真跑起来。别只看命令长什么样,还得看跑完该出现什么。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

终端里敲

Pipe Claude into scripts

真到动手的时候了,下面这条直接敲一遍,看它回什么。

git log --oneline -20 | claude -p "summarize these recent commits"

Next steps

这里不是让你背"Next steps"这个词,而是让你看它真干活时怎么使。

Best practices

这段算经验活,听劝通常能省事。

Manage sessions

这里讲的是收放和管理,不只是"能不能用",而是"怎么管住、怎么不乱"。

Worktrees

这一段是在把 isolated parallel sessions 真跑起来。别只看命令长什么样,还得看跑完该出现什么。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Extend Claude Code

这一块主要是在说"Extend Claude Code"真到手上该怎么用,哪里最容易踩坑。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

照着做一遍

这页属于“常见干活套路”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

先从“让它先看,再让它改,再让它验”这个固定节奏开始。

第 2 步:边做边看

如果是复杂活,就把活拆成几段,一段一段验,不要一口吞整头牛。

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

常见干活套路
   |
   v
常见干活套路 这一页讲的,就是 常见干活套路 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。