← 에디토리얼

바이브코딩 실험 · 2026.11.14 · 11분

클로드 코드 멈췄을 때 작업 안 날리는 법 — 일부러 4번 끊어 본 결과와 인수인계 파일 틀

AItoZ 개발팀 · 2026.11.14 발행

클로드 코드 멈췄을 때 작업 안 날리는 법 — 일부러 4번 끊어 본 결과와 인수인계 파일 틀 — 바이브코딩 실험

11월 13일 claude.ai · Claude Code가 2시간, 2시간 30분 두 번 멈춘 걸 계기로, 작은 습관 앱을 만들며 일부러 4번 끊어 봤습니다. 창을 닫았을 때 --continue로 무엇이 돌아오는지, /rewind가 되돌리지 못하는 경우, 커밋 한 줄의 차이, 클로드 없이 HANDOFF.md 한 장으로 Gemini CLI에 이어 맡긴 결과를 정리하고, 실험에 쓴 인수인계 파일 틀과 복구 순서 체크리스트를 넣었습니다.

2026년 11월 14일 직접 실행 · Claude Code 2.1.322(Sonnet 5.5) · Gemini CLI 0.67.0 · Windows 11 · 장애 시간은 Claude 공식 상태 페이지, 기능 설명은 code.claude.com 공식 문서(11월 14일 확인) 기준

영상에서 말씀드린 인수인계 파일 틀과 끊겼을 때 복구 순서 체크리스트는 아래 '인수인계 파일 틀' · '복구 순서 체크리스트' 절에 있어요.

작업 중이던 클로드 코드 화면 — 첫 수정(CSS 추가)이 뜬 1.2초 뒤 터미널을 닫았다(실험 녹화를 그대로 다시 그린 2배 화면)

11월 13일(금) 저녁, 클로드가 두 번 멈췄습니다. 공식 상태 페이지 기준으로 첫 번째는 09:5811:58 UTC(한국 시간 18:5820:58, 약 2시간)에 claude.ai · Claude Code · platform.claude.com이, 두 번째는 13:0915:38 UTC(한국 시간 22:09다음 날 00:38, 약 2시간 30분)에 claude.ai · Claude API · Claude Code 등이 영향을 받았습니다. 원인은 공식 발표가 없어 이 글에서는 다루지 않습니다.

이럴 때 날아가는 건 코드보다 '어디까지 했는지'입니다. 그래서 빈 폴더에서 작은 습관 체크 웹앱을 만들며, 초보도 겪는 네 가지 상황을 일부러 만들어 봤습니다. 아래 결과는 모두 제 PC에서 실제로 돌린 기록이에요.

실험은 어떻게 했나요?

빈 폴더(C:\lab\habit-app)에서 클로드 코드에 "습관 체크 웹앱 만들어 줘. index.html 파일 하나에 다 넣고, 습관 추가 · 오늘 체크 · 연속 일수 표시까지"를 보냈고, 21초 만에 첫 판이 나왔습니다. 그 위에 기능을 더하면서 상황마다 일부러 끊었습니다.

실험 상황 해 본 것 결과 걸린 시간
① 창을 실수로 닫았다 수정 도중 터미널 강제 종료 → claude --continue 대화는 돌아옴, 닫기 직전 수정은 기록에 없음 · 기능 1개 빠짐 다시 열고 마무리까지 67초
② 클로드가 엉뚱하게 고쳤다 디자인 전면 변경 → /rewind 터미널 명령으로 바꾼 파일은 안 돌아옴 / 직접 고친 파일은 정확히 돌아옴 몇 초
③ 커밋을 안 해 뒀다 CLAUDE.md에 커밋 규칙 → git revert 클로드가 스스로 커밋, 한 줄로 복구 약 2초
④ 클로드 서버가 멈췄다(가정) HANDOFF.md 한 장 → 같은 폴더에서 Gemini CLI 제미나이가 다음 할 일 2개를 만들고 기능마다 커밋 약 10분

앱 화면 속 30일 기록(연속 일수 · 달력 색)은 화면을 보기 좋게 하려고 넣은 시연용 예시 데이터입니다.

창을 실수로 닫으면 무엇이 남나요?

대화와 이미 디스크에 써진 파일은 남고, 닫는 순간 하던 수정은 반쪽이 됩니다. 통계 탭과 30일 달력을 추가해 달라고 보내고, 첫 수정이 화면에 뜨자마자(보내고 15초) 터미널을 닫았더니 index.html에는 통계용 CSS만 들어가 있고 탭 · 달력 HTML과 JS는 없었습니다.

같은 폴더에서 claude --continue로 다시 열자 대화는 돌아왔는데, 기록은 '파일 읽기'까지만 있었습니다. 세션 기록 파일을 열어 봐도 닫기 직전의 수정 기록은 없었어요. "아까 하던 거 이어서 마무리해 줘"라고 하니 67초 만에 탭 · 30일 달력 · 습관별 통계를 끝냈습니다.

이어서 끝낸 통계 탭 — 30일 달력과 습관별 달성률(2배 캡처)

다만 마지막 설명이 의외였어요. 클로드는 "작업 중 파일이 외부에서 바뀌어 CSS 편집이 한 번 실패했습니다", "그사이 다른 쪽에서 비슷한 CSS가 이미 들어와 있어서 … 그쪽 클래스 이름에 맞췄습니다. 이 때문에 습관별 30칸 막대는 뺐습니다"라고 했습니다. 자기가 넣다 만 CSS를 남이 바꾼 것으로 보고, 거기에 맞추느라 기능 하나를 뺀 거예요.

--continue가 엉뚱한 대화를 열 때는 어떻게 하나요?

claude --resume으로 목록을 띄워 하던 작업을 직접 고르면 됩니다. 창을 닫은 뒤 클로드를 다시 열어 짧은 질문 하나("localStorage 키 이름이 뭐였지?")만 하고 닫았더니, 그다음 --continue는 하던 작업이 아니라 그 짧은 대화를 열었습니다.

claude --resume 목록 — 대화마다 이름 · 시간 · 크기가 나오고 골라서 연다(실험 녹화 2배 화면)

공식 CLI 문서에 따르면 --continue는 "현재 폴더의 가장 최근 대화"를 열고, claude -p로 만든 세션은 건너뜁니다. 실제로 claude -p로 물어본 질문은 건너뛰었고, 대화형으로 연 짧은 질문은 '가장 최근'으로 잡혔습니다.

/rewind는 왜 앱을 되돌리지 못했나요?

클로드가 파일을 직접 고치지 않고 터미널 명령으로 바꿨기 때문입니다. "디자인을 완전히 다른 느낌으로 확 바꿔 줘"라고 하자 53초 만에 노랑 · 분홍 디자인으로 바뀌었는데, 기록을 보니 새 스타일을 임시 파일(new.css)에 쓰고 터미널 명령으로 index.html에 끼워 넣었습니다.

입력창이 비어 있을 때 Esc를 두 번 누르거나 /rewind를 치면 보낸 프롬프트 목록이 나오고, 고른 뒤 'Restore code and conversation'을 누르면 됩니다. 그런데 메뉴에 표시된 변경은 "new.css +116"뿐이었고, 되돌린 뒤에도 앱은 노란색 그대로였어요. 메뉴 아래에도 "Bash changes to other files are not undone."이라는 경고가 떠 있었습니다.

/rewind 확인 화면 — 되돌릴 변경이 new.css뿐이고, 아래에 Bash 변경은 되돌리지 않는다는 경고(실험 녹화 2배 화면)

비교하려고 "제목을 오늘의 습관으로 바꾸고 강조색을 빨간색으로 바꿔 줘"를 시켰을 때는 클로드가 index.html을 직접 고쳤고(+3 −3), /rewind로 수정 전과 똑같이 돌아왔습니다(파일 해시 비교로 확인). 공식 체크포인트 문서도 "Bash 명령으로만 바뀐 파일은 추적하지 않고 그대로 남는다, 되돌리려면 Git 같은 버전 관리를 쓰라"고 안내합니다.

커밋 한 줄은 얼마나 차이가 났나요?

엉뚱한 수정도 git revert 한 줄, 약 2초 만에 되돌렸습니다. 깃을 켜고 프로젝트 폴더의 CLAUDE.md에 아래 규칙 한 줄을 적은 뒤 같은 디자인 요청을 다시 했더니, 클로드가 바꾸고 나서 스스로 커밋(2c4e1ac 디자인을 네오브루탈리즘 스타일로 전면 변경)을 남겼습니다.

# 작업 규칙
- 기능 하나가 끝날 때마다 git add 와 git commit 을 해 줘. 커밋 메시지는 한국어 한 줄.

git revert 한 줄로 되돌린 화면 — 커밋 로그에 Revert가 추가됐다(실험 녹화 2배 화면)

되돌린 index.html은 통계 탭까지 있던 판과 내용이 같았습니다(줄 끝 문자만 다름). 되감기가 놓친 변경을 깃은 그냥 살린 셈이라, 오늘 실험에서 가장 싸게 먹히는 보험이었어요.

클로드 서버가 멈추면 어떻게 이어 가나요?

클로드가 살아 있을 때 인수인계 파일 한 장을 써 두면, 다른 도구가 그 파일만 보고 이어 갈 수 있습니다. 서버가 멈추면 --continue도 /rewind도 쓸 수 없으니까요. 클로드에게 "다른 AI가 이어받을 수 있게 HANDOFF.md 한 장 써 줘. 지금까지 한 일, 파일 구조, 다음 할 일, 주의할 점"을 시켰더니 51초 만에 61줄 문서가 나왔습니다.

그다음 클로드는 쓰지 않고, 같은 폴더에서 Gemini CLI를 열어 "HANDOFF.md 읽고 다음 할 일 이어서 해 줘"라고만 했습니다. 대화 기록은 넘기지 않았고, 이 파일 한 장이 전부였어요.

Gemini CLI가 HANDOFF.md → CLAUDE.md → index.html 순서로 읽는 화면(실험 녹화 2배 화면)

시각 한 일
16:46:39 보냄: "HANDOFF.md 읽고 다음 할 일 이어서 해 줘"
— HANDOFF.md → CLAUDE.md → index.html 순서로 읽음
16:52:09 커밋 edd8f55 다크 모드 전환 버튼 및 테마 유지 기능 추가
16:56:06 커밋 138eb8b 습관 기록 JSON 내보내기 기능 추가
16:56:52 커밋 938ed83 인수인계 문서 갱신

약 10분 걸렸고, 중간에 셸 명령 실행 확인을 세 번 눌러 줬습니다. HANDOFF.md에 적어 둔 커밋 규칙까지 따라 기능마다 한국어 커밋을 남긴 점이 인상적이었어요. 다만 무조건 되는 건 아닙니다. 파일이 부실하면 넘겨받은 도구가 처음부터 다시 파악해야 하니까요.

제미나이가 이어서 만든 판 — 오른쪽 위 버튼으로 다크 모드(2배 캡처)

인수인계 파일 틀

실험에서 클로드가 쓴 HANDOFF.md(61줄)의 구성을 그대로 틀로 옮겼습니다. 프로젝트 폴더 맨 위에 두고, 기능 하나가 끝날 때마다 "HANDOFF.md 갱신해 줘"라고 하면 됩니다.

# HANDOFF — <프로젝트 이름>

작성일: <날짜> / 현재 브랜치: <브랜치>

## 1. 프로젝트 개요
- 무엇을 만드는지, 실행 방법(빌드 도구 · 의존성 유무)
- 데이터를 어디에 저장하는지(예: localStorage 키 이름)

## 2. 지금까지 한 일 (git 기록 기준)
1. <기능> — <커밋 해시>
2. <되돌린 시도가 있으면 그 사실도> — <커밋 해시>

## 3. 파일 구조
- <파일>: <역할>
- 주요 함수 · 데이터 모델 한 줄씩

## 4. 다음 할 일
### A. <할 일> — 위치 · 저장 방식 · 접근성 같은 조건
### B. <할 일> — 범위 밖인 것도 적기

## 5. 주의할 점
- 커밋 규칙(CLAUDE.md), 브랜치 이름
- 바꾸면 안 되는 것(저장 키 · 데이터 모델 등)
- 테스트 방법(자동 테스트가 없으면 그렇다고)

복구 순서 체크리스트

실험에서 실제로 통한 순서만 적었습니다.

  1. 상황 확인: 창이 닫힌 건지, 클로드가 엉뚱하게 고친 건지, 서버가 멈춘 건지 먼저 구분합니다. 서버 문제면 status.claude.com부터 봅니다.
  2. 창이 닫혔다면: 같은 폴더에서 claude --continue. 엉뚱한 대화가 열리면 claude --resume 목록에서 하던 작업을 고릅니다.
  3. 이어서 시키기 전에: 닫기 직전 수정이 반쯤 들어가 있을 수 있으니 "파일이 반쯤 바뀌어 있을 수 있다, 지금 상태부터 확인하고 이어 가 줘"처럼 알려 줍니다(실험 ①에서 클로드가 자기 수정을 남의 것으로 오해했어요).
  4. 엉뚱하게 고쳤다면: Esc 두 번 또는 /rewind → 되돌린 뒤 앱이 정말 돌아왔는지 직접 열어 봅니다. 안 돌아왔다면 터미널 명령으로 바뀐 파일이라 깃으로 되돌립니다.
  5. 깃으로 되돌리기: git log --oneline으로 확인하고 git revert --no-edit HEAD(마지막 커밋 되돌리기).
  6. 서버가 멈췄다면: HANDOFF.md가 최신인지 확인 → 같은 폴더에서 다른 도구(예: Gemini CLI)에 "HANDOFF.md 읽고 다음 할 일 이어서 해 줘".
  7. 복구 뒤: 커밋을 남기고 HANDOFF.md를 갱신합니다.

주의할 점은 무엇인가요?

  • /rewind는 클로드의 파일 편집 도구로 고친 것만 되돌립니다. 터미널(Bash) 명령으로만 바뀐 파일은 그대로라, 되돌린 뒤 반드시 앱을 직접 확인하세요. 체크포인트 스냅샷은 기본 설정에서 약 30일 뒤 정리됩니다(공식 문서).
  • --continue는 현재 폴더의 가장 최근 대화를 엽니다. 중간에 짧은 대화를 하나 열었다면 --resume으로 고르세요.
  • Gemini CLI를 처음 열면 폴더 신뢰 · 인증 방식 선택이 나옵니다. API 키로 인증할 때는 키가 화면에 보이니 녹화 · 공유에 주의하세요. 셸 명령은 실행 전에 확인을 묻습니다.
  • 이 글의 결과는 Claude Code 2.1.322(Sonnet 5.5) · Gemini CLI 0.67.0으로 한 번씩 돌린 기록입니다. 모델 · 버전에 따라 클로드가 파일을 고치는 방식은 달라질 수 있어요.

한 번에 정리

  • 창을 닫으면 대화와 저장된 파일은 남지만, 닫는 순간 하던 수정은 반쪽이 된다(--continue로 67초 만에 마무리, 기능 1개 빠짐).
  • /rewind는 편하지만 터미널 명령으로 바뀐 파일은 못 되돌린다.
  • CLAUDE.md에 커밋 규칙 한 줄을 넣으면 클로드가 스스로 커밋하고, git revert 한 줄(약 2초)로 되돌릴 수 있다.
  • 클로드가 멈춰도 HANDOFF.md 한 장이면 Gemini CLI가 같은 폴더에서 이어 간다(약 10분, 커밋 3개).

출처

다음 글클로드로 만든 앱, 오픈AI 보안 검사 돌렸더니 비밀번호 1234가 통과됐다→