Claude Code 쓰기 전에 알아야 할 Git 기초 개념

Claude Code를 처음 설치하고 실행하면 터미널에 낯선 단어가 등장합니다. "git init", "git commit", "repository". 이 단어들을 모르면 Claude Code가 하는 말을 절반도 이해하기 어렵습니다. 이 글은 Git을 깊게 공부하는 것이 목적이 아닙니다. Claude Code를 쓰기 위해 꼭 알아야 하는 최소한의 개념만 짚습니다.

 

 

Git이 뭔지 한 문장으로 설명한다면

Git은 파일의 변경 이력을 기록하고 관리하는 도구입니다.

조금 더 풀어서 말하면 이렇습니다. 여러분이 Word 문서를 작성할 때 "과제_최종.docx", "과제_최종2.docx", "과제_진짜최종.docx"처럼 파일을 복사해서 버전을 관리한 적이 있을 것입니다. Git은 바로 그 과정을 자동으로, 체계적으로 처리해 주는 소프트웨어입니다.

Git은 2005년 리눅스(Linux) 운영체제를 만든 리누스 토르발스(Linus Torvalds)가 개발했습니다. 원래는 수천 명의 개발자가 동시에 하나의 거대한 코드를 수정할 때 충돌을 막기 위해 만들어졌습니다. 지금은 전 세계 거의 모든 소프트웨어 프로젝트가 Git을 사용합니다.

Git이 다루는 핵심 개념 두 가지를 먼저 알아야 합니다.

• 첫 번째는 레포지토리(repository)입니다. 레포지토리는 "저장소"라는 뜻입니다. 단순한 폴더가 아니라, 그 폴더 안의 모든 파일 변경 이력이 함께 저장되는 특별한 공간입니다. 폴더 안에 .git이라는 숨김 폴더가 생기면 그 폴더는 레포지토리가 됩니다.
• 두 번째는 커밋(commit)입니다. 커밋은 "지금 이 상태를 저장해 두겠다"는 선언입니다. Word의 저장(Ctrl+S)과 비슷하지만, 단순한 저장이 아니라 "이 시점의 스냅샷(snapshot, 그 순간의 상태를 찍은 사진)"을 남기는 것입니다. 커밋마다 메시지를 달 수 있어서 "로그인 기능 추가", "버그 수정" 같이 변경 이유를 기록할 수 있습니다.

Git을 사용하면 언제든지 과거의 커밋 시점으로 되돌아갈 수 있습니다. 코드를 잘못 수정해도, 실험적으로 뭔가를 바꿔봐도, 원하면 언제든 이전 상태로 복구됩니다.

처음 Git을 접하는 분들이 가장 많이 하는 오해가 있습니다. Git과 GitHub(깃허브)를 같은 것으로 생각하는 것입니다. Git은 내 컴퓨터에 설치되는 버전 관리 도구이고, GitHub는 Git으로 관리하는 프로젝트를 인터넷에 올려두는 서비스입니다. Git이 없으면 GitHub도 쓸 수 없습니다.

 

 

 

 

Git이 파일을 저장하는 방식

Git이 파일을 저장하는 방식은 일반적인 파일 저장과 다릅니다. 이 차이를 이해하면 Git이 왜 강력한지 알 수 있습니다.

일반적인 파일 저장 방식은 덮어쓰기입니다. 파일을 수정하고 저장하면 이전 내용은 사라집니다. "과제_최종.docx"를 수정하고 저장하면 수정 전 내용은 영원히 없어집니다.

Git의 저장 방식은 다릅니다. 변경된 내용만 추적하고, 커밋할 때마다 그 시점의 상태를 스냅샷으로 남깁니다. 파일 전체를 매번 복사하는 것이 아니라, 무엇이 달라졌는지(diff, 차이점)만 기록합니다. 덕분에 용량도 적게 차지하고, 변경 이력도 정확하게 남습니다.

Git의 작업 흐름은 세 가지 공간으로 나뉩니다.

• 작업 디렉토리(working directory)는 실제로 파일을 편집하는 공간입니다. 여러분이 VS Code나 메모장으로 파일을 열고 수정하는 그 공간입니다.
• 스테이징 영역(staging area)은 커밋할 준비가 된 파일을 모아두는 임시 공간입니다. 무대에 오르기 전 대기실과 같습니다. git add 명령어로 파일을 이 공간으로 이동시킵니다.
• 레포지토리(repository)는 최종적으로 커밋이 저장되는 공간입니다. git commit 명령어를 실행하면 스테이징 영역에 있는 파일들이 이 공간에 영구 기록됩니다.

이 세 단계를 비유로 설명하면 이렇습니다. 택배를 보내는 상황을 생각해 보십시오. 작업 디렉토리는 집 안에서 물건을 준비하는 공간입니다. 스테이징 영역은 택배 박스 안에 물건을 담는 과정입니다. 레포지토리는 택배 박스를 봉인하고 송장을 붙여 발송한 상태입니다. 일단 발송된 택배는 기록에 남고, 나중에 추적할 수 있습니다.

브랜치(branch, 가지)라는 개념도 중요합니다. 하나의 레포지토리에서 여러 방향으로 작업을 동시에 진행할 수 있는 기능입니다. 본류(main 브랜치)는 안정적인 버전을 유지하고, 새로운 기능을 실험할 때는 새 브랜치를 만들어 작업합니다. 실험이 성공하면 본류에 합칩니다(merge, 병합). Claude Code와 함께 작업할 때 브랜치를 활용하면 AI가 제안한 변경 사항을 안전하게 테스트할 수 있습니다.

 

 

 

Claude Code와 Git이 연결되는 순간

Claude Code를 처음 실행하면 바로 이런 상황이 만들어집니다. Claude Code는 코드를 직접 작성하고 수정하는 AI 도구입니다. 여러분이 "이 함수를 고쳐줘"라고 요청하면 Claude Code는 실제로 파일을 열고, 코드를 수정하고, 저장합니다.

문제는 Claude Code가 파일을 수정하면 이전 코드가 어떻게 바뀌었는지 추적하기 어렵다는 점입니다. Git이 없다면 Claude Code가 수정한 내용이 마음에 들지 않을 때 원상복구가 어렵습니다. Ctrl+Z로 되돌리는 것은 에디터를 닫는 순간 불가능해집니다.

Git이 있으면 Claude Code와의 작업이 완전히 달라집니다.

Claude Code가 코드를 수정하기 전에 커밋을 하나 만들어 두면, 수정 후 결과가 마음에 들지 않아도 언제든 그 시점으로 돌아올 수 있습니다. 실험적인 기능을 Claude Code에게 맡길 때 브랜치를 하나 만들면, 결과물이 나쁠 경우 브랜치 전체를 버릴 수도 있습니다.

Claude Code 자체도 Git을 이해합니다. git status(현재 변경 사항 확인)나 git diff(변경된 내용 비교) 같은 명령어를 Claude Code에게 실행하게 하면, Claude Code는 그 결과를 읽고 "어떤 파일이 달라졌는지", "왜 오류가 생겼는지"를 훨씬 정확하게 파악합니다.

실제 사용 시나리오를 하나 들겠습니다. 여러분이 간단한 Python 스크립트를 만들고 있다고 가정합니다. Claude Code에게 "이 스크립트에 오류 처리 기능을 추가해줘"라고 요청했습니다. Claude Code가 파일을 수정했는데, 수정 후 스크립트가 오히려 실행되지 않습니다. Git이 없다면 난감합니다. Git이 있다면 git checkout 명령어 한 줄로 수정 전 상태로 즉시 복구할 수 있습니다.

Claude Code 공식 문서에서도 프로젝트를 시작할 때 Git 레포지토리를 먼저 초기화하도록 권장합니다. git init 명령어 한 번으로 현재 폴더가 레포지토리가 됩니다. 이 작업은 30초도 걸리지 않습니다.

 

 

 

 

Git 없이 Claude Code만 써도 되는가

결론부터 말씀드리겠습니다. 기술적으로는 가능합니다. 하지만 권장하지 않습니다.

Claude Code는 Git 없이도 실행됩니다. 단순히 파일을 열고 내용을 수정하는 작업은 Git이 없어도 됩니다. 특히 처음 Claude Code를 설치하고 간단한 명령어를 테스트하는 단계라면 Git 없이도 충분히 진행할 수 있습니다.

그러나 프로젝트가 조금이라도 복잡해지면 Git 없이 작업하는 것은 여러 위험을 감수해야 합니다.

• 첫째, 실수에 취약합니다. Claude Code가 잘못된 방향으로 파일을 수정해도 되돌릴 방법이 없습니다. 에디터 히스토리는 에디터를 닫으면 사라집니다.
• 둘째, 협업이 불가능합니다. 지금은 혼자 작업한다고 해도, 나중에 다른 사람과 코드를 공유하거나 GitHub에 올리려면 반드시 Git이 필요합니다.
• 셋째, Claude Code의 기능을 절반만 쓰는 셈입니다. Claude Code는 git diff로 변경 사항을 파악하고, git log로 작업 흐름을 이해합니다. Git이 없으면 이 맥락 정보가 빠지기 때문에 Claude Code의 답변 정확도도 낮아집니다.

Git을 배우는 데 얼마나 걸리냐고 물으신다면, Claude Code를 쓰기 위한 최소한의 Git 명령어는 다섯 개입니다. git init(레포지토리 초기화), git add(스테이징), git commit(커밋), git status(상태 확인), git log(이력 확인). 이 다섯 가지만 익히면 Claude Code와의 작업에서 Git의 핵심 이점을 모두 누릴 수 있습니다.

Git 설치 자체도 어렵지 않습니다. Windows에서는 git-scm.com에서 설치 파일을 내려받아 실행하면 됩니다. macOS는 터미널에서 git --version을 입력하면 설치 안내가 자동으로 뜹니다. 설치 후 이름과 이메일을 등록하는 설정 두 줄만 입력하면 바로 쓸 수 있습니다.

Git을 배우는 것이 Claude Code를 배우는 것보다 어렵게 느껴질 수도 있습니다. 그러나 반대로 Git을 먼저 이해하면 Claude Code가 하는 행동이 훨씬 명확하게 보입니다. "왜 지금 이 명령어를 실행하는 거지?"라는 의문이 자연스럽게 풀립니다. 입문 단계에서 Git 개념을 한 번 정리해 두면, 이후 Claude Code 학습의 속도가 눈에 띄게 빨라집니다.

 

 

 

Git은 복잡한 개발 도구가 아닙니다. 파일의 변화를 기록하고, 필요할 때 되돌릴 수 있게 해주는 안전망입니다. Claude Code는 그 안전망 위에서 가장 효과적으로 작동합니다. 다음 글에서는 실제로 Git을 설치하고 Claude Code 프로젝트에 연결하는 과정을 단계별로 확인하겠습니다.