📚 용어 사전
Claude Code와 AI 개발 생태계에서 자주 등장하는 용어를 정리합니다.
A
Agent (에이전트)
특정 목표를 달성하기 위해 자율적으로 행동하는 AI 시스템. 단순히 질문에 답하는 것을 넘어, 도구를 사용하고 여러 단계를 거쳐 작업을 완료합니다. Claude Code 자체가 에이전트이며, Agent SDK로 커스텀 에이전트를 만들 수 있습니다.
Agent SDK
@anthropic-ai/claude-agent-sdk 패키지에서 제공하는 query() 함수 기반의 개발 도구. Claude를 프로그래밍 방식으로 호출하여 자동화 파이프라인을 구축하는 데 사용합니다.
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
컨텍스트 윈도우가 가득 찰 때 사용하는 슬래시 커맨드. 현재까지의 대화를 요약해 컨텍스트를 압축합니다.
E
Escalation (에스컬레이션)
에이전트가 처리 불가 또는 고위험 상황을 감지해 사람의 개입이나 상위 시스템에 알리는 프로세스. 기업 AI 팀 설계에서 중요한 안전 메커니즘입니다.
Extended Thinking (확장 사고)
Claude가 응답 전에 내부 추론 과정을 별도 토큰으로 수행하는 기능. 수학 증명, 복잡한 설계, 전략 분석 등 깊은 사고가 필요한 작업에 효과적입니다.
F
Few-shot Prompting
모델에게 예시(예시 입력 + 예시 출력)를 함께 제공해 원하는 출력 형식을 유도하는 프롬프트 기법.
G
Glob (도구)
파일 패턴 매칭으로 파일을 검색하는 Claude Code 내장 도구. **/*.ts 같은 와일드카드 패턴을 지원합니다.
Grep (도구)
파일 내용을 정규식으로 검색하는 Claude Code 내장 도구. 코드베이스에서 특정 함수나 패턴을 찾을 때 사용합니다.
H
Headless 모드
UI 없이 Claude Code를 프로그래밍 방식으로 실행하는 모드. CI/CD 파이프라인이나 자동화 스크립트에서 주로 사용합니다. claude -p "프롬프트" 형태로 실행합니다.
Hooks (훅)
특정 이벤트(도구 실행 전/후, 응답 완료 등) 발생 시 자동으로 실행되는 셸 스크립트. 알림, 로깅, 자동 검증 등에 활용합니다.
M
maxTurns
Agent SDK query() 옵션. 에이전틱 루프의 최대 반복 횟수를 제한합니다. 무한 루프 방지와 비용 제어에 중요합니다.
MCP (Model Context Protocol)
Anthropic이 주도하는 오픈 표준 프로토콜. 외부 시스템(데이터베이스, API, 파일 시스템 등)을 표준화된 방식으로 AI 모델에 연결합니다.
MCP 서버
MCP 프로토콜을 구현한 서버. Slack, GitHub, Notion 등 다양한 서비스의 MCP 서버를 설치해 Claude Code가 직접 연동하도록 할 수 있습니다.
Multi-agent (멀티에이전트)
여러 에이전트가 협력해 하나의 복잡한 작업을 수행하는 아키텍처. 오케스트레이터가 작업을 분배하고, 전문 에이전트들이 각자의 역할을 담당합니다.
O
Orchestrator (오케스트레이터)
멀티에이전트 시스템에서 작업을 분석하고 적절한 에이전트에게 배분하는 상위 에이전트. 이 가이드의 캡스톤에서 CEO 에이전트가 오케스트레이터 역할을 합니다.
P
Permission Mode (권한 모드)
Claude Code가 파일 수정, 명령어 실행 등 각 작업을 수행할 때 사용자 승인을 요구하는 수준을 설정합니다. 기본, 자동 승인, 읽기 전용 등이 있습니다.
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
Skill (스킬)
사용자가 /skill-name 형태로 호출할 수 있는 커스텀 커맨드. ~/.claude/commands/ 또는 .claude/commands/에 Markdown 파일로 정의합니다.
Streaming (스트리밍)
응답을 한 번에 받지 않고 생성되는 대로 실시간으로 받는 방식. 긴 응답을 기다리지 않고 즉시 화면에 표시할 때 유용합니다.
Subagent (서브에이전트)
오케스트레이터의 지시를 받아 특정 작업을 수행하는 하위 에이전트. 멀티에이전트 아키텍처의 실행 단위입니다.
System Prompt (시스템 프롬프트)
모델의 역할, 행동 방식, 제약 조건을 정의하는 사전 지시문. 대화 시작 전에 설정되며 전체 대화에 걸쳐 적용됩니다.
T
Token (토큰)
AI 모델이 텍스트를 처리하는 기본 단위. 한국어는 영어보다 토큰 효율이 낮아 같은 내용도 더 많은 토큰을 소비합니다. API 요금은 토큰 수 기준으로 부과됩니다.
Tool Use (도구 사용)
Claude가 외부 도구(함수)를 호출해 정보를 얻거나 작업을 수행하는 기능. Claude API에서는 tools 파라미터로 정의합니다.
W
Write (도구)
파일을 생성하거나 덮어쓰는 Claude Code 내장 도구. 새 파일 생성, 기존 파일 전체 교체에 사용합니다. 부분 수정은 Edit 도구를 사용합니다.