본문으로 건너뛰기

용어 사전

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 도구 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에서 자동 전환 토글 가능). 2026-06-12 미국 정부 수출통제 지시로 전 고객 접근이 일시 중단됐다가, 2026-07-01부로 복구됐습니다(공식 안내: anthropic.com/news/redeploying-fable-5). Pro·Max·Team·일부 Enterprise 플랜은 7월 7일까지 주간 사용 한도의 최대 50% 범위에서 구독에 포함되며, 이후 usage credits로 전환됩니다.

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 도구를 사용합니다.

이 챕터를 완료하셨나요?

학습 진도를 체크하여 나의 로드맵 달성률을 높여보세요.