Claude Code 딥다이브
— 터미널에 사는 AI 코딩 에이전트, 자연어로 코드베이스를 고친다

1프로젝트 한줄 요약

Claude Code는 터미널에서 자연어 명령으로 코드베이스를 이해하고 파일 편집·명령 실행·git 워크플로를 자동 처리하는 AI 코딩 에이전트다. "이 버그 고쳐줘"라고 말하면, AI가 코드를 읽고 → 수정하고 → 테스트하고 → 커밋까지 해주는 도구다.

2왜 주목받는가

경쟁 도구 비교

3기술 스택 전체 지도

언어 구성

백엔드 / 핵심 런타임

프론트엔드 / UI

인프라 / DevOps

4아키텍처 심화 분석

시스템 구조도

핵심 설계 패턴 ①: 에이전트 루프 (ReAct)

핵심 설계 패턴 ②: 멀티에이전트 오케스트레이션

메인 에이전트가 Task Tool로 서브에이전트를 spawn하고, 각 서브에이전트는 독립된 git worktree에서 작업해 메인 디렉토리를 오염시키지 않는다.

핵심 설계 패턴 ③: 설정 캐스케이드

CSS 캐스케이드처럼 5단계 설정이 상속된다. Enterprise(Managed) 설정이 최우선이라 회사가 "rm -rf 금지"를 설정하면 개인이 풀 수 없다. Local(.claude/settings.local.json)이 Project(.claude/settings.json)보다 높고, User(~/.claude/settings.json)가 최하위다.

핵심 설계 패턴 ④: Hooks 시스템 (31개 이벤트)

핵심 설계 패턴 ⑤: 23단계 보안 체크

Bash 명령 실행 전 23개 보안 검사를 통과해야 한다 — Zsh 등호 확장 공격 방어, 제로폭 유니코드 인젝션 감지, IFS 널바이트 인젝션 차단, 네이티브 클라이언트 암호화 해시 검증.

5디렉토리 구조 해부

플러그인 구조 표준: commands/(슬래시 커맨드) + agents/(전문 에이전트) + skills/(자동 트리거 스킬) + hooks/(라이프사이클 훅) + .mcp.json(MCP 서버 설정).

6학습 포인트 (기술별)

A. 에이전트 아키텍처 (ReAct 루프)

배울 것: AI 에이전트의 핵심 설계 — ReAct 루프, 도구 디스패치, 권한 관리. 도구 시스템: 50+ 도구가 어떻게 등록되고, AI가 어떤 도구를 선택하는지. 권한 3단계: allow(자동허용) → ask(물어보기) → deny(차단) 패턴.

B. Hooks 시스템 — 이벤트 드리븐 아키텍처

배울 것: 31개 라이프사이클 이벤트를 통한 워크플로 자동화. Hook 핸들러 4가지 타입: command(셸 스크립트), http(HTTP 엔드포인트), prompt(AI 검증 요청), agent(서브에이전트 실행).

C. 플러그인 시스템 — 모듈식 확장 아키텍처

배울 것: commands + agents + skills + hooks를 패키징한 확장 단위 설계 방법. 13개 공식 플러그인이 이 패턴의 실전 예시다.

D. MCP (Model Context Protocol)

배울 것: AI 도구와 외부 서비스를 연결하는 표준 프로토콜. OAuth 2.0 + RFC 9728 기반 인증. 도구 설명 2KB 제한으로 컨텍스트 블로트 방지하는 설계 원칙.

E. CLAUDE.md & 메모리 시스템

배울 것: AI에게 프로젝트 컨텍스트를 효과적으로 전달하는 방법. 글로벌(~/.claude/CLAUDE.md) → 프로젝트 루트(./CLAUDE.md) → 디렉토리별(./src/CLAUDE.md) → 규칙 파일(.claude/rules/*.md) 4단계 계층.

F. 터미널 렌더링 최적화

Claude Code의 TUI는 게임 엔진 기법을 사용한다: Int32Array 문자 풀링, 비트마스크 스타일 인코딩, 변경된 셀만 다시 그리는 패치 최적화, stringWidth 호출 ~50배 감소하는 라인폭 캐시.

7하드웨어 / 시스템 요구사항

8직접 해볼 수 있는 실습 과제

# 1. 설치
curl -fsSL https://claude.ai/install.sh | bash

# 2. 프로젝트에서 시작
cd my-project && claude

# 3. 다양한 명령 시도
> "이 프로젝트 구조 설명해줘"
> "이 함수에 테스트 작성해줘"
> "이 버그 고쳐줘"
> /compact    # 컨텍스트 압축
> /commit     # 변경사항 커밋

# my_mcp_server.py
from fastmcp import FastMCP

mcp = FastMCP("내 데이터 서버")

@mcp.tool()
def query_tasks(status: str = "open") -> list:
    """현재 작업 목록을 조회합니다"""
    return [{"id": 1, "title": "버그 수정", "status": status}]

if __name__ == "__main__":
    mcp.run()

9관련 기술 심화 학습 로드맵

1주차: 기초 체험

2주차: 커스터마이징

3주차: 멀티에이전트 & 플러그인

4주차: MCP & CI/CD 통합

10핵심 키워드 사전

11참고 링크

• GitHub 레포 — anthropics/claude-code
• 공식 문서
• Hooks 가이드
• MCP 가이드
• CLAUDE.md 가이드
• 플러그인 가이드
• Agent SDK
• GitHub Actions 통합
• DeepWiki 아키텍처 분석
• CHANGELOG