# Claude Code 术语表

> Claude Code 常见术语的中文解释:agentic loop、CLAUDE.md、MCP、Hooks、Skills、Subagent、Channel、ZDR、Worktree 和缓存。

URL: https://docs.passion8.cc/docs/claude-code/glossary
Language: zh-CN
Publisher: Passion8

这页把 Claude Code 官方术语翻成接入 Passion8 时更容易判断的中文口径。遇到英文命令或配置名,仍保留原文,方便搜索官方文档和 CLI help。

## A

### Agent Teams

多个 Claude Code session 作为 teammate 协作。每个 teammate 有自己的上下文和工具权限,可以认领任务、互相发消息。适合复杂 review 或大任务协作,成本高于单个 subagent。

### Agentic coding

Claude 不只是补全代码,而是读文件、计划、编辑、运行测试、根据结果继续迭代。风险也更大,所以要配权限、Hooks、沙箱和验证命令。

### Agentic loop

模型请求、工具调用、观察结果、继续推理的循环。Claude Code 的“自己推进任务”来自这个 loop。

### Artifact

Claude Code 生成并发布的交互页面。官方 Artifacts 依赖 Anthropic 云端存储。使用 Passion8 或严格数据边界时,可以改用本地静态页面或你自己的部署。

### Auto memory

Claude 自动积累项目经验的机制。它能减少重复解释,但也可能把过时经验带进上下文,需要定期审查。

### Auto mode

官方权限模式,根据规则和上下文自动决定能否执行。企业应配合 managed settings、deny rules 和 Hooks,不要只靠模型判断。

## B

### Bare mode

非交互输出的简洁模式,常和 `claude -p`、脚本或 CI 搭配。

### Bundled skills

Claude Code 内置的工作流能力,例如 review、batch、deep research 等。它们可能启动 subagent 或云端 session,缓存和成本要按实际执行位置判断。

## C

### Channel

MCP server 主动把外部事件推入运行中的 Claude Code session。常见来源包括 CI、聊天工具、监控告警和 webhook。

### Checkpoint

Claude Code 保存的会话或文件变更点。`/rewind` 可以回退对话和文件状态。它不是 Git 的替代品。

### `.claude` directory

项目或用户级 Claude Code 配置目录。可包含 settings、hooks、skills、agents、commands、rules、workflows 等。

### CLAUDE.md

项目说明和长期规则文件。它影响 Claude 如何理解仓库,但不能当安全边界。真正的禁止读取或禁止执行要用 permissions、Hooks 或沙箱。

### Command

Claude Code 里包括 CLI 命令、启动 flag、交互命令和 bundled skill。官方文案逐步淡化“slash command”这个说法,但很多命令仍以 `/` 输入。

### Compaction

把长会话压缩成摘要,释放上下文。`/compact` 的摘要请求通常能读旧缓存,但摘要完成后新历史会重建缓存。

### Context window

模型一次请求能处理的上下文窗口。Claude Code 会把系统提示、规则、工具结果、会话历史和新输入放进窗口。

## D

### Dispatch

把任务派发给新的 session、后台 agent、web session 或 teammate。要明确运行位置和权限。

## E

### Effort level

模型思考强度。`/effort` 或 `--effort` 会影响质量、速度、成本,也会进入 cache key。中途切换通常会造成下一轮 cache miss。

### Extended thinking

更深的推理预算。适合规划、复杂 bug 和架构审查,不适合每个小任务都开高档。

## H

### Hook

Claude Code 生命周期里的自动化脚本或 HTTP 调用。常用于拦截危险命令、格式化文件、运行检查、发送通知和审计工具调用。

## M

### Managed settings

组织集中下发的 Claude Code 设置。适合企业统一代理、权限、MCP allowlist、channel 开关和安全策略。

### MCP

Model Context Protocol。Claude Code 通过 MCP 连接外部工具、数据库、浏览器、Git 平台和内部服务。

### MCP Tool Search

工具很多时,Claude 不把全部工具定义塞进 system prompt,而是按需搜索和加载。它对大 MCP 集合和 prompt cache 都更友好。

## N

### Non-interactive mode

用 `claude -p` 跑一次性 prompt 或脚本。官方也会把旧的 headless mode 叫法归到这个概念。

## O

### Output style

控制 Claude 回复风格和任务姿态。切 output style 会改变系统提示形状,可能影响缓存。

## P

### Permission mode

控制 Claude 是否需要询问才能读写文件、运行命令或调用工具。常见有 default、plan、acceptEdits、auto、dontAsk、bypassPermissions。

### Permission rule

allow、ask、deny 规则。比 CLAUDE.md 更接近真正的安全边界。

### Plan mode

先规划、等确认后再执行的模式。适合高风险改动、迁移、发布和大范围重构。

### Plugin

扩展 Claude Code 的包,可包含 skills、agents、hooks、MCP server、commands 和 marketplace 信息。

### Prompt caching

Provider 侧复用相同 prompt 前缀的机制。5 分钟和 1 小时 TTL 只是缓存窗口,不是数据保留周期。

### Prompt injection

外部网页、issue、日志或文件里的恶意指令试图覆盖你的真实目标。需要权限、Hooks、MCP 输出过滤和任务提示共同防护。

## R

### Remote Control

从网页或手机继续控制本地 Claude Code session。模型请求仍由本机会话配置决定,但配对和远程入口可能依赖官方账号。

### Rules

项目或目录级规则。用于约束 Claude 的行为和上下文加载,但仍要和 permissions 配合。

## S

### Sandboxing

隔离文件系统、网络、进程或凭据。可用 Bash sandbox、Sandbox runtime、Dev Container、Docker、VM 或 CI runner。

### Session

一次 Claude Code 会话,包含 conversation、工具结果、状态和可恢复信息。背景 session、web session、teammate session 都要单独看缓存和权限。

### Settings layers

Claude Code 设置有用户级、项目级、本地覆盖、managed settings 等层级。排查时先看实际加载结果。

### Skill

可复用的任务能力和说明。可以是官方 bundled skill,也可以是团队自定义 skill。

### Subagent

当前会话派出去的专门 agent。它有独立上下文和缓存,结果再回到主会话。

### Surface

Claude Code 的运行表面,例如 CLI、IDE、Desktop、Web、Slack、CI。不同 surface 的数据、缓存和权限边界不同。

## T

### Teleport

把云端或 web session 拉回本地终端继续。拉回后要重新判断本地 provider、模型、effort、工具和缓存。

### Tool

Claude 可以调用的能力,例如 Read、Edit、Bash、Grep、Agent、MCP 工具。工具结果会进入上下文。

### Turn

一次用户输入到 Claude 回复完成的交互。每个 turn 可能包含多次模型请求和工具调用。

## V

### Verification loop

实现后运行测试、lint、typecheck、curl、截图或业务验证,再根据结果修复。Claude Code 质量很大程度取决于验证 loop 是否具体。

## W

### Worktree isolation

用 Git worktree 或 Claude Code `--worktree` 把并行任务的文件系统隔开。适合 background sessions、batch、subagent 和大迁移。

## Z

### ZDR

Zero Data Retention。面向符合条件 Enterprise 组织的数据保留模式。它不覆盖本地 transcript、第三方 MCP、CI 日志或 Passion8 网关日志。

## 旧称和新称

| 旧称 | 现在更常见的说法 | 说明 |
| --- | --- | --- |
| Headless mode | Non-interactive mode | 仍主要使用 `claude -p` |
| Custom commands | Skills | `.claude/commands/` 仍兼容 |
| Slash commands | Commands | 很多交互命令仍以 `/` 输入 |

## 官方参考

- [Glossary](https://code.claude.com/docs/en/glossary.md)
- [Commands](https://code.claude.com/docs/en/commands.md)
- [How Claude Code works](https://code.claude.com/docs/en/how-claude-code-works.md)
- [Prompt caching](https://code.claude.com/docs/en/prompt-caching.md)

## 相关页面



- [命令大全](https://docs.passion8.cc/docs/claude-code/commands): CLI、交互命令、后台 agent、review、权限模式和快捷键。
- [Prompt 缓存](https://docs.passion8.cc/docs/claude-code/prompt-caching): 5 分钟与 1 小时 TTL、缓存失效和网关字段。
- [配置调试与 .claude 目录](https://docs.passion8.cc/docs/claude-code/configuration-debugging): 排查 settings、CLAUDE.md、Hooks、MCP、Skills 和本地数据。