| Agentic Coding Tool | 智能体式编码工具 | 官方对 Claude Code 的定位：不止补全，而是读库、改文件、跑命令的完整 agent | 理解产品边界：它是一个跑在你机器上的 agent，不是聊天窗口 | 与「IDE 补全插件」混淆——后者无 agent loop |
| Agentic Loop | 智能体循环 | gather context → take action → verify results 的三阶段循环，工具结果不断回喂 | 一切 agent 系统的骨架；停止条件与打断机制是设计重点 | 与「单轮问答」混淆；三阶段相互交织而非严格串行 |
| Agentic Harness | 智能体脚手架 | 让模型能作为 agent 行动的执行系统：输入处理、工具编排、结果返回 | 官方称 Claude Code 为 a flexible agent harness——自建 agent 系统时的参照实现 | 与「模型本身」混淆——harness 是模型外的工程系统 |
| CLAUDE.md | 项目指令文件 | 你写给 Claude 的持久指令，每次会话自动加载；层级：Managed policy → User → Project → Local | 跨会话一致性的第一道设计面；官方建议每文件 ≤200 行 | 与「强制配置」混淆——它只是 context，强制要靠 hook/deny |
| Auto Memory | 自动记忆 | Claude 自己在 MEMORY.md 里记的偏好与纠错笔记 | 零成本积累项目知识的官方机制；加载限前 200 行/25 KB | 与 CLAUDE.md 混淆——作者不同（Claude vs 你） |
| Rules (.claude/rules/) | 路径规则 | 带 paths: 前置元数据的规则文件，只在读到匹配路径的文件时加载 | 把大 CLAUDE.md 按目录拆小的官方机制——局部约定按需付费 | 与 skills 混淆——rules 是约定不是流程 |
| Tiered Permissions | 分层权限 | 按工具类型（只读/Bash/文件修改/Web）决定是否需要批准的体系 | human oversight 的产品化：审批粒度即安全粒度 | 与 permission modes 混淆——前者是规则体系，后者是会话级模式 |
| Permission Modes | 权限模式 | default(Manual)/acceptEdits/plan/auto/dontAsk/bypassPermissions 六种免询问范围 | 效率 vs 审查的旋钮；auto 用 classifier 治提示疲劳 | 把 plan 当独立功能页——它已是一种 permission mode |
| Deny Rules | 拒绝规则 | permissions.deny 列表：命中的动作一律拒绝 | 唯一在所有模式（含 bypassPermissions）下生效的规则层 | 以为 allow 能压过 deny——顺序恰好相反 |
| Managed Settings / Policy | 组织托管配置 | 组织级 settings/CLAUDE.md，优先级最高、可锁定 | 企业统一红线与审计基座的落点 | 与项目 settings 混淆——托管层个人改不掉 |
| Protected Paths | 受保护路径 | 任何模式都不会被自动批准的敏感路径（bypass 除外） | 内置防误删防线；rm/rmdir 对关键路径永不自动批准 | 与 deny 规则混淆——这是平台内置行为，不是你配置的 |
| PreToolUse Hook | 工具调用前钩子 | 每次工具调用前必经的处理器，可返回 block 阻断 | 「无论模型怎么决定都执行」的强制点——LLM 指令 ≠ 应用层强制 | 与 CLAUDE.md 指令混淆——前者强制、后者建议 |
| Hooks | 钩子 | 生命周期事件触发的自动化：shell/HTTP/MCP 工具/LLM prompt/subagent | 把审批、审计、lint 接进 agent loop 的标准插槽 | 与 plugins 混淆——hook 是事件机制，plugin 是分发打包 |
| Exit Code 2 | （hook）阻断退出码 | hook 脚本以 2 退出即阻断该工具调用 | 最小可用的 deny 通道（pretooluse_guard.py 示例的核心） | 与普通脚本错误码混淆——2 是语义化 block 信号 |
| Skills | 技能 | 一个 SKILL.md 装知识/流程；/name 手动调用或相关时自动加载，正文用时才载入 | 长参考资料的「几乎零成本」容器；遵循 Agent Skills 开放标准 | 与旧 custom commands 混淆——已合并，二者等价 |
| Bundled Skills | 内置技能 | 官方自带的提示词驱动技能：/doctor、/code-review、/batch、/debug、/loop 等 | 区分「提示词驱动技能」与「固定逻辑命令」（/help、/compact） | 与 built-in commands 混淆——前者模型编排，后者固定逻辑 |
| Subagents | 子代理 | 独立上下文窗口的专职代理：自定义 system prompt、受限工具、独立权限，完成后只回摘要 | context 隔离 + 最小权限 + 成本路由三合一；description 合计 >15,000 tokens 告警 | 与「多开几个会话」混淆——subagent 由主会话自动委派 |
| Explore / Plan Subagents | 探索/规划子代理 | 内置只读代理：Explore 做大探索、Plan 在 plan 模式做研究，均禁 Write/Edit | 官方对「大规模探索污染主上下文」的标准答案 | 以为 Explore 固定跑 Haiku——模型继承主会话 |
| Plan Mode | 规划模式 | 一种 permission mode（plan）：只读探索 + 产出计划供人审 | 把 human approval 插进 agent loop 的标准位置（高危变更先审后动） | 老教程的独立 plan-mode 页面说法已过时 |
| Tool Search / Deferred Tools | 工具搜索/延迟加载 | MCP 工具默认只在上下文放名字列表，schema 按需载入（ENABLE_TOOL_SEARCH 可调） | MCP 规模化的上下文成本治理 | 与 transport 选择混淆——一个管 schema 加载，一个管连接 |
| .mcp.json | 项目 MCP 配置 | 随仓库分发的 MCP server 清单，团队/CI 环境一致 | 「配置入库 + token 走环境变量」是团队协作基线 | 把 token 写进 .mcp.json——绝不入库 |
| Plugins / Marketplaces | 插件/插件市场 | 把 skills+hooks+subagents+MCP 打包（.claude-plugin/plugin.json）经 marketplace 分发 | 跨仓库复用与组织内推广的分发层；先 standalone 后打包 | 与 skills 混淆——plugin 是打包格式，不是新能力类型 |
| Context Window Management | 上下文窗口管理 | /context 诊断、/compact 压缩、/clear 重开；启动时分层自动加载 | context 是 agent 最稀缺资源；隔离（subagent）优先于压缩（compact） | 以为 /compact 无损——它是有损摘要 |
| Prompt Caching (Claude Code) | 提示缓存 | Claude Code 自动管理的前缀缓存 | 成本/延迟优化：模型切换触发无缓存慢轮次；CLAUDE.md 中途改动不生效 | 与 API 侧手动 cache_control 混淆——Code 里是自动的 |
| Checkpointing | 检查点 | /rewind 把代码与对话回滚到检查点 | agent 事故的可恢复性设计（对照模块 10 故障处理） | 与 git 混淆——它连对话状态一起回滚 |
| Headless / Print Mode (-p) | 无头/打印模式 | claude -p "..." 非交互运行，用于 CI/脚本 | 自动化管道的接入点；配合 dontAsk + 最小 allow + hook 兜底 | 与「绕过所有权限」混淆——无人值守更要收紧 |