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 명령어 에디터로 직접 수정