AI 에이전트에게 일을 맡기다 보면 한 번쯤은 이런 순간이 옵니다. 어제까지 멀쩡하던 파일이 오늘 아침 전혀 다른 내용으로 바뀌어 있는 순간이요. 그때 가장 먼저 떠오르는 검색어가 AI 에이전트 되돌리기입니다. 저희는 둘이서 AI 크루와 함께 작은 회사를 꾸리고 있고, 둘 다 코딩 전문가가 아닙니다. 그래서 AI가 무엇을 어떻게 바꿨는지 눈으로 판별하기가 어렵습니다. 그래서 방향을 바꿨습니다. AI에게 잘 시키는 법보다 잘못 시켰을 때 원래대로 돌리는 법을 먼저 준비하기로요. 오늘은 비개발자가 AI 옆에 깔아 두면 좋은 되돌리기 장치 세 겹을 정리합니다.
1. 왜 비개발자일수록 'AI 에이전트 되돌리기'가 먼저일까
AI 에이전트는 사람보다 훨씬 빠르게, 훨씬 많은 파일을 건드립니다. 속도는 장점이지만 실수도 같은 속도로 퍼집니다. 사람 직원이라면 "이 부분 왜 바꿨어요?" 하고 물어보면 되지만, 에이전트는 여러 파일을 한꺼번에 바꿔 놓고 "완료했습니다"라고만 말할 때가 많습니다. 그 말을 그대로 믿으면 안 되는 이유는 AI 결과물 검수 루틴 글에서 따로 다뤘습니다.
비개발자에게 필요한 건 '원인을 찾는 능력'이 아니라 '일단 원래대로 돌리는 능력'입니다. 원인 분석은 되돌린 다음에 천천히 해도 됩니다. 되돌릴 수단이 있으면 사고는 '큰일'이 아니라 '한 단계 뒤로 가기'로 끝납니다. 실제로 되돌릴 수 없어서 큰 사고가 된 사례는 9초 만에 회사 DB가 사라진 사건을 다룬 글에 정리해 두었습니다. 오늘 글은 그 반대편, 미리 깔아 두는 쪽 이야기입니다.
2. 첫 번째 겹: 비개발자 버전 관리는 '게임 세이브 슬롯'부터
Git이라는 이름만 들어도 어렵게 느껴지실 겁니다. 저희는 이렇게 이해합니다. Git은 작업 폴더의 게임 세이브 슬롯입니다. 보스전 들어가기 전에 저장해 두면, 져도 거기서부터 다시 하면 되는 것처럼요. 커밋(commit)이 바로 그 한 번의 저장입니다. 비개발자 버전 관리의 핵심은 명령어를 외우는 게 아니라 습관 하나입니다. AI에게 큰 작업을 시키기 직전에 한 번 저장한다.
방법도 간단합니다. 에이전트에게 이렇게 말하면 됩니다. "작업 시작 전에 지금 상태를 Git에 저장해 줘. 설명은 한국어로 짧게." 에이전트가 대신 저장해 줍니다. 큰 변경은 별도 가지(branch)에서 하게 하세요. 가지는 '원본을 건드리지 않는 연습장'이라서, 망치면 연습장만 버리면 됩니다. 저희 홈페이지도 이 방식으로 돌아갑니다. 지금 읽고 계신 인사이트 글은 발행될 때마다 Git에 한 번씩 저장되기 때문에, 문제가 생기면 언제든 어느 날짜 상태로든 돌아갈 수 있습니다.
3. 두 번째 겹: 클로드 코드 체크포인트 — 편하지만 한계가 분명합니다
클로드 코드 체크포인트는 에이전트 도구 안에 들어 있는 '되감기' 기능입니다. 공식 문서에 따르면, 요청을 하나 보낼 때마다 그 직전 파일 상태가 자동으로 저장되고, /rewind를 입력하거나 입력창이 비어 있을 때 Esc를 두 번 누르면 되감기 메뉴가 열립니다. 여기서 '코드만 되돌리기', '대화만 되돌리기', '둘 다 되돌리기'를 고를 수 있습니다. 세션 하나에 최근 100개까지 보관되고, 기본 설정으로는 약 30일 뒤 정리됩니다.
다만 한계를 꼭 알아 두셔야 합니다. 공식 문서가 직접 밝힌 내용입니다.
- 명령줄(Bash)로 바꾼 파일은 되돌리지 못합니다. 에이전트가 명령어로 파일을 지우거나 옮기거나 복사한 건 추적 대상이 아닙니다.
- 하위 에이전트(서브에이전트)가 고친 파일도 대부분 되돌리지 못합니다. 문서는 이런 경우 Git으로 되돌리라고 안내합니다.
- 내가 직접 고친 파일이나 다른 창에서 동시에 돌던 세션의 수정도 보통은 잡히지 않습니다.
- 문서 스스로 "버전 관리(Git)를 대체하지 않는다"고 적어 둡니다.
정리하면 클로드 코드 체크포인트는 '방금 한 실수'를 빠르게 되돌리는 1차 안전망이고, Git은 며칠·몇 주 단위로 돌아갈 수 있는 최후의 안전망입니다. 둘 중 하나만 믿지 말고 겹쳐 두는 게 맞습니다. 특히 에이전트가 명령어를 많이 쓰는 작업일수록 클로드 코드 체크포인트만으로는 부족하다는 점을 기억해 두세요.
4. 세 번째 겹: '덮어쓰지 말고 v2로' 규칙
도구보다 더 오래 가는 건 일하는 규칙입니다. 저희는 AI 크루에게 이렇게 지시해 둡니다. "기존 파일은 덮어쓰지 말고, 고칠 땐 v2처럼 새 버전으로 만들어. 원본은 그대로 둬." 실제로 이 글의 초안도 그렇게 만들어졌습니다. 초안을 쓰는 AI 직원이 같은 날짜에 이미 다른 초안 파일이 있는 걸 보고, 덮어쓰지 않고 '_v2'라는 이름으로 따로 저장해 두었습니다. 덕분에 두 초안이 모두 살아 있었고, 어제는 첫 번째를, 오늘은 두 번째를 골라 쓸 수 있었습니다.
이 규칙의 장점은 도구가 없어도 작동한다는 점입니다. 폴더에 기획서.md와 기획서_v2.md가 나란히
있으면 무엇이 새것인지 한눈에 보이고, v2가 마음에 안 들면 원본을 그대로 쓰면 됩니다. 여기에 하나를 더하면 좋습니다.
삭제만큼은 에이전트에게 맡기지 않기. 지울 파일은 _to_delete 같은 폴더로 옮기게 하고, 비우는 건 사람이
직접 합니다. 앞에서 본 것처럼 명령어로 지운 파일은 체크포인트로도 돌아오지 않기 때문입니다.
5. 오늘부터 쓰는 AI 에이전트 되돌리기 체크리스트
- 큰 작업 직전: "지금 상태를 Git에 저장해 줘"라고 먼저 말하기
- 실험성 변경: "별도 가지(branch)에서 해 줘"라고 덧붙이기
- 방금 한 실수: /rewind 또는 Esc 두 번으로 클로드 코드 체크포인트 되감기
- 명령어·하위 에이전트가 바꾼 것: 체크포인트 대신 Git으로 되돌리기
- 파일 수정은 v2로, 삭제는 사람이 직접
이 다섯 줄이 저희가 쓰는 비개발자 버전 관리의 전부입니다. AI가 짜 준 코드가 나중에 어떤 청구서를 보내는지 궁금하시면 바이브 코딩 기술부채 글도 함께 읽어 보세요.
정리: 속도를 올리기 전에 브레이크부터
AI 에이전트를 더 많이, 더 빠르게 쓰고 싶다면 먼저 되돌리기 장치를 세 겹으로 깔아 두세요. 큰 작업 직전의 Git 저장, 도구의 체크포인트, 그리고 덮어쓰지 않고 버전을 나누는 규칙입니다. 이 세 가지만 있어도 AI가 실수했을 때 "큰일 났다"가 아니라 "한 단계만 뒤로 가자"가 됩니다. 코딩을 몰라도 AI 크루와 회사를 굴리는 저희의 실제 방식이 궁금하시다면 『AI 회사를 만들었습니다』 전자책에 더 자세히 정리해 두었습니다.