8 8
9本术语表定义了 Claude Code 术语。每个条目都链接到深入讨论该概念的页面。对于模型级概念(如 tokens、temperature 和 RAG),请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary)。9本术语表定义了 Claude Code 术语。每个条目都链接到深入讨论该概念的页面。对于模型级概念(如 tokens、temperature 和 RAG),请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary)。
10 10
11## A11<h2 id="a">
12 A
13</h2>
12 14
13### Agent teams15<h3 id="agent-teams">
16 Agent teams
17</h3>
14 18
15由团队负责人协调的多个独立 Claude Code 会话,具有共享任务列表和点对点消息传递。与在单个会话中运行且仅向父级报告的 [subagents](#subagent) 不同,团队成员各自拥有自己的上下文窗口,您可以直接与任何一个交互。Agent teams 是实验性的,必须通过设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 来启用。19由团队负责人协调的多个独立 Claude Code 会话,具有共享任务列表和点对点消息传递。与在单个会话中运行且仅向父级报告的 [subagents](#subagent) 不同,团队成员各自拥有自己的上下文窗口,您可以直接与任何一个交互。Agent teams 是实验性的,必须通过设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 来启用。
16 20
17了解更多:[运行 agent teams](/zh-CN/agent-teams)21了解更多:[运行 agent teams](/zh-CN/agent-teams)
18 22
19### Agentic coding23<h3 id="agentic-coding">
24 Agentic coding
25</h3>
20 26
21一种工作流程,其中 AI 可以自主读取文件、运行命令和进行更改,而您可以观看、重定向或离开,与只能用文本响应的基于聊天的助手相反,您必须自己应用这些响应。Claude Code 是 agentic 的,因为它拥有允许它采取行动而不仅仅是建议的[工具](#tool)。27一种工作流程,其中 AI 可以自主读取文件、运行命令和进行更改,而您可以观看、重定向或离开,与只能用文本响应的基于聊天的助手相反,您必须自己应用这些响应。Claude Code 是 agentic 的,因为它拥有允许它采取行动而不仅仅是建议的[工具](#tool)。
22 28
23了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)29了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)
24 30
25### Agentic harness31<h3 id="agentic-harness">
32 Agentic harness
33</h3>
26 34
27将语言模型转变为能力强大的编码代理的工具、上下文管理和执行环境。Claude Code 是 harness;Claude 是其中的模型。Harness 提供文件访问、shell 执行、权限控制、内存加载以及链接操作的循环。35将语言模型转变为能力强大的编码代理的工具、上下文管理和执行环境。Claude Code 是 harness;Claude 是其中的模型。Harness 提供文件访问、shell 执行、权限控制、内存加载以及链接操作的循环。
28 36
29了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)37了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)
30 38
31### Agentic loop39<h3 id="agentic-loop">
40 Agentic loop
41</h3>
32 42
33Claude 为每个任务所经历的循环:收集上下文、采取行动、验证结果并重复直到完成。每个工具使用都会返回信息,为下一步提供信息。您可以随时中断循环进行重定向。大多数扩展点,包括 [hooks](#hook)、[skills](#skill) 和 [MCP](#mcp-model-context-protocol),都插入到此循环的特定阶段。43Claude 为每个任务所经历的循环:收集上下文、采取行动、验证结果并重复直到完成。每个工具使用都会返回信息,为下一步提供信息。您可以随时中断循环进行重定向。大多数扩展点,包括 [hooks](#hook)、[skills](#skill) 和 [MCP](#mcp-model-context-protocol),都插入到此循环的特定阶段。
34 44
35了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)45了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)
36 46
37### Auto memory47<h3 id="auto-memory">
48 Auto memory
49</h3>
38 50
39Claude 根据您的更正和偏好为自己编写的笔记,按 git 存储库存储在 `~/.claude/projects/` 下。同一存储库的所有 worktrees 共享一个 auto memory 目录。`MEMORY.md` 索引的前 200 行或 25 KB 在每个会话开始时加载。Auto memory 是 Claude 编写的对应物,与您编写的 [CLAUDE.md](#claude-md) 相对。51Claude 根据您的更正和偏好为自己编写的笔记,按 git 存储库存储在 `~/.claude/projects/` 下。同一存储库的所有 worktrees 共享一个 auto memory 目录。`MEMORY.md` 索引的前 200 行或 25 KB 在每个会话开始时加载。Auto memory 是 Claude 编写的对应物,与您编写的 [CLAUDE.md](#claude-md) 相对。
40 52
41了解更多:[Auto memory](/zh-CN/memory#auto-memory)53了解更多:[Auto memory](/zh-CN/memory#auto-memory)
42 54
43### Auto mode55<h3 id="auto-mode">
56 Auto mode
57</h3>
44 58
45一种[权限模式](#permission-mode),其中单独的分类器模型在后台审查每个操作,而不是向您显示批准提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。它永远看不到工具结果,因此注入的指令无法影响其决策。Auto mode 是在 Max、Team、Enterprise 和 API 计划上提供的研究预览。59一种[权限模式](#permission-mode),其中单独的分类器模型在后台审查每个操作,而不是向您显示批准提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。它永远看不到工具结果,因此注入的指令无法影响其决策。Auto mode 是研究预览。
46 60
47了解更多:[使用 auto mode 消除提示](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)61了解更多:[使用 auto mode 消除提示](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)
48 62
49## B63<h2 id="b">
64 B
65</h2>
50 66
51### Bare mode67<h3 id="bare-mode">
68 Bare mode
69</h3>
52 70
53一个启动标志 `--bare`,跳过 hooks、skills、plugins、MCP servers、auto memory 和 CLAUDE.md 的自动发现。只有您显式传递的标志才会生效。建议用于 CI 和脚本调用,其中您需要在不同机器上的相同行为,无论本地配置如何。71一个启动标志 `--bare`,跳过 hooks、skills、plugins、MCP servers、auto memory 和 CLAUDE.md 的自动发现。只有您显式传递的标志才会生效。建议用于 CI 和脚本调用,其中您需要在不同机器上的相同行为,无论本地配置如何。
54 72
55了解更多:[使用 bare mode 更快启动](/zh-CN/headless#start-faster-with-bare-mode)73了解更多:[使用 bare mode 更快启动](/zh-CN/headless#start-faster-with-bare-mode)
56 74
57### Bundled skills75<h3 id="bundled-skills">
76 Bundled skills
77</h3>
58 78
59包含在 Claude Code 中的基于提示的 playbooks,例如 `/batch`、`/simplify`、`/debug` 和 `/loop`。与执行固定逻辑的内置命令不同,bundled skills 为 Claude 提供详细的提示并让它编排工作,因此它们可以生成代理、读取文件并适应您的代码库。79包含在 Claude Code 中的基于提示的 playbooks,例如 `/batch`、`/code-review`、`/debug` 和 `/loop`。与执行固定逻辑的内置命令不同,bundled skills 为 Claude 提供详细的提示并让它编排工作,因此它们可以生成代理、读取文件并适应您的代码库。
60 80
61了解更多:[Bundled skills](/zh-CN/skills#bundled-skills)81了解更多:[Bundled skills](/zh-CN/skills#bundled-skills)
62 82
63## C83<h2 id="c">
84 C
85</h2>
64 86
65### Channel87<h3 id="channel">
88 Channel
89</h3>
66 90
67一个 [MCP server](#mcp-model-context-protocol),将事件推送到您正在运行的会话中,以便 Claude 可以对您离开终端时发生的事情做出反应。Channels 可以是双向的:Claude 读取入站事件并通过同一 channel 回复。Telegram、Discord 和 iMessage 包含在研究预览中。91一个 [MCP server](#mcp-model-context-protocol),将事件推送到您正在运行的会话中,以便 Claude 可以对您离开终端时发生的事情做出反应。Channels 可以是双向的:Claude 读取入站事件并通过同一 channel 回复。Telegram、Discord 和 iMessage 包含在研究预览中。
68 92
69了解更多:[Channels](/zh-CN/channels)93了解更多:[Channels](/zh-CN/channels)
70 94
71### Checkpoint95<h3 id="checkpoint">
96 Checkpoint
97</h3>
72 98
73在每个您发送的提示处创建的还原点。Claude Code 在每次编辑之前对文件进行快照,以便 checkpoint 可以恢复它们。按两次 `Esc` 或运行 `/rewind` 将代码、对话或两者恢复到较早的点,或从选定的消息总结对话的一部分。Checkpoints 是会话本地的,与 git 分开,不跟踪通过 Bash 工具进行的更改。99在每个您发送的提示处创建的还原点。Claude Code 在每次编辑之前对文件进行快照,以便 checkpoint 可以恢复它们。按两次 `Esc` 或运行 `/rewind` 将代码、对话或两者恢复到较早的点,或从选定的消息总结对话的一部分。Checkpoints 是会话本地的,与 git 分开,不跟踪通过 Bash 工具进行的更改。
74 100
75了解更多:[Checkpointing](/zh-CN/checkpointing)101了解更多:[Checkpointing](/zh-CN/checkpointing)
76 102
77### `.claude` directory103<h3 id="claude-directory">
104 `.claude` directory
105</h3>
78 106
79Claude Code 读取项目范围配置的目录:settings、hooks、skills、subagents、rules 和 auto memory。项目在其根目录有 `.claude/`;您的用户级默认值在 `~/.claude/`。107Claude Code 读取项目范围配置的目录:settings、hooks、skills、subagents、rules 和 auto memory。项目在其根目录有 `.claude/`;您的用户级默认值在 `~/.claude/`。
80 108
81了解更多:[The `.claude` directory](/zh-CN/claude-directory)109了解更多:[The `.claude` directory](/zh-CN/claude-directory)
82 110
83### CLAUDE.md111<h3 id="claude-md">
112 CLAUDE.md
113</h3>
84 114
85一个 markdown 文件,包含您为 Claude 编写的持久指令,在每个会话开始时作为系统提示后的用户消息加载。在此处放置项目约定、架构笔记和"始终执行 X"规则。CLAUDE.md 在 [compaction](#compaction) 期间保留,之后从磁盘重新读取。115一个 markdown 文件,包含您为 Claude 编写的持久指令,在每个会话开始时作为系统提示后的用户消息加载。在此处放置项目约定、架构笔记和"始终执行 X"规则。Project-root CLAUDE.md 在 [compaction](#compaction) 期间保留,之后从磁盘重新读取。
86 116
87您可以在项目范围内的 `./CLAUDE.md` 或 `./.claude/CLAUDE.md`、用户范围内的 `~/.claude/CLAUDE.md` 或作为组织的[托管策略](#managed-settings)放置 CLAUDE.md。更具体的位置优先。117您可以在项目范围内的 `./CLAUDE.md` 或 `./.claude/CLAUDE.md`、用户范围内的 `~/.claude/CLAUDE.md` 或作为组织的[托管策略](#managed-settings)放置 CLAUDE.md。所有发现的文件都被连接到上下文中,而不是相互覆盖,按从最广泛的范围到最具体的范围排序。
88 118
89了解更多:[CLAUDE.md files](/zh-CN/memory#claude-md-files)119了解更多:[CLAUDE.md files](/zh-CN/memory#claude-md-files)
90 120
91### Command121<h3 id="command">
122 Command
123</h3>
92 124
93一个可重用的指令,您可以通过在提示中键入 `/name` 来调用。内置命令(如 `/clear`、`/model` 和 `/compact`)控制会话。您可以在 `.claude/commands/` 中将自己的命令定义为文件,或从 [plugin](#plugin) 安装它们。[Skills](#skill) 是打包多步骤命令的推荐方式。125一个可重用的指令,您可以通过在提示中键入 `/name` 来调用。内置命令(如 `/clear`、`/model` 和 `/compact`)控制会话。您可以在 `.claude/commands/` 中将自己的命令定义为文件,或从 [plugin](#plugin) 安装它们。[Skills](#skill) 是打包多步骤命令的推荐方式。
94 126
95了解更多:[Commands](/zh-CN/commands) · [Skills](/zh-CN/skills)127了解更多:[Commands](/zh-CN/commands) · [Skills](/zh-CN/skills)
96 128
97### Compaction129<h3 id="compaction">
130 Compaction
131</h3>
98 132
99当 [context window](#context-window) 接近其限制时,自动总结您的对话。首先清除较旧的工具输出,然后总结对话。项目根 CLAUDE.md 和 auto memory 在 compaction 期间保留并从磁盘重新加载;仅在对话中给出的指令可能会丢失。运行 `/compact` 手动触发,可选择使用焦点,如 `/compact focus on the API changes`。133当 [context window](#context-window) 接近其限制时,自动总结您的对话。首先清除较旧的工具输出,然后总结对话。Project-root CLAUDE.md 和 auto memory 在 compaction 期间保留并从磁盘重新加载;仅在对话中给出的指令可能会丢失。运行 `/compact` 手动触发,可选择使用焦点,如 `/compact focus on the API changes`。
100 134
101了解更多:[What survives compaction](/zh-CN/context-window#what-survives-compaction) · [When context fills up](/zh-CN/how-claude-code-works#when-context-fills-up)135了解更多:[What survives compaction](/zh-CN/context-window#what-survives-compaction) · [When context fills up](/zh-CN/how-claude-code-works#when-context-fills-up)
102 136
103### Context window137<h3 id="context-window">
138 Context window
139</h3>
104 140
105会话的工作内存,保存对话历史、文件内容、命令输出、CLAUDE.md、auto memory、加载的 skills 和系统指令。当您工作时,上下文会填满直到 [compaction](#compaction) 总结它。运行 `/context` 查看什么在使用空间。对于底层模型概念,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#context-window)。141会话的工作内存,保存对话历史、文件内容、命令输出、CLAUDE.md、auto memory、加载的 skills 和系统指令。当您工作时,上下文会填满直到 [compaction](#compaction) 总结它。运行 `/context` 查看什么在使用空间。对于底层模型概念,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#context-window)。
106 142
107了解更多:[Explore the context window](/zh-CN/context-window)143了解更多:[Explore the context window](/zh-CN/context-window)
108 144
109## D145<h2 id="d">
146 D
147</h2>
110 148
111### Dispatch149<h3 id="dispatch">
150 Dispatch
151</h3>
112 152
113一个电话启动的任务路由器,当您从 Claude 移动应用发送编码任务时,在 Desktop 应用中生成 Claude Code 会话。您的提示自动路由到正确的工具。在 Pro 和 Max 计划上可用。153一个电话启动的任务路由器,当您从 Claude 移动应用发送编码任务时,在 Desktop 应用中生成 Claude Code 会话。您的提示自动路由到正确的工具。在 Pro 和 Max 计划上可用。
114 154
115了解更多:[来自 Dispatch 的会话](/zh-CN/desktop#sessions-from-dispatch)155了解更多:[来自 Dispatch 的会话](/zh-CN/desktop#sessions-from-dispatch)
116 156
117## E157<h2 id="e">
158 E
159</h2>
118 160
119### Effort level161<h3 id="effort-level">
162 Effort level
163</h3>
120 164
121一个设置,控制 Claude 在每个回合上使用多少自适应推理思考预算。更高的努力意味着更多的思考 tokens 和更深入的推理;更低的努力更快且更便宜。Effort 在 Opus 4.7、Opus 4.6 和 Sonnet 4.6 上受支持。165一个设置,控制 Claude 在每个回合上使用多少自适应推理思考预算。更高的努力意味着更多的思考 tokens 和更深入的推理;更低的努力更快且更便宜。Effort 在 Opus 4.6 及更高版本以及 Sonnet 4.6 上受支持。
122 166
123了解更多:[调整 effort level](/zh-CN/model-config#adjust-effort-level)167了解更多:[调整 effort level](/zh-CN/model-config#adjust-effort-level)
124 168
125### Extended thinking169<h3 id="extended-thinking">
170 Extended thinking
171</h3>
126 172
127模型在响应前执行的可见逐步推理。您可以使用 `MAX_THINKING_TOKENS` 限制思考 tokens 或调整 [effort level](#effort-level)。思考在终端中以灰色斜体文本显示。173模型在响应前执行的可见逐步推理。您可以使用 `MAX_THINKING_TOKENS` 限制思考 tokens 或调整 [effort level](#effort-level)。思考在终端中以灰色斜体文本显示。
128 174
129了解更多:[使用 extended thinking](/zh-CN/model-config#extended-thinking)175了解更多:[使用 extended thinking](/zh-CN/model-config#extended-thinking)
130 176
131## H177<h2 id="h">
178 H
179</h2>
132 180
133### Hook181<h3 id="hook">
182 Hook
183</h3>
134 184
135一个用户定义的处理程序,在 Claude Code 生命周期中的特定点自动执行,例如在工具运行之前、文件编辑之后或会话开始时。处理程序可以是 shell 命令、HTTP 端点、MCP 工具、LLM 提示或 subagent。Hooks 是确定性的:它们在固定的生命周期点触发,而不是由模型自行决定。185一个用户定义的处理程序,在 Claude Code 生命周期中的特定点自动执行,例如在工具运行之前、文件编辑之后或会话开始时。处理程序可以是 shell 命令、HTTP 端点、MCP 工具、LLM 提示或 subagent。Hooks 是确定性的:它们在固定的生命周期点触发,而不是由模型自行决定。
136 186
142 192
143了解更多:[开始使用 hooks](/zh-CN/hooks-guide) · [Hooks 参考](/zh-CN/hooks)193了解更多:[开始使用 hooks](/zh-CN/hooks-guide) · [Hooks 参考](/zh-CN/hooks)
144 194
145## M195<h2 id="m">
196 M
197</h2>
146 198
147### Managed settings199<h3 id="managed-settings">
200 Managed settings
201</h3>
148 202
149由 IT 或 DevOps 在组织范围内强制执行的设置文件,放置在 `~/.claude` 之外的操作系统级路径。用户无法覆盖或排除托管设置。使用此功能可实现安全策略、合规要求或跨一个群体的标准化工具。203由 IT 或 DevOps 在组织范围内强制执行的设置文件,放置在 `~/.claude` 之外的操作系统级路径。用户无法覆盖或排除托管设置。使用此功能可实现安全策略、合规要求或跨一个群体的标准化工具。
150 204
151了解更多:[服务器管理的设置](/zh-CN/server-managed-settings)205了解更多:[服务器管理的设置](/zh-CN/server-managed-settings)
152 206
153### MCP (Model Context Protocol)207<h3 id="mcp-model-context-protocol">
208 MCP (Model Context Protocol)
209</h3>
154 210
155一个开放标准,用于将 AI 工具连接到外部数据源和服务。MCP servers 为 Claude 提供 Slack、Jira、数据库、浏览器和数百个其他集成的新工具。您可以通过 `/mcp` 连接服务器或将它们添加到 `.mcp.json`。对于协议本身,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#mcp-model-context-protocol)。211一个开放标准,用于将 AI 工具连接到外部数据源和服务。MCP servers 为 Claude 提供 Slack、Jira、数据库、浏览器和数百个其他集成的新工具。您可以通过 `/mcp` 连接服务器或将它们添加到 `.mcp.json`。对于协议本身,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#mcp-model-context-protocol)。
156 212
157了解更多:[Model Context Protocol](/zh-CN/mcp)213了解更多:[Model Context Protocol](/zh-CN/mcp)
158 214
159### MCP Tool Search215<h3 id="mcp-tool-search">
216 MCP Tool Search
217</h3>
160 218
161一个上下文节省机制,延迟 MCP 工具 schemas 直到需要。只有工具名称在启动时加载;Claude 在决定使用特定工具时按需获取完整 schema。这使空闲 MCP servers 不会消耗太多上下文。219一个上下文节省机制,延迟 MCP 工具 schemas 直到需要。只有工具名称在启动时加载;Claude 在决定使用特定工具时按需获取完整 schema。这使空闲 MCP servers 不会消耗太多上下文。
162 220
163了解更多:[使用 MCP Tool Search 扩展](/zh-CN/mcp#scale-with-mcp-tool-search)221了解更多:[使用 MCP Tool Search 扩展](/zh-CN/mcp#scale-with-mcp-tool-search)
164 222
165## N223<h2 id="n">
224 N
225</h2>
166 226
167### Non-interactive mode227<h3 id="non-interactive-mode">
228 Non-interactive mode
229</h3>
168 230
169一种执行单个提示并退出而不进行对话会话的模式,使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。[Agent SDK](/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。231一种执行单个提示并退出而不进行对话会话的模式,使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。[Agent SDK](/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。
170 232
171了解更多:[以编程方式运行 Claude Code](/zh-CN/headless)233了解更多:[以编程方式运行 Claude Code](/zh-CN/headless)
172 234
173## O235<h2 id="o">
236 O
237</h2>
174 238
175### Output style239<h3 id="output-style">
240 Output style
241</h3>
176 242
177一个配置,修改 Claude 的系统提示以改变响应行为、语气或格式。Output styles 关闭默认系统提示的软件工程特定部分,与 [CLAUDE.md](#claude-md) 不同,后者作为系统提示后的用户消息传递。内置样式包括 Default、Proactive、Explanatory 和 Learning。243一个配置,修改 Claude 的系统提示以改变响应行为、语气或格式。Output styles 关闭默认系统提示的软件工程特定部分,与 [CLAUDE.md](#claude-md) 不同,后者作为系统提示后的用户消息传递。内置样式包括 Default、Proactive、Explanatory 和 Learning。
178 244
179了解更多:[Output styles](/zh-CN/output-styles)245了解更多:[Output styles](/zh-CN/output-styles)
180 246
181## P247<h2 id="p">
248 P
249</h2>
182 250
183### Permission mode251<h3 id="permission-mode">
252 Permission mode
253</h3>
184 254
185会话的基线批准行为。在 CLI 中使用 `Shift+Tab` 循环或在 VS Code、Desktop 和 claude.ai 中使用模式选择器。可用模式为 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk` 和 `bypassPermissions`。255会话的基线批准行为。在 CLI 中使用 `Shift+Tab` 循环或在 VS Code、Desktop 和 claude.ai 中使用模式选择器。可用模式为 `default`、`acceptEdits`、`plan`、`auto`、`dontAsk` 和 `bypassPermissions`。
186 256
187了解更多:[选择权限模式](/zh-CN/permission-modes)257了解更多:[选择权限模式](/zh-CN/permission-modes)
188 258
189### Permission rule259<h3 id="permission-rule">
260 Permission rule
261</h3>
190 262
191一个设置条目,根据工具名称和参数模式允许、询问或拒绝工具调用。规则按 deny→ask→allow 顺序评估,首先匹配获胜。Permission rules 是分层在更广泛的 [permission mode](#permission-mode) 之上的细粒度控制。263一个设置条目,根据工具名称和参数模式允许、询问或拒绝工具调用。规则按 deny→ask→allow 顺序评估,首先匹配获胜。Permission rules 是分层在更广泛的 [permission mode](#permission-mode) 之上的细粒度控制。
192 264
193了解更多:[配置权限](/zh-CN/permissions)265了解更多:[配置权限](/zh-CN/permissions)
194 266
195### Plan mode267<h3 id="plan-mode">
268 Plan mode
269</h3>
196 270
197一种 [permission mode](#permission-mode),其中 Claude 研究并提议更改而不编辑您的源文件。它可以读取、搜索和运行探索命令,然后在触及任何内容之前提出批准计划。使用 `/plan` 或按 `Shift+Tab` 进入 plan mode。271一种 [permission mode](#permission-mode),其中 Claude 研究并提议更改而不编辑您的源文件。它可以读取、搜索和运行探索命令,然后在触及任何内容之前提出批准计划。使用 `/plan` 或按 `Shift+Tab` 进入 plan mode。
198 272
199了解更多:[使用 plan mode 分析后再编辑](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode)273了解更多:[使用 plan mode 分析后再编辑](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode)
200 274
201### Plugin275<h3 id="plugin">
276 Plugin
277</h3>
202 278
203一个 skills、hooks、subagents 和 MCP servers 的包,打包为单个可安装单元。Plugin skills 命名为 `plugin-name:skill-name`,以便多个 plugins 共存。通过[市场](/zh-CN/plugin-marketplaces)跨团队分发 plugins。279一个 skills、hooks、subagents 和 MCP servers 的包,打包为单个可安装单元。Plugin skills 命名为 `plugin-name:skill-name`,以便多个 plugins 共存。通过[市场](/zh-CN/plugin-marketplaces)跨团队分发 plugins。
204 280
205了解更多:[Plugins](/zh-CN/plugins)281了解更多:[Plugins](/zh-CN/plugins)
206 282
207### Project trust283<h3 id="project-trust">
284 Project trust
285</h3>
208 286
209一个对话框,在 Claude Code 加载其配置之前接受目录。接受情况按项目目录保存,除了您的主目录,其中信任仅在当前会话中保持,并在每次启动时重新显示提示。信任控制市场 plugins 的自动安装和项目定义的 hooks 的执行。信任目录意味着其 `.claude/settings.json`、`.mcp.json` 和其他配置文件生效。287一个对话框,在 Claude Code 加载其配置之前接受目录。接受情况按项目目录保存,除了您的主目录,其中信任仅在当前会话中保持,并在每次启动时重新显示提示。信任控制市场 plugins 的自动安装和项目定义的 hooks 的执行。信任目录意味着其 `.claude/settings.json`、`.mcp.json` 和其他配置文件生效。
210 288
211了解更多:[`.claude` directory](/zh-CN/claude-directory)289了解更多:[`.claude` directory](/zh-CN/claude-directory)
212 290
213### Prompt injection291<h3 id="prompt-injection">
292 Prompt injection
293</h3>
214 294
215嵌入在文件、网页或工具结果中的恶意指令,试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令黑名单和信任验证。[Auto mode](#auto-mode) 添加了一个服务器端探针,扫描工具结果中的可疑内容,以及一个永远看不到工具结果的分类器,因此注入的文本无法影响其批准决策。295嵌入在文件、网页或工具结果中的恶意指令,试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令黑名单和信任验证。[Auto mode](#auto-mode) 添加了一个服务器端探针,扫描工具结果中的可疑内容,以及一个永远看不到工具结果的分类器,因此注入的文本无法影响其批准决策。
216 296
217了解更多:[防止提示注入](/zh-CN/security#protect-against-prompt-injection)297了解更多:[防止提示注入](/zh-CN/security#protect-against-prompt-injection)
218 298
219## R299<h2 id="r">
300 R
301</h2>
220 302
221### Remote Control303<h3 id="remote-control">
304 Remote Control
305</h3>
222 306
223一种通过 claude.ai 从您的手机或浏览器继续本地 Claude Code 会话的方式。您的代码保留在您的机器上;只有 UI 是远程的。与在 web 上运行的 Claude Code 不同,后者在云沙箱中运行。307一种通过 claude.ai 从您的手机或浏览器继续本地 Claude Code 会话的方式。您的代码保留在您的机器上;只有 UI 是远程的。与在 web 上运行的 Claude Code 不同,后者在云沙箱中运行。
224 308
225了解更多:[Remote Control](/zh-CN/remote-control)309了解更多:[Remote Control](/zh-CN/remote-control)
226 310
227### Rules311<h3 id="rules">
312 Rules
313</h3>
228 314
229`.claude/rules/` 中的模块化指令文件,与 CLAUDE.md 一起加载。规则可以使用 YAML `paths:` frontmatter 进行路径范围限定,因此它仅在 Claude 读取匹配文件时加载,保持上下文精简直到相关。315`.claude/rules/` 中的模块化指令文件,与 CLAUDE.md 一起加载。规则可以使用 YAML `paths:` frontmatter 进行路径范围限定,因此它仅在 Claude 读取匹配文件时加载,保持上下文精简直到相关。
230 316
231了解更多:[使用 `.claude/rules/` 组织规则](/zh-CN/memory#organize-rules-with-claude/rules/)317了解更多:[使用 `.claude/rules/` 组织规则](/zh-CN/memory#organize-rules-with-claude/rules/)
232 318
233## S319<h2 id="s">
320 S
321</h2>
234 322
235### Sandboxing323<h3 id="sandboxing">
324 Sandboxing
325</h3>
236 326
237Bash 工具的操作系统级文件系统和网络隔离。命令在您预先定义的边界内运行,因此 Claude 可以在其中自由工作,无需每个命令的批准提示。Sandboxing 是与 [permission rules](#permission-rule) 分开的一层。327Bash 工具的操作系统级文件系统和网络隔离。命令在您预先定义的边界内运行,因此 Claude 可以在其中自由工作,无需每个命令的批准提示。Sandboxing 是与 [permission rules](#permission-rule) 分开的一层。
238 328
239了解更多:[Sandboxing](/zh-CN/sandboxing)329了解更多:[Sandboxing](/zh-CN/sandboxing)
240 330
241### Session331<h3 id="session">
332 Session
333</h3>
242 334
243与您当前目录相关的对话,具有自己独立的 [context window](#context-window)。会话可以使用 `claude -c` 恢复,使用 `--fork-session` 分叉以在新会话 ID 下保留历史,或在终端中并行运行。运行 `/clear` 启动新会话;前一个会话保持存储并可通过 `/resume` 获得。每个会话的记录存储在 `~/.claude/projects/` 下。335与您当前目录相关的对话,具有自己独立的 [context window](#context-window)。会话可以使用 `claude -c` 恢复,使用 `--fork-session` 分叉以在新会话 ID 下保留历史,或在终端中并行运行。运行 `/clear` 启动新会话;前一个会话保持存储并可通过 `/resume` 获得。每个会话的记录存储在 `~/.claude/projects/` 下。
244 336
245了解更多:[使用会话](/zh-CN/how-claude-code-works#work-with-sessions)337了解更多:[使用会话](/zh-CN/how-claude-code-works#work-with-sessions)
246 338
247### Settings layers339<h3 id="settings-layers">
340 Settings layers
341</h3>
248 342
249Claude Code 读取配置的层次结构,按优先级顺序从最高到最低:[托管策略](#managed-settings)、命令行参数、`.claude/settings.local.json` 处的本地设置、`.claude/settings.json` 处的项目设置,然后是 `~/.claude/settings.json` 处的用户设置。数组跨层合并;更高层的标量覆盖较低的。343Claude Code 读取配置的层次结构,按优先级顺序从最高到最低:[托管策略](#managed-settings)、命令行参数、`.claude/settings.local.json` 处的本地设置、`.claude/settings.json` 处的项目设置,然后是 `~/.claude/settings.json` 处的用户设置。数组跨层合并;更高层的标量覆盖较低的。
250 344
251了解更多:[Settings files](/zh-CN/settings#settings-files)345了解更多:[Settings files](/zh-CN/settings#settings-files)
252 346
253### Skill347<h3 id="skill">
348 Skill
349</h3>
254 350
255一个 `SKILL.md` 文件,包含 Claude 添加到其工具包中的指令、知识或工作流。Claude 在相关时自动加载 skill,或您可以使用 `/skill-name` 直接调用它。Skills 遵循 Agent Skills 开放标准;Claude Code 使用调用控制和 subagent 执行扩展它。351一个 `SKILL.md` 文件,包含 Claude 添加到其工具包中的指令、知识或工作流。Claude 在相关时自动加载 skill,或您可以使用 `/skill-name` 直接调用它。Skills 遵循 Agent Skills 开放标准;Claude Code 使用调用控制和 subagent 执行扩展它。
256 352
258 354
259了解更多:[使用 skills 扩展 Claude](/zh-CN/skills)355了解更多:[使用 skills 扩展 Claude](/zh-CN/skills)
260 356
261### Subagent357<h3 id="subagent">
358 Subagent
359</h3>
262 360
263一个专门的 AI 助手,在其自己的上下文窗口中运行,具有自定义系统提示、特定工具访问和独立权限。它处理委派任务并向主对话返回摘要。使用 subagents 将大型探索保留在主上下文之外或运行并行研究。与 [agent teams](#agent-teams) 不同,其中每个代理都是您可以直接交谈的完整独立会话。361一个专门的 AI 助手,在其自己的上下文窗口中运行,具有自定义系统提示、特定工具访问和独立权限。它处理委派任务并向主对话返回摘要。使用 subagents 将大型探索保留在主上下文之外或运行并行研究。与 [agent teams](#agent-teams) 不同,其中每个代理都是您可以直接交谈的完整独立会话。
264 362
266 364
267了解更多:[创建自定义 subagents](/zh-CN/sub-agents)365了解更多:[创建自定义 subagents](/zh-CN/sub-agents)
268 366
269### Surface367<h3 id="surface">
368 Surface
369</h3>
270 370
271您访问 Claude Code 的任何地方:CLI、VS Code、JetBrains、Desktop 或 claude.ai。所有 surfaces 共享相同的引擎,因此您的 CLAUDE.md、settings 和 skills 在所有 surfaces 上以相同方式工作。Slack 和 Chrome 扩展是连接到 surface 的集成,而不是 surfaces 本身。371您访问 Claude Code 的任何地方:CLI、VS Code、JetBrains、Desktop 或 claude.ai。所有 surfaces 共享相同的引擎,因此您的 CLAUDE.md、settings 和 skills 在所有 surfaces 上以相同方式工作。Slack 和 Chrome 扩展是连接到 surface 的集成,而不是 surfaces 本身。
272 372
273了解更多:[平台和集成](/zh-CN/platforms)373了解更多:[平台和集成](/zh-CN/platforms)
274 374
275## T375<h2 id="t">
376 T
377</h2>
276 378
277### Teleport379<h3 id="teleport">
380 Teleport
381</h3>
278 382
279一个命令 `/teleport`,将云 Claude Code 会话拉入您的本地终端。Claude 获取分支、加载对话历史并从 web 会话的最后状态恢复。反向方向是 `--remote`,它将本地任务发送到 web 上运行。383一个命令 `/teleport`,将云 Claude Code 会话拉入您的本地终端。Claude 获取分支、加载对话历史并从 web 会话的最后状态恢复。反向方向是 `--remote`,它将本地任务发送到 web 上运行。
280 384
281了解更多:[从 web 到终端](/zh-CN/claude-code-on-the-web#from-web-to-terminal)385了解更多:[从 web 到终端](/zh-CN/claude-code-on-the-web#from-web-to-terminal)
282 386
283### Tool387<h3 id="tool">
388 Tool
389</h3>
284 390
285Claude 可以采取的操作:读取文件、编辑代码、运行 shell 命令、搜索 web、生成 subagent。Tools 是使 Claude Code agentic 的原因。没有它们,Claude 只能用文本响应。每个工具使用都会返回一个结果,为 [agentic loop](#agentic-loop) 中 Claude 的下一个决策提供信息。391Claude 可以采取的操作:读取文件、编辑代码、运行 shell 命令、搜索 web、生成 subagent。Tools 是使 Claude Code agentic 的原因。没有它们,Claude 只能用文本响应。每个工具使用都会返回一个结果,为 [agentic loop](#agentic-loop) 中 Claude 的下一个决策提供信息。
286 392
287了解更多:[Claude 可用的工具](/zh-CN/tools-reference)393了解更多:[Claude 可用的工具](/zh-CN/tools-reference)
288 394
289### Turn395<h3 id="turn">
396 Turn
397</h3>
290 398
291Claude 在一个 [session](#session) 中的一个完整响应。一个 turn 从您发送消息开始,到 Claude 完成响应结束,中间可能有任意数量的 [tool](#tool) 调用。[Stop hooks](#hook) 在每个 turn 的末尾触发。一个 session 由许多 turn 组成,[agentic loop](#agentic-loop) 描述了在一个 turn 内发生的情况。399Claude 在一个 [session](#session) 中的一个完整响应。一个 turn 从您发送消息开始,到 Claude 完成响应结束,中间可能有任意数量的 [tool](#tool) 调用。[Stop hooks](#hook) 在每个 turn 的末尾触发。一个 session 由许多 turn 组成,[agentic loop](#agentic-loop) 描述了在一个 turn 内发生的情况。
292 400
293了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)401了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)
294 402
295## W403<h2 id="v">
404 V
405</h2>
296 406
297### Worktree isolation407<h3 id="verification-loop">
408 Verification loop
409</h3>
410
411一个会话知道工作实际完成而不仅仅是看起来合理的方式。您给 Claude 一个它可以运行的检查,例如测试套件、构建或屏幕截图比较,Claude 迭代直到检查通过,而不是在一次尝试后停止。验证循环是 [`/goal`](/zh-CN/goal)、无人值守运行和[动态工作流](/zh-CN/workflows)的先决条件:没有它,唯一决定代理完成的东西就是代理本身。
412
413了解更多:[给 Claude 一种验证其工作的方式](/zh-CN/best-practices#give-claude-a-way-to-verify-its-work)
414
415<h2 id="w">
416 W
417</h2>
418
419<h3 id="worktree-isolation">
420 Worktree isolation
421</h3>
298 422
299一个隔离模式,在 `.claude/worktrees/` 下的单独 git worktree 中运行 Claude,使用 `-w` 标志或 subagent 配置中的 `isolation: worktree` 启用。更改保留在单独分支的单独目录中,因此并行代理不会覆盖彼此的文件。423一个隔离模式,在 `.claude/worktrees/` 下的单独 git worktree 中运行 Claude,使用 `-w` 标志或 subagent 配置中的 `isolation: worktree` 启用。更改保留在单独分支的单独目录中,因此并行代理不会覆盖彼此的文件。
300 424
302 426
303***427***
304 428
305## 已弃用和重命名的术语429<h2 id="deprecated-and-renamed-terms">
430 已弃用和重命名的术语
431</h2>
306 432
307这些术语出现在较旧的文档、博客文章和社区内容中。搜索此网站时使用当前名称。433这些术语出现在较旧的文档、博客文章和社区内容中。搜索此网站时使用当前名称。
308 434