📚 首页 / 09-claude-code / README.md

模块 9 — Claude Code：Agentic 编码工具的架构全景

前置：模块 4（tool use）、模块 8（agents）。本模块以 2026-08-30 的官方文档为准（Claude Code 文档已迁移至 code.claude.com/docs，旧 docs.claude.com/en/docs/claude-code/* 路径会重定向）。过时术语一律注明。

📘 重要英语词汇表

9.0 Claude Code 是什么

🎯 学习重点：必考定位是 agentic coding tool / agent harness，不是单纯的代码补全器。

Claude Code 是 Anthropic 的 agentic coding tool（智能体式编码工具）：它读取你的代码库、编辑文件、运行命令，并与开发工具集成。它不只是补全——它运行完整的 agent loop（见 9.2）。

运行面（截至 2026-08-30）：

运行面	说明
Terminal CLI	全功能命令行，`claude` 启动
VS Code / JetBrains 插件	编辑器内集成（inline diffs、@-mentions、plan review）
Desktop app	独立应用：并行会话、可视化 diff、定时任务、云会话
Web（claude.ai/code）与移动端	浏览器/手机上运行云端会话，无需本地环境

来源: https://code.claude.com/docs/en/overview（访问于 2026-08-30）

架构师视角：Claude Code 本质上是 Anthropic 官方打造的一个 生产级 agent harness（脚手架）——官方在 evals 工程博文中明确把 Claude Code 称为 "a flexible agent harness"，即「让模型能够作为 agent 行动的系统：处理输入、编排工具调用、返回结果」。理解它的设计，等于理解一个真实 agent 产品如何处理上下文、权限、扩展性与安全。来源: https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents（访问于 2026-08-30）

9.1 安装与基础用法

🎯 学习重点：掌握交互式 claude 与 headless claude -p 的用途边界，并记住最低系统要求。

安装（macOS/Linux/WSL 推荐 native 安装，自动后台更新）：

curl -fsSL https://claude.ai/install.sh | bash     # macOS / Linux / WSL
brew install --cask claude-code                    # Homebrew（stable 渠道，通常落后约一周；claude-code@latest 跟最新）
winget install Anthropic.ClaudeCode                # Windows
# Debian/Fedora/RHEL/Alpine 也支持 apt / dnf / apk

系统要求（截至 2026-08-30）：macOS 13+、Windows 10 1809+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+；4 GB+ RAM；需要网络。来源: https://code.claude.com/docs/en/setup（访问于 2026-08-30）

基础用法：

cd your-project
claude                    # 交互式会话（首次提示登录；设置 ANTHROPIC_API_KEY 可跳过登录改为确认 key）
claude "fix the auth bug" # 直接带任务启动
claude -p "..."           # 非交互 print 模式（CI/脚本集成）

大多数运行面需要 Claude 订阅或 Anthropic Console 账号；Terminal/VS Code/JetBrains 也支持第三方供应商（Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 等）。来源: https://code.claude.com/docs/en/overview（访问于 2026-08-30）

🧨 犀利细节｜安装渠道也是运维决策：Homebrew stable 通常落后约一周，native 安装会自动后台更新；前者偏可控版本节奏，后者偏快速拿到修复。企业环境应先决定升级窗口和回滚策略，不能让不同开发机随机漂移版本。最低 4 GB RAM 只表示能运行，不代表大型仓库并行任务的容量预算。

9.2 Agent Loop：gather context → take action → verify results

🎯 学习重点：必背三阶段，并能把读文件、编辑、跑测试分别映射到 context、action、verification。

官方对 Claude Code 工作机制的描述：收到任务后，它循环经过三个阶段——gather context（收集上下文）、take action（行动）、verify results（验证结果）。三个阶段相互交织：搜索文件是在收集上下文，编辑文件是在行动，跑测试是在验证。每次工具调用的返回都反馈给模型，影响下一步决策；用户可随时打断纠正。来源: https://code.claude.com/docs/en/how-claude-code-works（访问于 2026-08-30）

flowchart LR U[用户任务] --> G[gather context<br/>读文件/搜索/git 状态] G --> A[take action<br/>编辑/运行命令/调工具] A --> V[verify results<br/>跑测试/重读 diff] V -->|未完成/新信息| G V -->|完成| D[交付结果] U -.随时打断/补充上下文.-> G

Claude Code 由两部分驱动：models（推理）+ tools（行动）；Claude Code 自身是围绕 Claude 的 agentic harness，提供工具、上下文管理与执行环境。内置工具分五类：

类别	能力
File operations	读文件、编辑、新建、重命名重组
Search	按模式找文件、正则搜内容、探索代码库
Execution	运行 shell 命令、起服务、跑测试、用 git
Web	网页搜索、抓取文档、查错误信息
Code intelligence	编辑后看类型错误、跳转定义、找引用（需 code intelligence 插件）

来源: https://code.claude.com/docs/en/how-claude-code-works（访问于 2026-08-30）

与模块 8 呼应：这就是「模型 + 工具 + 循环 + 停止条件」的最完整官方实现——停止条件由任务完成/用户打断构成。

🧨 犀利细节｜“改完了”不等于完成：若任务有可执行测试、类型检查或可重读 diff，却只依据模型自述结束，等于跳过 verify results。反模式是编辑成功即交付；正解是把环境证据作为完成门，并在验证持续失败时停止或升级，而不是无限重试。

9.3 仓库理解（Repo Understanding）

🎯 学习重点：理解 Claude Code 如何综合文件、终端、git、记忆与扩展，并避免把大规模探索塞进主上下文。

Claude Code 能访问：项目文件、终端（你能跑的命令它也能跑）、git 状态（分支/未提交变更/近期提交）、CLAUDE.md、auto memory、以及你配置的扩展（MCP/skills/subagents）。因此它能跨文件工作，而不像只看当前文件的 inline 补全。来源: https://code.claude.com/docs/en/how-claude-code-works（访问于 2026-08-30）

官方常见工作流（探索陌生代码库）：

give me an overview of this codebase      # 高层概览
explain the main architecture patterns    # 架构模式
find the files that handle user authentication   # 定位相关代码
trace the login process from front-end to database  # 追踪执行流

技巧：先问宽再问窄；用项目自己的领域词汇；为你的语言安装 code intelligence 插件以获得精确的「跳转定义/找引用」。来源: https://code.claude.com/docs/en/common-workflows（访问于 2026-08-30）。大规模探索会污染主上下文——官方建议交给只读的 Explore subagent（见 9.10）。

9.4 记忆：CLAUDE.md、auto memory 与 rules

🎯 学习重点：高频易错是 CLAUDE.md 属于 context 而非强制配置，并能说出四层加载顺序。

每个会话都从全新上下文窗口开始。跨会话记忆有两个机制（均为「上下文」而非「强制配置」——要无条件阻止行为应使用 PreToolUse hook）：来源: https://code.claude.com/docs/en/memory（访问于 2026-08-30）

	CLAUDE.md	Auto memory
谁写	你	Claude 自己
内容	指令与规则	学到的偏好与纠错
加载	每次会话	每次会话（MEMORY.md 前 200 行或 25 KB，取先到者）

CLAUDE.md 的层级（按加载顺序，从宽到窄，越具体越后加载）：

层级	位置	用途
Managed policy	`/Library/Application Support/ClaudeCode/CLAUDE.md`（macOS）/ `/etc/claude-code/CLAUDE.md`（Linux/WSL）等	IT/DevOps 管理的组织级策略
User	`~/.claude/CLAUDE.md`	个人偏好，跨所有项目
Project	`./CLAUDE.md` 或 `./.claude/CLAUDE.md`	团队共享（入版本控制）
Local	`./CLAUDE.local.md`	个人本地补充（不入库）

另外：.claude/rules/ 支持按路径生效的规则——带 paths: 前置元数据的规则文件只在 Claude 读到匹配路径的文件时自动加载。这是「把大 CLAUDE.md 拆小」的官方机制。官方建议 CLAUDE.md 保持在 200 行以内：事实放 CLAUDE.md，多步流程放 skill，局部规则放 rules。来源: https://code.claude.com/docs/en/memory、https://code.claude.com/docs/en/context-window（访问于 2026-08-30）

/init 命令可生成初始 CLAUDE.md，/memory 可打开编辑。来源: https://code.claude.com/docs/en/commands（访问于 2026-08-30）

🧨 犀利细节｜常驻上下文要按“每次会话税”审计：auto memory 只自动载入 MEMORY.md 的前 200 行或 25 KB（先到者），CLAUDE.md 官方建议不超过 200 行。把 800 行 playbook 放进 CLAUDE.md，不只是可读性差，而是每个会话都重复占用注意力；正解是事实留 CLAUDE.md、路径规则放 rules、多步流程放按需 skill。

9.5 Planning：先规划后动手

🎯 学习重点：把 plan mode 看作只读权限模式，并指出 human approval 位于探索与执行之间。

plan mode（规划模式） 现在是一种 permission mode（权限模式，config 值 plan）：Claude 只读地探索代码库、产出一份计划供你审阅，而不直接改文件；「Exploring a codebase before changing it」。在 CLI 用 Shift+Tab 循环切换模式，或直接输入 /plan。规划时的代码库研究会委派给只读的 Plan subagent，让探索输出留在独立上下文窗口里。来源: https://code.claude.com/docs/en/permission-modes、https://code.claude.com/docs/en/sub-agents、https://code.claude.com/docs/en/commands（访问于 2026-08-30）

术语注意（截至 2026-08-30）：官方文档不再有独立的 "plan-mode" 页面；规划能力分散在 permission modes（plan 模式）、Plan subagent 与 /plan 命令三处。老教程里的说法已过时。

架构师视角：plan→review→execute 是把「human approval」插进 agent loop 的标准位置（呼应模块 4/8）——高破坏性、低可逆性的操作前，让模型先出计划、人先审。

9.6 Permissions：分层权限体系

🎯 学习重点：必背六种 permission modes、deny 的优先级，以及 bypassPermissions 只能用于隔离环境。

Claude Code 用分层权限（tiered permission）在能力与安全间平衡。默认（Manual mode）：

工具类型	是否需要批准	「不再询问」记忆
只读（文件读、Grep）	否（限工作目录）	不适用
Bash 命令	是（内置只读命令白名单除外）	按仓库+命令永久保存
文件修改	是	仅到会话结束
Web fetch	是（预批准文档域名除外）	按仓库+域名永久保存
Web search	是	按仓库永久保存

权限批准可保存为规则（存入 .claude/settings.local.json）；按 Tab 可在批准时附评论；Ctrl+E 可让模型解释命令（低/中/高风险标注）。来源: https://code.claude.com/docs/en/permissions（访问于 2026-08-30）

Permission modes（截至 2026-08-30）：

模式	免询问范围	适用
`default`（CLI 显示 Manual）	仅只读	审查每个动作、敏感工作
`acceptEdits`	+ 文件编辑与常见文件系统命令	迭代中自动接受编辑
`plan`	只读 + 规划	先探索后动手
`auto`	全部（后台 classifier 审查代替人工确认）	长任务、减少提示疲劳（Pro/Max/Team 默认）
`dontAsk`	仅预批准工具	锁定的 CI 与脚本
`bypassPermissions`	全部	仅隔离容器/VM

要点：deny 规则在所有模式下都生效（包括 bypassPermissions）；受保护路径在任何模式下都不会被自动批准（bypass 除外）；rm/rmdir 针对关键路径永不自动批准。来源: https://code.claude.com/docs/en/permission-modes（访问于 2026-08-30）

配置层级：项目 .claude/settings.json（团队共享）→ 用户 ~/.claude/settings.json → 本地 .claude/settings.local.json → 组织 managed settings（可强制锁定，如禁用某些功能）。来源: https://code.claude.com/docs/en/settings（访问于 2026-08-30）

🧨 犀利细节｜“少弹窗”不能靠全放行：Bash(*) 或在宿主机使用 bypassPermissions 会把一次模型误判直接放大成系统动作。正解是项目级最小 allow、明确 deny、受保护路径与 sandbox 叠加；CI 用 dontAsk 时，未预批准工具应失败，而不是退回交互等待导致流水线挂死。

9.7 Tools

🎯 学习重点：工具是行动面；模型可选工具，但执行、权限和反馈格式由 harness 控制。

工具让 Claude Code 成为 agent：没有工具只能输出文本，有了工具就能行动。模型基于提示与过程反馈自主选工具。内置五类见 9.2；扩展工具的途径：skills（知识/流程）、MCP（外部服务）、hooks（事件自动化）、subagents（委派）。完整工具清单见官方 Tools reference（含 Bash、Read/Edit/Write、Glob/Grep、WebFetch/WebSearch、AskUserQuestion、Task、EndConversation 等，以及 code intelligence/LSP 行为）。来源: https://code.claude.com/docs/en/how-claude-code-works、https://code.claude.com/docs/en/tools-reference（访问于 2026-08-30）

9.8 Skills 与 slash commands（已合并）

🎯 学习重点：记住 custom commands 已并入 skills，并掌握「描述常驻、正文按需加载」的上下文优势。

Skills（技能） 是最灵活的扩展：一个 SKILL.md 文件装着知识、工作流或指令；你可以 /skill-name 显式调用，Claude 也会在相关时自动加载。skill 正文只在被使用时才载入上下文——「长参考资料几乎零成本」。Claude Code 的 skills 遵循开放标准 Agent Skills（agentskills.io），并扩展了调用控制、subagent 执行、动态上下文注入等能力。来源: https://code.claude.com/docs/en/skills（访问于 2026-08-30）

重要现状（截至 2026-08-30）：custom commands 已并入 skills。 .claude/commands/deploy.md 与 .claude/skills/deploy/SKILL.md 都生成 /deploy 且行为一致；旧 commands 文件继续兼容。skill 前置元数据可控制「谁能调用」（如 disable-model-invocation: true 表示只能用户手动 / 调用）。

skill 目录示例：

.claude/skills/deploy/
└── SKILL.md     # frontmatter: name/description + 正文（清单式部署流程）

Bundled skills（内置技能）：/doctor、/code-review、/batch、/debug、/loop、/claude-api、/run、/verify 等（可用 disableBundledSkills 关闭）。与「built-in commands（固定逻辑，如 /help、/compact）」不同，bundled skills 是提示词驱动、由模型用工具编排完成。来源: https://code.claude.com/docs/en/skills、https://code.claude.com/docs/en/commands（访问于 2026-08-30）

常用命令速览（完整见 commands reference）：

首次进仓：/init（生成 CLAUDE.md）→ /memory → /mcp → /permissions
任务中：/plan、/model、/effort、/context（看上下文占用）、/compact（压缩）、/btw（不进历史的侧问）
并行：/tasks、/background、/batch
交付前：/diff、/code-review [ultra]、/security-review
出问题：/rewind（checkpoint 回滚）、/doctor、/debug

命令只在消息开头识别；skill 可链式调用（最多 6 个）。来源: https://code.claude.com/docs/en/commands（访问于 2026-08-30）

🧨 犀利细节｜按需加载也有入口成本：skill 正文延迟加载，但每个 skill 的描述仍参与发现；把大量模糊、重叠 skill 注册进去会增加误触发与选择成本。链式调用上限是 6 个，因此长流程应设计清晰编排，而不是靠无限拼接命令。

9.9 Hooks：生命周期自动化

🎯 学习重点：必考 PreToolUse 阻断、PostToolUse 后处理，以及 hook 才是独立于模型决定的强制点。

Hooks 是在 Claude Code 生命周期特定节点自动执行的用户定义处理器——可以是 shell 命令、HTTP 请求、MCP 工具调用、LLM prompt 或 subagent。事件分三种节奏：来源: https://code.claude.com/docs/en/hooks（访问于 2026-08-30）

每会话一次：SessionStart、SessionEnd
每轮一次：UserPromptSubmit、Stop、StopFailure
agent loop 内每次工具调用：PreToolUse、PostToolUse（另有 PermissionRequest、PreCompact/PostCompact、Notification 等大量事件）

架构师要点：PreToolUse hook 是唯一「无论模型怎么决定都会执行」的强制点——官方 memory 文档明确说：CLAUDE.md 是上下文不是配置，「To block an action regardless of what Claude decides, use a PreToolUse hook instead」。这是模块 11「LLM 指令 ≠ 应用层强制」在 Claude Code 里的具体体现：hook 可以检查工具入参并返回 deny 决定。

// .claude/settings.json — 每次 Edit 后自动跑 lint
{
  "hooks": {
    "PostToolUse": [
      { "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "npx eslint --fix \"$CLAUDE_FILE_PATHS\"" }] }
    ]
  }
}

（示例为教学简化；字段细节以 hooks reference 为准。）

🧨 犀利细节｜安全 hook 先定义故障语义：解析失败、超时或 hook 进程崩溃时，fail-open 保可用性但可能放过危险动作，fail-closed 保安全却可能阻断生产。高风险 PreToolUse 默认应偏 fail-closed，并配超时、可观测日志与人工恢复路径；格式化等低风险 PostToolUse 才更适合降级放行。

9.10 Subagents

🎯 学习重点：subagent 的四个价值是上下文隔离、专用指令、工具限制与模型路由，同时要承认摘要会丢细节。

Subagent（子代理） 在自己的独立上下文窗口运行，带自定义 system prompt、受限工具集、独立权限；完成后只把摘要返回主会话。用途：保留主上下文（探索/日志等大输出不进主对话）、强制约束（只读工具）、成本控制（低价值任务路由到更便宜的模型如 Haiku）。来源: https://code.claude.com/docs/en/sub-agents（访问于 2026-08-30）

内置：Explore（只读探索，模型继承主会话且上限 Opus）与 Plan（plan mode 下的研究代理）——都禁用 Write/Edit。
自定义：.claude/agents/<name>.md（frontmatter：name/description/tools/model）。
上下文预算：所有 subagent 的 description 合计超过 15,000 tokens 会在启动时告警——把细节移进各 subagent 的 system prompt。

更大规模的并行：background agents / agent view（多会话监控）、agent teams（团队协作）、dynamic workflows（脚本编排大量 subagent）。来源: https://code.claude.com/docs/en/sub-agents、https://code.claude.com/docs/en/agents（访问于 2026-08-30）

🧨 犀利细节｜description 也是全局预算：所有 subagent description 合计超过 15,000 tokens 会在启动时告警。反模式是把完整操作手册塞进 description；正解是让 description 只负责路由，把执行细节放独立 system prompt，并在委派时明确目标、边界和输出格式。

9.11 MCP 集成

🎯 学习重点：掌握项目/用户配置边界、tool search 延迟 schema，以及外部内容带来的 prompt injection 风险。

Claude Code 通过 MCP（Model Context Protocol） 连接数百种外部工具/数据源。推荐远程服务器用 HTTP transport：

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer ***"   # 注意：真实 token 应放环境变量/密管，勿入库
claude mcp list

配置可写入项目 .mcp.json（随仓库共享，团队/CI 一致）或用户 ~/.claude.json。要点（截至 2026-08-30）：

Tool search：MCP 工具默认延迟加载——上下文里只有工具名列表，模型按需加载 schema（ENABLE_TOOL_SEARCH 可调），避免几十个 MCP server 的 schema 挤爆上下文。
组织可对 connector 工具设置 allow/ask 控制；单个工具可标 requiresUserInteraction 强制人工确认。
官方警告：会抓取外部内容的服务器可能带来 prompt injection 风险，连接前必须信任该服务器。

来源: https://code.claude.com/docs/en/mcp（访问于 2026-08-30）

🧨 犀利细节｜MCP 扩展的是信任边界：tool search 只解决 schema 的上下文成本，不会降低服务器本身的权限或注入风险。项目 .mcp.json 可共享服务器定义，但认证材料必须留在环境变量或密管；对会抓取外部内容的 server 还要限制工具权限、审计来源并保留人工确认点。

9.12 Plugins

🎯 学习重点：plugin 是 skills、hooks、subagents、MCP 的分发层，先单仓迭代成熟再打包共享。

Plugin（插件） 是打包分发层：把 skills、hooks、subagents、MCP servers 打成一个可安装单元，manifest 位于 .claude-plugin/plugin.json。插件技能带命名空间（/my-plugin:review），多插件可共存。通过 marketplace 分发（如官方 claude-plugins-official），/plugin install <name>@<marketplace> 安装。官方建议：先用 .claude/ 下的 standalone 配置快速迭代，要跨仓库复用/分享时再转成 plugin。来源: https://code.claude.com/docs/en/plugins（访问于 2026-08-30）

9.13 Context 管理

🎯 学习重点：必背 200K 启动加载顺序，以及 /context、/compact、/clear 的不同用途与副作用。

会话启动时的自动加载顺序（200K 窗口内）：system prompt → auto memory（前 200 行/25 KB）→ 环境信息 → MCP 工具名（延迟）→ skill 描述（仅一行描述，正文用时才载）→ 用户级 CLAUDE.md → 项目 CLAUDE.md →（规则按路径触发加载）。文件读取是上下文的主要消耗者——提示越具体，读的文件越少；研究型任务交给 subagent。来源: https://code.claude.com/docs/en/context-window（访问于 2026-08-30）

管理命令：/context（看什么占满窗口）、/compact（把历史摘要压缩；skill 描述列表不会被重新注入，只有实际用过的 skill 保留）、/clear（新任务清空但保留项目记忆）。Claude Code 还自动管理 prompt caching——模型切换会触发一次无缓存的慢轮次；CLAUDE.md 修改不会在会话中途生效。Checkpointing（/rewind） 可回滚代码与对话到检查点。来源: https://code.claude.com/docs/en/context-window、https://code.claude.com/docs/en/prompt-caching、https://code.claude.com/docs/en/checkpointing（访问于 2026-08-30）

flowchart TD A[会话启动 200K 窗口] --> B[自动加载: system prompt / memory / CLAUDE.md / 工具与技能描述] B --> C[任务执行: 文件读取主导消耗] C --> D{窗口接近上限?} D -->|是| E["/compact 压缩摘要<br/>或 subagent 隔离 / /clear 重开"] D -->|否| C E --> C

9.14 扩展机制选型（官方「随时间搭建」路径）

🎯 学习重点：按重复频率与问题类型逐级引入 CLAUDE.md、skill、MCP、code intelligence 和 subagent。

触发信号	加什么
同一约定/命令 Claude 错第二次	写进 CLAUDE.md
重复输入同一段起始提示	存成 skill
第三次粘贴同一份多步 playbook	捕获为 skill
一直从浏览器/系统复制数据给 Claude	接 MCP server
Claude 读很多文件只为找符号定义	装 code intelligence 插件
侧任务输出淹没主对话	走 subagent

来源: https://code.claude.com/docs/en/features-overview（访问于 2026-08-30）

9.15 Bad vs Better

🎯 学习重点：能把大 CLAUDE.md、宽权限、全量 MCP schema 和主会话重探索逐项改成分层、最小化与按需加载。

Bad：一个 800 行的 CLAUDE.md 塞满部署流程、API 文档与安全规则；permissions.allow: ["Bash(*)"] 一劳永逸；几十个 MCP server 全量加载；重要探索全在主会话里做。

Better：

CLAUDE.md ≤200 行只放「每个会话都该知道的事实」；API 参考放 skill（按需加载）；目录级约定放 .claude/rules/ 带路径匹配；组织级策略放 managed policy。
权限用最小化 allow 规则 + 明确 deny 列表 + sandbox（/sandbox 定义文件系统/网络隔离边界），CI 里用 dontAsk 只放预批准工具，容器里才用 bypassPermissions。
MCP 开 tool search 延迟加载；subagent 承担重探索，主上下文只留结论。

来源: https://code.claude.com/docs/en/memory、https://code.claude.com/docs/en/permission-modes、https://code.claude.com/docs/en/sandboxing（访问于 2026-08-30）

9.16 Tradeoffs

🎯 学习重点：比较人工审批、auto、subagent、plan mode、共享 MCP 与 bypassPermissions 的收益和失效半径。

决策	一面	另一面
Manual vs auto mode	逐动作审查安全	提示疲劳→机械式批准反而更危险；auto 用 classifier 换效率
主会话 vs subagent	主会话上下文连续、可交互	subagent 隔离省上下文、可并行，但结果只回摘要（细节丢失）
plan mode 先行	高风险变更可先人审	多一轮往返延迟；小改动不值得
项目 `.mcp.json` 入库	团队/CI 环境一致	服务器列表与 header 管理需谨慎（token 不入库）
bypassPermissions	容器内自动化最快	只有在不可逃逸的隔离环境才可接受

9.17 Common Mistakes

🎯 学习重点：易错点集中在 context/强制配置混淆、过时术语、非隔离 bypass、工具 schema 膨胀与上下文污染。

把 CLAUDE.md 当强制配置用——它是上下文；强制要靠 deny 规则/PreToolUse hook（来源: memory 文档，2026-08-30）。
用过时术语学习（如独立的 "plan mode 页面"、独立 custom commands）——截至 2026-08-30 规划在 permission modes，commands 已并入 skills。
在非隔离环境用 bypassPermissions 追求效率。
让 MCP server 全量加载 schema，上下文被工具定义吃掉——用默认的 deferred/tool search。
主会话里做大规模探索，/compact 越压越丢细节——该用 subagent。
长流程塞 CLAUDE.md 每个会话都付费加载——应放 skill。
团队每人各自的权限习惯不同，审计困难——用项目 .claude/settings.json + 组织 managed settings 统一。

9.18 重要英文术语

🎯 学习重点：术语题要能从英文反推其责任层：上下文、权限、生命周期、委派、分发或回滚。

术语	中文	一句话
agentic coding tool	智能体式编码工具	官方对 Claude Code 的定位
agentic loop	智能体循环	gather context → take action → verify results
agentic harness	智能体脚手架	让模型成为 agent 的执行系统
CLAUDE.md	项目指令文件	每会话加载的持久指令
auto memory	自动记忆	Claude 自己写的 MEMORY.md 学习笔记
permission modes	权限模式	default/acceptEdits/plan/auto/dontAsk/bypassPermissions
Skills	技能	SKILL.md 定义、按需加载的能力包（Agent Skills 开放标准）
hooks	钩子	生命周期事件触发的强制自动化
subagents	子代理	独立上下文窗口的专职代理
plugins / marketplaces	插件/插件市场	打包分发 skills+hooks+agents+MCP
tool search / deferred tools	工具搜索/延迟加载	MCP 工具 schema 按需载入
checkpointing	检查点	/rewind 回滚代码与对话

9.19 认证相关性

🎯 学习重点：把 permissions、hooks、context、MCP 分别映射到 human oversight、安全控制、上下文工程与工具设计。

Claude Certification（CCAR-F/CCAR-P 等）考察 advising/designing/building Claude solutions。Claude Code 是官方 agent harness 的参照实现：permissions/plan mode/hooks 对应考试中 human oversight 与安全控制主题；CLAUDE.md/skills/subagents/context 管理对应 context engineering 主题；MCP 集成对应 tool design 主题。备考时以本模块引用的现行官方文档为准（认证事实见 00-certification-current-status/certification-status.md）。

附：本模块示例与练习

🎯 学习重点：先用无 key 示例观察 loop 与配置门禁，再进入真实权限、hook、subagent 和 MCP 实验。

examples/：agent_loop_demo.py（无 key 可跑：模拟 agent loop）、config-examples/（CLAUDE.md/rules/settings/hooks/subagent/skill/.mcp.json 模板）+ validate_configs.py（JSON 校验，无 key 可跑）
labs/lab.md：从安装到权限/技能/钩子的动手实验
questions/：架构师问答 + 考试题型

📚 目录