AI 코딩 세션이 끊겨도 작업 이어받는 법
「대화창이 꺼지면 하던 코딩도 다 날아갈까?」 19분 만에 상한으로 끊긴 세션을 11분 뒤 이어받아 마친 기록.

AI 에이전트에게 큰 기능을 맡겼는데 한창 파일을 고치던 도중에 비용 한도나 시간 상한에 걸려 세션이 뚝 끊기면 어떻게 될까?
보통 채팅창 안에서 대화를 주고받으며 코딩을 시키면 세션이 꺼지는 순간 이전 대화 맥락(Context window)이 함께 증발한다.
새로 열린 세션은 앞선 세션이 왜 그 파일들을 열어 두었는지, 어디까지 시험했고 무엇이 남았는지 알지 못해 처음부터 코드를 다시 짜거나 건드리지 말아야 할 파일을 덮어쓴다.
카보틴 스튜디오의 웹사이트와 게임은 이 문제를 막으려고 모든 작업 기억을 모델의 대화창 밖인 디스크 파일과 Git 상태에 남기는 규칙을 쓴다.
2026년 11월 15일 실제로 이 블로그 틀(blog.mjs · src/blog.css)을 만들면서 세 번 연속으로 비용 상한에 걸려 세션이 끊겼던 실행 기록과, 다음 세션이 11분 만에 현장을 복원해 작업을 끝낸 구조를 정리한다.
19분 만에 끊긴 세션과 9개의 파일
2026년 11월 15일 오후 2시 23분(한국 시각, 05:23:12 UTC), 공식 홈 저장소에 블로그와 안내 페이지 세 곳(소개 · 문의 · 개인정보처리방침)을 추가하는 첫 번째 세션(#1446-0)이 켜졌다.
이 세션은 Git 작업 트리(site-blog, 브랜치 blog)를 새로 가르고 마크다운 파서와 RSS 생성기, 이미지 리사이즈 파이프라인을 작성하기 시작했다.
그러나 오후 2시 42분 41초, 시작한 지 정확히 19분(57턴) 만에 누적 API 호출 비용이 $4.7175(약 $4.72)에 도달했다. 세션당 비용 상한($4.64)을 넘기면서 프로세스가 종료 코드 1로 강제 중단되었다.
세션이 끊긴 직후 디스크에 남아 있던 흔적은 아래와 같았다.
work/site-blog폴더: 아직 커밋되지 않은 파일 9개(.gitattributes,blog.mjs234줄,build.mjs,src/blog.css99줄,src/pages/about.md38줄,src/pages/contact.md27줄,src/pages/privacy.md56줄,src/styles.css,tools/blog-images.py31줄, 총 +513줄 / -8줄)work/o1446-hooks.py: 기존build.mjs와src/styles.css에 블로그 빌드 호출을 끼워 넣으려고 작성한 46줄짜리 파이썬 패치 스크립트- 진행 장부(
progress.md)와 기억 노트(notes.md): 세션이 마지막 정리 단계에 들어가기 전에 잘렸기 때문에 새 기록 0줄
만약 다음 세션이 아무 규칙 없이 빈 프롬프트로 켜졌다면 커밋되지 않은 파일 9개를 미완성 조각으로 여겨 git checkout -- .으로 날려 버렸거나, 이미 만들어진 blog.mjs 위에 또 다른 빌드 스크립트를 덧대었을 것이다.
하지만 11분 뒤인 오후 2시 53분 12초에 자동으로 켜진 두 번째 세션(#1446-1)은 단 3분 만에 앞 세션의 작업을 검증하고 오후 2시 56분 1초에 첫 커밋(2c3acc0)을 남겼다.
기억을 프롬프트 밖 디스크로 빼는 법
세션이 예고 없이 죽어도 다음 세션이 길을 잃지 않는 이유는 작업 공간마다 네 가지 파일 규칙을 강제하기 때문이다.
조각 단위 커밋과 패치 스크립트
가장 중요한 원칙은 작업 전체가 끝날 때까지 커밋을 미루지 않는 것이다.
기능 조각 하나가 빌드(node build.mjs)와 자동 검사(node test/check.mjs), 브라우저 콘솔 오류 0건 확인을 통과할 때마다 즉시 Git 커밋을 남긴다.
세션이 시작되면 어떤 파일도 고치기 전에 무조건 git status와 git log -n 5, 그리고 수정된 파일의 타임스탬프부터 확인한다.
1차 세션(#1446-0)은 비록 커밋 직전에 끊겼지만, 기존 파일을 손으로 어설프게 고치는 대신 work/o1446-hooks.py라는 멱등성 있는 패치 스크립트를 파일로 남겨 두었다.
def rep(a, b, n=1):
global s
assert s.count(a) == n, (a, s.count(a))
s = s.replace(a, b)
이 스크립트는 치환할 대상 문자열(a)이 원본 파일에 정확히 n번 존재하는지 assert로 먼저 검사한다.
덕분에 이어받은 2차 세션(#1446-1)은 o1446-hooks.py와 git diff만 읽고도 앞 세션이 build.mjs의 어느 지점까지 연결했는지 1분 안에 파악했다.
다음 할 일 한 줄과 종료 신호 파일
대화 히스토리는 세션이 닫히면 사라지므로, 모든 상태는 두 개의 마크다운 파일에 나누어 적는다.
notes.md맨 위 「다음에 할 것」: 다음 세션이 켜지자마자 첫 턴에 읽는 자리다. 추상적인 목표가 아니라 실제로 열어야 할 파일 경로, 줄 번호, 실행할 검사 명령을 적는다.work/progress.md: 각 단계가 끝날 때마다 통과한 검사 항목 수(예:534/534), 첫 화면 무게(예:218.4KB), 배포된 Worker 버전 ID, 화면 갈무리 저장 경로를 적는다.
또한 외부 실행기는 세션의 토큰 사용량이나 시간이 상한에 가까워지면 작업 폴더에 work/STOP-SOON이라는 빈 파일을 만든다.
에이전트는 조각 하나를 마칠 때마다 이 파일이 있는지 확인하고, 파일이 보이면 새 일을 벌이지 않고 즉시 하던 조각을 커밋한 뒤 세션을 닫는다. 대화 턴 수가 80턴을 넘었을 때도 맥락이 흐려지는 것을 막기 위해 그 자리에서 정리하고 닫는다.
세션의 마지막 응답 맨 끝에는 반드시 기계가 파싱할 수 있는 고정 형식의 상태 줄(상태: 끝 | 막힘 | 이어서)을 적는다.
만약 비용 상한이나 오류로 프로세스가 중간에 죽어 이 상태 줄이 출력되지 않으면, 실행기는 해당 세션을 「끊김」으로 기록하고 다음 세션을 자동으로 대기열에 넣는다.
본체 저장소와 작업 브랜치 분리
카보틴 스튜디오 홈 본체 저장소(work/site, master 브랜치)에는 1시간마다 실험 장부를 확인해 통과한 도구를 자동으로 홈 목록에 올리고 배포하는 감시 스크립트(watch.mjs)가 돈다.
만약 감시 스크립트가 도는 순간에 work/site 폴더 안에 커밋되지 않은 수정 파일이 남아 있으면, 감시 스크립트는 다른 작업이 진행 중인 것으로 판단해 자동 배포를 건너뛴다. 반대로 긴 작업을 하다가 세션이 끊기면 본체 배포 파이프라인 전체가 멈추게 된다.
그래서 블로그처럼 시간이 걸리는 작업은 git worktree로 분리한 work/site-blog(blog 브랜치)에서만 진행한다.
세션이 중간에 끊겨 커밋 안 된 파일이 남더라도 본체 work/site는 항상 깨끗한 상태를 유지한다. blog 브랜치에서 모든 검사를 통과하고 커밋이 끝났을 때만 본체 폴더의 git status --short가 비어 있는지 확인한 뒤 git merge --ff-only blog로 합쳐 배포한다.
네 번의 세션으로 완성한 블로그 틀
2026년 11월 15일 실행 장부(runs.jsonl)에 기록된 블로그 틀 제작과 개편 과정의 네 세션 수치는 아래와 같다.
| 세션 기록 | 시작 시각 (KST) | 실행 시간 · 턴 | 비용 (상한) | 종료 상태와 남은 결과 |
|---|---|---|---|---|
1차 (#1446-0) | 14:23:12 | 19분 · 57턴 | $4.72 ($4.64) | 상한 초과로 끊김. site-blog에 미커밋 9파일(+513/-8줄)과 o1446-hooks.py 남김 |
2차 (#1446-1) | 14:53:12 | 8분 · 36턴 | $3.09 ($3.00) | 앞 세션 파일 검증 후 커밋 2c3acc0 생성, 글꼴 5종 측정 및 blog-plan.md 작성 뒤 끊김 |
3차 (#1447-0) | 15:33:12 | 21분 · 31턴 | $2.71 ($2.69) | 외부 블로그 스킨 8종 치수 측정(blog-ref.mjs), 설계서 12절 작성, CSS 개편 중 끊김 |
4차 (#1447-1) | 16:13:11 | 6분 · 50턴 | $1.83 (통과) | 목록 · 옆칸 300px · 본문 720px · 차례 · 미리보기 완성, 커밋 4b77965, 검사 534/534 통과 |
2차 세션은 1차 세션이 남긴 9개 파일을 이어받아 3분 만에 커밋 2c3acc0으로 고정했다.
그 뒤 첫 번째 글에 쓸 한글 웹폰트 서브셋 측정 스크립트(font-measure.py)를 돌려 수치를 뽑고 work/blog-plan.md에 기록해 둔 채 비용 상한($3.00)으로 끊겼다.
이어서 블로그 화면 배치를 다듬는 작업(#1447)에서도 첫 세션(#1447-0)이 robots.txt 허용 여부를 먼저 확인한 뒤 티스토리 스킨 3종(Odyssey · Book Club · Poster)과 Blogger 테마 4종(Contempo · Soho · Emporio · Notable), 브런치 1곳의 폭과 글자 크기를 헤드리스 크롬으로 측정했다.
이 치수를 설계서 12절에 적고 코드를 고치다가 21분 만에 상한($2.69)으로 다시 끊겼다.
하지만 19분 뒤에 켜진 4차 세션(#1447-1)이 이미 고쳐져 있던 한 줄 목록과 8편 쪽 넘김, 300px 옆칸 코드 위에 글 끝 차례와 미리보기 환경변수(KV_BLOG)를 마저 붙였다.

4차 세션은 테스트 과정에서 블로그 옆칸 클래스 이름(.rail)이 홈페이지 가로 카드 줄의 클래스 이름(.rail)과 겹쳐 레이아웃이 찌그러지는 결함까지 찾아내 .b-rail로 분리했다.
그렇게 16장의 화면 갈무리(가로 넘침 0 · 콘솔 오류 0)와 534개 자동 검사를 모두 통과하고 커밋 4b77965로 작업을 끝냈다.
세 번이나 중간에 프로세스가 잘렸지만, 네 세션이 쓴 총 시간은 54분(비용 합계 $12.35)이었고 단 한 줄의 코드도 중복해서 다시 짜지 않았다.
저는 AI 에이전트로 긴 개발 작업을 자동화할 때 한 번에 끝내는 거대한 프롬프트를 짜는 것보다 언제 끊겨도 다시 이어 달릴 수 있는 디스크 상태 규칙을 만드는 편이 훨씬 중요하다고 본다.
작업 트리를 분리하고, 작은 조각마다 검사 후 커밋하며, 다음 세션이 읽을 첫 줄을 파일 맨 위에 남겨 두면 세션 시간이나 비용 상한은 더 이상 장애물이 되지 않는다.
글 · Kavotin Studio. 숫자는 직접 잰 것만 기록. 문의