Claude Code 核心术语定义。理解这些概念是掌握 Claude Code 架构和工作方式的基础。
核心架构概念
Agentic Loop（Agent 循环） Claude 处理每个任务的循环：收集上下文 → 采取行动 → 验证结果 → 重复，直到完成。每次工具调用的结果都会影响下一步决策。Hooks、Skills 和 MCP 都插入这个循环的特定阶段。
Agentic Harness（Agent 框架） 将语言模型变成有能力的编码 Agent 的工具、上下文管理和执行环境。Claude Code 是框架，Claude 是其中的模型。框架提供文件访问、shell 执行、权限门控、记忆加载和链接动作的循环。
Turn（轮次） 一次完整的 Claude 响应，从你发送消息开始，到 Claude 完成响应结束，中间可以有任意数量的工具调用。Stop hooks 在每个 turn 结束时触发。
Session（会话）
绑定到当前目录的对话，有独立的上下文窗口。/clear 开始新会话（旧会话可通过 /resume 恢复），--fork-session 保留历史但创建新 session ID。
记忆与上下文
CLAUDE.md 用户编写的持久指令文件，每次会话开始时作为用户消息加载（在系统提示词之后）。存放项目约定、架构说明和”始终做 X”规则。压缩（compaction）后从磁盘重新读取，不会丢失。
Auto Memory（自动记忆）
Claude 根据你的纠正和偏好自动写入的笔记，按 git 仓库存储在 ~/.claude/projects/。同一仓库的所有 worktree 共享一个 auto memory 目录。是 CLAUDE.md 的 Claude 写入版本。
Context Window（上下文窗口）
会话的工作记忆，包含对话历史、文件内容、命令输出、CLAUDE.md、auto memory、已加载的 skills 和系统指令。/context 查看占用，/compact 手动压缩。
Compaction（压缩） 上下文窗口接近上限时的自动摘要机制。先清除旧工具输出，再摘要对话。CLAUDE.md 和 auto memory 在压缩后重新加载；仅在对话中给出的指令可能丢失。
工具与扩展
Tool（工具） Claude 可以采取的行动：读文件、编辑代码、运行 shell 命令、搜索网络、生成子 Agent。工具是 Claude Code 具有 agentic 能力的原因。
MCP（Model Context Protocol） 连接 AI 工具与外部数据源和服务的开放标准。MCP 服务器为 Claude 提供 Slack、Jira、数据库、浏览器等集成的新工具。
MCP Tool Search 延迟加载 MCP 工具 schema 的机制。启动时只加载工具名称，Claude 决定使用某个工具时才获取完整 schema，节省空闲 MCP 服务器的上下文占用。
Skill（技能）
包含指令、知识或工作流的 SKILL.md 文件，Claude 在相关时自动加载，或通过 /skill-name 直接调用。是自定义命令的推荐继任者。
Hook（钩子） 在 Claude Code 生命周期特定节点自动执行的用户自定义处理器（如工具运行前、文件编辑后、会话开始时）。是确定性的：在固定节点触发，而非由模型决定。
Plugin（插件） 将 skills、hooks、子 Agent 和 MCP 服务器打包为单一可安装单元。通过 marketplace 在团队间分发。
权限与安全
Permission Mode（权限模式）
会话的基线审批行为。Shift+Tab 循环切换：default（逐一审批）、acceptEdits（自动接受编辑）、plan（只规划不执行）、auto（分类器自动决策）、bypassPermissions（跳过所有检查）。
Auto Mode（自动模式） 由独立分类器模型在后台审查每个操作的权限模式。安全的编辑和命令无需打断用户；破坏性或可疑操作被阻止并上报。分类器不看工具结果，防止 prompt injection 影响决策。
Checkpoint（检查点）
每次发送提示时创建的恢复点。Claude Code 在每次编辑前快照文件。Esc+Esc 或 /rewind 恢复代码、对话或两者。与 git 独立，不跟踪 Bash 工具的变更。
Prompt Injection（提示词注入） 嵌入在文件、网页或工具结果中的恶意指令，试图将 Claude 引向你未要求的操作。Auto mode 的分类器不看工具结果，是防御 prompt injection 的关键机制。
Agent 协作
Subagent（子 Agent） 在独立上下文窗口中运行的专用 AI 助手，有自定义系统提示词、特定工具访问和独立权限。完成委托任务后向主对话返回摘要。
Agent Teams（Agent 团队）
多个独立 Claude Code 会话由团队负责人协调，共享任务列表和点对点消息。与子 Agent 不同，每个成员有自己的上下文窗口，可以直接交互。实验性功能，需设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。
Worktree Isolation（Worktree 隔离）
在 .claude/worktrees/ 下的独立 git worktree 中运行 Claude，通过 -w flag 或子 Agent 配置中的 isolation: worktree 启用。并行 Agent 不会互相覆盖文件。
已废弃/重命名术语
| 旧术语 | 现称 |
|---|---|
| Headless mode | Non-interactive mode（-p flag） |
| Custom commands | Skills（.claude/commands/ 文件仍可用） |
| Slash commands | Commands（去掉了”Slash”） |
与其他概念的关联
- commands — 命令系统详解
- tools-reference — 工具完整参考
- env-vars — 环境变量控制各概念行为
- interactive-mode — 交互模式中的快捷键和功能