CLAUDE.md — AI 시대의 영구 지시어
Entity (인물·조직)lectureverified2026-05-09

CLAUDE.md — AI 시대의 영구 지시어

#vch#lecture-intro#C-se-tool#se-g6

CLAUDE.md — AI 시대의 영구 지시어

1. 요약

CLAUDE.md 는 2024년 Anthropic 의 Claude Code 출시와 함께 등장한 AI 영구 지시 markdown 파일 이다. Claude 가 매 세션 시작 시 자동으로 읽는다 — 즉 프로젝트 컨텍스트를 영구화 하는 SE 도구. 벡터 DB 같은 복잡한 메모리 대신 단순한 markdown 파일 이라는 Anthropic 의 결정이 핵심.

2. 배경 (이전 도구의 한계)

LLM 의 세션 단위 망각 — 매번 처음부터 프로젝트 설명을 반복해야 했다. CLAUDE.md 가 없으면 매 세션마다 "이 프로젝트는 Python 이고, 폴더 구조는 이렇고, 코딩 스타일은 이렇다" 를 다시 입력. 토큰 낭비 + 일관성 깨짐.

3. 핵심 개념·표기법

CLAUDE.md 의 2 종 메모리 시스템:

  1. CLAUDE.md (사람이 작성) — 영구 컨텍스트
  2. MEMORY.md / auto-memory (Claude 가 작성) — 자가 학습

전형적 CLAUDE.md 구조:

# 프로젝트 개요

## 폴더 구조

## 코딩 스타일

## 작업 이력

## 슬래시 커맨드

핵심 원칙:

  • Markdown — 사람도 AI 도 읽기 쉬움
  • Hierarchical — ~/.claude/CLAUDE.md (글로벌) → 프로젝트 CLAUDE.md (지역)
  • Append-only — 작업 이력 누적
  • SSOT — 단일 진실원

4. 언어·OS 매핑 (★ 강의 핵심)

시대환경CLAUDE.md 활용
2024Anthropic Claude Code 초기핵심 기능
2024~모든 Claude 사용 프로젝트표준화
2025v2.1.59~auto-memory 추가

★ CLAUDE.md 는 AI 시대의 README.md — 사람을 위한 README + AI 를 위한 영구 지시. 언어·프레임워크·OS 무관 — 모든 프로젝트 에 적용.

5. 현대까지의 영향

  • AGENTS.md (OpenAI 등 합의 표준, 2024~)
  • .cursor/rules/ (Cursor IDE)
  • .github/copilot-instructions.md (GitHub Copilot)
  • README.md 의 AI 시대 진화 — 사람 + AI 동시 독자
  • LLMWiki 사상 — CLAUDE.md 가 살아있는 설계 문서

6. 주요 인물·사건

연도사건
2023OpenAI Custom Instructions (사용자 단위)
2024Anthropic Claude Code — CLAUDE.md (프로젝트 단위 영구 지시)
2024 후반hierarchical (글로벌 + 프로젝트)
2025auto-memory MEMORY.md 추가
2025AGENTS.md 합의 표준 출범

7. 강의 활용

★ 본 강의의 결론 1번 — CLAUDE.md 가 AI 시대의 영구 설계 문서 다. 자연어로 작성된 markdown 파일이 곧 설계 도구 — 1947년 von Neumann 의 flow diagram 부터 80년 진화해 온 설계 도구의 종착점. 본 강의 모든 프로젝트의 진입점 이 CLAUDE.md 다.

출처

그룹 시리즈

→ synthesis/group-se_g6 (시대 그룹 종합 카드)