Git 명령어 하나도 몰라도 괜찮아 — Claude Code로 revert까지 실습한 후기

[Claude Code] Git 명령어 하나도 몰라도 괜찮아 — Claude Code로 revert까지 실습한 후기

📝 한줄 요약

Git을 처음 다뤄보는 상황에서 Claude Code와 자연어 대화만으로 저장소 초기화부터 커밋, 번역, 되돌리기(revert)까지 한 번에 실습했습니다.

바쁘시면 이것만 읽어도 돼요:

• Claude Code로 Git 초기화 → 커밋 → 번역 → 되돌리기까지 자연어로 진행

• "한국어로 돌려줘"라고만 했는데 git revert 명령을 알아서 실행해줌

• revert는 이전 커밋을 삭제하는 게 아니라 새 커밋을 만들면서 되돌린다는 걸 실습으로 체득

• 명령어를 몰라도 일단 시도하고, 거기서 생긴 호기심을 파고들면 이해가 넓어짐

🎯 이런 분들께 도움돼요

• AI 코딩 도구를 처음 접하는 비개발자/입문자

• Git을 배우고 싶지만 명령어가 어려워서 망설이는 분

• 스터디에서 AI 도구 활용 실습을 시작하려는 분

😫 문제 상황 (Before)

Git이라는 걸 들어는 봤지만, commit, revert, reset 같은 명령어들은 생소했습니다. 개발 스터디에서 Git 실습 시간이 잡혔는데, 명령어를 하나하나 외워가며 따라가려니 부담이 컸습니다.

처음에는 스터디장님이 사용하신 Antigravity(구글 AI 코딩 도구)로 따라해보려 했는데, 로그인은 된 상태인데 채팅을 보내도 반응이 없는 현상이 발생했습니다. 신기하게도 스터디장님도 같은 현상을 겪고 있는 중이라, 스터디장님이 그랬듯이 저도 방향을 바꿔서 VSCode에서 Claude Code를 켜고 실습을 진행했습니다. (나중에 안티그래비티 재시작후 재로그인하니까 잘 됨)

🛠️ 사용한 도구

• 도구명: Claude Code (VSCode 확장)

• 모델: Claude Opus 4.6

• 특이사항: Antigravity 인증 이슈로 Claude Code로 전환하여 실습 진행

🔧 작업 과정

AI에게 글 써달라고 했더니 — 파일 생성부터 알아서

스터디 실습의 첫 번째 과제는 마크다운 문서를 만들어보는 것이었습니다. AI에 대한 글을 한국어로 작성해달라고 요청했습니다.

ai에 대한 글을 한국어로 작성해서 md 파일로 저장해

Claude Code가 AI의 정의, 분류, 핵심 기술, 산업별 활용 사례, 윤리적 과제까지 다룬 종합 문서를 ai.md 파일로 바로 만들어줬습니다. 직접 작성했으면 한참 걸렸을 내용인데, 한마디에 완성된 문서가 나와서 신기했습니다.

"커밋해줘" 한마디로 Git 시작 — 저장소 초기화까지 알아서

문서가 만들어졌으니 Git에 저장해보고 싶었습니다.

깃 커밋해줘

그런데 아직 Git 저장소가 만들어지지 않은 상태였습니다. Claude Code가 이걸 스스로 감지하고 "Git 저장소가 초기화되어 있지 않습니다. git init을 실행할까요?"라고 물어봤습니다. 승인하니까 저장소 초기화부터 해줬습니다.

그리고 폴더에 파일이 3개 있었는데(a.md, ai.md, b.md), "모두 커밋할까요, ai.md만 커밋할까요?"라고 다시 물어봤습니다. 원하는 파일만 골라서 커밋할 수 있었습니다.

ai.md만

불필요한 파일이 섞이지 않게 확인해주는 게 좋았습니다.

영어로 바꿔달라고 했더니 — 번역 후 커밋까지 한 번에

이번엔 같은 문서를 영어 버전으로 바꿔보고 싶었습니다.

문서를 영어로 교체해

기존 한국어 파일을 읽고, 영어로 번역해서 덮어쓰고, Git 커밋까지 한 번에 처리해줬습니다. 커밋 메시지도 docs: ai.md 문서를 한국어에서 영어로 번역이라고 깔끔하게 달아줬습니다.

"돌려줘" 한마디에 revert 실행 — 여기서 진짜 배움이 시작됐다

영어 버전을 확인한 후, 다시 한국어로 돌아가고 싶었습니다.

한국어로 된 문서로 돌려줘

Claude Code가 git revert HEAD --no-edit 명령을 실행했습니다. 커밋 메시지도 Revert "docs: ai.md 문서를 한국어에서 영어로 번역"이라고 자동으로 작성해줬습니다. 이 명령어를 직접 쳤어야 했다면 사용법을 찾아보는 데만 한참 걸렸을 텐데, 자연어 한 줄로 끝났습니다.

그런데 여기서 끝이 아니었습니다. revert가 실행된 결과를 보니, 이전 커밋이 삭제된 게 아니라 새로운 커밋이 추가되면서 되돌아간 것이었습니다. 이게 궁금해서 더 찾아봤더니, Git에는 revert 말고 reset이라는 명령도 있는데, 이건 과거로 돌아가면서 이력 자체를 삭제하는 방식이라는 걸 알게 됐습니다. 협업할 때 이 두 명령의 차이를 아는 게 중요하겠다는 생각이 들었습니다.

실습으로 직접 해보니까 개념이 와닿았습니다. 예전 같았으면 Git 명령어를 익숙해질 때까지 반복 실습해야 했을 텐데, AI 도구 덕분에 명령어 자체보다 그 명령이 왜 존재하는지, 어떤 상황에서 쓰는지에 집중할 수 있었습니다.

✅ 결과 (After)

Before vs After

결과물

• ai.md — AI에 대한 한국어 종합 문서

• Git 커밋 3개 (생성 → 번역 → 되돌리기)로 구성된 버전 히스토리

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

1. 실수해도 AI가 되돌리는 방법을 알려주니까 부담 없이 시도할 수 있다 — "돌려줘"라고만 하면 적절한 명령을 알아서 골라줌

2. 모르는 개념이 나오면 바로 이어서 질문하면 된다 — revert 결과를 보고 궁금해진 reset 개념도 바로 찾아볼 수 있었음

소소하지만 확실한 팁

실습 중에 스터디장님이 Mac Finder에서 Cmd + Shift + .을 누르면 숨김 파일을 볼 수 있다는 단축키를 알려주셨습니다. Git을 쓰면 .git 같은 숨김 폴더가 생기는데, 이걸 Finder에서 확인하고 싶을 때 딱 필요한 단축키입니다. 사실 평소에 숨김 폴더나 파일 보고싶은 순간이 많았는데 검색 한 번이면 알 수 있는 것인 줄 알면서도 매번 귀찮아서 넘어가던 것이었거든요. 이런 작은 팁 하나가 작업 흐름을 확 바꿔주기도 합니다.

이렇게 하면 안 돼요

1. AI가 해준 결과를 그냥 넘기지 마세요 — revert 결과를 유심히 봤기 때문에 "이력이 삭제되지 않는다"는 핵심을 알게 됐습니다

2. 도구가 안 되면 너무 붙잡지 마세요 — Antigravity 인증 이슈가 생겼을 때 바로 Claude Code로 전환한 게 시간을 아꼈습니다

🌍 다른 업무에 적용한다면?

• 반복적인 문서 작업(번역, 포맷 변환, 요약)을 AI에게 맡기고 Git으로 버전 관리

• 새로운 도구나 명령어를 배울 때 AI와 함께 실습하면서 개념 중심으로 학습

• 팀 협업에서 Git 히스토리 관리(revert vs reset 선택) 시 AI에게 상황 설명하고 적절한 명령 추천받기

🚀 앞으로의 계획

스터디에서 패키지 관리자(npm, pip 등)와 Docker도 이어서 실습할 예정입니다. 이번에 Git을 AI와 함께 배운 것처럼, 세세한 명령어와 개념을 하나씩 잡아가면서 환경설정 문제를 스스로 해결할 수 있는 사람으로 거듭나고 싶습니다.

📋 재사용 가능한 프롬프트

프롬프트 1: 마크다운 문서 생성

[주제]에 대한 글을 한국어로 작성해서 md 파일로 저장해 [주제]는 본인이 원하는 주제로 변경하세요

프롬프트 2: Git 커밋

깃 커밋해줘 AI가 저장소 상태를 확인하고 초기화, 파일 선택, 커밋 메시지 작성까지 안내해줍니다

프롬프트 3: 이전 상태로 되돌리기

[이전 상태]로 돌려줘 예: "한국어로 된 문서로 돌려줘", "삭제 전 상태로 돌려줘"