通俗版 Claude Code 文档

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

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

参考

交互模式

交互模式里有哪些口令和习惯用法。

页面信息

对应原页

Interactive mode

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

这页讲交互模式,也就是你和 Claude Code 在会话里怎么配合最顺手。

快捷键、输入方式、命令节奏,基本都在这页。

这像教你怎么跟熟练帮工搭话。什么时候直接开口,什么时候用快捷动作,什么时候翻历史记录,都有门道。

如果你天天待在交互式会话里,这页能帮你少绕很多手。

它不一定华丽,但非常实用。

先记最常用的快捷键和内置命令,别想着一口气全背。

输入、编辑、历史搜索这些动作,练熟之后效率会明显上来。

如果你习惯 Vim 或固定键位,这页尤其值得细看。

关键片段

原页关键片段:Shell mode with ! prefix

这一段要真抓重点,通常就抓下面这块原文。

! npm test
! git status
! ls -la
关键片段

原页关键片段:Prompt suggestions

"Prompt suggestions"这一段里最要紧的原始写法在下面,先看它怎么落地。

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
直接对 Claude 说

原页关键片段:Side questions with /btw

最省事的做法,就是把下面这句原样说给 Claude。

/btw what was the name of that config file again?

预留广告位

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

Documentation Index

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

Keyboard shortcuts

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

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

General controls

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

Text editing

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

Theme and display

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

Multiline input

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

这一段还会谈显示方式和终端环境,重点是先选一个你当前最稳能用的模式,不必一上来追求花哨。

Quick commands

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

Transcript viewer

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

Voice input

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

Commands

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

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

Vim editor mode

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

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

Mode switching

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

Navigation (NORMAL mode)

看到这里,就把"Navigation (NORMAL mode)"当成一件真要上手的活来看。

Editing (NORMAL mode)

看到这里,就把"Editing (NORMAL mode)"当成一件真要上手的活来看。

Text objects (NORMAL mode)

这里不是让你背"Text objects (NORMAL mode)"这个词,而是让你看它真干活时怎么使。

Visual mode

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

Command history

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

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

Reverse search with Ctrl+R

这一段主要是在把"Reverse search with Ctrl+R"讲实,不是只摆个标题给你看。

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

Background bash commands

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

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

How backgrounding works

这一段是在讲它背后怎么转,不是立刻让你去按按钮。

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

Shell mode with ! prefix

这一段是在把 shell commands directly without going through Claude by prefixing your input with !: 真跑起来。别只看命令长什么样,还得看跑完该出现什么。

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

关键片段

Shell mode with ! prefix

这一段要真抓重点,通常就抓下面这块原文。

! npm test
! git status
! ls -la

Prompt suggestions

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

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

关键片段

Prompt suggestions

"Prompt suggestions"这一段里最要紧的原始写法在下面,先看它怎么落地。

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

Side questions with /btw

这一段是在说怎么用 /btw to ask a quick question about your current work without adding to the conversation history. This is useful when you want a fast answer but don’t want 去做 clutter the main context or derail Claude from a long-running task.。看这种内容,光知道名字没用,还是得落到手上。

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

直接对 Claude 说

Side questions with /btw

最省事的做法,就是把下面这句原样说给 Claude。

/btw what was the name of that config file again?

Task list

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

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

Session recap

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

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

PR review status

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

See also

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

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

照着做一遍

如果你不想来回翻,就先照这几步顺着做。

每做完一步就看一下结果,再决定要不要继续往下。

关键片段

第 1 步:Shell mode with ! prefix

这一段要真抓重点,通常就抓下面这块原文。

! npm test
! git status
! ls -la
关键片段

第 2 步:Prompt suggestions

"Prompt suggestions"这一段里最要紧的原始写法在下面,先看它怎么落地。

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
直接对 Claude 说

第 3 步:Side questions with /btw

最省事的做法,就是把下面这句原样说给 Claude。

/btw what was the name of that config file again?

一眼看懂这一页

先把这页到底在讲什么看明白,再去碰具体命令和配置,最不容易绕晕。

Interactive mode
   |
   v
这是 Reference 里的一摊要紧活
   |
   v
先弄懂,再下手

文末提醒

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

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