일반 텍스트 파일 하나가 개발자들이 AI 코딩을 사용하는 방식을 영원히 바꿔 놓았습니다.
새로운 모델이 아닙니다.
비싼 IDE도 아닙니다.
또 다른 "AI 에이전트" 스타트업도 아닙니다.
단 하나의 파일이죠:
CLAUDE.md
그리고 이 파일은 조용히 GitHub에서 가장 빠르게 성장하는 개발자 환경 중 하나가 되었습니다.
별 82,000개 이상.
수천 개의 포크.
스타트업부터 엔터프라이즈 팀까지 엔지니어들이 하룻밤 사이에 프로젝트에 복사해 넣고 있습니다.
개발자들이 드디어 한 가지를 깨달았기 때문입니다:
Claude Code가 실패하는 이유는 모델이 약해서가 아닙니다.
매 세션이 기억 상실증으로 시작하기 때문입니다.
Claude Code를 열 때마다, 다음 내용들을 잊어버립니다:
• 당신의 스택
• 당신의 아키텍처 결정
• 당신의 네이밍 컨벤션
• 당신의 코딩 표준
• 지난주에 이미 실패한 것
• 절대 변경되어서는 안 되는 것
• 하나의 프레임워크를 다른 것보다 선택한 이유
• 건드리기엔 너무 위험한 파일
그래서 모델은 문맥 없이 AI가 하는 일을 합니다:
추측합니다.
그리고 그 추측들은 엄청난 비용을 초래합니다.
하나의 함수를 수정해 달라고 요청하면,
세 개의 파일을 다시 작성합니다.
당신이 의도적으로 선택한 변수 이름을 바꿉니다.
작동 중인 코드를 리팩터링합니다.
아키텍처와 호환되지 않는 도구를 제안합니다.
"정리"한다며 무언가를 삭제합니다.
아무도 건드리라고 하지 않은 포맷을 변경합니다.
그리고 다음 한 시간을 "도움"을 취소하는 데 보냅니다.
그것이 아무도 이야기하지 않는 AI 코딩의 숨겨진 세금입니다.
한 엔지니어링 매니저는 자신의 팀이 매주 거의 8시간을 다음 작업에만 낭비하고 있다고 추정했습니다:
→ 프로젝트 컨텍스트 재설명
→ 승인되지 않은 변경 사항 되돌리기
→ 잘못된 가정 수정
→ 아키텍처 결정 재교육
→ 범위 확장 중단
그것은 AI 문제가 아닙니다.
메모리 문제입니다.
그리고 CLAUDE.md는 가장 간단한 방법으로 이를 해결합니다.
프로젝트 루트에 배치된 평범한 텍스트 파일일 뿐입니다.
하지만 Claude는 모든 세션 시작 시 자동으로 이를 읽습니다.
즉, 당신의 AI가 마침내 혼란 대신 컨텍스트로 시작한다는 의미입니다.
그 차이는 엄청납니다.
CLAUDE.md 없이:
"AI 어시스턴트"
CLAUDE.md 있으면:
"당신의 프로젝트를 이미 알고 있는 엔지니어"
파일은 일반적으로 3개의 레이어를 포함합니다.
━━━━━━━━━━━━━━━
- 기본 규칙 ━━━━━━━━━━━━━━━
이 섹션은 Claude에게 당신의 작업 방식을 가르칩니다.
응답이 얼마나 상세해야 하는지.
당신의 스택이 무엇인지.
어떻게 소통하는지.
당신이 이미 얼마나 많은 컨텍스트를 알고 있는지.
어떤 글쓰기 스타일을 사용해야 하는지.
하지 말아야 할 것은 무엇인지.
예를 들면:
→ 불필요한 표현 사용 금지
→ 답변은 작업 복잡성에 비례하게 유지
→ 가정하기 전에 질문
→ 기본 개념을 지나치게 설명하지 않음
→ 내 코딩 스타일과 정확히 일치
→ 프로젝트 제약 사항을 자동으로 따름
작게 들리나요?
하지만 수백 개의 프롬프트에 걸쳐?
이는 엄청난 반복을 제거합니다.
대부분의 개발자는 매일 20~40분을 AI에 컨텍스트를 재교육하는 데 무의식적으로 소비합니다.
매. 세. 번. 마. 다.
이제 그것을 엔지니어링 팀 규모로 곱해 보세요.
매달 수천 달러가 단지 같은 말을 반복하는 데 낭비되고 있는 셈입니다.
━━━━━━━━━━━━━━━
- 행동 제어
━━━━━━━━━━━━━━━
이 섹션은 개발자들이 몇 달 전에 있었더라면 하고 바랐던 부분입니다.
바로 여기서 Claude가 "창의적으로 파괴적"이 되는 것을 막기 때문입니다.
다음과 같은 경계를 명확히 정의합니다:
→ 작업과 직접 관련된 파일만 건드리기
→ 관련 없는 코드는 절대 리팩터링하지 않음
→ 삭제하기 전에 질문
→ 파괴적인 작업 전에 확인
→ 승인 없이 기존 구조를 다시 작성하지 않음
→ 변경된 사항을 정확히 항상 표시
→ 마이그레이션이나 배포를 자동으로 실행하지 않음
이 하나의 섹션만으로 대부분의 AI 코딩 공포 이야기를 방지합니다.
더 이상의 예상치 못한 재작성은 없습니다.
더 이상의 아키텍처 이탈은 없습니다.
더 이상의 "제가 정리해 드렸어요" 재앙은 없습니다.
AI는 예측 가능해집니다.
그것이 바로 엔지니어들이 실제로 원하는 것입니다.
━━━━━━━━━━━━━━━
- 메모리 + 프로젝트 두뇌
━━━━━━━━━━━━━━━
이 부분이 진정으로 강력해지는 곳입니다.
개발자들은 CLAUDE.md를 다음과 같은 파일과 함께 사용하기 시작했습니다:
MEMORY.md
ERRORS.md
이제 Claude는 다음을 기억할 수 있습니다:
• 당신의 팀이 이미 내린 결정
• 실패한 접근 방식
• 거부된 도구
• 프로덕션 인시던트
• 기술적 제약
• 아키텍처 트레이드오프
• 클라이언트별 규칙
즉, AI는 수개월 전에 이미 배제했던 것들을 더 이상 추천하지 않습니다.
잊는 것을 멈춥니다.
그것이 모든 것을 바꿉니다.
AI 코딩의 진정한 병목 현상은 더 이상 코드 생성이 아니기 때문입니다.
그것은 지속적인 컨텍스트입니다.
그리고 대부분의 사람들은 아직 이것을 깨닫지 못했습니다.
━━━━━━━━━━━━━━━
바이럴이 된 4가지 규칙
━━━━━━━━━━━━━━━
개발자들이 Andrej Karpathy의 AI 시스템 작업 접근 방식에서 영감을 받은 4가지 간단한 규칙을 공유하기 시작하면서 이 설정은 폭발적으로 퍼졌습니다.
겉보기에는 매우 기본적으로 보입니다:
- 가정하기 전에 질문하라.
- 가장 간단한 해결책을 먼저 사용하라.
- 관련 없는 코드를 건드리지 마라.
- 불확실함은 즉시 표시하라.
그게 전부입니다.
하지만 이 4가지 규칙은 대부분의 AI 코딩 실패를 해결합니다.
가장 큰 피해는 일반적으로 AI가 충분한 컨텍스트 없이 자신감 있게 행동할 때 발생하기 때문입니다.
최고의 결과를 얻는 개발자들은 "더 많은 AI"를 사용하는 것이 아닙니다.
그들은 모호함을 줄이고 있습니다.
그리고 이것을 한 번 보면, 다시는 못 본 체할 수 없습니다.
━━━━━━━━━━━━━━━
AI 코딩의 진정한 분열
━━━━━━━━━━━━━━━
현재 Claude Code를 사용하는 개발자는 기본적으로 두 가지 유형으로 나뉩니다.
그룹 1:
매 세션을 처음부터 시작합니다.
매일 컨텍스트를 반복합니다.
원치 않는 변경 사항을 정리합니다.
끊임없이 범위 확장과 싸웁니다.
AI를 일시적인 자동 완성처럼 대합니다.
그룹 2:
지속적인 명령어를 사용합니다.
행동 규칙을 고정합니다.
프로젝트 메모리를 유지합니다.
범위를 엄격히 제어합니다.
AI를 장기적인 엔지니어링 협업자처럼 대합니다.
동일한 모델입니다.
완전히 다른 결과입니다.
그렇기 때문에 이 파일이 그렇게 빠르게 퍼졌습니다.
Claude가 다음을 가지게 되면:
• 규칙
• 메모리
• 스택 인식
• 행동 제약
• 프로젝트 컨텍스트
…챗봇처럼 느껴지지 않기 시작합니다.
그리고 인프라처럼 느껴지기 시작합니다.
━━━━━━━━━━━━━━━
여기서 시작하세요
━━━━━━━━━━━━━━━
프로젝트를 엽니다.
다음 이름의 파일을 만듭니다:
CLAUDE.md
그런 다음 먼저 이 4가지 규칙을 붙여넣으세요:
• 가정하기 전에 질문
• 가장 간단한 해결책 먼저
• 관련 없는 코드 건드리지 않기
• 불확실함을 명시적으로 표시
이것만으로도 Claude의 행동이 즉시 개선될 것입니다.
그런 다음 시간이 지남에 따라 점차 확장하세요:
→ 당신의 스택
→ 코딩 표준
→ 아키텍처 규칙
→ 금지된 작업
→ 결정 로그
→ 프로젝트 메모리
대부분의 개발자는 아직 이것을 하지 않았습니다.
즉, 평균적인 AI 지원 코딩과 엘리트 AI 지원 코딩 사이의 격차는 점점 모델에 관한 것이 줄어들고...
...컨텍스트를 적절히 구조화하는 방법을 아는 사람에 관한 것이 늘어나고 있습니다.
이 글을 북마크하세요.
6개월 후면, 지속적인 AI 프로젝트 메모리는 아마 오늘날의 GitHub 저장소만큼 자연스러워질 것이기 때문입니다.
