사이트 배포 성공, 그리고 GitHub Desktop과의 첫 충돌
2026.07.31
소개
시도하고자 했던 것과 그 이유.
오늘 네 가지를 했다.
오전: GitHub에 있는 "학습허브 사이트" 템플릿을 내 컴퓨터로 그대로 가져오고, 앞으로 4주간 이 사이트를 채워가는 걸 도와줄 AI 학습메이트를 만들었다. 코딩을 모르기 때문에 회원가입이나 복잡한 설치 없이 통째로 가져오는 게 목표였고, 매번 내 상황(이직 준비, 배우려는 분야, 컴퓨터 환경)을 새로 설명하지 않아도 되도록 AI에게 성격과 규칙을 미리 심어두고 싶었다.
오후: 4주 로드맵을 확정했다. 반도체·배터리·AI로 이직을 준비하는데 이 분야 뉴스가 너무 많아서 하나하나 분석할 시간이 없다는 게 평소 불편함이었다. "뉴스 키워드 요약봇"이라는 어렴풋한 방향을 학습메이트한테 던지고, 로드맵을 구체적으로 짜보기로 했다.
저녁: 지금까지 로컬(내 컴퓨터)에만 있던 사이트를 실제 인터넷 주소로 배포했다. 이직 포트폴리오로 쓰려면 남들도 들어올 수 있는 진짜 웹사이트여야 하는데, 코딩을 모르니 회원가입부터 명령어 실행까지 전부 AI에게 맡겨서 진행했다.
밤: 오늘 작업한 걸 "커밋으로 저장해줘"라고 요청했는데, 알고 보니 이미 다 저장·업로드가 되어 있었다. 왜 그런지 파보다가 내 컴퓨터에 켜져 있던 GitHub Desktop(GUI로 깃을 다루는 프로그램)이 그 사이에 자기가 알아서 커밋·푸시를 해놓은 걸 발견했다. 터미널(AI)과 GitHub Desktop이 동시에 같은 저장소를 건드리면서 파일 잠금(lock) 충돌까지 나서, 원인을 찾아 해결하는 과정을 거쳤다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용했는지.
오전 — 템플릿 가져오기 & 학습메이트 만들기
사용 도구: Claude Code, GitHub, Node.js/npm
저장소 링크를 주고 요청:
"아래 GitHub 링크에 학습허브 사이트 템플릿이 있어. 이 내용을 지금 이 폴더로 그대로 가져와줘. 나는 코딩을 몰라, 회원가입이나 복잡한 설치 없이 가져와줘."
AI가
git clone으로 저장소를 통째로 받아왔다. (클론 대상 폴더에 이미.claude설정 폴더가 있어서 한 번에 안 됐는데, AI가 임시 폴더에 먼저 받은 뒤 옮기는 방식으로 해결했다.)SOUL.md·USER.md·AGENTS.md·CLAUDE.md 4개 파일을 만들기 위해 AI가 순서대로 질문 (이름 후보 → 말투 선택 → 나에 대한 자유 답변). 컴퓨터 환경(OS·Node.js 버전)은 AI가 직접 확인해서 기록.
미리보기 요청:
"이제 내 사이트를 내 컴퓨터에서 미리보기로 띄워줘."
npm install→npm run dev로http://localhost:4321에서 첫 화면 확인.
오후 — 4주 로드맵 확정 & 랜딩페이지 완성
사용 도구: Claude Code(학습메이트), 웹서치(실제 사례 조사), Astro 로컬 미리보기
처음 던진 프롬프트:
내 4주 로드맵 만들어줘. 내가 만들려는 것에 어렴풋한 방향이 있으면,그것에 맞는 실제 사례나 방법을 먼저 찾아보고, 거기에 맞춰서 로드맵을 짜줘.AI가 먼저 "RSS + LLM 뉴스 요약봇" 실제 사례(n8n 자동화 사례, GitHub 오픈소스 프로젝트들)를 웹서치로 찾아본 뒤, 그 틀에 맞춰 하나씩 물어봤다 (뭘 만들고 싶은지 → 왜 → 누구한테 필요한지 → 최종 결과물 → 지금 나 → 되고 싶은 나). 처음엔 "뉴스 요약봇" 정도로만 생각했는데, 질문에 답하다 보니 "기사 하나 요약"이 아니라 "여러 기사에 걸쳐 공통으로 뜨는 키워드를 잡아 설명+사례로 보여주고, 위키에 용어 사전처럼 쌓이는 것"으로 훨씬 뾰족해졌다.
완성된 로드맵을
src/content/wiki/00-roadmap.md에 저장.랜딩·미리보기 요청:
방금 만든 로드맵과 인터뷰 내용으로 내 랜딩 페이지 글을 만들어서,랜딩 자리에 넣어줘. 그리고 로컬로 첫 화면을 보여줘.→
src/content/landing/landing.md반영 후npm run dev로 재확인.
(Tip: 로컬 미리보기 화면 캡처를 여기에 넣으면 좋아요 — 오전엔 첫 배포 화면, 오후엔 새 랜딩 화면)
저녁 — GitHub 업로드 & Vercel 배포
사용 도구: Claude Code, GitHub, GitHub CLI(gh), Git, Vercel, Vercel CLI
먼저 GitHub·Vercel 가입 방법을 안내받음 (GitHub는 이메일·비밀번호·사용자명으로 가입, Vercel은 "Continue with GitHub"로 GitHub 계정 그대로 로그인). 필요한 도구(Git, gh, Node.js, Vercel CLI)를 확인해달라고 했는데 이미 다 설치되어 있었음.
GitHub 업로드 요청:
지금 이 폴더(GPters_Study, 내 학습허브 사이트)를 통째로 GitHub에 올려줘. Git으로 해줘. 나는 코딩을 몰라서 명령어를 직접 못 쳐, 네가 대신 실행해줘.
GitHub에 새 저장소(repository)를 하나 만들어서, 이 폴더 내용을 전부 올려줘.
처음이라 GitHub 로그인/인증이 필요하면, 뭘 어디서 해야 하는지 알려줘.
다 올라가면 GitHub에서 내 사이트 주소(저장소 링크)를 알려줘.
→ 이미 로그인이 되어 있어서
git init→git add→git commit→gh repo create로 저장소 생성과 업로드가 한 번에 끝남.Vercel 배포 요청:
방금 GitHub에 올린 이 사이트를 Vercel로 배포해줘. Vercel CLI로 해줘. 나는 코딩을 몰라서 명령어를 직접 못 쳐, 네가 대신 실행해줘.
Vercel CLI가 없으면 "깔까요?"라고 되묻지 말고 바로 설치해줘.
처음이라 Vercel 로그인이 필요하면, 아까 만든 GitHub 계정으로 로그인하게 안내해줘.
방금 올린 그 GitHub 저장소를 배포하는 거야.
배포가 끝나면 내 사이트 URL(주소)을 알려줘.
→
vercel --prod --yes실행 중 프로젝트 이름 오류 발생 → 이름을gpters-study로 직접 지정해서 재시도, 성공.배포 후 실제 주소로 들어가서 로컬 화면과 똑같이 나오는지, 홈·위키·프로젝트 페이지와 콘솔 에러를 함께 확인함.
(Tip: 여기에 GitHub 저장소 화면 또는 Vercel 배포 완료 화면 스크린샷을 넣으면 좋아요)
밤 — 알고 보니 이미 커밋돼 있었다 (GitHub Desktop 충돌)
사용 도구: Claude Code, Git, GitHub Desktop,
ghCLI오늘 만든 학습일지·사례글·프로젝트 페이지를 "커밋으로 저장해줘"라고 요청했는데,
git status를 보니 이미45c636f라는 낯선 커밋이 올라가 있었고 그 안에 오늘 작업한 내용이 다 들어있었다. AI가 GitHub API로 실제 GitHub 저장소 상태까지 다시 확인해서, 로컬만이 아니라 GitHub에도 이미 반영돼 있다는 걸 알려줬다.남아있던
landing.md의 장난스러운 문구(누군가 인사말을 "ㅎㅇㅎㅇ 나는야 마리아노 리베라 인데욬ㅋㅋㅋㅋ"로 바꿔놓은 것)를 원래대로 되돌리려는데,git restore가 자꾸 이 오류로 막혔다:fatal: Unable to create '.../.git/index.lock': File exists.Another git process seems to be running in this repository...AI가 실행 중인 프로그램 목록을 확인해서, 내 컴퓨터에 GitHub Desktop이 켜져 있던 걸 찾아냈다. 그게 배경에서 같은 저장소를 커밋·푸시하고 있었던 것. GitHub Desktop을 직접 껐다.
껐는데도 잠금 파일이 그대로 남아있어서(비정상 종료로 인한 찌꺼기), 프로세스가 완전히 종료된 걸 다시 확인한 뒤에야 AI가 잠금 파일을 안전하게 지우고
landing.md를 원래대로 되돌렸다.마지막으로 남아있던 로컬 설정 파일(
.claude/settings.local.json) 변경을 커밋하려는데 이번엔HEAD.lock오류가 또 남 → 같은 방식(프로세스 확인 → 잠금 파일 제거)으로 해결하고 최종 커밋·푸시까지 마쳤다.
(Tip: 여기에 git lock 오류 메시지 캡처나 GitHub Desktop 실행 화면을 넣으면 좋아요)
결과와 배운 점
결과물:
GitHub 저장소: https://github.com/raysmc517/gpters-study
배포된 사이트 주소: https://gpters-study-fawn.vercel.app
배운 점:
저장소 링크 하나만 있으면
git clone으로 사이트 전체 구조를 통째로 가져올 수 있고,.md파일 몇 개(SOUL/USER/AGENTS/CLAUDE)만으로 AI에게 성격·내 정보·작업 규칙을 미리 심어둘 수 있다는 것."로드맵 만들어줘" 한 줄로 끝내지 않고, 실제 사례(n8n+LLM+RSS 조합)를 먼저 찾아본 다음 그 틀에 맞춰 짜니 4주 안에 진짜 완성 가능한 크기로 계획이 잡혔다. AI가 질문으로 파고드니 어렴풋한 생각이 훨씬 뾰족한 요구사항으로 바뀌었다.
GitHub 저장소와 Vercel을 한번 연결해두면, 앞으로 GitHub에 새 내용을 올릴 때마다 Vercel이 자동으로 다시 배포해준다는 것.
GitHub Desktop(GUI)과 터미널(AI)처럼 서로 다른 도구가 동시에 같은 저장소를 건드리면 충돌이 날 수 있다는 것. 그리고 "로컬에만 있겠지"라고 짐작하지 말고, 진짜 상태는 직접 확인(
git status, GitHub API)해봐야 한다는 것.git이 작업 중에 만드는
.lock파일은, 그 작업을 하던 프로그램이 완전히 꺼졌는데도 남아있으면(비정상 종료) 안전하게 지워도 된다는 것.
시행착오:
학습메이트 이름을 정하는 과정에서 특정 독재자를 연상시키는 이름을 여러 번 제안했는데, AI가 정중히 거절했고 결국 "게릿 콜"로 정착.
클론 대상 폴더에 이미
.claude설정 폴더가 있어서git clone이 바로 안 먹혔던 문제 → 임시 폴더 경유로 해결.로컬 서버를 다시 띄우려는데 4321 포트가 다른 세션에서 이미 쓰이고 있어서 충돌 →
.claude/launch.json포트를 4322로 바꿔서 해결.Vercel 배포 시, 내 컴퓨터 폴더 경로에 들어있는 한글("민철 포트폴리오")이 프로젝트 이름에 그대로 섞여 들어가면서 이름 규칙 오류가 남 → 프로젝트 이름을 영문(
gpters-study)으로 직접 지정해서 해결."커밋으로 저장해줘"라고 했다가 이미 GitHub Desktop이 저장해놓은 걸 발견 →
git status/index.lock/HEAD.lock오류로 한참 헤맴 → GitHub Desktop 종료 확인 → 잠금 파일 정리 → 정상적으로 커밋·푸시 완료.
오늘 느낌: 밤에 git lock 오류가 계속 나서 처음엔 좀 당황했는데, 원인(GitHub Desktop)을 찾고 나서 딱 해결되니까 시원했다.
도움이 필요한 부분: 다음 주로 넘어가면 n8n·텔레그램 봇 API 연동처럼 처음 다뤄보는 도구가 나오는데, 여기서 막힐 걸로 예상된다.
앞으로의 계획: 1주차 나머지 — 텔레그램 봇 토큰 발급, n8n 가입, LLM API 키 준비, 반도체·배터리·AI 세 섹터 RSS 뉴스 소스 리스트 정리, 프로젝트 페이지 실제 내용 채우기. (그리고 앞으로는 GitHub Desktop과 AI 중 하나로만 커밋하기로!)
로그인하고 댓글을 남겨 주세요
커밋으로 저장해줘"라고 했다가 이미 GitHub Desktop이 저장해놓은 걸 발견
github desktop과 ai가 충돌이 생긴 것
진짜 상태는 직접 확인(
git status, GitHub API)해봐야 한다는 것.
사용하다 자주 마주칠 수 있는 오류를 설명해주셨네요^^
남은 기간도 화이팅입니다 민철님!
이제는 스스로 계획을 구체화시키면서 프로젝트를 만들어 갈 수 있는 모습이 보기 좋습니다. 깃이 데스크탑이 있었군요. 저도 데스크탑은 거의 써 보지가 않아서 그게 충돌이 난다는 것도 처음 알았네요. 저도 좋은 걸 배웠습니다.



배포까지 하루에 전부 마쳤네요 — 템플릿 클론, 로드맵 확정, GitHub 업로드, Vercel 배포, 거기에 lock 파일 충돌 디버깅까지. 특히 "커밋 저장해줘"라고 했더니 GitHub Desktop이 이미 해뒀다는 걸
git status와 GitHub API로 실제 상태를 짚어낸 부분이 인상적이었어요. "로컬에만 있겠지"라고 짐작하지 않고 직접 확인하는 습관, 앞으로 디버깅할 때도 계속 도움이 될 거예요."뉴스 요약봇" 하나로 시작한 방향이 질문에 답하다 보니 "여러 기사에서 공통 키워드를 뽑아 위키처럼 쌓는 것"으로 뾰족해진 부분도 좋았어요 — AI한테 로드맵을 짜달라고 할 때 실제 사례를 먼저 찾게 한 게 그 차이를 만든 것 같아요. GitHub Desktop은 저장 전용으로 두고, 터미널(AI)이랑 분리하기로 하셨다니 다음 주 n8n·텔레그램 연동도 기대됩니다.
학습메이트 이름이 게릿 콜로 정착한 과정… 조용히 웃겼어요. 고롱고롱 🐈⬛