2장 Claude Code (문서)

---
moduleId: m2
toolKey: claude-code
title: 2장. CLAUDE CODE
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m2
---

# 2장. CLAUDE CODE

Claude Code CLI 워크플로우를 기준으로 설치, 업데이트 추적 기준, 핵심 기능 10가지를 정리합니다.

> 인터랙티브 커리큘럼(TSX): [/projects/ai-coding-tools/hub/curriculum/m2](/projects/ai-coding-tools/hub/curriculum/m2)  
> 벤더 요약: [/ai-coding-tools-files/docs/vendor/claude-code/summary.md](/ai-coding-tools-files/docs/vendor/claude-code/summary.md)

## 개요

- **부제**: CLI · 에이전트
- **섹션**: Claude Code Reference View

## 설치 (macOS 요약)

- 1. **CLI 설치** — Node.js 환경 확인 후 Claude Code CLI 설치
- 2. **로그인/인증** — 로그인/인증 완료 후 기본 모델 접근 확인
- 3. **프로젝트 규칙 점검** — 프로젝트 루트에서 CLAUDE.md 규칙 적용 점검
- 4. **첫 작업 루프 실행** — Cmd+K → 탐색, 수정, 검증 루프 실행

## 최근 업데이트

- 2026-04-14 — **v2.1.109**: Extended thinking 표시가 개선되어 진행 상태를 더 명확하게 확인할 수 있게 되었습니다.
- 2026-04-14 — **v2.1.108**: 프롬프트 캐싱 TTL 옵션, 세션 recap, /undo alias, 메모리 사용량 개선이 추가되었습니다.
- 2026-04-초 — **명령/세션 UX 개선**: /model, /resume, transcript 상세 보기 안정성 및 로그인/세션 관련 버그 수정이 반영되었습니다.

## 핵심 기능

### CLI Setup + 첫 실행 루프 고정

설치→로그인→첫 명령까지 끊김 없는 시작 루틴

- 시나리오: 처음 Claude Code를 켰을 때 시작점을 못 잡을 때

### Rules/CLAUDE.md 컨텍스트 정렬

프로젝트 규칙을 먼저 읽고 변경 범위를 좁혀 일관된 결과

- 시나리오: 팀 규칙을 지키면서 안전하게 수정해야 할 때

### 툴 체인 연계(탐색→수정→검증)

탐색→패치→린트→테스트를 한 흐름으로 묶어 수정 정확도 향상

- 시나리오: 버그를 빠르게 고치고 즉시 검증해야 할 때

### Plan/Agent 모드 분리 운영

설계와 실행을 분리해 복잡한 변경에서도 품질 유지

- 시나리오: 리스크 있는 변경을 단계적으로 진행할 때

### 실제 사례) 릴리즈 전 버그픽스 스프린트

짧은 기간 다수 이슈 해결 반복 루프 사례(학습용 단순화)

- 시나리오: 배포 직전 품질을 빠르게 끌어올려야 할 때

### 에이전틱 엔지니어링 핵심 — Claude Skills

MCP·Sub-Agent·Skills를 컨텍스트 효율 기준으로 비교, Skill Creator 실전까지 연결

- 시나리오: 반복 작업을 토큰 효율적으로 자동화하고 재사용 가능한 팀 자산으로 만들고 싶을 때

### 병렬 서브에이전트 운영 템플릿

조사·구현·검증 병렬 분리로 긴 작업 처리량 향상

- 시나리오: 한 번에 해야 할 작업이 많아 단일 흐름으로는 시간이 오래 걸릴 때

### Hooks 자동화 파이프라인 (Pre/Post/Stop)

수정 전·후 검증을 훅으로 연결해 품질 루틴 자동화

- 시나리오: 수정 뒤 매번 수동으로 포맷/체크를 반복하고 있을 때

## 공식 링크

- [Claude Code 공식 문서](https://docs.anthropic.com/en/docs/claude-code)
- [Claude Code 릴리즈 노트](https://docs.anthropic.com/en/release-notes/claude-code)

## 링크 정책

허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.

<hr>
<h2>moduleId: m2
toolKey: claude-code
title: 2장. CLAUDE CODE
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m2</h2>
<h1>2장. CLAUDE CODE</h1>
<p>Claude Code CLI 워크플로우를 기준으로 설치, 업데이트 추적 기준, 핵심 기능 10가지를 정리합니다.</p>
<blockquote>
<p>인터랙티브 커리큘럼(TSX): <a href="/projects/ai-coding-tools/hub/curriculum/m2">/projects/ai-coding-tools/hub/curriculum/m2</a><br>벤더 요약: <a href="/ai-coding-tools-files/docs/vendor/claude-code/summary.md">/ai-coding-tools-files/docs/vendor/claude-code/summary.md</a></p>
</blockquote>
<h2>개요</h2>
<ul>
<li><strong>부제</strong>: CLI · 에이전트</li>
<li><strong>섹션</strong>: Claude Code Reference View</li>
</ul>
<h2>설치 (macOS 요약)</h2>
<ul>
<li><ol>
<li><strong>CLI 설치</strong> — Node.js 환경 확인 후 Claude Code CLI 설치</li>
</ol>
</li>
<li><ol start="2">
<li><strong>로그인/인증</strong> — 로그인/인증 완료 후 기본 모델 접근 확인</li>
</ol>
</li>
<li><ol start="3">
<li><strong>프로젝트 규칙 점검</strong> — 프로젝트 루트에서 CLAUDE.md 규칙 적용 점검</li>
</ol>
</li>
<li><ol start="4">
<li><strong>첫 작업 루프 실행</strong> — Cmd+K → 탐색, 수정, 검증 루프 실행</li>
</ol>
</li>
</ul>
<h2>최근 업데이트</h2>
<ul>
<li>2026-04-14 — <strong>v2.1.109</strong>: Extended thinking 표시가 개선되어 진행 상태를 더 명확하게 확인할 수 있게 되었습니다.</li>
<li>2026-04-14 — <strong>v2.1.108</strong>: 프롬프트 캐싱 TTL 옵션, 세션 recap, /undo alias, 메모리 사용량 개선이 추가되었습니다.</li>
<li>2026-04-초 — <strong>명령/세션 UX 개선</strong>: /model, /resume, transcript 상세 보기 안정성 및 로그인/세션 관련 버그 수정이 반영되었습니다.</li>
</ul>
<h2>핵심 기능</h2>
<h3>CLI Setup + 첫 실행 루프 고정</h3>
<p>설치→로그인→첫 명령까지 끊김 없는 시작 루틴</p>
<ul>
<li>시나리오: 처음 Claude Code를 켰을 때 시작점을 못 잡을 때</li>
</ul>
<h3>Rules/CLAUDE.md 컨텍스트 정렬</h3>
<p>프로젝트 규칙을 먼저 읽고 변경 범위를 좁혀 일관된 결과</p>
<ul>
<li>시나리오: 팀 규칙을 지키면서 안전하게 수정해야 할 때</li>
</ul>
<h3>툴 체인 연계(탐색→수정→검증)</h3>
<p>탐색→패치→린트→테스트를 한 흐름으로 묶어 수정 정확도 향상</p>
<ul>
<li>시나리오: 버그를 빠르게 고치고 즉시 검증해야 할 때</li>
</ul>
<h3>Plan/Agent 모드 분리 운영</h3>
<p>설계와 실행을 분리해 복잡한 변경에서도 품질 유지</p>
<ul>
<li>시나리오: 리스크 있는 변경을 단계적으로 진행할 때</li>
</ul>
<h3>실제 사례) 릴리즈 전 버그픽스 스프린트</h3>
<p>짧은 기간 다수 이슈 해결 반복 루프 사례(학습용 단순화)</p>
<ul>
<li>시나리오: 배포 직전 품질을 빠르게 끌어올려야 할 때</li>
</ul>
<h3>에이전틱 엔지니어링 핵심 — Claude Skills</h3>
<p>MCP·Sub-Agent·Skills를 컨텍스트 효율 기준으로 비교, Skill Creator 실전까지 연결</p>
<ul>
<li>시나리오: 반복 작업을 토큰 효율적으로 자동화하고 재사용 가능한 팀 자산으로 만들고 싶을 때</li>
</ul>
<h3>병렬 서브에이전트 운영 템플릿</h3>
<p>조사·구현·검증 병렬 분리로 긴 작업 처리량 향상</p>
<ul>
<li>시나리오: 한 번에 해야 할 작업이 많아 단일 흐름으로는 시간이 오래 걸릴 때</li>
</ul>
<h3>Hooks 자동화 파이프라인 (Pre/Post/Stop)</h3>
<p>수정 전·후 검증을 훅으로 연결해 품질 루틴 자동화</p>
<ul>
<li>시나리오: 수정 뒤 매번 수동으로 포맷/체크를 반복하고 있을 때</li>
</ul>
<h2>공식 링크</h2>
<ul>
<li><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code 공식 문서</a></li>
<li><a href="https://docs.anthropic.com/en/release-notes/claude-code">Claude Code 릴리즈 노트</a></li>
</ul>
<h2>링크 정책</h2>
<p>허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.</p>