작업 이력 남기기 — 깃(Git) 기초

깃이라는 말에 겁먹을 필요가 없습니다. 명령어를 하나도 외우지 않아도 됩니다. 이 페이지에서 기억할 것은 두 가지뿐입니다. 깃은 파일이 바뀐 기록을 남기는 도구라는 것, 그리고 그 기록 관리는 전부 클로드에게 말로 시키면 된다는 것입니다. 기록을 남기는 습관이 필요한 이유는 AI가 자기가 무엇을 망쳤는지 스스로 알아채지 못하기 때문입니다. 이 약점이 왜 생기는지는 「AI는 자기가 한 일을 스스로 판단하지 못합니다」 페이지에서 설명합니다.

깃이란 — 작업 폴더의 이력 앨범

깃은 작업 폴더에서 무엇이 언제 어떻게 바뀌었는지, 그 변경 이력을 저장하고 관리하는 도구입니다. 공식 안내의 비유를 빌리면, 사진을 찍어 앨범에 차곡차곡 모아 두는 것과 비슷합니다. 일이 어느 정도 되었을 때마다 그 시점의 사진을 한 장씩 남기는데, 이것이 커밋(바뀐 내용을 한 묶음으로 저장하는 일)입니다. 그렇게 남겨 두면 나중에 무엇이 잘못되어도 사진이 남은 시점으로 언제든 돌아갈 수 있습니다.

클로드에게 일을 시키다 보면 파일이 계속 바뀝니다. 이력을 남겨 두지 않으면 “어제까지는 멀쩡했는데”의 그 어제로 돌아갈 방법이 없습니다. 그래서 우리 회사도 일을 한 단계 마칠 때마다 커밋으로 저장합니다.

전부 말로 시킵니다

깃은 원래 터미널 명령어로 다루는 도구지만, 클로드 코드 안에서는 말로 시키는 것이 기본입니다. 지금 상태가 궁금하면 이렇게 묻습니다.

# 무엇이 바뀌었는지 확인 — 공식 안내의 예시
지금까지 어떤 파일이 바뀌었나요?

# 이력 남기기(커밋)
바뀐 내용을 설명이 담긴 메시지와 함께 커밋해 주세요.

이력을 뒤져 보거나 되돌리는 일도 같은 방식입니다.

# 이력 살펴보기
최근 커밋 5개를 보여 주세요.
방금 커밋에서 뭐가 바뀌었는지 보여 주세요.

# 사고가 났을 때
어제 커밋 상태로 되돌려 주세요.

더 복잡한 일도 됩니다. “feature/quickstart라는 새 브랜치를 만들어 주세요”, “병합 충돌(merge conflict) 해결을 도와주세요”처럼 개발자들이 어려워하는 작업까지 말로 맡길 수 있습니다. 무슨 뜻인지 몰라도 괜찮습니다. 필요해지는 날 클로드에게 물어보십시오.

알아 둘 용어는 세 개면 충분합니다

체크포인트와 무엇이 다를까요

클로드 코드에는 /rewind로 되돌리는 체크포인트가 따로 있습니다. 체크포인트는 클로드가 파일을 고치기 전에 자동으로 남겨 두는 임시 저장입니다. 편하지만 한계가 있습니다. 한 세션(대화창을 열어 일하고 닫기까지)에 최근 100개까지만 보관합니다. 오래된 세션은 기본적으로 30일이 지나면 정리되며, 이 기간은 설정에서 바꿀 수 있습니다. 되돌리는 대상도 클로드가 자기 편집 도구로 고친 파일뿐입니다. 공식 안내도 체크포인트가 깃을 대신하지 못한다고 분명히 적어 두었습니다.

그러니 체크포인트는 방금 한 일을 잠깐 되돌릴 때 쓰고, 오래 남길 기록은 설명을 붙인 커밋으로 저장하십시오.

백업은 한 줄이면 됩니다

커밋은 내 컴퓨터 안의 기록입니다. 컴퓨터가 고장 나면 그 기록도 함께 사라집니다. 그래서 깃허브(GitHub) 같은 원격 저장소(인터넷에 있는 저장소)에 올려 둡니다. 그러면 컴퓨터가 고장 나도 이력은 남아 있습니다. 이것도 말로 시킵니다. “지금까지 커밋을 깃허브에 올려 주세요”라고 하면 됩니다.

올리기 전에 한 번 걸러 냅니다

커밋에는 담기로 고른 파일만 들어갑니다. 다만 폴더를 통째로 고를 수도 있습니다. 그래서 “백업해 주세요”라고만 시키면, 그 폴더에 들어 있던 고객 명단·계약서·비밀번호가 적힌 파일까지 같은 묶음에 담겨 올라갈 수 있습니다.

올리기 전에 무엇이 올라가는지 한 번 보고, 빼야 할 것을 빼 두면 됩니다. 이 두 가지도 전부 말로 시킵니다.

제외 목록(.gitignore) — 올리지 않을 파일·폴더 이름을 적어 두는 목록

.gitignore는 올리지 않을 파일·폴더 이름을 적어 두는 목록입니다. 이 목록에 이름이 적힌 파일은 커밋에도 담기지 않고 인터넷에도 올라가지 않습니다. 공식 안내도 저장소에 올리고 싶지 않은 파일은 이 목록에 넣으라고 적어 두었습니다. 나만 쓰는 설정 파일인 CLAUDE.local.md가 그런 파일입니다. 개인 설정 파일인 .claude/settings.local.json은 클로드가 만든 것이라면 클로드가 알아서 목록에 넣어 줍니다. 내가 직접 만든 것이라면 내가 목록에 적어야 합니다. 밖으로 나가면 안 되는 회사 자료도 같은 목록에 적어 두면 됩니다.

다만 여기에 한 가지 함정이 있습니다. 이미 한 번 올라간 적이 있는 파일은, 목록에 이름을 적는 것만으로는 빠지지 않습니다. 제외 목록은 “앞으로 새로 담을 것”을 걸러 내는 목록이라, 이미 기록에 들어간 파일은 계속 따라 올라갑니다. 그런 파일이 보이면 클로드에게 “이 파일은 앞으로 올라가지 않게 해 주세요”라고 함께 시키십시오.

공식 안내는 비밀 정보가 든 대표적인 파일로 .env(비밀번호나 API 키가 담긴 파일)와 secrets/ 폴더를 듭니다. 사장님 폴더라면 여기에 고객 명단·계약서·정산표처럼 밖으로 나가면 안 되는 파일이 더해집니다.

실전 — 두 마디로 끝냅니다

순서가 중요합니다. 먼저 보고, 그다음에 뺍니다.

# ⓐ 올리기 전 — 무엇이 올라가는지 목록으로 먼저 봅니다
지금 깃허브에 올리면 어떤 파일이 함께 올라가는지,
올리기 전에 목록으로 먼저 보여 주세요.
그중에 고객 정보나 비밀번호가 들어 있을 만한 파일이 있으면 표시해 주세요.

목록을 눈으로 훑어 “이건 나가면 안 되는데” 싶은 것이 보이면, 그 자리에서 빼 달라고 시킵니다.

# ⓑ 빼기 — 제외 목록에 넣어 달라고 시킵니다
방금 목록에서 고객 명단과 비밀번호가 든 파일을 .gitignore 제외 목록에 넣어 주세요.
이미 올라간 적이 있는 파일이라면, 앞으로는 올라가지 않게 함께 처리해 주세요.
넣은 뒤에 다시 한번, 올라갈 파일 목록을 보여 주세요.

가운데 한 줄(“이미 올라간 적이 있는 파일이라면”)을 빼지 마십시오. 이것이 앞서 말한 함정을 막는 줄입니다. 마지막 한 줄(“다시 한번 보여 주세요”)도 그대로 두십시오. 제대로 빠졌는지 눈으로 확인하고 나서 올리는 습관이 사고 대부분을 미리 걸러 냅니다.

요령 — 하루 한 번, 커밋 하나

거창한 규칙은 필요 없습니다. 하루 일을 마칠 때 한 줄만 습관으로 삼으면 됩니다.

# 퇴근 전 한 줄 습관
오늘 작업한 내용을 커밋해 주세요.

이 한 줄이 쌓이면, 어느 날 무엇이 망가져도 “어제로 돌아가 주세요” 한마디로 복구할 수 있는 회사가 됩니다.