6 6
7> Claude Code 术语定义。了解 agentic loop、compaction、CLAUDE.md、hooks、subagents、MCP 和其他核心概念的含义。7> Claude Code 术语定义。了解 agentic loop、compaction、CLAUDE.md、hooks、subagents、MCP 和其他核心概念的含义。
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)。对于 Claude Desktop 术语(如 desktop extension、MCPB 和 DXT),请参阅 [Claude 帮助中心](https://support.claude.com/)。
10 10
11<h2 id="a">11<h2 id="a">
12 A12 A
16 Agent teams16 Agent teams
17</h3>17</h3>
18 18
19由团队负责人协调的多个独立 Claude Code 会话,具有共享任务列表和点对点消息传递。与在单个会话中运行且仅向父级报告的 [subagents](#subagent) 不同,团队成员各自拥有自己的上下文窗口,您可以直接与任何一个交互。Agent teams 是实验性的,必须通过设置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 来启用。19由团队负责人协调的多个独立 Claude Code 会话,具有共享任务列表和点对点消息传递。与在单个会话中运行且仅向父级报告的 [subagents](#subagent) 不同,团队成员各自拥有自己的上下文窗口,您可以直接与任何一个交互。Agent teams 是实验性的,默认情况下被禁用;请参阅[启用 agent teams](/docs/zh-CN/agent-teams#enable-agent-teams)。
20 20
21了解更多:[运行 agent teams](/zh-CN/agent-teams)21了解更多:[运行 agent teams](/docs/zh-CN/agent-teams)
22 22
23<h3 id="agentic-coding">23<h3 id="agentic-coding">
24 Agentic coding24 Agentic coding
26 26
27一种工作流程,其中 AI 可以自主读取文件、运行命令和进行更改,而您可以观看、重定向或离开,与只能用文本响应的基于聊天的助手相反,您必须自己应用这些响应。Claude Code 是 agentic 的,因为它拥有允许它采取行动而不仅仅是建议的[工具](#tool)。27一种工作流程,其中 AI 可以自主读取文件、运行命令和进行更改,而您可以观看、重定向或离开,与只能用文本响应的基于聊天的助手相反,您必须自己应用这些响应。Claude Code 是 agentic 的,因为它拥有允许它采取行动而不仅仅是建议的[工具](#tool)。
28 28
29了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)29了解更多:[Claude Code 如何工作](/docs/zh-CN/how-claude-code-works)
30 30
31<h3 id="agentic-harness">31<h3 id="agentic-harness">
32 Agentic harness32 Agentic harness
34 34
35将语言模型转变为能力强大的编码代理的工具、上下文管理和执行环境。Claude Code 是 harness;Claude 是其中的模型。Harness 提供文件访问、shell 执行、权限控制、内存加载以及链接操作的循环。35将语言模型转变为能力强大的编码代理的工具、上下文管理和执行环境。Claude Code 是 harness;Claude 是其中的模型。Harness 提供文件访问、shell 执行、权限控制、内存加载以及链接操作的循环。
36 36
37了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works)37了解更多:[Claude Code 如何工作](/docs/zh-CN/how-claude-code-works)
38 38
39<h3 id="agentic-loop">39<h3 id="agentic-loop">
40 Agentic loop40 Agentic loop
42 42
43Claude 为每个任务所经历的循环:收集上下文、采取行动、验证结果并重复直到完成。每个工具使用都会返回信息,为下一步提供信息。您可以随时中断循环进行重定向。大多数扩展点,包括 [hooks](#hook)、[skills](#skill) 和 [MCP](#mcp-model-context-protocol),都插入到此循环的特定阶段。43Claude 为每个任务所经历的循环:收集上下文、采取行动、验证结果并重复直到完成。每个工具使用都会返回信息,为下一步提供信息。您可以随时中断循环进行重定向。大多数扩展点,包括 [hooks](#hook)、[skills](#skill) 和 [MCP](#mcp-model-context-protocol),都插入到此循环的特定阶段。
44 44
45了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)45了解更多:[Claude Code 如何工作](/docs/zh-CN/how-claude-code-works#the-agentic-loop)
46 46
47<h3 id="artifact">47<h3 id="artifact">
48 Artifact48 Artifact
50 50
51Claude Code 从您的会话发布到 claude.ai 上私有 URL 的实时交互式网页,因此您可以直观地查看输出或共享它,而不是阅读终端文本。当会话重新发布时,页面会就地更新。您从 Claude Code 创建的 Artifacts 出现在与 claude.ai 对话中创建的 artifacts 相同的库中。共享取决于您的计划:在 Pro 和 Max 上,任何人都可以打开的公开链接;在 Team 和 Enterprise 上,在您的组织内共享,以及一旦所有者启用它们就可以公开链接。51Claude Code 从您的会话发布到 claude.ai 上私有 URL 的实时交互式网页,因此您可以直观地查看输出或共享它,而不是阅读终端文本。当会话重新发布时,页面会就地更新。您从 Claude Code 创建的 Artifacts 出现在与 claude.ai 对话中创建的 artifacts 相同的库中。共享取决于您的计划:在 Pro 和 Max 上,任何人都可以打开的公开链接;在 Team 和 Enterprise 上,在您的组织内共享,以及一旦所有者启用它们就可以公开链接。
52 52
53了解更多:[将会话输出共享为 artifacts](/zh-CN/artifacts)53了解更多:[将会话输出共享为 artifacts](/docs/zh-CN/artifacts)
54 54
55<h3 id="auto-memory">55<h3 id="auto-memory">
56 Auto memory56 Auto memory
58 58
59Claude 根据您的更正和偏好为自己编写的笔记,按 git 存储库存储在 `~/.claude/projects/` 下。同一存储库的所有 worktrees 共享一个 auto memory 目录。`MEMORY.md` 索引的前 200 行或 25 KB 在每个会话开始时加载。Auto memory 是 Claude 编写的对应物,与您编写的 [CLAUDE.md](#claude-md) 相对。59Claude 根据您的更正和偏好为自己编写的笔记,按 git 存储库存储在 `~/.claude/projects/` 下。同一存储库的所有 worktrees 共享一个 auto memory 目录。`MEMORY.md` 索引的前 200 行或 25 KB 在每个会话开始时加载。Auto memory 是 Claude 编写的对应物,与您编写的 [CLAUDE.md](#claude-md) 相对。
60 60
61了解更多:[Auto memory](/zh-CN/memory#auto-memory)61了解更多:[Auto memory](/docs/zh-CN/memory#auto-memory)
62 62
63<h3 id="auto-mode">63<h3 id="auto-mode">
64 Auto mode64 Auto mode
65</h3>65</h3>
66 66
67一种[权限模式](#permission-mode),其中单独的分类器模型在后台审查操作,因此大多数操作无需批准提示即可运行;显式 ask 规则仍会提示。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。它永远看不到工具结果,因此注入的指令无法影响其决策。67一种[权限模式](#permission-mode),其中单独的分类器模型审查操作而不是您,因此 Claude Code 可以在不询问您的情况下运行大多数操作。Claude Code 仍然会在您的显式 ask 规则匹配的操作之前询问您。在 Pro、Max 和 Team 计划上,auto mode 是交互式终端和 VS Code 会话的[内置起始权限模式](/docs/zh-CN/permission-modes#which-mode-a-session-starts-in)。分类器阻止范围升级、不受信任的基础设施和[提示注入](#prompt-injection)。工具结果从它看到的内容中被剥离,因此文件或网页中的恶意内容无法直接操纵它。
68 68
69了解更多:[使用 auto mode 消除提示](/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)69了解更多:[使用 auto mode 消除提示](/docs/zh-CN/permission-modes#eliminate-prompts-with-auto-mode)
70 70
71<h2 id="b">71<h2 id="b">
72 B72 B
76 Bare mode76 Bare mode
77</h3>77</h3>
78 78
79一个启动标志 `--bare`,跳过 hooks、skills、plugins、MCP servers、auto memory 和 CLAUDE.md 的自动发现。只有您显式传递的标志才会生效。建议用于 CI 和脚本调用,其中您需要在不同机器上的相同行为,无论本地配置如何。79使用 `--bare`,Claude Code 启动时不加载 hooks、skills、custom commands、subagents、plugins、MCP servers、auto memory 或 CLAUDE.md,除了您通过 `--add-dir` 传递的目录中的 skills。建议用于 CI 和脚本调用,其中您需要在每台机器上获得相同的结果。
80 80
81了解更多:[使用 bare mode 更快启动](/zh-CN/headless#start-faster-with-bare-mode)81了解更多:[使用 bare mode 更快启动](/docs/zh-CN/headless#start-faster-with-bare-mode)
82 82
83<h3 id="bundled-skills">83<h3 id="bundled-skills">
84 Bundled skills84 Bundled skills
86 86
87包含在 Claude Code 中的基于提示的 playbooks,例如 `/batch`、`/code-review`、`/debug` 和 `/loop`。与执行固定逻辑的内置命令不同,bundled skills 为 Claude 提供详细的提示并让它编排工作,因此它们可以生成代理、读取文件并适应您的代码库。87包含在 Claude Code 中的基于提示的 playbooks,例如 `/batch`、`/code-review`、`/debug` 和 `/loop`。与执行固定逻辑的内置命令不同,bundled skills 为 Claude 提供详细的提示并让它编排工作,因此它们可以生成代理、读取文件并适应您的代码库。
88 88
89了解更多:[Bundled skills](/zh-CN/skills#bundled-skills)89了解更多:[Bundled skills](/docs/zh-CN/skills#bundled-skills)
90 90
91<h2 id="c">91<h2 id="c">
92 C92 C
98 98
99一个 [MCP server](#mcp-model-context-protocol),将事件推送到您正在运行的会话中,以便 Claude 可以对您离开终端时发生的事情做出反应。Channels 可以是双向的:Claude 读取入站事件并通过同一 channel 回复。Telegram、Discord 和 iMessage 包含在研究预览中。99一个 [MCP server](#mcp-model-context-protocol),将事件推送到您正在运行的会话中,以便 Claude 可以对您离开终端时发生的事情做出反应。Channels 可以是双向的:Claude 读取入站事件并通过同一 channel 回复。Telegram、Discord 和 iMessage 包含在研究预览中。
100 100
101了解更多:[Channels](/zh-CN/channels)101了解更多:[Channels](/docs/zh-CN/channels)
102 102
103<h3 id="checkpoint">103<h3 id="checkpoint">
104 Checkpoint104 Checkpoint
105</h3>105</h3>
106 106
107在每个您发送的提示处创建的还原点。Claude Code 在每次编辑之前对文件进行快照,以便 checkpoint 可以恢复它们。按两次 `Esc` 或运行 `/rewind` 将代码、对话或两者恢复到较早的点,或从选定的消息总结对话的一部分。Checkpoints 是会话本地的,与 git 分开,不跟踪通过 Bash 工具进行的更改。107在每个您发送的提示处创建的还原点。Claude Code 在每次编辑之前对文件进行快照,以便 checkpoint 可以恢复它们。按两次 `Esc` 或运行 `/rewind` 将代码、对话或两者恢复到较早的点,或从选定的消息总结对话的一部分。Checkpoints 会与对话一起保存,因此恢复的会话仍然可以 `/rewind` 到它们。它们与 git 分开,不跟踪通过 Bash 工具进行的更改。
108 108
109了解更多:[Checkpointing](/zh-CN/checkpointing)109了解更多:[Checkpointing](/docs/zh-CN/checkpointing)
110 110
111<h3 id="claude-directory">111<h3 id="claude-directory">
112 `.claude` directory112 `.claude` directory
114 114
115Claude Code 读取项目范围配置的目录:settings、hooks、skills、subagents、rules 和 auto memory。项目在其根目录有 `.claude/`;您的用户级默认值在 `~/.claude/`。115Claude Code 读取项目范围配置的目录:settings、hooks、skills、subagents、rules 和 auto memory。项目在其根目录有 `.claude/`;您的用户级默认值在 `~/.claude/`。
116 116
117了解更多:[The `.claude` directory](/zh-CN/claude-directory)117了解更多:[The `.claude` directory](/docs/zh-CN/claude-directory)
118 118
119<h3 id="claude-md">119<h3 id="claude-md">
120 CLAUDE.md120 CLAUDE.md
124 124
125您可以在项目范围内的 `./CLAUDE.md` 或 `./.claude/CLAUDE.md`、用户范围内的 `~/.claude/CLAUDE.md` 或作为组织的[托管策略](#managed-settings)放置 CLAUDE.md。所有发现的文件都被连接到上下文中,而不是相互覆盖,按从最广泛的范围到最具体的范围排序。125您可以在项目范围内的 `./CLAUDE.md` 或 `./.claude/CLAUDE.md`、用户范围内的 `~/.claude/CLAUDE.md` 或作为组织的[托管策略](#managed-settings)放置 CLAUDE.md。所有发现的文件都被连接到上下文中,而不是相互覆盖,按从最广泛的范围到最具体的范围排序。
126 126
127了解更多:[CLAUDE.md files](/zh-CN/memory#claude-md-files)127了解更多:[CLAUDE.md files](/docs/zh-CN/memory#claude-md-files)
128 128
129<h3 id="command">129<h3 id="command">
130 Command130 Command
132 132
133一个可重用的指令,您可以通过在提示中键入 `/name` 来调用。内置命令(如 `/clear`、`/model` 和 `/compact`)控制会话。您可以在 `.claude/commands/` 中将自己的命令定义为文件,或从 [plugin](#plugin) 安装它们。[Skills](#skill) 是打包多步骤命令的推荐方式。133一个可重用的指令,您可以通过在提示中键入 `/name` 来调用。内置命令(如 `/clear`、`/model` 和 `/compact`)控制会话。您可以在 `.claude/commands/` 中将自己的命令定义为文件,或从 [plugin](#plugin) 安装它们。[Skills](#skill) 是打包多步骤命令的推荐方式。
134 134
135了解更多:[Commands](/zh-CN/commands) · [Skills](/zh-CN/skills)135这个词的另外两种用法是无关的:`claude` CLI 子命令,如 `claude mcp add`,列在 [CLI 参考](/docs/zh-CN/cli-reference#cli-commands) 中,以及 stdio [MCP server](#mcp-server) 条目的 `command` 字段,它指定 Claude Code 启动以启动服务器的可执行文件。
136
137了解更多:[Commands](/docs/zh-CN/commands) · [Skills](/docs/zh-CN/skills)
136 138
137<h3 id="compaction">139<h3 id="compaction">
138 Compaction140 Compaction
140 142
141当 [context window](#context-window) 接近其限制时,自动总结您的对话。首先清除较旧的工具输出,然后总结对话。Project-root CLAUDE.md 和 auto memory 在 compaction 期间保留并从磁盘重新加载;仅在对话中给出的指令可能会丢失。运行 `/compact` 手动触发,可选择使用焦点,如 `/compact focus on the API changes`。143当 [context window](#context-window) 接近其限制时,自动总结您的对话。首先清除较旧的工具输出,然后总结对话。Project-root CLAUDE.md 和 auto memory 在 compaction 期间保留并从磁盘重新加载;仅在对话中给出的指令可能会丢失。运行 `/compact` 手动触发,可选择使用焦点,如 `/compact focus on the API changes`。
142 144
143了解更多:[What survives compaction](/zh-CN/context-window#what-survives-compaction) · [When context fills up](/zh-CN/how-claude-code-works#when-context-fills-up)145了解更多:[What survives compaction](/docs/zh-CN/context-window#what-survives-compaction) · [When context fills up](/docs/zh-CN/how-claude-code-works#when-context-fills-up)
146
147<h3 id="connector">
148 Connector
149</h3>
150
151一个 [MCP server](#mcp-server),添加到您的 claude.ai 账户而不是在 Claude Code 中配置。当您使用该账户登录 Claude Code 时,您的 connectors 会在 `/mcp` 中与您本地添加的服务器一起出现。组织也可以配置 connectors 并对其设置按工具控制。
152
153了解更多:[Use MCP servers from claude.ai](/docs/zh-CN/mcp#use-mcp-servers-from-claude-ai)
144 154
145<h3 id="context-window">155<h3 id="context-window">
146 Context window156 Context window
148 158
149会话的工作内存,保存对话历史、文件内容、命令输出、CLAUDE.md、auto memory、加载的 skills 和系统指令。当您工作时,上下文会填满直到 [compaction](#compaction) 总结它。运行 `/context` 查看什么在使用空间。对于底层模型概念,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#context-window)。159会话的工作内存,保存对话历史、文件内容、命令输出、CLAUDE.md、auto memory、加载的 skills 和系统指令。当您工作时,上下文会填满直到 [compaction](#compaction) 总结它。运行 `/context` 查看什么在使用空间。对于底层模型概念,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#context-window)。
150 160
151了解更多:[Explore the context window](/zh-CN/context-window)161了解更多:[Explore the context window](/docs/zh-CN/context-window)
152 162
153<h2 id="d">163<h2 id="d">
154 D164 D
160 170
161一个电话启动的任务路由器,当您从 Claude 移动应用发送编码任务时,在 Desktop 应用中生成 Claude Code 会话。您的提示自动路由到正确的工具。在 Pro 和 Max 计划上可用。171一个电话启动的任务路由器,当您从 Claude 移动应用发送编码任务时,在 Desktop 应用中生成 Claude Code 会话。您的提示自动路由到正确的工具。在 Pro 和 Max 计划上可用。
162 172
163了解更多:[来自 Dispatch 的会话](/zh-CN/desktop#sessions-from-dispatch)173了解更多:[来自 Dispatch 的会话](/docs/zh-CN/desktop#sessions-from-dispatch)
164 174
165<h2 id="e">175<h2 id="e">
166 E176 E
170 Effort level180 Effort level
171</h3>181</h3>
172 182
173一个设置,控制 Claude 在每个回合上使用多少自适应推理思考预算。更高的努力意味着更多的思考 tokens 和更深入的推理;更低的努力更快且更便宜。Effort 在 Fable 5、Opus 4.6 及更高版本以及 Sonnet 4.6 及更高版本上受支持。183一个设置,控制自适应推理,让模型决定是否以及在每一步上进行多少思考。更高的努力意味着更多的思考 tokens 和更深入的推理;更低的努力更快且更便宜。Effort 在 Fable 模型、Opus 4.6 及更高版本以及 Sonnet 4.6 及更高版本上受支持。
174 184
175了解更多:[调整 effort level](/zh-CN/model-config#adjust-effort-level)185了解更多:[调整 effort level](/docs/zh-CN/model-config#adjust-effort-level)
176 186
177<h3 id="extended-thinking">187<h3 id="extended-thinking">
178 Extended thinking188 Extended thinking
180 190
181模型在响应前执行的可见逐步推理。您可以使用 [effort level](#effort-level) 调整它,或使用 `MAX_THINKING_TOKENS` 在具有固定思考预算的模型上限制思考 tokens。思考在终端中以灰色斜体文本显示。191模型在响应前执行的可见逐步推理。您可以使用 [effort level](#effort-level) 调整它,或使用 `MAX_THINKING_TOKENS` 在具有固定思考预算的模型上限制思考 tokens。思考在终端中以灰色斜体文本显示。
182 192
183了解更多:[使用 extended thinking](/zh-CN/model-config#extended-thinking)193了解更多:[使用 extended thinking](/docs/zh-CN/model-config#extended-thinking)
184 194
185<h2 id="h">195<h2 id="h">
186 H196 H
198* **Matcher**:过滤哪些事件触发它208* **Matcher**:过滤哪些事件触发它
199* **Hook handler**:运行什么209* **Hook handler**:运行什么
200 210
201了解更多:[开始使用 hooks](/zh-CN/hooks-guide) · [Hooks 参考](/zh-CN/hooks)211了解更多:[开始使用 hooks](/docs/zh-CN/hooks-guide) · [Hooks 参考](/docs/zh-CN/hooks)
202 212
203<h2 id="m">213<h2 id="m">
204 M214 M
208 Managed settings218 Managed settings
209</h3>219</h3>
210 220
211由 IT 或 DevOps 在组织范围内强制执行的设置,通过管理员控制台从 Anthropic 的服务器交付,或部署到 `~/.claude` 之外的操作系统级路径。用户和项目设置无法覆盖托管设置。服务器管理的交付适用于[符合条件的配置](/zh-CN/server-managed-settings#platform-availability);请参阅[安全考虑](/zh-CN/server-managed-settings#security-considerations)。使用此功能可实现安全策略、合规要求或跨一个群体的标准化工具。221由 IT 或 DevOps 在组织范围内强制执行的设置,通过管理员控制台从 Anthropic 的服务器交付,或部署到 `~/.claude` 之外的操作系统级路径。用户和项目设置无法覆盖托管设置。服务器管理的交付适用于[符合条件的配置](/docs/zh-CN/server-managed-settings#platform-availability);请参阅[安全考虑](/docs/zh-CN/server-managed-settings#security-considerations)。使用此功能可实现安全策略、合规要求或跨一个群体的标准化工具。
212 222
213了解更多:[服务器管理的设置](/zh-CN/server-managed-settings) · [设置文件](/zh-CN/settings#settings-files)223了解更多:[服务器管理的设置](/docs/zh-CN/server-managed-settings) · [设置文件](/docs/zh-CN/settings#where-settings-live)
214 224
215<h3 id="mcp-model-context-protocol">225<h3 id="mcp-model-context-protocol">
216 MCP (Model Context Protocol)226 MCP (Model Context Protocol)
218 228
219一个开放标准,用于将 AI 工具连接到外部数据源和服务。MCP servers 为 Claude 提供 Slack、Jira、数据库、浏览器和数百个其他集成的新工具。您可以通过 `/mcp` 连接服务器或将它们添加到 `.mcp.json`。对于协议本身,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#mcp-model-context-protocol)。229一个开放标准,用于将 AI 工具连接到外部数据源和服务。MCP servers 为 Claude 提供 Slack、Jira、数据库、浏览器和数百个其他集成的新工具。您可以通过 `/mcp` 连接服务器或将它们添加到 `.mcp.json`。对于协议本身,请参阅[平台术语表](https://platform.claude.com/docs/zh-CN/about-claude/glossary#mcp-model-context-protocol)。
220 230
221了解更多:[Model Context Protocol](/zh-CN/mcp)231了解更多:[Model Context Protocol](/docs/zh-CN/mcp)
232
233<h3 id="mcp-server">
234 MCP server
235</h3>
236
237一个为 Claude 提供工具、提示或资源的程序,通过 [MCP](#mcp-model-context-protocol)。您可以使用 `claude mcp add` 添加服务器,在 `.mcp.json` 中添加,通过 [plugin](#plugin) 添加,或作为 claude.ai [connector](#connector) 添加。本地 stdio 服务器作为一个进程运行,Claude Code 从其配置的 `command` 和 `args` 字段启动该进程,这与您在提示符处键入的 [commands](#command) 无关。
238
239了解更多:[Model Context Protocol](/docs/zh-CN/mcp)
222 240
223<h3 id="mcp-tool-search">241<h3 id="mcp-tool-search">
224 MCP Tool Search242 MCP Tool Search
225</h3>243</h3>
226 244
227一个上下文节省机制,延迟 MCP 工具 schemas 直到需要。只有工具名称在启动时加载;Claude 在决定使用特定工具时按需获取完整 schema。这使空闲 MCP servers 不会消耗太多上下文。245一个上下文节省机制,延迟 MCP 工具 schemas 直到需要。只有工具名称和服务器指令在启动时加载;Claude 在决定使用特定工具时按需获取完整 schema。这使空闲 MCP servers 不会消耗太多上下文。
228 246
229了解更多:[使用 MCP Tool Search 扩展](/zh-CN/mcp#scale-with-mcp-tool-search)247了解更多:[使用 MCP Tool Search 扩展](/docs/zh-CN/mcp#scale-with-mcp-tool-search)
230 248
231<h2 id="n">249<h2 id="n">
232 N250 N
236 Non-interactive mode254 Non-interactive mode
237</h3>255</h3>
238 256
239一种执行单个提示并退出而不进行对话会话的模式,使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。该运行仍然保存为可恢复的会话,除非您传递 `--no-session-persistence`。[Agent SDK](/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。257一种执行单个提示并退出而不进行对话会话的模式,使用 `-p` 或 `--print` 调用。用于 CI、脚本和管道。该运行仍然保存为可恢复的会话,除非您传递 `--no-session-persistence`。[Agent SDK](/docs/zh-CN/agent-sdk/overview) 是 Python 和 TypeScript 等效项。以前称为 headless mode。
240 258
241了解更多:[以编程方式运行 Claude Code](/zh-CN/headless)259了解更多:[以编程方式运行 Claude Code](/docs/zh-CN/headless)
242 260
243<h2 id="o">261<h2 id="o">
244 O262 O
248 Output style266 Output style
249</h3>267</h3>
250 268
251一个配置,修改 Claude 的系统提示以改变响应行为、语气或格式。Output styles 关闭默认系统提示的软件工程特定部分,与 [CLAUDE.md](#claude-md) 不同,后者作为系统提示后的用户消息传递。内置样式包括 Default、Proactive、Explanatory 和 Learning。269一个配置,改变 Claude Code 给予 Claude 的指令,以设置响应行为、语气或格式。与 [CLAUDE.md](#claude-md) 不同,后者在 Claude Code 的默认指令旁添加项目上下文,自定义输出样式可以替换默认的软件工程指令。
252 270
253了解更多:[Output styles](/zh-CN/output-styles)271了解更多:[Output styles](/docs/zh-CN/output-styles)
254 272
255<h2 id="p">273<h2 id="p">
256 P274 P
264 282
265`default` 模式在 CLI 中标记为 Manual,在 VS Code 和 JetBrains 扩展中也标记为 Manual,在桌面应用中也标记为 Manual,Claude Code 接受 `manual` 作为该值的别名。283`default` 模式在 CLI 中标记为 Manual,在 VS Code 和 JetBrains 扩展中也标记为 Manual,在桌面应用中也标记为 Manual,Claude Code 接受 `manual` 作为该值的别名。
266 284
267了解更多:[选择权限模式](/zh-CN/permission-modes)285了解更多:[选择权限模式](/docs/zh-CN/permission-modes)
268 286
269<h3 id="permission-rule">287<h3 id="permission-rule">
270 Permission rule288 Permission rule
272 290
273一个设置条目,根据工具名称和参数模式允许、询问或拒绝工具调用。规则按 deny→ask→allow 顺序评估,首先匹配获胜。Permission rules 是分层在更广泛的 [permission mode](#permission-mode) 之上的细粒度控制。291一个设置条目,根据工具名称和参数模式允许、询问或拒绝工具调用。规则按 deny→ask→allow 顺序评估,首先匹配获胜。Permission rules 是分层在更广泛的 [permission mode](#permission-mode) 之上的细粒度控制。
274 292
275了解更多:[配置权限](/zh-CN/permissions)293了解更多:[配置权限](/docs/zh-CN/permissions)
276 294
277<h3 id="plan-mode">295<h3 id="plan-mode">
278 Plan mode296 Plan mode
280 298
281一种 [permission mode](#permission-mode),其中 Claude 研究并提议更改而不编辑您的源文件。它可以读取、搜索和运行探索命令,然后在触及任何内容之前提出批准计划。使用 `/plan` 或按 `Shift+Tab` 进入 plan mode。299一种 [permission mode](#permission-mode),其中 Claude 研究并提议更改而不编辑您的源文件。它可以读取、搜索和运行探索命令,然后在触及任何内容之前提出批准计划。使用 `/plan` 或按 `Shift+Tab` 进入 plan mode。
282 300
283了解更多:[使用 plan mode 分析后再编辑](/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode)301了解更多:[使用 plan mode 分析后再编辑](/docs/zh-CN/permission-modes#analyze-before-you-edit-with-plan-mode)
284 302
285<h3 id="plugin">303<h3 id="plugin">
286 Plugin304 Plugin
287</h3>305</h3>
288 306
289一个 skills、hooks、subagents 和 MCP servers 的包,打包为单个可安装单元。Plugin skills 命名为 `plugin-name:skill-name`,以便多个 plugins 共存。通过[市场](/zh-CN/plugin-marketplaces)跨团队分发 plugins。307一个 skills、hooks、subagents 和 MCP servers 的包,打包为单个可安装单元。Plugin skills 命名为 `plugin-name:skill-name`,以便多个 plugins 共存。通过[市场](/docs/zh-CN/plugin-marketplaces)跨团队分发 plugins。
290 308
291了解更多:[Plugins](/zh-CN/plugins)309了解更多:[Plugins](/docs/zh-CN/plugins)
292 310
293<h3 id="project-trust">311<h3 id="project-trust">
294 Project trust312 Project trust
295</h3>313</h3>
296 314
297一个对话框,在 Claude Code 加载其配置之前接受目录。接受情况按项目目录保存,除了您的主目录,其中信任仅在当前会话中保持,并在每次启动时重新显示提示。信任控制市场 plugins 的自动安装和项目定义的 hooks 的执行。信任目录意味着其 `.claude/settings.json`、`.mcp.json` 和其他配置文件生效。315一个对话框,在 Claude Code 加载其配置之前接受目录。接受情况按项目目录保存,除了您的主目录,其中信任仅在当前会话中保持,并在每次启动时重新显示提示。在您信任目录之前,Claude Code 会暂不加载其存储库提供的某些内容,例如来自 `.claude/settings.json` 的项目允许规则和市场。[在您信任文件夹之前运行的内容](/docs/zh-CN/permissions#what-runs-before-you-trust-a-folder)列出了每种内容,包括 `-p` 会话在没有对话框的情况下运行的内容。
298 316
299了解更多:[`.claude` directory](/zh-CN/claude-directory)317了解更多:[`.claude` directory](/docs/zh-CN/claude-directory)
300 318
301<h3 id="prompt-injection">319<h3 id="prompt-injection">
302 Prompt injection320 Prompt injection
303</h3>321</h3>
304 322
305嵌入在文件、网页或工具结果中的恶意指令,试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令黑名单和信任验证。[Auto mode](#auto-mode) 添加了一个服务器端探针,扫描工具结果中的可疑内容,以及一个永远看不到工具结果的分类器,因此注入的文本无法影响其批准决策。323嵌入在文件、网页或工具结果中的恶意指令,试图将 Claude 重定向到您从未要求的操作。Claude Code 的防御包括权限系统、命令注入检测和信任验证。[Auto mode](#auto-mode) 添加了一个服务器端探针,扫描工具结果中的可疑内容,以及一个分类器,用于审查剥离工具结果的操作,因此注入的文本无法直接操纵它。
306 324
307了解更多:[防止提示注入](/zh-CN/security#protect-against-prompt-injection)325了解更多:[防止提示注入](/docs/zh-CN/security#protect-against-prompt-injection)
308 326
309<h2 id="r">327<h2 id="r">
310 R328 R
316 334
317一种通过 claude.ai 从您的手机或浏览器继续本地 Claude Code 会话的方式。您的代码执行和文件保留在您的机器上;界面是远程的。与在 web 上运行的 Claude Code 不同,后者在云沙箱中运行。335一种通过 claude.ai 从您的手机或浏览器继续本地 Claude Code 会话的方式。您的代码执行和文件保留在您的机器上;界面是远程的。与在 web 上运行的 Claude Code 不同,后者在云沙箱中运行。
318 336
319了解更多:[Remote Control](/zh-CN/remote-control)337了解更多:[Remote Control](/docs/zh-CN/remote-control)
320 338
321<h3 id="rules">339<h3 id="rules">
322 Rules340 Rules
324 342
325`.claude/rules/` 中的模块化指令文件,与 CLAUDE.md 一起加载。规则可以使用 YAML `paths:` frontmatter 进行路径范围限定,因此它仅在 Claude 读取匹配文件时加载,保持上下文精简直到相关。343`.claude/rules/` 中的模块化指令文件,与 CLAUDE.md 一起加载。规则可以使用 YAML `paths:` frontmatter 进行路径范围限定,因此它仅在 Claude 读取匹配文件时加载,保持上下文精简直到相关。
326 344
327了解更多:[使用 `.claude/rules/` 组织规则](/zh-CN/memory#organize-rules-with-claude/rules/)345了解更多:[使用 `.claude/rules/` 组织规则](/docs/zh-CN/memory#organize-rules-with-claude/rules/)
328 346
329<h2 id="s">347<h2 id="s">
330 S348 S
336 354
337Bash 工具的操作系统级文件系统和网络隔离。命令在您预先定义的边界内运行,因此 Claude 可以在其中自由工作,无需每个命令的批准提示。Sandboxing 是与 [permission rules](#permission-rule) 分开的一层。355Bash 工具的操作系统级文件系统和网络隔离。命令在您预先定义的边界内运行,因此 Claude 可以在其中自由工作,无需每个命令的批准提示。Sandboxing 是与 [permission rules](#permission-rule) 分开的一层。
338 356
339了解更多:[Sandboxing](/zh-CN/sandboxing)357了解更多:[Sandboxing](/docs/zh-CN/sandboxing)
340 358
341<h3 id="session">359<h3 id="session">
342 Session360 Session
344 362
345与您当前目录相关的对话,具有自己独立的 [context window](#context-window)。会话可以使用 `claude -c` 恢复,使用 `--fork-session` 分叉以在新会话 ID 下保留历史,或在终端中并行运行。运行 `/clear` 启动新会话;前一个会话保持存储并可通过 `/resume` 获得。每个会话的记录存储在 `~/.claude/projects/` 下。363与您当前目录相关的对话,具有自己独立的 [context window](#context-window)。会话可以使用 `claude -c` 恢复,使用 `--fork-session` 分叉以在新会话 ID 下保留历史,或在终端中并行运行。运行 `/clear` 启动新会话;前一个会话保持存储并可通过 `/resume` 获得。每个会话的记录存储在 `~/.claude/projects/` 下。
346 364
347了解更多:[使用会话](/zh-CN/how-claude-code-works#work-with-sessions)365了解更多:[使用会话](/docs/zh-CN/how-claude-code-works#work-with-sessions)
348 366
349<h3 id="settings-layers">367<h3 id="settings-layers">
350 Settings layers368 Settings layers
351</h3>369</h3>
352 370
353Claude Code 读取配置的层次结构,按优先级顺序从最高到最低:[托管策略](#managed-settings)、命令行参数、`.claude/settings.local.json` 处的本地设置、`.claude/settings.json` 处的项目设置,然后是 `~/.claude/settings.json` 处的用户设置。数组跨层合并;更高层的标量覆盖较低的。371Claude Code 读取配置的层次结构,按优先级顺序从最高到最低:[managed policy](#managed-settings)、命令行参数、`.claude/settings.local.json` 处的本地设置、`.claude/settings.json` 处的项目设置,然后是 `~/.claude/settings.json` 处的用户设置。数组跨层合并;更高层的标量覆盖较低的。请参阅 [Settings precedence](/docs/zh-CN/settings#settings-precedence)。
354 372
355了解更多:[Settings files](/zh-CN/settings#settings-files)373了解更多:[Settings files](/docs/zh-CN/settings#where-settings-live)
356 374
357<h3 id="skill">375<h3 id="skill">
358 Skill376 Skill
362 380
363Skills 是自定义命令的推荐后继。`.claude/commands/deploy.md` 处的文件和 `.claude/skills/deploy/SKILL.md` 处的文件都创建 `/deploy` 并以相同方式工作;现有命令文件继续工作。381Skills 是自定义命令的推荐后继。`.claude/commands/deploy.md` 处的文件和 `.claude/skills/deploy/SKILL.md` 处的文件都创建 `/deploy` 并以相同方式工作;现有命令文件继续工作。
364 382
365了解更多:[使用 skills 扩展 Claude](/zh-CN/skills)383了解更多:[使用 skills 扩展 Claude](/docs/zh-CN/skills)
366 384
367<h3 id="subagent">385<h3 id="subagent">
368 Subagent386 Subagent
369</h3>387</h3>
370 388
371一个专门的 AI 助手,在其自己的上下文窗口中运行,具有自定义系统提示、特定工具访问和独立权限。它处理委派任务并向主对话返回摘要。使用 subagents 将大型探索保留在主上下文之外或运行并行研究。与 [agent teams](#agent-teams) 不同,其中每个代理都是您可以直接交谈的完整独立会话。389一个专门的 AI 助手,在其自己的上下文窗口中运行,具有自定义系统提示、特定工具访问和独立权限。它处理委派任务并向主对话返回摘要。使用 subagents 将大型探索保留在主上下文之外或运行并行研究。Subagent 保持在生成它的会话内。要在您自己运行的单独会话之间传递发现,请使用 [cross-session messaging](/docs/zh-CN/cross-session-messaging)。
372 390
373内置 subagents 包括 Explore、Plan 和通用目的。391内置 subagents 包括 Explore、Plan 和通用目的。
374 392
375了解更多:[创建自定义 subagents](/zh-CN/sub-agents)393了解更多:[创建自定义 subagents](/docs/zh-CN/sub-agents)
376 394
377<h3 id="surface">395<h3 id="surface">
378 Surface396 Surface
379</h3>397</h3>
380 398
381您访问 Claude Code 的任何地方:CLI、VS Code、JetBrains、Desktop 或 claude.ai。所有 surfaces 共享相同的引擎,因此您的 CLAUDE.md、settings 和 skills 在所有 surfaces 上以相同方式工作。Slack 和 Chrome 扩展是连接到 surface 的集成,而不是 surfaces 本身。399您访问 Claude Code 的任何地方:CLI、VS Code、JetBrains、Desktop 或 claude.ai。所有 surfaces 共享相同的引擎。您机器上的会话读取您的本地 CLAUDE.md、settings 和 skills;[cloud sessions](/docs/zh-CN/cloud-environments#what-carries-over-from-your-setup) 从您的存储库的新克隆开始,不读取您机器上的 `~/.claude/`。Slack 和 Chrome 扩展是连接到 surface 的集成,而不是 surfaces 本身。
382 400
383了解更多:[平台和集成](/zh-CN/platforms)401了解更多:[平台和集成](/docs/zh-CN/platforms)
384 402
385<h2 id="t">403<h2 id="t">
386 T404 T
392 410
393一个命令 `/teleport`,将云 Claude Code 会话拉入您的本地终端。Claude 获取分支、加载对话历史并从 web 会话的最后状态恢复。反向方向是 `--cloud`,它将本地任务发送到 web 上运行。411一个命令 `/teleport`,将云 Claude Code 会话拉入您的本地终端。Claude 获取分支、加载对话历史并从 web 会话的最后状态恢复。反向方向是 `--cloud`,它将本地任务发送到 web 上运行。
394 412
395了解更多:[从 web 到终端](/zh-CN/claude-code-on-the-web#from-web-to-terminal)413了解更多:[从 web 到终端](/docs/zh-CN/claude-code-on-the-web#from-web-to-terminal)
396 414
397<h3 id="tool">415<h3 id="tool">
398 Tool416 Tool
400 418
401Claude 可以采取的操作:读取文件、编辑代码、运行 shell 命令、搜索 web、生成 subagent。Tools 是使 Claude Code agentic 的原因。没有它们,Claude 只能用文本响应。每个工具使用都会返回一个结果,为 [agentic loop](#agentic-loop) 中 Claude 的下一个决策提供信息。419Claude 可以采取的操作:读取文件、编辑代码、运行 shell 命令、搜索 web、生成 subagent。Tools 是使 Claude Code agentic 的原因。没有它们,Claude 只能用文本响应。每个工具使用都会返回一个结果,为 [agentic loop](#agentic-loop) 中 Claude 的下一个决策提供信息。
402 420
403了解更多:[Claude 可用的工具](/zh-CN/tools-reference)421了解更多:[Claude 可用的工具](/docs/zh-CN/tools-reference)
404 422
405<h3 id="turn">423<h3 id="turn">
406 Turn424 Turn
408 426
409Claude 在一个 [session](#session) 中的一个完整响应。一个 turn 从您发送消息开始,到 Claude 完成响应结束,中间可能有任意数量的 [tool](#tool) 调用。[Stop hooks](#hook) 在每个 turn 的末尾触发。一个 session 由许多 turn 组成,[agentic loop](#agentic-loop) 描述了在一个 turn 内发生的情况。427Claude 在一个 [session](#session) 中的一个完整响应。一个 turn 从您发送消息开始,到 Claude 完成响应结束,中间可能有任意数量的 [tool](#tool) 调用。[Stop hooks](#hook) 在每个 turn 的末尾触发。一个 session 由许多 turn 组成,[agentic loop](#agentic-loop) 描述了在一个 turn 内发生的情况。
410 428
411了解更多:[Claude Code 如何工作](/zh-CN/how-claude-code-works#the-agentic-loop)429了解更多:[Claude Code 如何工作](/docs/zh-CN/how-claude-code-works#the-agentic-loop)
412 430
413<h2 id="v">431<h2 id="v">
414 V432 V
418 Verification loop436 Verification loop
419</h3>437</h3>
420 438
421一个会话知道工作实际完成而不仅仅是看起来合理的方式。您给 Claude 一个它可以运行的检查,例如测试套件、构建或屏幕截图比较,Claude 迭代直到检查通过,而不是在一次尝试后停止。验证循环是 [`/goal`](/zh-CN/goal)、无人值守运行和[动态工作流](/zh-CN/workflows)的先决条件:没有它,唯一决定代理完成的东西就是代理本身。439一个会话知道工作实际完成而不仅仅是看起来合理的方式。您给 Claude 一个它可以运行的检查,例如测试套件、构建或屏幕截图比较,Claude 迭代直到检查通过,而不是在一次尝试后停止。验证循环是 [`/goal`](/docs/zh-CN/goal)、无人值守运行和[动态工作流](/docs/zh-CN/workflows)的先决条件:没有它,唯一决定代理完成的东西就是代理本身。
422 440
423了解更多:[给 Claude 一种验证其工作的方式](/zh-CN/best-practices#give-claude-a-way-to-verify-its-work)441了解更多:[给 Claude 一种验证其工作的方式](/docs/zh-CN/best-practices#give-claude-a-way-to-verify-its-work)
424 442
425<h2 id="w">443<h2 id="w">
426 W444 W
432 450
433一个隔离模式,在 `.claude/worktrees/` 下的单独 git worktree 中运行 Claude,使用 `-w` 标志或 subagent 配置中的 `isolation: worktree` 启用。更改保留在单独分支的单独目录中,因此并行代理不会覆盖彼此的文件。451一个隔离模式,在 `.claude/worktrees/` 下的单独 git worktree 中运行 Claude,使用 `-w` 标志或 subagent 配置中的 `isolation: worktree` 启用。更改保留在单独分支的单独目录中,因此并行代理不会覆盖彼此的文件。
434 452
435了解更多:[使用 git worktrees 运行并行会话](/zh-CN/worktrees)453了解更多:[使用 git worktrees 运行并行会话](/docs/zh-CN/worktrees)
436 454
437***455***
438 456