용어집 (Glossary)
기준일: 2026-07-26
공식 기준: Glossary
개요
Claude Code 문서와 UI에서 반복되는 용어를 알파벳순으로 정리합니다. 각 정의는 공식 용어집의 의미를 한국어로 옮긴 것입니다.
핵심 개념
| 영역 | 대표 용어 |
|---|---|
| 실행 모델 | Agentic loop, Turn, Session, Surface |
| 확장 | Plugin, Skill, Hook, MCP, Command |
| 안전 | Permission mode, Permission rule, Sandboxing, Project trust |
| 컨텍스트 | CLAUDE.md, Context window, Compaction, Auto memory |
상세
A
Agent teams
여러 Claude 에이전트가 공유 목표를 위해 조율·역할 분담하며 병렬 작업하는 기능. 팀메이트 페인, 권한, 메시지 교환이 포함됩니다. 자세한 내용: Agent teams.
Agentic coding
모델이 코드를 읽고 도구를 호출하며 결과를 바탕으로 다음 행동을 선택하는, 여러 턴에 걸친 자율적 코딩 작업 방식.
Agentic harness
에이전트가 안전하게 도구를 쓰고 권한·컨텍스트·루프를 유지하도록 감싸는 런타임과 정책 계층. Claude Code CLI·Desktop·SDK가 이에 해당합니다.
Agentic loop
관찰 → 계획 → 도구 사용 → 결과 반영을 반복하는 실행 루프. Claude Code 세션의 핵심 동작 모델입니다.
Artifact
세션에서 생성·검토하는 산출물(파일, 미리보기, 공유 가능한 결과). 플랜·표면에 따라 지원이 다릅니다. Artifacts.
Auto memory
대화에서 유용한 사실을 자동으로 저장·불러오는 메모리. /memory에서 폴더와 토글을 관리합니다. Memory.
Auto mode
승인 프롬프트를 줄이고 허용 정책 안에서 작업을 더 자율 진행하는 권한 모드. 공급자·모델 제한이 있을 수 있습니다. Auto mode.
B
Bare mode
커스터마이징(CLAUDE.md, skills, plugins, hooks, MCP 등)을 끈 최소 구성 세션. 설정 디버그에 사용됩니다. claude --safe-mode 참고.
Bundled skills
플러그인 패키지에 포함되어 설치 시 함께 제공되는 스킬 집합.
C
Channel
세션 알림이나 메시지를 외부 채널로 보내는 통합. Channels.
Checkpoint
대화와 파일 상태를 특정 시점으로 되돌릴 수 있게 하는 체크포인트. Checkpointing.
.claude directory
설정, 스킬, 로컬 상태, 플러그인 데이터 등이 위치하는 디렉터리 계층(~/.claude, 프로젝트 .claude 등). Claude directory.
CLAUDE.md
Claude에게 프로젝트 컨벤션·명령을 알려 주는 마크다운 지침 파일. 사용자·프로젝트·하위 디렉터리 계층으로 로드됩니다. Memory.
Command
/로 시작하는 슬래시 명령. 내장, 커스텀, 플러그인 제공 명령이 있습니다. Commands.
Compaction
컨텍스트가 커질 때 이력을 요약으로 줄여 창을 확보하는 과정. 수동 /compact 또는 자동. Context window.
Connector
claude.ai에 연결된 외부 도구 통합. Desktop·MCP 커넥터 등으로 워크플로에 데이터를 가져옵니다.
Context window
한 번의 모델 요청에 실을 수 있는 토큰 용량. 시스템 프롬프트, 도구, 메모리, 대화가 함께 사용합니다. Context window.
D
Dispatch
Desktop 등에서 세션을 트리거·시작하는 경로. 구독 플랜에 따라 가용성이 다릅니다.
E
Effort level
모델 추론 깊이를 조절하는 설정. 프롬프트 캐시 키에 포함되어 변경 시 캐시가 갈릴 수 있습니다. Model config.
Extended thinking
모델이 최종 답 전에 내부 사고 토큰을 더 사용하는 능력. 모델 기능이며 제공 모델에서 동작합니다.
H
Hook
도구 실행 전후, 알림, 세션 종료 등 라이프사이클 이벤트에 연결되는 명령·프롬프트·에이전트 훅. Hooks.
M
Managed settings
조직이 배포하는 관리 설정. 사용자/프로젝트 설정을 덮어쓰며 보안 정책을 강제합니다. Settings.
MCP (Model Context Protocol)
LLM에 도구와 컨텍스트를 연결하기 위한 프로토콜. MCP.
MCP server
MCP를 구현해 도구·리소스를 제공하는 로컬 또는 원격 서버.
MCP Tool Search
도구 수가 많을 때 전부 접두에 넣지 않고 검색·지연 로드하는 기능. 일부 공급자에서는 기본 비활성.
N
Non-interactive mode
대화 UI 없이 프롬프트를 실행하고 종료하는 모드(-p 등). 자동화·CI에 사용. Headless.
O
Output style
응답 스타일·형식을 바꾸는 설정. 종종 세션 시작 시 system prompt에 고정됩니다. Output styles.
P
Permission mode
파일 수정·명령 실행 전 승인 방식을 정하는 모드(Manual, Accept edits, Plan, Auto 등). Permission modes.
Permission rule
특정 도구·패턴을 allow, deny, ask로 제어하는 규칙. Permissions.
Plan mode
편집 전에 계획을 세우고 승인을 받는 모드. 대규모 변경 전에 유용. Plan mode.
Plugin
스킬, 에이전트, 훅, MCP 서버 등을 묶어 배포하는 확장. Plugins.
Project trust
프로젝트 디렉터리에 대한 신뢰 승인. 신뢰 전에는 일부 작업이 제한됩니다.
Prompt injection
콘텐츠에 숨긴 지시로 모델 행동을 조작하려는 시도. 권한 경계, hooks, 샌드박스로 완화합니다.
R
Remote Control
다른 표면에서 세션을 원격 제어·이어하기. Remote Control.
Rules
경로 조건 등이 있는 지침 규칙 파일. CLAUDE.md 계층과 함께 사용. Memory.
S
Sandboxing
Bash 등 실행을 격리해 파일시스템·네트워크 영향을 제한. Sandboxing.
Session
하나의 작업 대화 단위. 병렬 세션은 컨텍스트와 변경을 분리합니다. Sessions.
Settings layers
managed, user, project, local 등 설정이 병합되는 계층과 우선순위. Settings scopes.
Skill
반복 작업을 위한 재사용 지침 패키지(SKILL.md 등). Skills.
Subagent
메인 대화와 분리된 컨텍스트에서 하위 작업을 수행하는 에이전트. Sub-agents.
Surface
Claude Code가 동작하는 인터페이스 종류(CLI, Desktop, IDE, web, mobile, Slack, CI 등).
T
Teleport
웹과 로컬 터미널 등 표면 사이에서 세션을 이동. Teleport.
Tool
모델이 호출하는 개별 기능(Read, Edit, Bash, MCP 도구 등). Tools reference.
Turn
사용자 입력과 이어지는 모델·도구 활동의 한 사이클.
V
Verification loop
변경 후 테스트·검증을 반복해 수정이 올바른지 확인하는 작업 패턴.
W
Worktree isolation
An isolation mode that runs Claude in a separate git worktree under .claude/worktrees/, enabled with the -w flag or isolation: worktree in subagent config. Changes stay on a separate branch in a separate directory, so parallel agents don't overwrite each other's files.
Learn more: Run parallel sessions with git worktrees
Deprecated and renamed terms
These terms appear in older docs, blog posts, and community content. Use the current name when searching this site.
| Old term | Now called | Notes |
|---|---|---|
| Headless mode | Non-interactive mode | Same -p flag, same behavior |
| Custom commands | Skills | .claude/commands/ files still work |
| Slash commands | Commands | "Slash" dropped from product copy |
(공식 원문 용어 정의. 상세는 관련 공식 문서를 함께 참고.)
체크리스트
- 권한·훅·MCP 용어를 설정 문서와 짝지어 이해했다
- Session / Surface / Teleport 차이를 구분했다
- Compaction과 Checkpoint(/rewind) 목적을 혼동하지 않는다
다음 단계
기준일
- 문서 작성·동기화 기준일: 2026-07-26
- 원문: https://code.claude.com/docs/en/glossary