要点速览
- agentic loop:收集上下文→执行→验证,循环至完成,可随时打断重定向。
- harness vs model:Claude Code 是 harness(工具/上下文/执行环境),Claude 是其中的模型。
- CLAUDE.md 你写、auto memory Claude 自己写;二者都在 compaction 后从磁盘重载。
- permission mode(会话基线:default/acceptEdits/plan/auto/dontAsk/bypassPermissions)≠ permission rule(allow/ask/deny 细粒度,deny→ask→allow 首条匹配)。
- subagent 在单会话内独立上下文、只回报摘要;agent teams 是多个可直接对话的独立会话。
本文是对官方 Glossary 的中文整理,释义以原文为准。
| 术语 | 释义 |
|---|---|
| Agentic coding(自主编码) | AI 能自己读文件、跑命令、改代码,你旁观/纠偏/走开;区别于只回文字的聊天助手。 |
| Agentic harness(代理外壳) | 把语言模型变成编码代理的工具+上下文管理+执行环境。Claude Code 是 harness,Claude 是其中的模型。 |
| Agentic loop(代理循环) | 每个任务的循环:收集上下文→执行→验证,直到完成;可随时打断。hooks/skills/MCP 都接入此循环的特定阶段。 |
| Agent teams(代理团队) | 多个独立 Claude Code 会话由 team lead 协调,共享任务表、点对点消息;每个有独立上下文、可直接对话。实验性,需 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。 |
| Artifact | 从会话发布到 claude.ai 私有 URL 的交互式网页,可视化/组织内分享;就地更新。 |
| Auto memory | Claude 据你的纠正/偏好自己写的笔记,按 git 仓库存于 ~/.claude/projects/;每次会话加载 MEMORY.md 前 200 行或 25KB。是 CLAUDE.md 的"Claude 写"版。 |
| Auto mode | 一种权限模式:独立分类器后台审操作,多数免批准;拦权限升级/不可信基础设施/prompt injection;它看不到工具结果。研究预览。 |
| Bare mode | 启动参数 --bare,跳过 hooks/skills/plugins/MCP/memory/CLAUDE.md 自动发现,只用显式参数;CI/脚本推荐。 |
| Bundled skills(内置技能) | 随 Claude Code 自带的提示型 playbook,如 /batch//code-review//debug//loop。 |
| Channel(频道) | 一种 MCP 服务器,把外部事件推进运行中的会话,可双向。Telegram/Discord/iMessage 在研究预览。 |
| Checkpoint(检查点) | 每次发提示创建的还原点;编辑前快照文件。Esc Esc 或 /rewind 还原代码/对话。本地、独立于 git,不跟踪 Bash 改动。 |
.claude 目录 | Claude Code 读取项目级配置(settings/hooks/skills/subagents/rules/auto memory)之处;项目根 .claude/,用户级 ~/.claude/。 |
| CLAUDE.md | 你写的持久指令 markdown,每次会话开头作为系统提示后的用户消息加载;项目根 CLAUDE.md 在 compaction 后从磁盘重读。 |
| Command(命令) | 输入 /name 调用的可复用指令;内置如 /clear//model//compact;自定义放 .claude/commands/。skill 是打包多步命令的推荐方式。 |
| Compaction(压缩) | 上下文接近上限时自动摘要:先清旧工具输出,再摘要对话。CLAUDE.md 与 auto memory 幸存并重载。/compact 手动触发,可带焦点。 |
| Context window(上下文窗口) | 会话工作内存:对话历史、文件内容、命令输出、CLAUDE.md、auto memory、已加载 skill、系统指令。/context 看占用。 |
| Effort level | 控制每轮自适应推理的思考预算;越高思考越深、越慢越贵。支持 Fable 5、Opus 4.6+、Sonnet 4.6。 |
| Extended thinking(扩展思考) | 模型回应前可见的逐步推理;用 effort 调,或 MAX_THINKING_TOKENS 封顶;终端灰色斜体显示。 |
| Hook | 在生命周期固定点自动执行的处理器(工具前/编辑后/会话开始等);可为 shell/HTTP/MCP/LLM 提示/subagent。确定性触发。 |
| Managed settings(托管设置) | IT/DevOps 全组织强制的设置,经管理控制台或 OS 级路径下发;用户无法用低优先级覆盖。 |
| MCP(Model Context Protocol) | 连接 AI 工具与外部数据/服务的开放标准;经 /mcp 或 .mcp.json 添加服务器。 |
| MCP Tool Search | 省上下文机制:MCP 工具 schema 延迟加载,启动只载工具名,用时按需取完整 schema。 |
| Non-interactive mode(非交互模式) | -p/--print 执行单条提示后退出;用于 CI/脚本/管道。Agent SDK 是其 Python/TS 等价。原名 headless。 |
| Output style(输出风格) | 改系统提示以调整回应行为/语气/格式;内置 Default/Proactive/Explanatory/Learning。 |
| Permission mode(权限模式) | 会话基线审批行为,Shift+Tab 切换;有 default/acceptEdits/plan/auto/dontAsk/bypassPermissions。 |
| Permission rule(权限规则) | 据工具名+参数模式 allow/ask/deny;求值 deny→ask→allow 首条匹配;比权限模式更细粒度。 |
| Plan mode | 一种权限模式:只调研、提方案不改源文件;/plan 或 Shift+Tab 进入。 |
| Plugin | 把 skills/hooks/subagents/MCP 打包成可安装单元;skill 命名空间 plugin-name:skill-name;经 marketplace 分发。 |
| Project trust(项目信任) | 加载配置前接受目录的对话;gate 插件自动安装与项目 hook 执行。 |
| Prompt injection(提示注入) | 藏在文件/网页/工具结果里、企图改变 Claude 行为的恶意指令;防御含权限系统、命令注入检测、信任校验。 |
| Remote Control(远程控制) | 从手机/浏览器经 claude.ai 续接本地会话;代码留本机,只有 UI 远程。区别于云端沙箱的 Claude Code on the web。 |
| Rules(规则) | .claude/rules/ 里与 CLAUDE.md 一起加载的模块化指令;可用 YAML paths: 限定路径按需加载。 |
| Sandboxing(沙箱) | Bash 工具的 OS 级文件系统+网络隔离;在预设边界内自由运行、免逐条批准。独立于权限规则。 |
| Session(会话) | 绑定当前目录、有独立上下文的对话;claude -c 恢复、--fork-session 复刻、/clear 开新会话;transcript 存 ~/.claude/projects/。 |
| Skill | SKILL.md 文件,含指令/知识/工作流;相关时自动加载或 /skill-name 调用。是自定义命令的推荐继任。 |
| Subagent(子代理) | 独立上下文+自定系统提示+特定工具权限的专职助手;完成委托任务回报摘要;内置 Explore/Plan/general-purpose。 |
| Surface(界面) | 访问 Claude Code 的地方:CLI/VS Code/JetBrains/Desktop/claude.ai;共享同一引擎。 |
| Teleport | /teleport 把云端会话拉进本地终端;反向是 --remote。 |
| Tool(工具) | Claude 能做的动作:读文件/改代码/跑命令/搜网/起子代理;让 Claude 具备"代理性"。 |
| Turn(轮) | Claude 在会话内的一次完整响应,中间可含任意次工具调用;Stop hook 在每轮末触发。 |
| Verification loop(验证循环) | 给 Claude 能跑的检查(测试/构建/截图比对),它迭代到通过而非一次就停;是 /goal、无人值守、动态 workflow 的前提。 |
| Worktree isolation | -w 或 subagent isolation: worktree,在 .claude/worktrees/ 独立 git worktree 跑,并行代理互不覆盖。 |
已更名:Headless mode → 非交互模式(同
-p);Custom commands → Skills(.claude/commands/仍可用);Slash commands → Commands。