Day 1 — 코딩 어시스턴트와 컨텍스트 관리
1. 코딩 어시스턴트란?
코딩 어시스턴트는 LLM을 두뇌로 품고 있는 시스템이다. 일반 LLM 채팅과 달리, 두 가지가 추가된다:
- 컨텍스트 읽기: 내가 알려주지 않아도 실제 파일·코드베이스를 직접 읽음
- 액션 실행: 읽기만 하는 게 아니라 파일 수정, 명령어 실행 등 실제로 행동함
일반 LLM 채팅:
나 → LM → 텍스트 응답
코딩 어시스턴트:
나 → [LM + 컨텍스트 리더 + 액션 도구] → 텍스트 응답 + 실제 행동
핵심: LM이 코딩 어시스턴트 안에 있다. “LM과 나 사이”가 아니다.
2. 컨텍스트 관리 — CLAUDE.md
CLAUDE.md란?
Claude Code가 세션 시작 시 자동으로 읽어들이는 마크다운 파일. 프로젝트 규칙, 개인 선호, 아키텍처 결정 등을 저장한다.
CLAUDE.md 계층 구조
| 레벨 | 경로 | 용도 |
|---|---|---|
| 조직(Enterprise) | managed policy | 전사 보안·정책 (최우선) |
| 프로젝트 | ./CLAUDE.md |
팀 공유 컨벤션 |
| 사용자 | ~/.claude/CLAUDE.md |
개인 선호 (전 프로젝트 적용) |
| 로컬 | ./CLAUDE.local.md |
개인 프로젝트별 (gitignore) |
CLAUDE.md에 내용 추가하는 방법
1. Claude에게 직접 요청
"add to CLAUDE.md that we always use TypeScript strict mode"
2. /memory 명령어 메모리 에디터를 직접 열어서 편집
3. # prefix (구버전 방식)
# Always use bun instead of npm
# Use single quotes for strings
프롬프트 앞에 #을 붙이면 Claude가 Project 또는 Global CLAUDE.md 중 어디에 저장할지 물어보고 저장함
3. 파일 참조 — @ 표시
@를 사용해 다른 파일을 컨텍스트에 직접 불러올 수 있다.
@src/utils/auth.js 이 코드 설명해줘
CLAUDE.md 안에서도 사용 가능
# Architecture
See @docs/architecture.md
# Patterns
Follow patterns in @src/features/auth/CLAUDE.md가 너무 커지면 내용을 별도 파일로 분리하고 @로 참조하는 것이 권장됨 (최대 200줄 권고)
요약
| 기능 | 방법 | 설명 |
|---|---|---|
| 영구 지시사항 저장 | CLAUDE.md 작성 | 세션마다 자동 로드 |
| 파일 컨텍스트 추가 | @파일경로 |
해당 파일 내용을 컨텍스트에 포함 |
| 빠른 메모리 추가 | # prefix |
CLAUDE.md에 한 줄 규칙 추가 |
| 메모리 편집 | /memory 명령어 |
에디터로 직접 수정 |