AI한테 파일을 고치라고 시키면, 파일이 순식간에 바뀝니다. 한 번이면 괜찮은데 두세 번 고치다 보면 "처음 버전이 나았다"는 생각이 듭니다. 문제는 그때 이미 처음 버전이 사라져 있다는 겁니다.
왜 저장이 따로 필요한가
일반적인 문서 작업이라면 Ctrl+S 하나로 충분합니다. 하지만 Claude Code와 함께 작업하면 상황이 다릅니다.
- AI가 한 번에 여러 파일을 동시에 수정합니다
- "이것도 고쳐줘"를 3번 반복하면 원본이 어땠는지 기억이 안 납니다
- Ctrl+Z는 현재 열려 있는 파일 하나만 되돌립니다
- "2시간 전 상태로 통째로 돌아가고 싶다"는 불가능합니다
Git은 이 문제를 해결합니다. 작업 폴더 전체를 특정 시점으로 되돌리는 타임머신입니다.
Google Drive vs Git — 뭐가 다른가요
"Google Drive도 버전 기록이 있잖아요?"라고 생각하실 수 있습니다. 맞습니다. 하지만 성격이 다릅니다.
| 항목 | Google Drive | Git |
|---|---|---|
| 저장 방식 | 자동 저장 (알아서 됨) | 직접 저장 (내가 "저장해줘"라고 해야 됨) |
| 저장 단위 | 파일 1개씩 | 폴더 전체를 한꺼번에 |
| 되돌리기 | 특정 파일의 과거 버전 | 프로젝트 전체를 특정 시점으로 |
| 메모 기능 | 없음 (날짜만 표시) | 매 저장마다 메모 남김 ("로그인 기능 추가") |
| 백업 장소 | Google 서버 | GitHub (무료 클라우드 창고) |
| AI 작업에 적합 | 보통 (파일 단위라 불편) | 매우 적합 (폴더 통째 관리) |
Google Drive는 문서 하나를 관리할 때 편합니다. 하지만 Claude Code처럼 폴더 안의 여러 파일이 동시에 바뀌는 작업에는 Git이 맞습니다.
핵심 3단계 — "확인해줘 → 저장해줘 → 올려줘"
Git의 전체 흐름은 딱 세 단계입니다. Claude Code한테 한국어로 말하면 됩니다.
1 변경 확인 — "지금 뭐가 바뀌었어?"
작업 중간에 "지금 상태가 어때?"를 확인하는 단계입니다. 어떤 파일이 바뀌었는지, 뭐가 추가됐는지 한눈에 볼 수 있습니다.
Claude Code가 git status와 git diff를 실행해서 변경 내역을 보여줍니다. 명령어를 외울 필요 없습니다.
2 저장 (Commit) — "저장해줘"
마음에 드는 상태가 되면 "저장해줘"라고 말합니다. 이걸 Git에서는 커밋(Commit)이라고 부릅니다. 작업물을 상자에 넣고 라벨을 붙이는 겁니다.
라벨(커밋 메시지)은 나중에 "아, 이때 이걸 했구나"를 찾을 때 씁니다. 날짜만 있는 것보다 훨씬 편합니다.
3 올리기 (Push) — "올려줘"
저장한 상자를 클라우드 창고(GitHub)로 보내는 단계입니다. 내 컴퓨터가 고장 나도 GitHub에 백업이 남습니다.
택배 보내는 것과 같습니다. 상자(커밋)를 포장하고, 택배(푸시)로 창고(GitHub)에 보내는 겁니다.
Before / After — Git 쓰기 전과 후
- "아까 버전이 나았는데" → 복구 불가
- 파일을 수동으로 복사 (v1, v2, v3_최종_진짜최종)
- 컴퓨터 고장 → 작업물 전부 소실
- 뭘 언제 고쳤는지 기억 안 남
- "아까 버전으로 돌아가줘" → 즉시 복구
- 자동 버전 관리 (커밋 메시지로 구분)
- GitHub에 백업 → 어디서든 복구
- 커밋 기록으로 변경 이력 추적
Git 용어 5개 — 이것만 알면 됩니다
| 용어 | 쉬운 설명 | 비유 |
|---|---|---|
| Repository (저장소) | 프로젝트 폴더 전체 | 작업실 |
| Commit (커밋) | 현재 상태를 저장 | 상자에 넣고 라벨 붙이기 |
| Push (푸시) | GitHub에 올리기 | 택배로 창고에 보내기 |
| Pull (풀) | GitHub에서 내려받기 | 창고에서 택배 받기 |
| Branch (브랜치) | 실험용 복사본 만들기 | 원본은 놔두고 사본에서 테스트 |
Claude Code를 쓸 때는 Repository, Commit, Push 세 개만 알면 충분합니다. 나머지는 필요할 때 배우면 됩니다.
하루 루틴 예시
Git을 매일 쓰는 건 어렵지 않습니다. 습관으로 만들면 됩니다.
| 시점 | 할 일 | Claude Code에 할 말 |
|---|---|---|
| 작업 시작 전 | 최신 상태 받기 | "최신 상태로 업데이트해줘" |
| 의미 있는 작업 완료 시 | 커밋 | "저장해줘. 메모는 '헤더 디자인 변경'" |
| 작업 끝날 때 | 푸시 | "GitHub에 올려줘" |
커밋만 하고 푸시를 안 하면 내 컴퓨터에만 저장된 상태입니다. 컴퓨터가 고장 나면 커밋 기록도 함께 사라집니다. "올려줘" 한마디면 GitHub에 백업됩니다.
.gitignore — API 키는 절대 올리면 안 됩니다
GitHub는 기본적으로 공개 저장소입니다. 비밀번호나 API 키가 들어간 파일을 올리면 전 세계에 공개됩니다.
.gitignore 파일을 만들어두면, 특정 파일을 Git이 무시하게 할 수 있습니다.
Claude Code한테 이렇게 말하면 .gitignore 파일을 자동으로 만들어줍니다. 직접 작성할 필요가 없습니다.
- 올리면 안 되는 것: .env (환경변수), API 키, 비밀번호, 개인정보 파일
- 올려도 되는 것: 코드, 설정 파일, 문서, HTML/CSS
Git 없이도 할 수 있는 대안들
"Git까지는 아직 부담스럽다"면 이 방법들로 시작해도 됩니다.
- Google Docs 버전 기록: 파일 → 버전 기록 → 버전 기록 보기. 문서 파일 한 개를 되돌릴 때 유용합니다.
- AI한테 백업 요청: "이 파일을 backup 폴더에 복사해줘"라고 말하면 됩니다. 원시적이지만 확실합니다.
- Esc로 되감기: Claude Code에서 Esc를 누르면 직전 AI 작업을 취소할 수 있습니다. 단, 바로 직전 한 단계만 가능합니다.
이 방법들은 응급처치입니다. 작업이 쌓이면 결국 Git이 필요해집니다. 지금은 대안으로 시작하더라도, 이 글의 3단계를 기억해두세요.
자주 묻는 질문 (FAQ)
Q. Git을 쓰려면 프로그래밍을 알아야 하나요?
아닙니다. Claude Code를 쓰고 있다면 "저장해줘", "올려줘"라고 한국어로 말하면 됩니다. Git 명령어를 외울 필요가 전혀 없습니다. Claude Code가 대신 실행합니다.
Q. GitHub 계정이 꼭 있어야 하나요?
커밋(저장)만 하려면 없어도 됩니다. 하지만 푸시(올리기)를 하려면 GitHub 계정이 필요합니다. 무료로 만들 수 있고, 비공개 저장소도 무료입니다.
Q. 실수로 잘못 커밋했으면 어떻게 되돌리나요?
Claude Code한테 "마지막 커밋 취소해줘"라고 말하면 됩니다. 파일을 직접 건드릴 필요 없이, AI가 안전하게 되돌려줍니다.
정리하며
관점 한 스푼: AI와 작업하면 파일이 빠르게 바뀝니다. 속도가 빠른 만큼 "되돌리기"의 가치도 커집니다. Git은 개발자 전용이라고 생각하기 쉬운데, 사실 "무한 Ctrl+Z"가 필요한 사람이라면 누구나 쓸 수 있는 도구입니다. 저는 블로그 글 하나 쓸 때도 중간중간 커밋합니다. "이 버전 괜찮다" 싶을 때 한 번, "방향을 바꿔볼까" 싶을 때 한 번. 그러면 어떤 실험을 해도 안전합니다. AI 시대에 가장 중요한 습관이 있다면, 작업을 빠르게 하는 것보다 안전하게 저장하는 것입니다.
시리즈 전체 목차
클로드 코드 왕초보 가이드 — 전체 시리즈
- 1편 — 클로드 코드가 뭔가요?
- 2편 — 요금제 비교 (Pro vs Max)
- 3편 — 설치부터 실행까지 10분 컷
- 4편 — AI한테 일 시키기 전에 알아야 할 5가지
- 5편 — 첫 번째 일 시키기 5분 실습
- 6편 — 슬래시 명령어 모음
- 7편 — CLAUDE.md로 나만의 규칙 만들기
- 8편 — AI가 까먹을 때 대화 이어가기
- 9편 — (준비 중)
- 10편 — (준비 중)
- 11편 — 작업 내용 안전하게 저장하는 법 (현재 글)
다음 편에서는 시리즈 완결편 또는 심화 활용법을 다룰 예정입니다
1편부터 다시 보기 →
참고 자료
· Anthropic Claude Code 공식 문서 — docs.anthropic.com
· GitHub 공식 — github.com
댓글
댓글 쓰기