Claude Code 深度学习手册

主题

术语表 Glossary ​

Claude Code 核心术语的官方定义速查表。

对你意味着什么 ​

术语速查页，无需任何配置。按你日常实际会碰到的，先认这几个就够用：

  • bypassPermissions：你全局开着它（权限弹窗全跳过）——所以 hook 才是你唯一硬闸。
  • Subagent：你靠 pr-review-toolkit 那套（不是自建）。
  • MCP：你有 5 个（serena/context7/playwright/figma/chrome-devtools），全来自插件。
  • Auto memory / CLAUDE.md：你用 4 层 CLAUDE.md+AGENTS.md，没用用户级 auto memory。
  • Worktree / Checkpoint / Compaction / Plan mode：你并行任务与回退时天天用。

不熟的词在此查定义；模型层概念（token、temperature 等）见 platform glossary。

官方文档要点 ​

以下为按官方文档整理的系统性参考。

是什么 ​

本术语表收录 Claude Code 的核心术语定义，涵盖 agentic loop（代理循环）、compaction（压缩）、CLAUDE.md、hooks（钩子）、subagents（子代理）、MCP 等概念。每个条目都链接到深入讲解该概念的页面；关于 tokens、temperature、RAG 等模型层面的概念，请参阅平台术语表（platform glossary）。

什么时候用 ​

  • 查不熟悉的 Claude Code 术语时

硬事实速查（44 条） ​

  • Agent teams：由一个团队负责人协调的多个独立 Claude Code 会话，共享任务列表并支持点对点消息。与子代理不同，每个队友拥有自己的上下文窗口，你可以直接与任意一个交互。实验性，需 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。
  • Agentic coding：AI 可在你旁观、纠偏或离开时自主读取文件、运行命令、做出修改的工作流，区别于只回复文本、需你手动应用的聊天式助手。
  • Agentic harness：把语言模型变成有能力的编码代理所需的工具、上下文管理与执行环境。Claude Code 是 harness，Claude 是其中的模型。
  • Agentic loop：Claude 处理每个任务都会经历的循环：收集上下文、采取行动、验证结果，重复直至完成。每次工具调用返回的信息会影响下一步。
  • Auto memory：Claude 根据你的纠正与偏好为自己写下的笔记，按 git 仓库存于 ~/.claude/projects/。每次会话开始加载 MEMORY.md 索引的前 200 行或 25 KB。
  • Auto mode：一种权限模式，由独立分类器模型在后台审查每个动作而非弹审批；分类器永不查看工具结果，故注入指令无法影响其判断。研究预览。
  • Bare mode：启动标志 --bare，跳过对 hooks、skills、plugins、MCP 服务器、auto memory 与 CLAUDE.md 的自动发现。推荐用于 CI 与脚本。
  • Bundled skills：随 Claude Code 附带的基于提示词的操作手册，如 /batch、/code-review、/debug、/loop。
  • Channel：一种把事件推送进运行中会话的 MCP 服务器，使 Claude 能对你离开终端期间发生的事做出反应，可双向。
  • Checkpoint：在你发送的每个提示处创建的还原点，每次编辑前对文件快照。按两次 Esc 或 /rewind 还原；会话本地、独立于 git、不追踪 Bash 工具更改。
  • .claude directory：Claude Code 读取项目级配置的目录（settings、hooks、skills、subagents、rules、auto memory）；用户级默认在 ~/.claude/。
  • CLAUDE.md：你为 Claude 写的持久化指令，每次会话开始作为系统提示之后的用户消息加载，compaction 后仍存续并从磁盘重读。
  • Command：在提示中输入 /name 调用的可复用指令；内置如 /clear、/model、/compact。Skills 是打包多步命令的推荐方式。
  • Compaction：上下文接近上限时对对话的自动总结。CLAUDE.md 与 auto memory 存续并重载；仅对话中的指令可能丢失。可 /compact 手动触发并加焦点。
  • Context window：会话的工作记忆，保存对话历史、文件内容、命令输出、CLAUDE.md、auto memory、已加载 skills 与系统指令。/context 查看占用。
  • Dispatch：由手机发起的任务路由器，从 Claude 手机 App 发任务会在桌面 App 生成会话。面向 Pro 和 Max。
  • Effort level：控制每轮自适应推理思考预算的设置。Opus 4.6 及以后、Sonnet 4.6 支持。
  • Extended thinking：模型回复前可见的逐步推理，可用 MAX_THINKING_TOKENS 限制或调 effort level。
  • Hook：在生命周期特定节点自动执行的用户处理器（shell/HTTP/MCP/prompt/subagent），确定性触发。三层：Hook event、Matcher、Hook handler。
  • Managed settings：由 IT/DevOps 全组织强制的设置文件，放在 ~/.claude 之外的 OS 级路径，用户无法覆盖或排除。
  • MCP (Model Context Protocol)：连接 AI 工具与外部数据源/服务的开放标准。通过 /mcp 或 .mcp.json 添加服务器。
  • MCP Tool Search：把 MCP 工具 schema 推迟到需要时加载的省上下文机制；启动只加载工具名。
  • Non-interactive mode：执行单提示即退出、无对话会话的模式，以 -p 或 --print 调用，用于 CI/脚本/管道。旧称 headless mode。
  • Output style：修改 Claude 系统提示以改变回复行为/语气/格式的配置，会关闭默认软件工程相关提示。内置 Default、Proactive、Explanatory、Learning。
  • Permission mode：会话的基准审批行为，CLI 用 Shift+Tab 循环。可用 default、acceptEdits、plan、auto、dontAsk、bypassPermissions。
  • Permission rule：按工具名与参数模式允许/询问/拒绝某次工具调用的设置，按 deny→ask→allow 求值，首个匹配生效。
  • Plan mode：一种权限模式，Claude 不编辑源文件地研究并提出方案，待你批准后再动手。用 /plan 或 Shift+Tab 进入。
  • Plugin：将 skills、hooks、subagents、MCP 服务器打包为单一可安装单元；插件 skill 以 plugin-name:skill-name 命名空间命名，可经 marketplace 分发。
  • Project trust：加载某目录配置前接受该目录的对话框。按项目保存（主目录除外，每次启动重新提示），把关插件自动安装与项目 hooks 执行。
  • Prompt injection：嵌入文件/网页/工具结果的恶意指令；Claude Code 用权限系统、命令黑名单、信任验证防御，auto mode 另有服务端探针与不查看结果的分类器。
  • Remote Control：通过 claude.ai 从手机或浏览器继续本地会话的方式，代码留本机、只有 UI 远程，区别于云沙箱的 Claude Code on the web。
  • Rules：位于 .claude/rules/ 的模块化指令文件，与 CLAUDE.md 一同加载，可用 YAML paths: 做路径限定按需加载。
  • Sandboxing：针对 Bash 工具的 OS 级文件系统与网络隔离，命令在预设边界内运行而无需逐条审批；独立于 permission rules 的一层。
  • Session：与当前目录绑定、拥有独立上下文窗口的对话。可 claude -c 恢复、--fork-session 分叉、并行运行；记录存于 ~/.claude/projects/。
  • Settings layers：配置优先级从高到低：managed policy、命令行参数、.claude/settings.local.json、.claude/settings.json、~/.claude/settings.json。数组合并、标量高层覆盖低层。
  • Skill：含指令/知识/工作流的 SKILL.md 文件，Claude 相关时自动加载或用 /skill-name 调用，遵循 Agent Skills 开放标准；是自定义命令的推荐继任者。
  • Subagent：在自己上下文窗口运行、带自定义系统提示/特定工具/独立权限的专用助手，处理委派任务并返回摘要。内置 Explore、Plan、general-purpose。
  • Surface：访问 Claude Code 的场所：CLI、VS Code、JetBrains、Desktop、claude.ai；共享同一引擎。Slack 与 Chrome 扩展是集成而非 surface。
  • Teleport：命令 /teleport，把云端会话拉入本地终端（取分支、载历史、恢复状态）。反方向是 --remote，把本地任务发到 web 运行。
  • Tool：Claude 可执行的动作（读文件、改代码、跑命令、搜网、生成子代理），使 Claude Code 具备 agentic 能力。
  • Turn：Claude 在一个 session 内的一次完整响应，从你发消息到 Claude 完成，其间可含任意工具调用。Stop hooks 在每个 turn 结束触发。
  • Verification loop：判断工作是否真正完成的机制——给 Claude 可运行的检查（测试/构建/截图对比），它迭代至通过。是 /goal、无人值守、dynamic workflows 的前提。
  • Worktree isolation：在 .claude/worktrees/ 下独立 git worktree 中运行的隔离模式，用 -w 或子代理 isolation: worktree 启用，使并行代理不覆盖彼此文件。
  • 已更名：Headless mode → Non-interactive mode（同 -p）；Custom commands → Skills（.claude/commands/ 仍可用）；Slash commands → Commands（去掉 "Slash"）。

官方出处：https://code.claude.com/docs/en/glossary