J'Blog

6 课 · 入门

语义检索

基于 Chroma 向量库,与 Workspace 知识库分离。用自然语言描述你想查的内容。 非管理员每人每天可检索 5 次(消耗站点 AI 配额)。

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如何执行操作。可用模式包括defaultacceptEditsplanautodontAskbypassPermissions

会话 (Session)

与你当前目录相关的对话,拥有独立的上下文窗口。可以恢复、分叉或并行运行。

自动记忆 (Auto memory)

Claude基于你的纠正和偏好为自己编写的笔记,存储在每个git仓库的~/.claude/projects/下。与CLAUDE.md相对应,后者是你编写的。

怎么做

理解要点

  1. 区分代理式编程与传统编程助手:Claude Code可以自主执行操作,而不仅仅是提供建议。
  2. 掌握上下文管理:了解上下文窗口如何工作,以及压缩如何影响会话历史。
  3. 熟悉配置层次结构:从托管设置到用户设置的配置优先级。
  4. 理解权限系统:权限模式控制整体行为,权限规则提供细粒度控制。
  5. 区分工具和技能:工具是单个操作,技能是多步工作流。

常用命令

  • /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用户设置文件

初学者易错点

  1. 混淆subagents和agent teams:subagents在单个会话中运行并只向父代理报告,而agent teams中的每个成员都是独立会话。
  2. 误解自动模式的安全性:自动模式使用分类器审查操作,但分类器从不看到工具结果,因此注入的指令无法影响其决策。
  3. 忽略上下文窗口限制:随着工作增加,上下文会填满,需要压缩,这可能导致某些信息丢失。
  4. 混淆CLAUDE.md和自动记忆:CLAUDE.md是你编写的持久指令,而自动记忆是Claude基于你的纠正和偏好为自己编写的笔记。
  5. 错误理解权限模式:权限模式控制整体批准行为,而权限规则提供更细粒度的控制。

相关词条

  • session 会话管理
  • tools 工具参考
  • memory 记忆系统
  • permissions 权限控制
  • hooks 钩子系统
  • skills 技能系统

官方原文:https://code.claude.com/docs/en/glossary