通俗版 Claude Code 文档

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

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

核心概念

它咋个干活

它咋个干活 这一页讲的,就是 它咋个干活 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

它咋个干活

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

这页解释 Claude Code 干活的基本套路。

它不是瞎猜,而是先看现场、再计划、再动手、再回头验。

像一个靠谱师傅,先围着屋子转一圈,问清问题,再决定从哪块砖下手。

你越理解这个工作节奏,就越知道该什么时候让它先分析,什么时候再让它改。

大活先让它分析和列计划,小活可以直接让它上手。

如果它开始跑偏,通常是任务边界不清,或者上下文里混了太多互不相关的信息。

预留广告位

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

Documentation Index

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

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

The agentic loop

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

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

Models

这一段主要是在把"Models"讲实,不是只摆个标题给你看。

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

Tools

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

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

What Claude can access

这里主要是在交代"What Claude can access"这一块会碰到哪些事。

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

Environments and interfaces

别把这段只当成标题看,它其实是在给"Environments and interfaces"划边界。

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

Execution environments

这一段主要是在把"Execution environments"讲实,不是只摆个标题给你看。

Interfaces

这一段主要是在把"Interfaces"讲实,不是只摆个标题给你看。

Work with sessions

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

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

Work across branches

这一段主要是在把"Work across branches"讲实,不是只摆个标题给你看。

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

Resume or fork sessions

看到这里,就把"Resume or fork sessions"当成一件真要上手的活来看。

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

The context window

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

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

Stay safe with checkpoints and permissions

这里不是让你背"Stay safe with checkpoints and permissions"这个词,而是让你看它真干活时怎么使。

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

Undo changes with checkpoints

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

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

Control what Claude can do

这段主要是在说平时怎么管,不是光教你怎么开。

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

Work effectively with Claude Code

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

Ask Claude Code for help

这一段主要是在把"Ask Claude Code for help"讲实,不是只摆个标题给你看。

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

It’s a conversation

这一块主要是在说"It’s a conversation"真到手上该怎么用,哪里最容易踩坑。

直接对 Claude 说

It’s a conversation 1

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

Fix the login bug
直接对 Claude 说

It’s a conversation 2

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

That's not quite right. The issue is in the session handling.

Be specific upfront

别把这段只当成标题看,它其实是在给"Be specific upfront"划边界。

关键片段

Be specific upfront

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

The checkout flow is broken for users with expired cards.
Check src/payments/ for the issue, especially token refresh.
Write a failing test first, then fix it.

Give Claude something to verify against

这里不是让你背"Give Claude something to verify against"这个词,而是让你看它真干活时怎么使。

关键片段

Give Claude something to verify against

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

Implement validateEmail. Test cases: 'user@example.com' → true,
'invalid' → false, 'user@.com' → false. Run the tests after.

Explore before implementing

看到这里,就把"Explore before implementing"当成一件真要上手的活来看。

关键片段

Explore before implementing

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

Read src/auth/ and understand how we handle sessions.
Then create a plan for adding OAuth support.

Delegate, don’t dictate

看到这里,就把"Delegate, don’t dictate"当成一件真要上手的活来看。

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

直接对 Claude 说

Delegate, don’t dictate

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

The checkout flow is broken for users with expired cards.
The relevant code is in src/payments/. Can you investigate and fix it?

What’s next

看到这里,就把"What’s next"当成一件真要上手的活来看。

Extend with features

看到这里,就把"Extend with features"当成一件真要上手的活来看。

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

Common workflows

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

照着做一遍

这页属于“它咋个干活”这类活,最稳的办法还是一小步一小步来。

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

第 1 步:先起步

大活先让它分析和列计划,小活可以直接让它上手。

第 2 步:边做边看

如果它开始跑偏,通常是任务边界不清,或者上下文里混了太多互不相关的信息。

一眼看懂这一页

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

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

文末提醒

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

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