기본 콘텐츠로 건너뛰기

클로드 코드 왕초보 가이드 11편 — Git으로 작업 안전하게 저장하기 2026

thumbnail

Photo by Chan Yuwoh on Unsplash

클로드 코드 왕초보 가이드 — 11편 전체 목차 보기
Claude Code로 파일을 수정하다가 "아, 아까 그 버전이 더 나았는데" 싶은 적 있으신가요? Ctrl+Z를 연타해도 돌아가지 않는 그 순간. Git을 쓰면 무한 Ctrl+Z가 됩니다. 비개발자도 세 마디면 끝납니다.

AI한테 파일을 고치라고 시키면, 파일이 순식간에 바뀝니다. 한 번이면 괜찮은데 두세 번 고치다 보면 "처음 버전이 나았다"는 생각이 듭니다. 문제는 그때 이미 처음 버전이 사라져 있다는 겁니다.

광고 자리 (AdSense 승인 후 교체)

왜 저장이 따로 필요한가

일반적인 문서 작업이라면 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 statusgit diff를 실행해서 변경 내역을 보여줍니다. 명령어를 외울 필요 없습니다.

2 저장 (Commit) — "저장해줘"

마음에 드는 상태가 되면 "저장해줘"라고 말합니다. 이걸 Git에서는 커밋(Commit)이라고 부릅니다. 작업물을 상자에 넣고 라벨을 붙이는 겁니다.

지금 상태 저장해줘. "메인 페이지 레이아웃 완성"이라고 메모 남겨줘

라벨(커밋 메시지)은 나중에 "아, 이때 이걸 했구나"를 찾을 때 씁니다. 날짜만 있는 것보다 훨씬 편합니다.

3 올리기 (Push) — "올려줘"

저장한 상자를 클라우드 창고(GitHub)로 보내는 단계입니다. 내 컴퓨터가 고장 나도 GitHub에 백업이 남습니다.

GitHub에 올려줘

택배 보내는 것과 같습니다. 상자(커밋)를 포장하고, 택배(푸시)로 창고(GitHub)에 보내는 겁니다.

광고 자리 (AdSense 승인 후 교체)

Before / After — Git 쓰기 전과 후

Before — Git 없이 작업
  • "아까 버전이 나았는데" → 복구 불가
  • 파일을 수동으로 복사 (v1, v2, v3_최종_진짜최종)
  • 컴퓨터 고장 → 작업물 전부 소실
  • 뭘 언제 고쳤는지 기억 안 남
After — Git 사용 후
  • "아까 버전으로 돌아가줘" → 즉시 복구
  • 자동 버전 관리 (커밋 메시지로 구분)
  • 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이 무시하게 할 수 있습니다.

.gitignore 파일 만들어줘. .env 파일이랑 API 키가 들어간 파일은 올라가지 않게 해줘

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 시대에 가장 중요한 습관이 있다면, 작업을 빠르게 하는 것보다 안전하게 저장하는 것입니다.


시리즈 전체 목차

#멜론 AI 인사이트 #Claude Code #초보자 가이드 #비개발자

다음 편에서는 시리즈 완결편 또는 심화 활용법을 다룰 예정입니다

1편부터 다시 보기 →

광고 자리 (AdSense 승인 후 교체)

참고 자료
· Anthropic Claude Code 공식 문서 — docs.anthropic.com
· GitHub 공식 — github.com

댓글

이 블로그의 인기 게시물

AI 비서로 블로그 만들었더니 5일 만에 682명 왔습니다 - 비개발자가 직접 해본 솔직 후기

Photo by Ronan Furuta on Unsplash 코딩 한 줄 못 짜는 사람이 AI 비서 하나로 블로그를 만들었습니다. 개설 5일 만에 682명 방문. 그 전 기록: 0명. 블로그 한번 해볼까 생각은 많이 했습니다. 근데 막상 시작하면 글 쓰는 게 너무 고되잖아요. 주제 잡고, 조사하고, 쓰고, 퇴고하고… 한 편에 반나절은 기본이니까요. 저도 그 이유로 몇 번을 포기했어요. 그러다 올해 3월에 AI 비서를 붙여서 다시 해봤습니다. 결과가 꽤 달랐습니다. 광고 자리 (AdSense 승인 후 교체) 실제 Blogger 통계 화면 — 개설 5일 만에 전체 682명 개설 5일 성과 — 숫자부터 보여드립니다 말보다 숫자가 솔직합니다. 682 5일 총 방문자 128 하루 최고 방문자 13 발행한 글 수 블로그 개설일: 2026년 3월 26일. 5일 뒤 방문자: 682명. 글 13편으로 만들어낸 수치입니다. 일반적인 블로그는 첫 달에 수십 명도 쉽지 않다는 걸 감안하면, 5일 만에 682명은 꽤 의미 있는 숫자입니다. ❌ 혼자 블로그 할 때 글 1편에 반나절 주제 정하는 데 1시간 금방 지쳐서 포기 발행 주기 0 (결국 안 씀) 5일에 682명? 꿈도 못 꿈 ✅ AI 비서와 함께 글 1편에 1~2시간 트렌드 체크 + 주제 자동 제안 첫 달 13편 발행 하루 최고 128명 방문 5일 만에 682명 달성 무엇을 어떻게 만들었나요? 플랫폼은 구글 블로거(Blogger) 를 선택했습니다. 무료이고, 구글 생태계 안에 있어서 애드센스 연결이 가장 간단하다는 이유였습니다. AI 비서는 Claude Code...

Claude로 블로그 만들었더니 개설 5일 만에 682명 — 비개발자 세팅 완전 가이드

Photo by Bernd 📷 Dittrich on Unsplash 블로그를 세 번 시작하고 세 번 다 포기했습니다. 이번엔 Claude AI 비서를 붙였습니다. 결과는 개설 5일 만에 682명. 글 하나 쓰는 데 반나절씩 걸리다 보니 금방 지치는 게 당연했습니다. 저도 그 이유로 몇 번을 포기했어요. 이번엔 뭔가 달라야 했는데, 그게 Claude였습니다. 제가 주제 소스를 던지면 Claude가 트렌드를 확인하고 초안을 씁니다. 저는 읽고 "발행해" 한 마디. 그 흐름으로 13편을 냈더니 5일 만에 682명이 왔습니다. 성과 전체가 궁금하면 이 글을 먼저 보세요. 이 글은 그 결과를 만들기까지의 세팅 과정 입니다. 코딩 한 줄 없이, 비개발자가 Claude 비서 블로그를 어떻게 세팅했는지 단계별로 공유합니다. 광고 자리 (AdSense 승인 후 교체) 준비물은 딱 3가지입니다 복잡하게 생각할 것 없습니다. 저도 처음엔 뭐가 뭔지 몰라서 한참 헤맸는데, 결국 필요한 건 이 세 가지였어요. 🤖 Claude AI 글을 써주는 AI 비서. claude.ai 계정만 있으면 됩니다. 📝 Google Blogger 블로그 플랫폼. 구글 계정만 있으면 무료로 시작 가능합니다. 💬 텔레그램 비서에게 지시를 내리는 채널. 스마트폰으로 어디서든 명령합니다. 추가로 있으면 좋은 게 Claude Code인데, 이건 처음부터 없어도 됩니다. 저도 처음엔 claude.ai 웹 버전으로만 했고, 자동화는 나중에 붙였습니다. 광고 자리 (AdSense 승인 후 교체) 세팅 5단계 — 처음 하는 사람 기준으로 씁니다 제가 실제로 거친 순서입니다. 중간에 삽질도 있었지만, 이 순서대로 하면 최단 경로입니다. 1 Google Blogger 계정 만들기 blogger.com...

코딩 없이 나만의 AI 비서 만들기 1편 — 준비물 3가지와 Claude 계정 세팅 완전 가이드

Photo by Daniel Sturley on Unsplash AI 비서 만들기 시리즈 1편 코딩 몰라도 됩니다. 준비물 딱 3가지면 AI 비서를 만들 수 있습니다. 이 글에서 계정 세팅부터 첫 대화까지 단계별로 안내합니다. "AI 비서 만들기"라는 말을 들으면 막막하게 느껴지는 분들이 많습니다. 개발자나 할 수 있을 것 같고, 코드를 써야 할 것 같고, 어디서 시작해야 할지 모르겠다는 생각이 드는 게 당연합니다. 저도 처음엔 그랬습니다. 그런데 실제로 해보니 달랐습니다. Claude를 사용하면 코딩 경험이 전혀 없어도 나만의 AI 비서를 만들 수 있습니다. 이 시리즈는 딱 그 과정을 담습니다. 1편에서는 AI 비서가 무엇인지, 어떤 준비물이 필요한지, Claude 계정을 어떻게 세팅하는지 처음부터 안내합니다. 광고 자리 (AdSense 승인 후 교체) AI 비서란 무엇인가 — 쉽게 이해하기 AI 비서를 한 문장으로 정의하면 이렇습니다. "내가 시키는 일을 대신 해주는 AI 프로그램" 입니다. 카카오톡처럼 메시지를 보내면, 반대편에서 AI가 답하거나 행동합니다. 예약을 잡아주거나, 정보를 요약해주거나, 이메일 초안을 써줍니다. 기존의 AI 서비스(ChatGPT, Claude)와 다른 점은 내 상황에 맞게 세팅된다 는 겁니다. 일반 AI 사용 (Before): 매번 새 창 열기 → 내 상황 설명 → 질문 → 답변 받기 AI 비서 (After): 텔레그램/디스코드에서 메시지 입력 → 나에 대해 이미 아는 AI가 즉시 답변 → 24시간, 폰으로도, 내 업무 맥락 기억 차이가 보이시나요? AI 비서는 매번 처음부터 설명하지 않아도 됩니다. 내 직업, 내 업무 스타일, 내가 자주 쓰는 표현을 모두 기억한 채로 대화합니다. 이 시리즈로 뭘...