📚 용어 사전
Claude Code와 AI 개발 생태계에서 자주 등장하는 용어를 정리합니다.
A
Agent (에이전트)
특정 목표를 달성하기 위해 자율적으로 행동하는 AI 시스템. 단순히 질문에 답하는 것을 넘어, 도구를 사용하고 여러 단계를 거쳐 작업을 완료합니다. Claude Code 자체가 에이전트이며, Agent SDK로 커스텀 에이전트를 만들 수 있습니다.
Agent SDK
Claude Code를 프로그래밍 방식으로 실행하는 도구. CLI(claude -p), Python SDK, TypeScript SDK 세 가지 방식을 제공합니다. Claude Code의 에이전틱 루프를 활용하여 자동화 파이프라인을 구축합니다.
Agent Team (에이전트 팀)
여러 Claude Code 인스턴스가 동시에 협력하여 작업하는 실험적 기능. --teammate-mode로 표시 방식을 설정하고, TeammateIdle 훅으로 유휴 상태를 감지합니다.
Agentic Loop (에이전틱 루프)
에이전트가 도구를 호출하고 결과를 받아 다음 행동을 결정하는 반복 사이클. maxTurns로 최대 반복 횟수를 제어합니다.
allowedTools
Agent SDK query() 옵션 중 하나. 에이전트가 사용할 수 있는 도구 목록을 배열로 지정합니다. (예: ["Read", "Write", "Bash"])
Anthropic
Claude를 개발한 AI 안전 연구 회사. Claude Code, Claude API, Claude.ai 등의 제품을 제공합니다.
Auto memory (자동 메모리)
Claude가 사용자의 정정·선호를 보고 자기 자신을 위해 저장하는 메모. git 저장소별로 ~/.claude/projects/ 아래 저장됩니다. 같은 저장소의 모든 worktree가 한 디렉토리를 공유. MEMORY.md 인덱스의 첫 200줄(또는 25KB)이 매 세션 시작 시 자동 로드됩니다. CLAUDE.md(사용자가 작성)의 Claude 작성 카운터파트.
B
Bash (도구)
Claude Code가 셸 명령어를 실행할 수 있게 해주는 내장 도구. npm test, git log 등 터미널 명령어를 Claude가 직접 실행할 때 사용합니다.
Bare mode (베어 모드)
--bare 시작 플래그. hooks·skills·plugins·MCP 서버·auto memory·CLAUDE.md 자동 발견을 건너뛰고, 명시 플래그만 적용. CI·스크립트 호출에서 머신마다 동작이 달라지지 않도록 동일 동작을 보장할 때 권장.
budget_tokens
Extended Thinking에서 Claude가 내부 사고(thinking)에 사용할 수 있는 최대 토큰 수. 높을수록 더 깊이 생각하지만 비용도 증가합니다.
C
Channel (채널)
Claude가 자리 비운 사이에 발생한 이벤트를 진행 중인 세션으로 푸시하는 MCP 서버 종류. 인박스로 들어온 이벤트를 Claude가 읽고 같은 채널로 응답하는 양방향도 가능. Telegram·Discord·iMessage가 research preview에 포함됨.
Checkpoint (체크포인트)
보낸 prompt마다 자동 생성되는 복원 지점. Claude Code가 매 edit 직전에 파일 스냅샷을 저장하므로 checkpoint로 되돌릴 수 있음. Esc 두 번 또는 /rewind로 코드·대화·둘 다 이전 시점으로 복원, 또는 선택한 메시지부터 대화 요약 가능. session-local이고 git과 별개. Bash 도구로 만든 변경은 추적 X.
CLAUDE.md
Claude Code가 프로젝트 시작 시 자동으로 읽는 설정 파일. 프로젝트 규칙, 코딩 컨벤션, 자주 쓰는 명령어, 현재 진행 상황 등을 기록해 Claude에게 컨텍스트를 제공합니다.
Claude Code
Anthropic이 개발한 터미널 기반 AI 코딩 어시스턴트. 파일 읽기/쓰기, 셸 명령어 실행, Git 작업 등을 자율적으로 수행합니다.
Context Window (컨텍스트 윈도우)
모델이 한 번에 처리할 수 있는 최대 토큰 수. 대화 히스토리, 파일 내용, 시스템 프롬프트 모두 포함됩니다. 초과하면 오래된 내용부터 잘립니다.
/compact
컨텍스트 윈도우가 가득 찰 때 사용하는 슬래시 커맨드. 현재까지의 대화를 요약해 컨텍스트를 압축합니다. 자동 압축은 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 환경변수로 트리거 임계값을 조절합니다 (기본 ~95%).
Compaction (컴팩션)
컨텍스트 윈도우가 한도에 가까워질 때 자동으로 대화를 요약하는 동작. 오래된 도구 출력이 먼저 정리되고, 그 다음 대화 본문이 요약됩니다. project-root CLAUDE.md와 auto memory는 compaction을 살아남아 자동 재로드되지만, 대화에서만 준 지시는 잃을 수 있음. 수동 호출 = /compact, 포커스 지정 = /compact focus on the API changes.
D
Desktop App
Claude Code를 터미널이 아닌 데스크톱 애플리케이션에서 실행하는 방식. 대화 중 /desktop 커맨드로 현재 세션을 데스크톱 앱으로 이동할 수 있습니다. macOS와 Windows에서 지원합니다.
Dispatch (디스패치)
폰에서 코딩 task를 보내면 Desktop 앱에서 Claude Code 세션을 자동 생성하는 phone-initiated task router. Claude 모바일 앱에서 prompt 보내면 본인 머신 Desktop 앱이 받아 작업 수행. Pro·Max 플랜 지원.
E
Escalation (에스컬레이션)
에이전트가 처리 불가 또는 고위험 상황을 감지해 사람의 개입이나 상위 시스템에 알리는 프로세스. 기업 AI 팀 설계에서 중요한 안전 메커니즘입니다.
Edit (도구)
파일의 특정 부분을 수정하는 Claude Code 내장 도구. 전체 파일을 덮어쓰는 Write와 달리, 정확한 문자열 매칭으로 부분 수정을 수행합니다.
Effort Level
Claude Code에서 adaptive reasoning(태스크 복잡도에 따른 동적 추론)의 깊이를 제어하는 설정. Fable 5·Opus 4.8·4.7은 low·medium·high·xhigh·max 5단계, Opus 4.6·Sonnet 4.6은 low·medium·high·max를 지원합니다. /effort 슬라이더, /model 메뉴, 또는 CLAUDE_CODE_EFFORT_LEVEL 환경변수로 조절합니다. 기본값은 Fable 5·Opus 4.8 = high, Opus 4.7 = xhigh. 별도로 ultracode는 effort 수준이 아니라 xhigh + 동적 워크플로우 조율을 묶은 Claude Code 설정입니다.
Extended Thinking (확장 사고)
Claude가 응답 전에 내부 추론 과정을 별도 토큰으로 수행하는 기능. Claude Code에서는 Effort Level로 제어합니다. API 직접 사용 시에는 thinking.budget_tokens로 사고 예산을 지정합니다. 단 Fable 5는 adaptive thinking 전용이라 thinking을 끌 수 없고(thinking: disabled 미지원), raw 사고 과정도 반환되지 않습니다.
F
Fast Mode
Claude Code에서 /fast로 토글하는 고속 모드. 같은 Opus 모델을 더 빠르게 사용하며, 별도 과금됩니다. Opus 4.8에서는 fast mode 단가가 더 낮아졌습니다. Opus 전용이라 Fable 5는 지원하지 않으며, 다른 모델에서 켜면 Opus로 자동 전환됩니다. 라이브 디버깅, 빠른 반복 작업에 적합합니다.
Few-shot Prompting
모델에게 예시(예시 입력 + 예시 출력)를 함께 제공해 원하는 출력 형식을 유도하는 프롬프트 기법.
G
Glob (도구)
파일 패턴 매칭으로 파일을 검색하는 Claude Code 내장 도구. **/*.ts 같은 와일드카드 패턴을 지원합니다.
Grep (도구)
파일 내용을 정규식으로 검색하는 Claude Code 내장 도구. 코드베이스에서 특정 함수나 패턴을 찾을 때 사용합니다.
H
Headless 모드 → Non-interactive 모드 (rename)
공식 문서가 "Non-interactive mode"로 이름 변경. UI 없이 Claude Code를 프로그래밍 방식으로 실행하는 모드. CI/CD 파이프라인이나 자동화 스크립트에서 주로 사용합니다. claude -p "프롬프트" 또는 --print 플래그로 실행. 동작·플래그는 동일.
Hooks (훅)
특정 이벤트(도구 실행 전/후, 응답 완료 등) 발생 시 자동으로 실행되는 핸들러. 셸 커맨드, HTTP 엔드포인트, LLM 프롬프트, MCP 도구 4가지 타입을 지원합니다. 총 18개 이벤트가 있으며, 알림, 로깅, 자동 검증, 권한 제어 등에 활용합니다.
M
maxTurns
Agent SDK query() 옵션. 에이전틱 루프의 최대 반복 횟수를 제한합니다. 무한 루프 방지와 비용 제어에 중요합니다.
MCP (Model Context Protocol)
Anthropic이 주도하는 오픈 표준 프로토콜. 외부 시스템(데이터베이스, API, 파일 시스템 등)을 표준화된 방식으로 AI 모델에 연결합니다.
MCP 서버
MCP 프로토콜을 구현한 서버. Slack, GitHub, Notion 등 다양한 서비스의 MCP 서버를 설치해 Claude Code가 직접 연동하도록 할 수 있습니다.
MCP Tool Search
MCP 도구 schema를 필요할 때까지 미루는 context 절약 메커니즘. 시작 시 tool 이름만 로드, 실제 사용 결정 시 Claude가 full schema를 가져옴. 사용 안 하는 MCP 서버가 context를 크게 차지하지 않도록 함.
Multi-agent (멀티에이전트)
여러 에이전트가 협력해 하나의 복잡한 작업을 수행하는 아키텍처. 오케스트레이터가 작업을 분배하고, 전문 에이전트들이 각자의 역할을 담당합니다.
Mythos-class (미토스 클래스)
Opus 위에 위치하는 Claude 모델 티어. 일반 공개 모델은 Fable 5(2026년 6월 출시, Claude Code v2.1.170+)이고, safeguard를 일부 해제한 Mythos 5는 Project Glasswing 파트너 한정입니다. Fable 5는 사이버보안·생물/화학 관련 요청을 안전 분류기가 감지하면 해당 요청을 Opus가 대신 처리하고 transcript에 알림을 표시합니다 — 이후 세션은 그 Opus 모델로 유지되며, Fable 5로 돌아가려면 /model fable을 직접 실행해야 합니다(/config에서 자동 전환 토글 가능).
O
Output Style (출력 스타일)
Claude Code의 응답 스타일을 변경하는 설정. Default(기본), Explanatory(구현 선택과 코드베이스 패턴에 대한 설명 추가), Learning(직접 코드를 작성해보는 실습 모드) 3가지가 있으며, /output-style로 전환합니다.
Orchestrator (오케스트레이터)
멀티에이전트 시스템에서 작업을 분석하고 적절한 에이전트에게 배분하는 상위 에이전트. 이 가이드의 캡스톤에서 CEO 에이전트가 오케스트레이터 역할을 합니다.
P
Permission Mode (권한 모드)
Claude Code가 파일 수정, 명령어 실행 등 각 작업을 수행할 때 사용자 승인을 요구하는 수준을 설정합니다. Default, Auto-accept Edits, Plan, Bypass Permissions 4가지가 있으며, Shift+Tab으로 전환합니다. 최신 공식 문서 기준 추가 모드: dontAsk, auto (Auto mode, Max·Team·Enterprise·API).
Plan mode (플랜 모드)
Claude가 source 파일 수정 없이 변경안을 조사·제안하는 permission mode. 읽기·검색·탐색 명령은 실행하고, 승인 받기 전까지 source 건드리지 않음. /plan 또는 Shift+Tab으로 진입.
Plugin (플러그인)
Claude Code의 기능을 확장하는 패키지. Skills, Agents, Hooks, MCP 서버를 포함할 수 있으며, 마켓플레이스를 통해 공유/배포합니다. .claude-plugin/plugin.json 매니페스트로 정의합니다.
Prompt Caching (프롬프트 캐싱)
반복적으로 사용되는 긴 시스템 프롬프트나 문서를 Anthropic 서버에 캐싱해 비용과 지연시간을 줄이는 기능. cache_control: { type: "ephemeral" } 마커로 설정합니다.
Q
query()
Agent SDK의 핵심 함수. Claude에게 작업을 요청하고 에이전틱 루프를 실행한 후 결과를 반환합니다.
R
RAG (Retrieval-Augmented Generation)
외부 데이터베이스에서 관련 정보를 검색해 모델의 응답에 추가하는 기법. 모델의 지식 한계를 보완하고 최신 정보를 활용할 수 있습니다.
Rate Limit (레이트 리밋)
API 요청 빈도 제한. 분당/시간당 허용 요청 수를 초과하면 429 오류가 발생합니다. 멀티에이전트 구현 시 큐잉 로직이 필요합니다.
Read (도구)
파일 내용을 읽는 Claude Code 내장 도구. 코드 분석, 문서 확인 등에 사용합니다.
S
Sandbox (샌드박스)
Claude Code의 파일 시스템 접근을 격리하는 보안 기능. /sandbox로 토글하며, 지원 플랫폼에서만 사용 가능합니다.
Skill (스킬)
지시·지식·워크플로우를 담은 SKILL.md 파일. Claude가 관련 시점에 자동 로드하거나, 사용자가 /skill-name으로 직접 호출. Agent Skills open standard를 따르며, Claude Code는 호출 제어·subagent 실행으로 확장. Custom commands(.claude/commands/deploy.md)의 권장 후속이며, .claude/skills/deploy/SKILL.md와 둘 다 /deploy로 작동. 기존 commands/ 파일도 계속 사용 가능.
Streaming (스트리밍)
응답을 한 번에 받지 않고 생성되는 대로 실시간으로 받는 방식. 긴 응답을 기다리지 않고 즉시 화면에 표시할 때 유용합니다.
Subagent (서브에이전트)
오케스트레이터의 지시를 받아 특정 작업을 수행하는 하위 에이전트. 멀티에이전트 아키텍처의 실행 단위입니다.
System Prompt (시스템 프롬프트)
모델의 역할, 행동 방식, 제약 조건을 정의하는 사전 지시문. 대화 시작 전에 설정되며 전체 대화에 걸쳐 적용됩니다.
T
Token (토큰)
AI 모델이 텍스트를 처리하는 기본 단위. 한국어는 영어보다 토큰 효율이 낮아 같은 내용도 더 많은 토큰을 소비합니다. API 요금은 토큰 수 기준으로 부과됩니다.
Tool Use (도구 사용)
Claude가 외부 도구(함수)를 호출해 정보를 얻거나 작업을 수행하는 기능. Claude API에서는 tools 파라미터로 정의합니다.
W
Worktree (워크트리)
Git worktree를 활용해 Claude Code를 격리된 브랜치에서 실행하는 기능. claude -w feature-auth처럼 사용하며, 병렬 Claude Code 세션을 동시에 실행할 때 유용합니다.
Write (도구)
파일을 생성하거나 덮어쓰는 Claude Code 내장 도구. 새 파일 생성, 기존 파일 전체 교체에 사용합니다. 부분 수정은 Edit 도구를 사용합니다.