클로드 코드에 대해서

Review

Word count: 955Reading time: 5 min

 2026/02/10   Share

클로드 코드(Claude Code) 완벽 가이드

목적

클로드 코드의 핵심 기능과 실무 활용법을 체계적으로 이해하고 숙달하기 위함

핵심 팁

markdown 문법보다는 xml 문법으로 요구하는 것이 매우 효과적이다
PRD를 반드시 작성하자
Skill 들을 만들어놓고 활용하자

바이브 코딩 시대의 도래

역할의 재정의

AI의 역할: 단순 반복적인 코드 작성
개발자의 역할: 전략적 업무 집중
- 시스템 아키텍처 설계
- 복잡한 비즈니스 로직 구현
- 사용자 경험 개선

초기 AI 코딩 도구의 한계

주요 문제점

컨텍스트 부재: 용량 부족으로 인한 부정확한 결과 도출
파편화된 워크플로: IDE와 AI 툴을 번갈아 사용하는 비효율
끊임없는 마이크로매니징: AI가 작업을 스스로 분리하지 못해 개발자가 세부 계획을 직접 쪼개야 함
수동적 실행: AI가 먼저 제안하거나 문제를 지적하지 않음

에이전틱 AI의 등장

패러다임의 전환

도구에서 동료로의 진화

큰 맥락을 작은 맥락으로 자동 분해
프로젝트 컨텍스트에 맞는 변경 사항 제안
자율적 문제 해결 능력 보유

새로운 평가 기준

기존: “얼마나 많은 코드를 작성했는가?”
→ 현재: “얼마나 가치 있는 문제를 해결했는가?”

개발자의 새로운 역할

핵심 책임

방향 제시: AI에게 명확한 목표와 제약 조건 설정
비판적 검토: 생성된 결과물의 품질, 보안, 아키텍처 적합성 평가
최종 문제 해결: AI가 해결할 수 없는 복잡한 아키텍처 문제 처리

클로드 코드 동작 방식

자율적 실행 프로세스

프로젝트 구조 분석
작업 계획 수립
실행
검증 및 개선
테스트 후 2번으로 복귀 또는 작업 완료

클로드 코드 명령어

기본 실행

claude

슬래시 명령어 목록

명령어	기능
`/init`	클로드 초기화 (CLAUDE.md 파일 생성)
`/compact`	컨텍스트 압축 (이전 내용 기억 필요 시 필수)
`/config`	전반적인 설정 변경
`/permissions`	접근 권한 설정
`/memory`	메모리 관리
`/mcp`	MCP 관리
`/cost`	토큰 사용 통계 조회
`/doctor`	설치 상태 확인
`/help`	사용 설명서 조회
`/login`	로그인
`/logout`	로그아웃
`/pr_comments`	PR 코멘트 조회 (GitHub CLI 연동 필요)
`/review`	PR 리뷰 (GitHub CLI 연동 필요)
`/status`	계정 및 시스템 상태 확인
`/terminal-setup`	Shift + Enter 줄바꿈 기능 연동 (iTerm, VSCode)
`/vim`	Vim 사용 설정

CLAUDE.md 파일 시스템

파일 종류 및 용도

1. 프로젝트 메모리 (`./CLAUDE.md`)

위치: 프로젝트 루트
용도: 팀 전체 공유 규칙 및 정보

주요 작성 내용:

프로젝트 개요 (제목, 설명)
자주 사용하는 Bash 명령어
핵심 파일 및 유틸 함수
코드 스타일 가이드라인
테스트 지침
저장소 에티켓
개발 환경 설정
예상치 못한 동작 및 경고사항

기술 스택 명시 예시:

# 사용할 기술 정리
- DB 통신: 반드시 JPA 사용
- Excel 생성: OutStream 기술 활용
```

**아키텍처 문서화 예시**:
```
# 프로젝트 아키텍처
book-service/
├── docs/                              # 설계 문서
│   ├── Requirements.md                # 요구사항 정의
│   ├── DomainModels.md                # 도메인 모델 설계
│   ├── ERD.md                         # ERD 설계도
│   ├── SequenceDiagrams.md            # 시퀀스 다이어그램
│   └── StatusDiagrams.md              # 상태 다이어그램
├── sql/                               # SQL 스크립트
│   ├── db-ddl.sql                     # DDL (테이블 생성)
│   └── db-init-dml.sql                # DML (초기 데이터)
├── src/
│   ├── main/
│   │   ├── java/www/cdri/bookservice/
│   │   │   ├── application/           # 애플리케이션 레이어
│   │   │   │   ├── book/              # 도서 도메인
│   │   │   │   │   ├── domain/        # 도메인 모델
│   │   │   │   │   ├── exception/     # 도메인 예외
│   │   │   │   │   ├── repository/    # 리포지토리 인터페이스
│   │   │   │   │   └── service/       # 애플리케이션 서비스
│   │   │   │   └── category/          # 카테고리 도메인
│   │   │   ├── facade/                # 파사드 레이어
│   │   │   ├── infrastructure/        # 인프라 레이어
│   │   │   ├── presentation/          # 프레젠테이션 레이어
│   │   │   └── support/               # 공통 유틸리티
│   │   └── resources/
│   └── test/
├── build.gradle
└── README.md

2. 로컬 프로젝트 메모리 (`./claude.local.md`)

위치: 프로젝트 루트
용도: 개인 설정 (팀 공유 제외)
중요: 반드시 .gitignore에 추가

작성 내용:

개인 API 키
개인 맞춤 명령어
샌드박스 URL

3. 사용자 메모리 (`~/.claude/CLAUDE.md`)

위치: 홈 디렉터리
용도: 모든 프로젝트 전역 설정

작성 내용:

일반적인 코드 스타일 선호도 (예: 4칸 들여쓰기)
개인 도구 단축키

CLAUDE.md 관리 팁

정책 자동 추가

# 명령어로 CLAUDE.md에 항상 정책을 최신화하고 관리하세요
예시: 항상 변수명은 카멜케이스로만 작성해줘 → 바로 CLAUDE.md 파일에 추가됩니다

중요 항목 강조

“반드시(YOU MUST)”, “중요한(IMPORTANT)” 형용사를 붙이세요
/compact 실행 시 컨텍스트에 남을 확률이 높아집니다

작업 모드

1. 일반 모드

수정 사항을 개발자에게 확인 요청

2. 자동 수정 모드

사용자에게 허락받지 않고 직접 코드 수정
테스트 코드 작성 시 유용

3. 플래닝 모드

작업 계획 수립 전용 모드
권장 사항: Yes보다는 항상 No를 누르고, 계획의 컨텍스트 범위를 줄이고, 구체적으로 작성되도록 유도
Yes만 누르다 보면 기술 선택 등에서 확률 게임이 되어버림

모델 선택 가이드

Opus

특징: 고비용, 고성능
용도: 고차원 작업

시스템 설계
개발 및 아키텍처 결정
업무 계획 수립 시 추천

Sonnet

특징: 저비용, 빠른 속도
용도: 반복 작업

일반적인 유스케이스
빠른 코드 작성 시 선택

고급 기능

Chain of Thought (CoT)

개념: 사고의 사슬, 논리적 사고 과정을 거치는 프롬프팅 기법

효과:

여러 단계를 통한 정확성 향상
일관성 증가
디버깅 용이성 개선

활성화 방법:

1. 간단한 방법

프롬프트에 “생각해라”라고 입력하면 자동 동작

2. 구조화된 방법

[think] 태그에 생각한 과정을 입력하고, 분석하여 그를 기반으로 [answer] 태그에 답변을 작성

확장된 사고 (Extended Thinking)

개념: CoT보다 더 깊게 많이 사고
단점: 비용 증가

활성화 방법 (영어 권장):

프롬프트에 “깊게 고민해라”
또는 영어로: “Think”, “Hard Think”, “Think harder”, “Ultra think”

Skills (구 커스텀 슬래시 커맨드)

참고 문서: https://code.claude.com/docs/ko/skills

스킬을 만들어놓고 활용해라

에이전트 병렬 실행

SubAgent 활용

사용 예시:

subagent를 사용해서 4개 국어 동시 번역을 수행하면 속도를 올릴 수 있습니다

비용 절감 효과

메인 에이전트:

전체 대화 히스토리를 매번 API 호출에 포함
예: 이미 50개 메시지가 있다면, 매 응답마다 50개 메시지 전체를 재전송
토큰 사용: 기존 컨텍스트(50K 토큰) + 새 응답(5K 토큰) = 55K 토큰

서브 에이전트:

독립된 새로운 컨텍스트에서 시작
메인 대화 히스토리를 포함하지 않음
작업에 필요한 프롬프트만 받음
토큰 사용: 작업 프롬프트(1K 토큰) + 응답(5K 토큰) = 6K 토큰

커스텀 서브 에이전트

생성 방법:

# 커스텀 서브에이전트 생성 → new → All tools 선택
/agents

# 커스텀 에이전트 정보는 ./claude/agents/**.md 파일로 생성됨
# 예: test-runner-fixer.md

사용 방법:

프롬프트에서 “서브 에이전트를 사용해서 ~~”
프롬프트에서 “커스텀 에이전트를 사용해서 테스트 코드 작성해줘”

독립 에이전트 활용

멀티 터미널 전략

독립적으로 에이전트를 활용하고 싶다면, 터미널 창 여러 개를 띄워서 각각 claude 호출 후 사용
커밋 작업 관리는 git worktree 활용 추천

실무 적용 전략

클로드 데스크톱 병행 사용

바이브 코딩을 하기로 결정했다고 해서 꼭 클로드 코드의 에이전트 모드만 사용해야 하는 것은 아닙니다. 클로드 데스크톱을 함께 사용하면 컨텍스트를 효율적으로 나눠서 작업할 수 있습니다.

역할 분담:

클로드 코드:

프로젝트를 직접 수정할 때만 사용
코드 생성 및 리팩토링

클로드 데스크톱:

아이디어 정리
PRD(Product Requirements Document) 작성
독립적으로 수행할 수 있는 작업

장점: 각각 독립적으로 컨텍스트를 유지하여 작업 품질 향상

Previous Post

책읽기-개발자-온보딩-가이드

CATALOG

1. 클로드 코드(Claude Code) 완벽 가이드

