📚 용어 사전
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 등의 제품을 제공합니다.
B
Bash (도구)
Claude Code가 셸 명령어를 실행할 수 있게 해주는 내장 도구. npm test, git log 등 터미널 명령어를 Claude가 직접 실행할 때 사용합니다.
budget_tokens
Extended Thinking에서 Claude가 내부 사고(thinking)에 사용할 수 있는 최대 토큰 수. 높을수록 더 깊이 생각하지만 비용도 증가합니다.
C
CLAUDE.md
Claude Code가 프로젝트 시작 시 자동으로 읽는 설정 파일. 프로젝트 규칙, 코딩 컨벤션, 자주 쓰는 명령어, 현재 진행 상황 등을 기록해 Claude에게 컨텍스트를 제공합니다.
Claude Code
Anthropic이 개발한 터미널 기반 AI 코딩 어시스턴트. 파일 읽기/쓰기, 셸 명령어 실행, Git 작업 등을 자율적으로 수행합니다.
Context Window (컨텍스트 윈도우)
모델이 한 번에 처리할 수 있는 최대 토큰 수. 대화 히스토리, 파일 내용, 시스템 프롬프트 모두 포함됩니다. 초과하면 오래된 내용부터 잘립니다.
/compact
컨텍스트 윈도우가 가득 찰 때 사용하는 슬래시 커맨드. 현재까지의 대화를 요약해 컨텍스트를 압축합니다. 자동 압축은 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE 환경변수로 트리거 임계값을 조절합니다 (기본 ~95%).
D
Desktop App
Claude Code를 터미널이 아닌 데스크톱 애플리케이션에서 실행하는 방식. 대화 중 /desktop 커맨드로 현재 세션을 데스크톱 앱으로 이동할 수 있습니다. macOS와 Windows에서 지원합니다.
E
Escalation (에스컬레이션)
에이전트가 처리 불가 또는 고위험 상황을 감지해 사람의 개입이나 상위 시스템에 알리는 프로세스. 기업 AI 팀 설계에서 중요한 안전 메커니즘입니다.
Edit (도구)
파일의 특정 부분을 수정하는 Claude Code 내장 도구. 전체 파일을 덮어쓰는 Write와 달리, 정확한 문자열 매칭으로 부분 수정을 수행합니다.
Effort Level
Claude Code에서 Extended Thinking의 깊이를 제어하는 설정. low, medium, high 3단계로, /model 슬라이더나 CLAUDE_CODE_EFFORT_LEVEL 환경변수로 조절합니다. Opus 4.6은 Max/Team에서 기본 medium.
Extended Thinking (확장 사고)
Claude가 응답 전에 내부 추론 과정을 별도 토큰으로 수행하는 기능. Claude Code에서는 Effort Level로 제어합니다. API 직접 사용 시에는 thinking.budget_tokens로 사고 예산을 지정합니다.
F
Fast Mode
Claude Code에서 /fast로 토글하는 고속 모드. 같은 Opus 4.6 모델을 2.5배 빠르게 사용하며, 별도 과금됩니다. 라이브 디버깅, 빠른 반복 작업에 적합합니다.
Few-shot Prompting
모델에게 예시(예시 입력 + 예시 출력)를 함께 제공해 원하는 출력 형식을 유도하는 프롬프트 기법.
G
Glob (도구)
파일 패턴 매칭으로 파일을 검색하는 Claude Code 내장 도구. **/*.ts 같은 와일드카드 패턴을 지원합니다.
Grep (도구)
파일 내용을 정규식으로 검색하는 Claude Code 내장 도구. 코드베이스에서 특정 함수나 패턴을 찾을 때 사용합니다.
H
Headless 모드
UI 없이 Claude Code를 프로그래밍 방식으로 실행하는 모드. CI/CD 파이프라인이나 자동화 스크립트에서 주로 사용합니다. claude -p "프롬프트" 형태로 실행합니다.
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가 직접 연동하도록 할 수 있습니다.
Multi-agent (멀티에이전트)
여러 에이전트가 협력해 하나의 복잡한 작업을 수행하는 아키텍처. 오케스트레이터가 작업을 분배하고, 전문 에이전트들이 각자의 역할을 담당합니다.
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으로 전환합니다.
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-name 형태로 호출할 수 있는 커스텀 커맨드. ~/.claude/commands/ 또는 .claude/commands/에 Markdown 파일로 정의합니다.
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 도구를 사용합니다.