AI4 하네스 엔지니어링 🐴 Claude Code로 작업하다 보면 이런 경험이 생깁니다.분명히 print() 쓰지 말라고 했는데 어느 순간 다시 쓰고 있습니다.세션이 길어지면 앞에서 정한 규칙을 슬그머니 잊어버립니다.같은 말을 반복하게 됩니다.이건 모델이 멍청해서가 아닙니다.구조가 없어서입니다. AI 활용의 발전 흐름AI를 활용하는 방식은 점점 "프롬프트 잘 쓰기"에서 "환경 설계"로 이동하고 있습니다. 프롬프트 엔지니어링: AI에게 프롬프트를 잘 작성하는 기술→ 컨텍스트 엔지니어링: 프로젝트 상황을 AI에게 알려주기→ MCP + 스킬: 도구 연결 + AI가 쓸 수 있는 범위 정하기→ 하네스 엔지니어링: AI가 일하는 전체 환경을 설계 도구를 계속 얹어주는 게 아니라, 정확하게 동작할 수밖에 없는 환경 자체를 설계하는 것입니다. 프.. 2026. 4. 24. Claude Code 개발 속도만큼 품질도 챙기는 방법 (Plan Mode) Claude Code를 활용하면서 개발 속도는 확실히 빨라졌습니다.코드 생성, 리팩토링 같은 반복 작업을 넘어서 구조 설계까지 AI를 활용하는 것이 자연스러워졌습니다. 하지만 속도가 빨라진 만큼, 결과물의 품질이 항상 일정하게 유지되지는 않습니다.특히 아무 준비 없이 바로 구현을 요청했을 때, 다음과 같은 문제가 자주 발생합니다.현재 코드 컨텍스트를 충분히 반영하지 못한 구조 생성레이어 책임이 섞인 코드 (ViewModel에 네트워크 로직 포함 등)기존 아키텍처(MVVM, Clean Architecture)와 맞지 않는 설계불필요하게 긴 코드 생성으로 인한 토큰 낭비이전 대화 맥락이 오염되면서 점점 일관성이 깨지는 문제이런 상태에서 수정을 반복하게 되면, 단순 구현보다 오히려 더 많은 시간과 토큰을 소비.. 2026. 4. 23. Claude Code 반복작업으로 부터 토큰 낭비를 없애는 가장 확실한 방법 (CLAUDE.md) 새 세션을 시작할 때마다 이런 상황이 반복됩니다.이 프로젝트는 SwiftUI + MVVM + Clean Architecture 기반이고,비동기는 async/await 써줘. 로그는 OSLog 써줘.외부 라이브러리는 추가하기 전에 먼저 물어봐.Claude Code는 대화 단위로 동작합니다.세션이 바뀌면 이전 맥락은 전부 사라집니다. 매번 같은 설명을 반복하는 것은 시간 낭비이자 토큰 낭비입니다.이 문제를 해결하는 것이 CLAUDE.md 파일입니다. CLAUDE.md란프로젝트 루트에 두는 마크다운 파일입니다.Claude Code는 실행될 때 이 파일을 자동으로 컨텍스트에 주입합니다.세션이 바뀌어도, 컨텍스트를 초기화해도CLAUDE.md는 항상 먼저 읽힙니다.처음 만나는 Claude가 프로젝트를 이미 알고 있.. 2026. 4. 22. Claude Code가 느려지는 이유와 컨텍스트 관리 전략 Claude Code를 사용하다 보면 세션(대화)이 길어질수록 응답이 느려지거나 맥락을 잃어버리는 경험을 하게 됩니다.이 문제의 근본 원인은 컨텍스트 윈도우에 있습니다.이번 포스팅에서는 컨텍스트 윈도우의 개념과 Claude Code에서 제공하는 관리 명령어, 그리고 auto-compact 설정의 트레이드오프까지 정리합니다. 컨텍스트 윈도우란?컨텍스트 윈도우는 AI가 하나의 세션 내에서 동시에 기억하고 처리할 수 있는 토큰의 총량입니다.대화 기록, 업로드된 파일, 코드 등 세션에서 주고받은 모든 데이터가 이 공간을 소비합니다.예를들어, Claude 3.5 모델(Sonnet, Opus 등)은 200K(약 20만) 토큰의 컨텍스트 윈도우를 제공합니다.이 공간이 가득 차면 AI는 이전 내용을 잊기 시작하거나, .. 2026. 4. 21. 이전 1 다음
