Claude Code 안내서

챕터

개요

터미널과 기본 Git은 다뤄봤지만 AI 코딩 에이전트는 처음인 개발자를 위한, "왜 그렇게 동작하는지"까지 이해하는 체계적 학습서.

이 안내서는 Claude Code(Anthropic의 에이전틱 코딩 도구)를 처음부터 실전까지 단계적으로 익히도록 구성되어 있습니다. 명령어를 외우는 데서 멈추지 않고, 그 명령이 왜 그렇게 동작하는지를 비유 → 정의 → 실전 예시 → 흔한 실수의 흐름으로 설명합니다.

이 안내서를 읽는 법

완전 초보      → 1부부터 순서대로. 2부까지만 해도 일상 작업은 충분합니다.
어느 정도 써봄  → 1부는 훑고, 3·4부(설정·확장)에 집중하세요.
팀에 도입 중   → 3·4·5부(설정·확장·자동화)와 6부(보안·비용)를 보세요.
레퍼런스 필요   → 부록의 치트시트와 설정 레퍼런스를 북마크하세요.

각 챕터는 동일한 양식을 따릅니다: 이 장의 목표 → 본문(비유·정의·예시·표·콜아웃) → 배운 것 요약 → 확인 문제 3문항 → 다음 장 안내.

Claude Code 전체 그림

아래 다이어그램은 Claude Code의 핵심 동작 구조를 한눈에 보여줍니다. 각 요소는 해당 부에서 자세히 다룹니다.

flowchart TB
    User([사용자]):::user

    subgraph Core["Claude Code 핵심 루프"]
        direction TB
        Prompt[프롬프트 입력]:::user
        Loop{에이전트 루프<br/>모델이 다음 행동 결정}:::agent
        Perm[권한 게이트<br/>승인/거부]:::danger
        Tools[도구 실행<br/>읽기·수정·실행·검색]:::tool
        Result[결과 요약]:::result
    end

    subgraph Context["컨텍스트 & 메모리"]
        CLAUDEMD[CLAUDE.md<br/>프로젝트 규칙]:::know
        Memory[자동 메모리]:::know
        Session[세션 / 컴팩션]:::know
    end

    subgraph Extend["확장"]
        Skills[Skills]:::tool
        Sub[Subagents]:::agent
        Hooks[Hooks]:::danger
        MCP[MCP 서버]:::tool
        Plugins[Plugins]:::tool
    end

    User --> Prompt --> Loop
    Loop --> Perm --> Tools --> Result --> Loop
    Loop -.참조.-> Context
    Loop -.활용.-> Extend
    Result --> User

    classDef user fill:#FFE082,stroke:#F9A825,color:#000
    classDef agent fill:#80DEEA,stroke:#00ACC1,color:#000
    classDef tool fill:#90CAF9,stroke:#1E88E5,color:#000
    classDef result fill:#A5D6A7,stroke:#43A047,color:#000
    classDef danger fill:#EF9A9A,stroke:#E53935,color:#000
    classDef know fill:#CE93D8,stroke:#8E24AA,color:#000

🎨 색상 약속 (안내서 전체 공통): 🟡 사용자 · 🟦 에이전트 · 🔵 도구/툴 · 🟢 결과 · 🔴 위험/권한·거부 · 🟣 지식/메모리

커리큘럼 (전체 목차)

1부 · 시작하기

Claude Code가 무엇이고, 어떻게 설치·인증하며, 첫 세션을 어떻게 진행하는지.

2부 · 핵심 사용법

일상 작업의 80%를 차지하는 핵심 기능들.

3부 · 프로젝트 설정

Claude Code를 "내 프로젝트"에 맞게 길들이기.

4부 · 확장

Claude Code를 프로그래밍 가능한 플랫폼으로.

5부 · 통합과 자동화

터미널 밖으로 — IDE·Git·CI·클라우드·모바일.

6부 · 실전과 베스트 프랙티스

프로처럼 쓰기 — 효율·비용·보안·문제 해결.

부록

버전·환경 정보 (작성 시점 기준)

아래 값은 빠르게 바뀝니다. 항상 공식 문서로 재확인하세요.

준비되셨다면 1부 · 01. Claude Code란 무엇인가 로 시작하세요.