Claude Code 术语表
原文:Glossary
一句话
快速理解Claude Code核心术语,建立概念基础。
什么时候翻这页
- 遇到不熟悉的Claude Code术语时
- 学习Claude Code功能前建立概念框架
- 需要澄清特定术语含义时
- 编写或阅读Claude Code相关文档时
核心概念
代理式编程 (Agentic coding)
一种工作流程,AI可以自主读取文件、运行命令和进行修改,而你可以观察、重定向或离开,与仅提供文本建议的基于聊天的助手不同。
代理循环 (Agentic loop)
Claude为每个任务所经历的周期:收集上下文、采取行动、验证结果,然后重复直到完成。每个工具使用都会返回信息,指导下一步操作。
上下文窗口 (Context window)
会话的工作内存,保存对话历史、文件内容、命令输出、CLAUDE.md、自动记忆等。随着工作增加,上下文会填满,需要压缩。
CLAUDE.md
你为Claude编写的持久指令的markdown文件,在每个会话开始时作为用户消息加载。包含项目约定、架构说明和"始终执行X"的规则。
压缩 (Compaction)
当上下文窗口接近限制时自动总结对话的过程。较旧的工具输出首先被清除,然后对话被总结。项目根目录的CLAUDE.md和自动记忆会保留。
工具 (Tool)
Claude可以执行的操作:读取文件、编辑代码、运行shell命令、搜索网络、生成子代理等。工具使Claude Code具有代理能力。
技能 (Skill)
包含指令、知识或工作流的SKILL.md文件,Claude将其添加到其工具包中。技能是自定义命令的推荐替代方案。
钩子 (Hook)
在Claude Code生命周期特定点自动执行的用户定义处理器,如工具运行前、文件编辑后或会话开始时。钩子是确定性的,在固定的生命周期点触发。
子代理 (Subagent)
在自己的上下文窗口中运行的专业AI助手,具有自定义系统提示、特定工具访问和独立权限。用于处理大型探索或并行研究。
MCP (Model Context Protocol)
用于连接AI工具与外部数据源和服务的开放标准。MCP服务器为Claude提供Slack、Jira、数据库等新工具。
权限模式 (Permission mode)
会话的基线批准行为,控制Claude如何执行操作。可用模式包括default、acceptEdits、plan、auto、dontAsk和bypassPermissions。
会话 (Session)
与你当前目录相关的对话,拥有独立的上下文窗口。可以恢复、分叉或并行运行。
自动记忆 (Auto memory)
Claude基于你的纠正和偏好为自己编写的笔记,存储在每个git仓库的~/.claude/projects/下。与CLAUDE.md相对应,后者是你编写的。
怎么做
理解要点
- 区分代理式编程与传统编程助手:Claude Code可以自主执行操作,而不仅仅是提供建议。
- 掌握上下文管理:了解上下文窗口如何工作,以及压缩如何影响会话历史。
- 熟悉配置层次结构:从托管设置到用户设置的配置优先级。
- 理解权限系统:权限模式控制整体行为,权限规则提供细粒度控制。
- 区分工具和技能:工具是单个操作,技能是多步工作流。
常用命令
/compact- 手动触发对话压缩/context- 查看上下文使用情况/rewind- 恢复到检查点/teleport- 将云会话拉入本地终端/clear- 开始新会话/resume- 恢复之前的会话
命令 / 配置速查
| 命令/配置 | 描述 |
|---|---|
--bare | 跳过自动发现的基础模式启动标志 |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 | 启用实验性代理团队 |
MAX_THINKING_TOKENS | 限制思考令牌的环境变量 |
~/.claude/ | 用户级配置目录 |
.claude/ | 项目级配置目录 |
.claude/rules/ | 模块化指令文件目录 |
.claude/commands/ | 自定义命令文件目录 |
.claude/skills/ | 技能文件目录 |
.claude/settings.json | 项目设置文件 |
~/.claude/settings.json | 用户设置文件 |
初学者易错点
- 混淆subagents和agent teams:subagents在单个会话中运行并只向父代理报告,而agent teams中的每个成员都是独立会话。
- 误解自动模式的安全性:自动模式使用分类器审查操作,但分类器从不看到工具结果,因此注入的指令无法影响其决策。
- 忽略上下文窗口限制:随着工作增加,上下文会填满,需要压缩,这可能导致某些信息丢失。
- 混淆CLAUDE.md和自动记忆:CLAUDE.md是你编写的持久指令,而自动记忆是Claude基于你的纠正和偏好为自己编写的笔记。
- 错误理解权限模式:权限模式控制整体批准行为,而权限规则提供更细粒度的控制。
相关词条
session会话管理tools工具参考memory记忆系统permissions权限控制hooks钩子系统skills技能系统