Claude Code 완벽 가이드 2026
모든 기본 기능, 표준 에이전트, 공식 Skills, Plugins 에 대한 한눈에 보는 개요
이 글에서는 놀라울 정도로 진화한 Claude Code 의 모든 기능을 종합적으로 다룹니다.
솔직히 말해서, 2026년에는 "터미널에서 실행되는 AI 채팅"이라는 표현만으로는 Claude Code 를 설명하기에 충분하지 않습니다.
그만큼 그 기능이 확장되었기 때문입니다.
오늘날의 Claude Code 는 리포지토리를 스스로 탐색하고, 요구사항을 정리하며, 구현 계획을 세우고, 파일을 편집하고, 명령어를 실행하고, 애플리케이션을 실행하고, 결과를 관찰한 다음, 실패하면 다시 돌아와서 수정합니다.
이 모든 것을 거의 독립적으로 처리합니다.
그리고 그것뿐만이 아닙니다.
여러 에이전트 간에 작업을 분할하고, 독립적인 Git Worktree 를 사용하여 병렬로 구현하며, 오래 실행되는 프로세스를 백그라운드에서 실행하고, 외부 서비스로부터 이벤트를 수신하며, 결과를 웹 페이지로 게시할 수도 있습니다.
간단히 말해, Claude Code 는 다음 요소들을 묶은 "에이전트 실행 플랫폼"입니다.
- Claude 모델의 추론
- 파일, Shell, Web, LSP 등을 처리하기 위한 실행 도구
- 대화 기록, 프로젝트 규칙, Memory 를 통한 컨텍스트 관리
- Permissions, Auto 모드, Sandboxes, Hooks 를 통한 안전 제어
- Subagents, Agent Views, Agent Teams, Dynamic Workflows 를 통한 병렬 처리
- Skills, Plugins, MCP 를 통한 확장성
- CLI, IDE, Desktop, Web, Mobile, CI, SDK 에 걸친 실행 환경
이 글이 Claude Code 시스템이 가진 기능과 각 기능을 효과적으로 사용하는 방법에 대한 이해를 정리하는 지도가 되길 바랍니다.
1장: Claude Code 의 9가지 레이어
참고: 설정 및 고급 사용 기술을 PDF 로 요약했습니다.
원하시면 여기서 받아가세요! 👇
https://x.com/MakeAI_CEO/status/2027682940847898770?s=20
Claude Code 를 마스터하기 위해 가장 먼저 이해해야 할 것은 "Models", "Tools", "Agents", "Skills", "Plugins" 간의 차이입니다.
이것들이 섞이면 문제가 생깁니다.
CLAUDE.md 에 있어야 할 내용을 Hooks 에 작성하거나, Permissions 로 엄격히 차단해야 할 작업을 Skill 에서 그냥 "요청"만 하는 실수를 할 수 있습니다.
이러한 불일치를 방지하기 위해 시스템을 9가지 레이어로 나누어 생각해 봅시다.
- Claude Model (두뇌)
Claude 모델은 "두뇌"입니다. 코드를 읽고, 문제를 이해하며, 다음에 무엇을 할지 생각합니다. 이러한 "사고" 부분은 모델이 처리합니다.
대표적인 모델 제품군은 다음과 같습니다.
- Sonnet
- Opus
- Haiku
- Fable
하지만 흔한 오해는 모델 자체가 직접 파일을 수정하거나 명령어를 실행한다는 것입니다. 모델은 단지 "이 파일을 읽고 싶다", "이 코드를 바꾸고 싶다", "테스트를 실행하고 싶다"와 같은 결정만 내립니다. 실제 작업은 런타임의 Tool 호출이 수행합니다.
- Claude Code Runtime (지휘관)
Claude Code 런타임은 모델과 실행 환경 사이를 중재하는 지휘관입니다. 주요 역할은 다음과 같습니다.
- 대화 기록 저장
- CLAUDE.md 및 Skills 로드
- 모델에 Tool 정의 전달
- Tool 호출 실행
- Permissions 결정
- Hooks 트리거
- Sandbox 제약 조건 적용
- Subagents 실행
- 컨텍스트 압축
- 세션 저장 및 재개
흥미롭게도, 동일한 모델을 사용하더라도 런타임 설정에 따라 동작이 크게 달라질 수 있습니다.
- Built-in Tools (손과 발)
Built-in Tools 는 Claude Code 에 통합된 "사지"입니다. 이러한 도구를 통해 Claude 는 다음을 수행할 수 있습니다.
- 파일 읽기
- 파일 생성
- 파일 일부 편집
- 파일 이름 검색
- 코드 내 문자열 검색
- Shell 명령어 실행
- 웹 검색
- Language Server 에서 타입 정보 가져오기
- Subagents 실행
- 결과 게시
Tools 가 없으면 Claude 는 구두 제안만 할 수 있습니다. Tools 는 Claude 를 "조언만 하는 AI"에서 "실제로 작업하는 AI"로 변화시킵니다.
- Built-in Subagents (표준 어시스턴트)
기본적으로 포함된 보조 에이전트입니다. 세 가지 주요 유형이 있습니다.
- Explore
- Plan
- 범용
이들은 메인 대화와 별도의 컨텍스트에서 작동하며, 다른 방에서 작업하는 어시스턴트와 같습니다.
- Custom Subagents (전문 역할)
Custom Subagents 는 사용자나 팀이 정의한 전문 에이전트입니다. 다음과 같은 역할을 만들 수 있습니다.
- 보안 검토 에이전트
- API 설계 에이전트
- 테스트 생성 에이전트
- 데이터베이스 마이그레이션 에이전트
- 문서 감사 에이전트
- 성능 분석 에이전트
- Skills (재사용 가능한 매뉴얼)
Skills 는 Claude 에게 재사용 가능한 절차나 전문 지식을 제공하는 메커니즘입니다. 긴 지침을 반복해서 입력해야 한다면 Skill 로 만들어야 합니다.
- Plugins (배포 상자)
Plugins 는 Skills, Subagents, Hooks, MCP 설정 등 여러 확장 요소를 함께 배포하는 데 사용되는 "상자"입니다.
- MCP (외부 연결 공통 표준)
MCP 는 "Model Context Protocol"의 약자로, Claude Code 를 외부 서비스, API, 데이터베이스, 비즈니스 시스템에 연결하기 위한 표준입니다.
- Execution Surfaces (사용 환경)
Claude Code 는 터미널에서만 사용할 수 있는 것이 아닙니다. VS Code, JetBrains IDE, Claude Desktop, Web, Mobile, Slack, CI/CD 파이프라인에서 사용할 수 있습니다.
2장: 기본 작동 — 에이전트 루프
Claude Code 의 기본 작동은 회전하는 "루프"로 상상하는 것이 가장 좋습니다.
사용자가 목표 전달 -> 필요한 정보 수집 -> 다음 행동 생각 -> Tool 선택 -> Permissions/Hooks/Sandbox 통과 -> 파일 편집 또는 명령어 실행 -> 결과 관찰 -> 테스트/실제 환경에서 확인 -> 부족하면 조사/수정으로 돌아가기 -> 완료 조건 충족 시 종료.
3장: Models, Effort, Fast 모드, Advisor
이 섹션에서는 작업에 적합한 모델과 강도를 선택하는 방법을 다룹니다.
- Sonnet: 구현 및 버그 수정을 위한 일상적인 작업용.
- Opus: 아키텍처 설계 및 복잡한 문제 해결과 같은 어려운 상황을 위한 파트너.
- Haiku: 간단한 검색 및 요약을 위한 빠르고 저렴한 모델.
- Fable 5: 대규모 리포지토리에서 자율 실행을 위한 최고 수준의 장거리 러너 (2026년 7월 기준).
Effort: 할당할 추론 양을 결정하는 슬라이더 (Low ~ Max).
Ultracode: 깊은 추론과 자동 서브에이전트 오케스트레이션을 결합한 고유 설정.
Fast 모드: Opus 용 고속 구성으로, 긴급 작업 시 약 2.5배 더 빠릅니다.
Advisor: 중요한 결정에 대해 두 번째 모델이 "제2의 의견"을 제공하는 실험적 기능.
4장: Context, CLAUDE.md, Rules, Auto Memory
컨텍스트 관리는 Claude Code 성능의 주요 요소입니다.
- CLAUDE.md: 프로젝트 전제 조건(기술 스택, 코딩 규칙 등)을 위한 마크다운 파일입니다. 엄격한 적용 메커니즘이 아닌 가이드 역할을 합니다.
- .claude/rules/: CLAUDE.md 를 관련 파일이 편집될 때만 로드되는 특정 규칙으로 분할할 수 있습니다.
- Auto Memory: 특정 빌드 명령어나 선호하는 구현 스타일과 같은 발견 사항을 자동으로 기록합니다.
- Auto Compaction: 긴 대화를 요약하여 컨텍스트 제한 내에 유지합니다.
5장: 42가지 유형의 Built-in Tools
2026년 7월 기준, 42개의 내장 도구가 있으며 다음을 포함합니다.
- 파일/코드: Read, Write, Edit, Glob, Grep, LSP 등
- Shell/프로세스: Bash, PowerShell, Monitor
- 계획/Worktree: EnterPlanMode, EnterWorktree
- 에이전트/워크플로우: Agent, Workflow, SendMessage
- 작업: TaskCreate, TaskList
- 웹/MCP: WebSearch, WebFetch, ToolSearch
- 사용자/클라우드: AskUserQuestion, PushNotification, Artifact
6장: Session, Checkpoint, Branch, Fork, Worktree
Claude Code 는 작업을 "Session"으로 저장하여 작업을 재개하고, 대화를 분기하거나, 이전 Checkpoint 로 돌아갈 수 있습니다. 그러나 Checkpoint 는 Git 을 대체하지 않으며, API 호출이나 데이터베이스 업데이트와 같은 외부 부작용을 취소할 수 없습니다.
7장: 기본 에이전트
- Explore: 코드베이스 탐색에 특화된 읽기 전용 에이전트.
- Plan: Plan 모드에서 구현 전 정보 수집에 사용되는 읽기 전용 에이전트.
- 범용: 탐색과 실행을 모두 처리하는 다목적 에이전트.
가이드에서 계속 👇
