부록 C. 용어집

안내서에 나온 핵심 용어를 한곳에. 각 항목 끝에 자세히 다룬 장을 링크했습니다.

기본 개념

에이전틱(agentic) — AI가 목표를 받아 스스로 도구를 고르며 여러 단계를 거쳐 일을 완수하려는 방식. 핵심은 "모델 호출 → 도구 실행 → 결과 확인 → 반복"의 루프. (1장)

에이전트 루프(agent loop) — Claude Code 동작의 심장. 모델을 호출하고 도구를 실행하고 결과를 보고 다음을 정하는 단순 반복. (1장)

세션(session) — claude 실행으로 시작되는 하나의 작업 단위. 자기만의 컨텍스트 윈도우를 가짐. (4장)

표면/채널(surface) — 같은 엔진이 노출되는 형태(CLI·IDE·데스크톱·Web·모바일·SDK·GitHub). CLI가 기준. (1장, 17장)

컨텍스트 윈도우(context window) — 모델이 한 순간에 "볼 수 있는" 모든 것이 담기는 유한한 예산. (4장)

컴팩션(compaction) — 윈도우가 차면 오래된 도구 출력부터 비우고, 부족하면 대화를 요약하는 자동 정리. (4장)

context rot(컨텍스트 부패) — 세션이 길어질수록 오래된 컨텍스트 가중치가 떨어지고 품질이 저하되는 현상. (21장)

CLAUDE.md — 매 세션 자동 로드되는, 사용자가 작성한 영구 지침 파일. 안내이지 강제는 아님(약 70% 준수). (9장)

자동 메모리(auto memory) — Claude가 교정·발견을 스스로 기록하는 메모리. ~/.claude/projects/<project>/memory/. (10장)

프롬프트 캐싱(prompt caching) — 반복되는 컨텍스트(시스템 프롬프트 등)를 캐시해 비용을 크게 줄이는 자동 최적화. 약 5분 쉬면 만료. (22장)

프롬프트 엔지니어링 — 무엇을 어떻게 지시할지(지시문의 명확성·구조). (5장)

컨텍스트 엔지니어링 — 무엇을 컨텍스트에 넣고 뺄지. (5장)

스펙(spec) — 큰 작업의 짧은 설계 문서. 탐색→계획→검토→구현 흐름의 출발점. (5장)

Plan Mode — 파일을 건드리지 않고 탐색·질문·계획만 하는 읽기 전용 모드. (7장)

피드백 루프 — Claude가 자기 작업을 검증(테스트·스크린샷·브라우저)하고 고치는 반복. (21장)

내장 도구 — Read·Glob·Grep·Edit·Write·Bash·Agent·TodoWrite 등. 전용 도구가 raw 셸보다 선호됨. (6장)

권한 모드 — 승인 멈춤 빈도를 정하는 모드: default·acceptEdits·plan·auto·dontAsk·bypassPermissions. (8장)

권한 규칙(allow/ask/deny) — 특정 도구·명령을 미리 허용/확인/차단. deny→ask→allow 순, deny 우선. (8장)

체크포인트 / /rewind — 편집 전 파일 스냅샷과 그 복원 기능. Git과 보완 관계. (18장)

Skill(스킬) — SKILL.md를 가진 디렉터리. 이름·설명으로 자동/수동 호출. 점진적 공개로 가벼움. 슬래시 명령은 스킬로 통합됨. (12장)

점진적 공개(progressive disclosure) — 세션 시작엔 스킬 이름·설명만(~30-50토큰), 호출 시 본문 로드. (12장)

Subagent(서브에이전트) — 자기 컨텍스트에서 일하고 요약만 돌려주는 독립 Claude 인스턴스. 내장 Explore·Plan·general-purpose. 승인 프롬프트 불가. (13장)

Agent Teams(에이전트 팀) — 여러 인스턴스가 공유 작업 목록으로 협업. 거대 작업용. (13장)

MCP(Model Context Protocol) — Claude Code를 외부 서비스와 잇는 표준 규약. 도구 스키마를 선행 로드해 컨텍스트를 많이 씀. (14장)

Hook(훅) — 라이프사이클 이벤트에 발동하는 결정적 스크립트. PreToolUse가 1차 보안 체크포인트. "가드레일이지 벽이 아님". (15장)

Plugin(플러그인) — Skill·Subagent·Hook·MCP를 하나의 버전 단위로 묶는 패키징 층. 마켓플레이스로 배포. (16장)

마켓플레이스(marketplace) — 여러 플러그인을 배포하는 GitHub 저장소. /plugin으로 탐색. (16장)

헤드리스(headless, -p) — TTY 없이 원샷 실행 후 종료. 자동화의 토대. (3장, 19장)

Agent SDK — TypeScript·Python에서 같은 루프를 query()로 호출. 비대화형 사용은 별도 크레딧 풀. (19장)

/loop — 현재 세션에서 프롬프트를 주기 반복. 세션 닫으면 멈춤. (19장, 20장)

Routines — Anthropic 클라우드에서 도는 스케줄/API/GitHub 트리거 작업. 로컬 파일 미접근. (19장)

Ralph 루프 — 완료 신호가 나올 때까지 Claude Code를 반복 실행하는 자율 개발 패턴. 안전장치 필수. (20장)

Remote Control / Teleport — 폰·웹에서 세션을 조종하거나(Remote Control), 클라우드 세션을 터미널로 끌어오기(--teleport). (17장, 20장)

샌드박싱(sandboxing) — OS 수준 파일시스템·네트워크 격리. 진짜 "벽". 네이티브·Docker. (23장)

bypassPermissions — 모든 권한 검사를 생략하는 모드. 격리 환경에서만. (8장, 23장)

프롬프트 주입(prompt injection) — 외부 입력(MCP·웹·파일)에 숨은 악성 지시. 훅은 완화하나 막진 못함 → 샌드박스. (23장)

관리 정책(managed settings) — OS 수준에서 조직 표준을 강제하는 설정. (10장, 23장)

다음: 부록 D. 추가 학습 링크