Claude Code 입문 강의 요약
Anthropic SkillJar의 Claude Code 강의를 듣고 정리한 내용입니다.
https://anthropic.skilljar.com/claude-code-in-action
Claude Code란?
Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 어시스턴트입니다.
단순한 코드 자동완성 도구가 아니라, 코드베이스 전체를 이해하고 실제 작업(파일 수정, 명령 실행 등)을
에이전트처럼 수행할 수 있는 것이 특징입니다.
일반적인 코딩 어시스턴트(GitHub Copilot 등)가 제안(suggestion) 중심이라면,
Claude Code는 실행(action) 중심입니다.
프로젝트 시작: /init
새 프로젝트에서 Claude Code를 처음 사용할 때는 /init 커맨드부터 시작하는 것을 권장합니다.
- 코드베이스 전체를 자동으로 분석
- 구조와 주요 파일을 요약
- 요약 내용을
CLAUDE.md파일에 기록
이 과정을 통해 Claude는 이후 모든 요청에서 프로젝트 구조를 다시 파악할 필요 없이
즉시 관련 컨텍스트를 활용할 수 있습니다.
컨텍스트 추가: Adding Context
핵심 원칙: 필요한 것만 제공하라
Claude에게 작업을 시킬 때는 해당 작업과 관련된 파일이나 문서만 제공해야 합니다.
관련 없는 파일까지 넘기면 컨텍스트 윈도우가 낭비되고 노이즈가 늘어나 오히려 성능이 떨어집니다.
CLAUDE.md: Claude의 가이드 문서
/init 실행 시 생성되는 CLAUDE.md는 Claude가 프로젝트를 이해하는 핵심 문서입니다.
CLAUDE.md의 역할
- 코드베이스 이해 가속화 — 관련 코드를 더 빠르게 찾을 수 있게 함
- 작업 가이드 제공 — 코딩 스타일, 규칙, 중요 파일 위치 등을 명시
파일 종류별 비교
| 파일 | 공유 여부 | 용도 |
|---|---|---|
CLAUDE.md | ✅ 코드 레포에 포함, 팀 전체 공유 | 프로젝트 공통 가이드 |
CLAUDE.local.md | ❌ 공유 안 됨 | 개인 지시사항, 개인 커스터마이즈 |
~/.claude/CLAUDE.md | ❌ 공유 안 됨 | 내 기기의 모든 프로젝트에 공통 적용 |
Custom Instructions: # Memory Mode
#을 입력하면 memory mode가 활성화되어 해당 내용이 CLAUDE.md에 자동으로 추가됩니다.
입력:
# Use comments sparingly. Only comment complex code.CLAUDE.md에 추가되는 내용:
## Code Style
- Use comments sparingly. Only comment complex code.이를 통해 대화할 때마다 반복적으로 지시하지 않아도, Claude가 항상 일관된 스타일로 코드를 작성하게 됩니다.
File Mention: @ 파일 참조
질문할 때 @파일명으로 관련 파일을 직접 멘션할 수 있습니다.
Claude가 파일을 직접 탐색하는 시간을 줄여주고, 더 빠르고 정확한 답변을 받을 수 있습니다.
예시:
How does the auth system work? @src/auth/middleware.ts
중요 파일을 CLAUDE.md에 등록하기
프로젝트 전반에서 자주 참조되는 파일은 CLAUDE.md에 등록해두면 좋습니다.
예를 들어, Prisma를 사용하는 프로젝트라면 DB 스키마 파일이 거의 모든 기능에 영향을 미칩니다.
이런 파일은 매번 탐색하는 것보다 CLAUDE.md에 명시해두는 것이 효율적입니다.
memory mode로 등록:
# The database schema is defined in the @prisma/schema.prisma file.
Reference it anytime you need to understand the structure of data stored in the database.CLAUDE.md에 추가되는 내용:
### Database Schema
Defined in `prisma/schema.prisma`. Reference it whenever you need to
understand the structure of data stored in the database.효과 비교
등록 전에는 what attrs does a user have? 같은 질문에 Claude가 파일을 탐색하고 읽는 과정을 거칩니다.
등록 후에는 컨텍스트가 이미 있으므로 즉시 정확한 답변을 반환합니다.
📷 (스크린샷: instruction 없을 때 vs 있을 때 비교)
- 없을 때
- 있을 때
정리
| 기능 | 사용법 | 효과 |
|---|---|---|
| 프로젝트 초기화 | /init | 코드베이스 자동 분석 + CLAUDE.md 생성 |
| 커스텀 지시 저장 | # 지시내용 | CLAUDE.md에 영구 기록 |
| 파일 직접 참조 | @파일명 | 탐색 없이 즉시 해당 파일 기반 답변 |
| 중요 파일 등록 | # ... @파일명 | 매 요청마다 자동으로 컨텍스트 제공 |
