1인 개발자의 Claude Code 하루 워크플로우 활용법
1인 개발자가 Claude Code를 종일 곁에 두고 일하는 실제 워크플로우. 아침 맥락 복구, CLAUDE.md, 4원칙, 커스텀 MCP, 자동 기록까지 하루 흐름을 그대로 풀었다.
목차 (9)
2026년 5월 · 귀찮은개발자
Claude Code를 쓴 지 좀 됐다. 처음엔 그냥 코드 짜주는 도구로 썼다. 지금은 다르다. 아침에 컴퓨터를 켜는 순간부터 밤에 커밋할 때까지 거의 종일 곁에 두고 일한다.
1인 개발자라 옆에 물어볼 사람이 없다. 그 빈자리를 Claude Code가 메운다. 근데 그냥 띄워놓는다고 되는 게 아니었다. 매번 설명하고, 매번 같은 실수를 막고, 매번 데이터를 직접 찾았다. 그게 쌓이니 개발보다 잡일이 길어졌다.
그래서 하루 흐름을 통째로 정리했다. 아침 맥락 복구부터 마무리 기록까지, 내가 실제로 도는 워크플로우를 그대로 푼다. 거창한 셋업이 아니라 매일 반복되는 동선 이야기다.
빠르게 보기
아침엔 어제 맥락부터 복구하고, 작업은 CLAUDE.md가 설명을 대신한다. 작업 중엔 4원칙으로 폭주를 막고, 데이터는 커스텀 MCP에 대화로 물어본다. 마무리는 커밋만 하면 기록이 따라온다.
아침 — 어제 어디까지 했는지부터 복구한다
하루의 첫 마찰은 항상 똑같았다. "어제 뭐 하다 멈췄지?" 1인 개발은 프로젝트가 여러 개라 어제 맥락이 날아간다. 커밋 로그를 뒤지고 메모를 더듬는 데 20분씩 썼다.
지금은 세션 열자마자 어제 흐름을 한 줄 요약으로 받는다. 어떤 프로젝트에서 뭘 만지다 멈췄고, 다음 한 수가 뭔지가 정리돼 나온다. 빈 화면 앞에서 기억을 더듬던 시간이 사라졌다.
핵심은 "기억을 사람이 들고 있지 말 것"이다. 어제의 나와 오늘의 나 사이를 도구가 이어주면, 아침에 컴퓨터를 켜는 게 가벼워진다. 이게 하루 전체의 톤을 정한다.
작업 시작 — 설명 대신 CLAUDE.md가 말한다
예전엔 세션 열 때마다 프로젝트를 처음부터 설명했다. 폴더 구조, 네이밍 규칙, 진행 상황까지. 하루에 세션을 열 번 열면 같은 설명을 열 번 했다.
지금은 CLAUDE.md가 그 일을 대신한다. 이 파일은 Claude가 세션 시작 때 자동으로 읽는 안내문이다. 새 직원에게 건네는 업무 인수인계서 같은 거다.
여기에 개요 한두 줄, 폴더 구조, 규칙, 다음 할 일을 적어둔다. 세션을 새로 열어도 Claude가 프로젝트를 이미 아는 상태로 시작한다. "이 함수 이미 있어?" 같은 질문을 바로 할 수 있다.
나는 이 CLAUDE.md를 글로벌·프로젝트·폴더 세 층으로 나눠 쓴다. 그 계층 구조랑 커스텀 MCP까지 깊게 파는 건 따로 글로 정리했다. 여기선 "설명을 파일이 대신한다"는 한 줄만 기억하면 된다.
작업 중 — Claude가 폭주하지 않게 원칙을 박았다
Claude Code의 함정은 너무 일을 잘한다는 거다. 시키지도 않은 기능을 붙이고, 안 망가진 코드를 "개선"하고, 200줄로 끝날 걸 500줄로 짠다. 그대로 두면 diff가 감당이 안 됐다.
그래서 글로벌 CLAUDE.md에 행동 원칙을 박아뒀다. 요청한 만큼만 할 것, 건드릴 것만 건드릴 것, 불확실하면 묻을 것. 이게 있으니 Claude가 혼자 폭주하다 일을 키우는 빈도가 확 줄었다.
원칙은 Claude를 통제하려는 게 아니다. 판단은 항상 내가 한다. 제안을 받되, 맞는 말이면 쓰고 아니면 막는다. 도구를 부하가 아니라 같이 일하는 파트너로 두는 쪽이 결과가 좋았다.
데이터 확인 — 앱 지표를 대화로 물어본다
개발하다 보면 중간에 숫자를 봐야 할 때가 있다. 어제 매출이 어땠는지, 어떤 키워드 순위가 올랐는지. 예전엔 대시보드를 따로 켜서 눈으로 찾았다.
지금은 Claude한테 그냥 묻는다. 여기엔 MCP라는 게 끼어 있다. MCP는 Claude한테 외부 도구를 꽂아주는 USB 포트 같은 거다. 기본 Claude는 내 코드만 보지만, MCP를 물리면 앱 데이터까지 직접 가져다 쓴다.
그래서 "이번 주 매출 지난주랑 비교해줘" 하면 대시보드를 안 켜고 답이 나온다. 코드 짜다 말고 브라우저로 넘어가는 맥락 전환이 사라졌다. 손이 키보드를 떠나지 않는다.
이 MCP는 내가 직접 만든 거라 남들 셋업엔 없다. 그 부분도 깊은 이야기라 아래 관련 글에서 따로 다뤘다.
마무리 — 커밋하면 기록이 따라온다
하루 끝엔 커밋을 한다. 예전엔 여기서 또 일이 생겼다. CLAUDE.md를 열어 오늘 뭐 했는지 적고, 타임라인에 한 줄 남기고, 내일 할 일을 정리해야 했다.
이걸 안 하면 다음 날 아침 맥락이 또 끊겼다. 결국 귀찮은 걸 없애려다 귀찮은 게 하나 더 생긴 꼴이었다. 그래서 이 마무리 루틴 자체를 자동으로 돌게 만들었다.
지금은 작업이 끝나면 기록이 알아서 따라붙는다. 오늘 바뀐 게 정리되고, 내일 아침 복구할 맥락이 미리 쌓인다. 첫 단락에서 말한 "아침 복구"가 사실은 전날 밤 이 마무리에서 만들어진다.
솔직히 이건 아직 별로다
다 좋은 건 아니다. 토큰 비용이 든다. 종일 곁에 두면 그만큼 쓴다. 그래서 세션을 짧게 끊고, 반복 지시는 파일로 빼서 같은 설명을 매번 토큰으로 태우지 않게 한다.
그리고 셋업을 유지하는 비용도 있다. CLAUDE.md가 현실과 어긋나면 오히려 오래된 지도를 쥐여주는 꼴이 된다. 자동화로 줄이긴 했지만 0은 아니다. 이건 알고는 있다. 근데 아낀 시간이 더 커서 지금은 넘어갔다.
자주 묻는 것
Claude Code를 처음 쓰면 뭐부터 해야 하나?
CLAUDE.md부터다. 프로젝트 개요와 규칙을 적어두면 세션마다 설명하는 시간이 먼저 사라진다. 자동화나 MCP는 그다음이다.
1인 개발자에게 Claude Code가 Cursor보다 나은가?
용도가 다르다. Claude Code는 여러 파일을 알아서 고치는 에이전트라 자동화에 강하다. 인라인 편집 위주면 다른 도구가 맞을 수 있다. 나는 자동화 비중이 커서 메인으로 쓴다.
토큰 비용이 부담되지 않나?
부담된다. 세션을 짧게 끊고 반복 지시를 파일로 빼서 줄인다. 그래도 아낀 시간 대비 남는다고 본다.
커스텀 MCP는 꼭 만들어야 하나?
아니다. 기본 도구로도 충분하다. 같은 외부 작업을 매일 반복할 때만 빼면 된다.
결론
특별한 비법은 없다. 매일 반복되는 잡일을 하나씩 도구한테 넘긴 게 전부다. 아침 복구, 세션 설명, 폭주 방지, 데이터 조회, 마무리 기록. 다섯 개를 넘기니 하루가 가벼워졌다.
핵심은 "사람이 들고 있던 걸 도구로 옮긴다"는 한 줄이다. 80%는 먼저 빠르게 옮기고, 나머지 20%는 실제로 문제가 생기면 그때 고친다. 귀찮은 게 보이면 자동화하면 된다.
더 깊게
귀찮은개발자 · 모든 걸 자동화합니다
관련 글
Claude Code 커스텀 MCP·스킬·CLAUDE.md 계층화 셋업
Claude Code를 기본 상태로 쓰다 한계를 느껴 CLAUDE.md 계층화, 커스텀 MCP, 스킬 세 층으로 셋업을 짰다. 세션마다 설명하던 걸 없앤 1인 개발자의 실전 구성을 코드 단위로 정리했다.
CLAUDE.md 자동화로 Claude Code 세션 컨텍스트 관리하기
Claude 세션마다 프로젝트 컨텍스트를 다시 설명하는 게 지겨워서 CLAUDE.md 자동 업데이트, 협업 스케줄 등록, 작업 타임라인 자동 기록까지 전부 자동화했다. 두 달 손으로 하다가 만든 4가지 자동화 시스템 정리.
Claude API로 앱 성장 분석 자동화하기 — AI 그로스 에이전트
Apsity 위에 얹은 AI 그로스 에이전트 두 달 회고. AI 키워드 추천, 키워드 건강도, 신뢰도 뱃지, 성장 단계, 주간 메일을 화면 단위로 풀어 정리했다.