클로드코드 10-glossary

1. 용어집 (Glossary)

참고: Claude Code 핵심 용어 정의

1.1. A

1.1.1. Agent team

리드 에이전트가 조율하고 공유 작업 목록과 피어 투 피어 메시징을 가진 여러 독립 Claude Code 세션. Subagent와 달리 각 팀원은 자신의 컨텍스트 윈도우를 가지며 사용자가 직접 상호작용할 수 있다.

1.1.2. Agentic coding

AI가 파일을 읽고, 명령어를 실행하고, 자율적으로 변경을 수행하는 워크플로우. Claude Code는 행동할 수 있는 도구를 가지므로 에이전틱하다.

1.1.3. Agentic harness

언어 모델을 유능한 코딩 에이전트로 전환하는 도구, 컨텍스트 관리, 실행 환경. Claude Code가 harness이고 Claude는 그 안의 모델이다.

1.1.4. Agentic loop

Claude가 작업을 위해 반복하는 사이클: 컨텍스트 수집 → 행동 수행 → 결과 검증 → 반복. 확장 지점(hooks, skills, MCP)은 이 루프의 특정 단계에 연결된다.

1.1.5. Auto memory

Claude가 사용자의 교정과 선호도를 기반으로 스스로 작성한 노트. ~/.claude/projects/ 아래 git 저장소별로 저장. 처음 200줄 또는 25KB가 각 세션 시작 시 로드된다.

1.1.6. Auto mode

별도의 분류기 모델이 각 행동을 백그라운드에서 검토하는 권한 모드. 분류기는 도구 결과를 볼 수 없으므로 injected text가 결정에 영향을 줄 수 없다. Max, Team, Enterprise, API 플랜에서 연구 프리뷰로 제공.

1.2. B

1.2.1. Bare mode

--bare 플래그로 hooks, skills, plugins, MCP 서버, auto memory, CLAUDE.md의 자동 검색을 건너뛰는 시작 모드. CI와 스크립트 호출에 권장.

1.2.2. Bundled skills

/batch, /simplify, /debug, /loop 등 Claude Code에 포함된 프롬프트 기반 플레이북.

1.3. C

1.3.1. Channel

실행 중인 세션에 이벤트를 푸시하는 MCP 서버. Telegram, Discord, iMessage 등이 연구 프리뷰로 포함.

1.3.2. Checkpoint

각 프롬프트마다 생성되는 복원 지점. 편집 전 파일 스냅샷을 만들어 Esc 두 번 또는 /rewind로 되돌릴 수 있다.

1.3.3. .claude directory

Claude Code가 프로젝트 범위 설정을 읽는 디렉토리. settings, hooks, skills, subagents, rules, auto memory를 포함. 프로젝트는 ./.claude/, 사용자 기본값은 ~/.claude/.

1.3.4. CLAUDE.md

Claude에게 지속적인 지시사항을 제공하는 마크다운 파일. 프로젝트 규칙, 아키텍처 노트, "항상 X를 수행" 규칙을 담는다. compaction 후에도 재로드된다.

1.3.5. Command

/name으로 호출하는 재사용 가능한 지시사항. /clear, /model, /compact 등 내장 명령어와 사용자 정의 명령어가 있다.

1.3.6. Compaction

컨텍스트 윈도우가 한도에 가까워질 때의 자동 요약. 오래된 도구 출력을 먼저 지운 뒤 대화를 요약. 프로젝트 루트 CLAUDE.md와 auto memory는 compaction 후에도 생존.

1.3.7. Context window

세션의 작업 메모리. 대화 기록, 파일 내용, 명령어 출력, CLAUDE.md, auto memory, skills, 시스템 지시사항을 담는다.

1.4. D

1.4.1. Dispatch

Claude 모바일 앱에서 코딩 작업을 보내면 Desktop 앱에서 Claude Code 세션을 생성하는 전화 발신 작업 라우터. Pro와 Max 플랜에서 사용 가능.

1.5. E

1.5.1. Effort level

Claude가 각 턴에서 사용하는 적응형 추론 예산을 제어하는 설정. 높을수록 더 많은 thinking token과 깊은 추론. Opus 4.7, Opus 4.6, Sonnet 4.6에서 지원.

1.5.2. Extended thinking

모델이 응답 전에 수행하는 단계별 추론. 터미널에서 회색 이탤릭체로 표시. MAX_THINKING_TOKENS로 캡하거나 effort level로 조정.

1.6. H

1.6.1. Hook

Claude Code 생명주기의 특정 시점에 자동으로 실행되는 사용자 정의 핸들러. 셸 명령어, HTTP 엔드포인트, MCP 도구, LLM 프롬프트, subagent가 될 수 있다.

- Hook event: 생명주기 시점
- Matcher: 어떤 이벤트에서 실행될지 필터링
- Hook handler: 실행할 내용

1.7. M

1.7.1. Managed settings

IT 또는 DevOps가 OS 수준 경로에 배포하는 조직 전체 설정 파일. 사용자가 재정의하거나 제외할 수 없다.

1.7.2. MCP (Model Context Protocol)

AI 도구를 외부 데이터 소스와 서비스에 연결하는 개방형 표준. Slack, Jira, 데이터베이스, 브라우저 등 수백 가지 통합을 제공.

1.7.3. MCP Tool Search

MCP 도구 스키마를 필요할 때까지 지연하는 컨텍스트 절약 메커니즘. 시작 시 도구 이름만 로드하고, Claude가 특정 도구를 사용하기로 결정할 때 전체 스키마를 가져온다.

1.8. N

1.8.1. Non-interactive mode

-p 또는 --print로 실행하는 단일 프롬프트 실행 후 종료 모드. CI, 스크립트, 파이프에 사용.

1.9. O

1.9.1. Output style

Claude의 시스템 프롬프트를 수정해 응답 행동, 톤, 형식을 변경하는 설정. Default, Proactive, Explanatory, Learning 등 내장 style이 있다.

1.10. P

1.10.1. Permission mode

세션의 기본 승인 동작. Shift+Tab으로 전환. default, acceptEdits, plan, auto, dontAsk, bypassPermissions가 있다.

1.10.2. Permission rule

도구 이름과 인자 패턴에 따라 도구 호출을 허용, 질문, 거부하는 설정 항목. deny → ask → allow 순서로 평가.

1.10.3. Plan mode

Claude가 소스 파일을 편집하지 않고 탐색하고 변경을 제안하는 권한 모드. /plan 또는 Shift+Tab으로 진입.

1.10.4. Plugin

skills, hooks, subagents, MCP 서버를 단일 설치 가능 단위로 묶은 것. plugin-name:skill-name 형태로 네임스페이싱.

1.10.5. Project trust

Claude Code가 설정을 로드하기 전 디렉토리를 한 번 수락하는 대화상자. .claude/settings.json, .mcp.json 등의 효력을 발휘하게 한다.

1.10.6. Prompt injection

파일, 웹 페이지, 도구 결과에 삽입된 적대적 지시사항. Claude Code의 방어: permission 시스템, 명령어 블랙리스트, trust 검증, auto mode의 서버측 프로브.

1.11. R

1.11.1. Remote Control

휴대폰이나 브라우저를 통해 claude.ai로 로컬 Claude Code 세션을 이어가는 방법. 코드는 로컬에 남고 UI만 원격이다.

1.11.2. Rule

.claude/rules/의 모듈식 지시사항 파일. YAML paths: frontmatter로 파일 유형 또는 하위 디렉토리에 범위를 제한할 수 있다.

1.12. S

1.12.1. Sandboxing

Bash tool에 대한 OS 수준 파일시스템 및 네트워크 격리. 미리 정의된 경계 내에서 Claude가 더 자유롭게 작업할 수 있게 한다.

1.12.2. Session

현재 디렉토리에 묶인 독립적인 컨텍스트 윈도우를 가진 대화. claude -c로 재개, --fork-session으로 분기, /clear로 새 세션 시작.

1.12.3. Settings layers

높은 우선순위 → 낮은 우선순위: managed policy → CLI 인자 → local settings → project settings → user settings.

1.12.4. Skill

Claude의 도구킷에 추가되는 지시사항, 지식, 워크플로우를 담은 SKILL.md 파일. /skill-name으로 호출하거나 Claude가 자동으로 로드.

1.12.5. Subagent

자체 컨텍스트 윈도우, 커스텀 시스템 프롬프트, 특정 도구 접근, 독립적 권한을 가진 전문화된 AI 어시스턴트. 위임된 작업을 수행하고 요약을 메인 대화로 반환.

1.12.6. Surface

Claude Code에 접근할 수 있는 모든 곳: CLI, VS Code, JetBrains, Desktop, claude.ai.

1.13. T

1.13.1. Teleport

/teleport 명령어로 클라우드 Claude Code 세션을 로컬 터미널로 가져온다. 반대 방향은 --remote로 로컬 작업을 웹에서 실행.

1.13.2. Tool

Claude가 수행할 수 있는 행동: 파일 읽기, 코드 편집, 셸 명령어 실행, 웹 검색, subagent 생성.

1.13.3. Turn

세션 내 Claude의 하나의 완전한 응답. 사용자가 메시지를 보내면 시작하여 Claude가 응답을 마칠 때 끝난다.

1.14. W

1.14.1. Worktree isolation

-w 플래그나 subagent 설정의 isolation: worktree로 활성화. 별도의 git worktree에서 Claude를 실행해 병렬 에이전트가 서로의 파일을 덮어쓰지 않게 한다.