Claude Code로 개발 시작할 때 미리 알았더라면 좋았을 것들
Things I wish I knew when I started building with Claude Code
핵심 요약
Claude Code를 활용해 효율적으로 개발 프로젝트를 관리하고 컨텍스트를 유지하는 실전 팁 공유.
- 프로젝트 컨텍스트 관리 — 마스터 컨텍스트 파일을 유지해 세션마다 맥락을 초기화하지 않음.
- 세션 단위 최적화 — 기능별로 세션을 분리해 토큰 낭비를 줄이고 Claude의 집중력을 높임.
- 빌드 로그 기록 — 비밀번호가 걸린 HTML 보관소에 주요 결정 사항과 키를 저장해 관리함.
- 다음 프롬프트 생성 — 세션 종료 시 Claude에게 다음 작업에 필요한 컨텍스트를 정리하게 함.
4월부터 Claude Code로 풀스택 Flutter 앱과 웹 제품을 만들고 있습니다. 컴퓨터 공학 배경은 전혀 없지만, 하면서 하나씩 익혔습니다. 습관으로 정착시킨 후 큰 효과를 본 몇 가지 팁을 공유합니다.
살아있는 프로젝트 프롬프트 Claude에서 프로젝트를 생성하고 마스터 컨텍스트 파일을 유지하세요. 세션이 끝날 때마다 Claude에게 변경 사항, 결정된 내용, 보류 중인 작업을 업데이트하게 하세요. 매번 새로 시작할 필요 없이 모든 컨텍스트를 가지고 새 세션을 시작할 수 있습니다. 설정은 번거롭지만 금방 보상을 받게 됩니다.
하루 단위가 아닌 기능별 세션 예전에는 하나의 긴 세션에서 모든 걸 해결하려 했습니다. 나쁜 생각입니다. 컨텍스트가 비대해지면 비용이 많이 들고, Claude가 너무 많은 정보를 처리하다 보면 이상한 결정을 내리기 시작합니다. 기능이나 문제 하나당 세션을 하나씩 만들고, 관련 있는 내용만 붙여넣으세요.
파일 전체가 아닌 함수 단위로 붙여넣기 파일 전체를 붙여넣을 일은 거의 없습니다. 중요한 함수나 컴포넌트를 찾아 그것만 붙여넣으세요. 토큰을 절약하고 Claude의 집중력을 유지할 수 있습니다.
자격 증명과 빌드 로그 보관 단계를 마칠 때마다 비밀번호로 보호된 HTML 보관소에 모든 키, URL, 결정 사항, 빌드 노트를 업데이트합니다. 프로젝트가 6개쯤 쌓여서 어떤 Supabase 프로젝트가 어떤 앱에 속하는지 기억이 안 날 때가 되면 이게 왜 필요한지 알게 될 겁니다.
다음 프롬프트는 Claude에게 작성하게 하기 빌드 세션이 끝날 때 Claude에게 다음 세션을 위한 프롬프트를 작성해달라고 하세요. Claude는 어디까지 작업했는지, 다음 인스턴스에 어떤 컨텍스트가 필요한지 정확히 알고 있습니다. 직접 기억하려 애쓰는 것보다 훨씬 낫습니다.
혁명적인 내용은 아니지만, 쌓이면 큰 차이를 만듭니다. 이걸 일찍 깨달은 개발자들이 그렇지 않은 개발자들보다 훨씬 빠르게 움직입니다.
