코드를 실행하랬더니 왜 git부터 깔라고 하나
비개발자가 AI로 뭔가를 만들어보려고 Claude Desktop에 '이 코드를 실행해줘'라고 요청하면, 기대와 달리 코드가 돌아가는 게 아니라 'git을 먼저 설치하세요'라는 안내가 뜹니다. 코딩 도구인 Claude Code를 설명하기도 전에, git이라는 처음 듣는 이름부터 나오는 겁니다.
많은 사람이 여기서 당황합니다. 나는 코드를 만들고 싶었는데 왜 다른 걸 깔라고 하지? 하지만 이건 순서상 자연스러운 일입니다. AI가 만든 코드를 안전하게 다루려면 그 코드의 변경 이력을 관리할 도구가 먼저 필요하고, 그 표준이 git이기 때문입니다.
git이란 무엇인가
git은 코드의 변경 이력을 기록하고 관리하는 '버전 관리' 도구입니다. 워드나 구글 문서의 '변경 내용 추적'이나 '버전 기록'을 떠올리면 가깝습니다. 다만 문서 한 개가 아니라, 폴더 안의 코드 파일 전체를 통째로 시점별로 저장한다는 점이 다릅니다.
코드를 저장할 때마다 git은 '이 순간의 전체 상태'를 스냅샷처럼 남깁니다. 그래서 코드가 어떻게 바뀌어 왔는지 되짚을 수 있고, 원하는 과거 시점으로 통째로 돌아갈 수도 있습니다. 개발자들이 수십 년째 코드를 다루는 공용어이자, AI 코딩 도구들이 전제로 삼는 기반이기도 합니다.
git을 왜 써야 하나
가장 큰 이유는 되돌리기입니다. 바이브 코딩은 AI에게 '이렇게 바꿔줘'를 반복하는 작업인데, AI가 멀쩡하던 코드를 엉뚱하게 고쳐 놓는 일이 자주 생깁니다. git이 있으면 '방금 그 변경 전으로 돌려줘' 한 번으로 직전의 정상 상태로 복구됩니다. 이게 없으면 망가진 코드를 손으로 되돌려야 합니다.
두 번째는 안전한 보관입니다. 내 PC의 코드를 git으로 관리하면, 그 이력을 GitHub 같은 원격 저장소에 통째로 올려 백업할 수 있습니다. 컴퓨터가 고장 나도 다른 PC에서 그대로 이어받을 수 있습니다.
세 번째는 협업입니다. 여러 사람이 같은 코드를 각자 고치고 합치는 일을 git이 충돌 없이 정리해 줍니다. 지금 당장은 혼자 쓰더라도, 조금만 규모가 커지면 반드시 필요해집니다.
git은 어디서 어떻게 설치하나
설치 방법은 크게 셋입니다. 첫째, 공식 사이트(git-scm.com)에 접속해 내 운영체제용 설치 파일을 받아 여느 프로그램처럼 깝니다. 둘째, 터미널에 명령어 한 줄을 붙여 넣어 설치합니다. 맥은 Homebrew로, 윈도우는 winget으로 받는 방식이 대표적입니다.
셋째, 그리고 제가 실제 교육에서 권하는 방식은 설치 자체를 Claude Code에게 시키는 것입니다. '내 컴퓨터에 git을 설치해줘'라고 하면, 에이전트가 지금 PC 환경을 확인하고 맞는 명령을 골라 실행해 줍니다. 사람마다 다른 PC 환경과 숙련도 때문에 생기는 '여기서 next를 눌러요? install을 눌러요? 이 옵션은 뭘 골라요?' 같은 막힘을 에이전트에게 맡겨 넘기는 겁니다. 첫 실습이 곧 도구를 배우는 과정이 됩니다.
# macOS (Homebrew 사용)
brew install git
# Windows (winget 사용)
winget install --id Git.Git
# 설치 확인 (버전이 찍히면 성공)
git --version내 컴퓨터에 git을 설치해줘.
설치가 끝나면 git --version으로 확인해줘.git clone, git push, git pull은 무엇인가
설치를 끝냈다고 이 명령들을 바로 배우지는 않습니다. 실제 교육에서는 바이브 코딩에 어느 정도 적응한 한참 뒤에 알려줍니다. 처음엔 '일단 git을 깔았다'로 충분합니다. 다만 앞으로 반드시 만날 세 명령이라, 뜻만 미리 알아 두면 좋습니다.
git clone은 원격 저장소(GitHub 등)에 있는 코드를 통째로 내 PC로 복제해 오는 명령입니다. 남이 만든 프로젝트나 내 백업을 내려받아 시작할 때 씁니다.
git push는 내 PC에서 바꾼 코드의 변경 이력을 원격 저장소로 밀어 올리는 명령입니다. 작업 결과를 백업하거나 남과 공유할 때 씁니다.
git pull은 반대로, 원격 저장소의 최신 변경을 내 PC로 당겨 받아 맞추는 명령입니다. 다른 PC나 동료가 올린 변경을 내 것에 반영할 때 씁니다. clone은 처음 한 번, push와 pull은 작업할 때마다 주고받는다고 보면 됩니다.
# 원격 저장소를 내 PC로 복제
git clone <저장소 주소>
# 내 변경을 원격으로 올리기
git push
# 원격의 최신 변경을 내 PC로 받기
git pullgit을 깔면 첫 난관은 넘은 것
힘들게 설치를 끝내면 일단 간단한 게임이나 웹사이트부터 만들어봅니다. 되돌리기라는 안전벨트가 채워졌으니, AI에게 마음껏 시켜보고 망치면 되돌리는 연습을 할 수 있습니다. git을 깔았다면 바이브 코딩의 첫 관문은 넘은 겁니다.
비개발자의 바이브 코딩은 코드 실력이 아니라 환경 설치에서 먼저 갈립니다. 그래서 AX 교육의 진짜 첫 수업은 'AI에게 무엇을 시킬까'가 아니라 '첫 도구가 왜 하필 git인지'를 이해시키는 데서 시작합니다. 이 벽을 넘은 사람과 넘지 못한 사람의 차이가 이후 모든 학습 속도를 가릅니다.