본문으로 건너뛰기

사이트 배포 성공, 그리고 GitHub Desktop과의 첫 충돌

성민철

2026.07.31

소개

시도하고자 했던 것과 그 이유.

오늘 네 가지를 했다.

  1. 오전: GitHub에 있는 "학습허브 사이트" 템플릿을 내 컴퓨터로 그대로 가져오고, 앞으로 4주간 이 사이트를 채워가는 걸 도와줄 AI 학습메이트를 만들었다. 코딩을 모르기 때문에 회원가입이나 복잡한 설치 없이 통째로 가져오는 게 목표였고, 매번 내 상황(이직 준비, 배우려는 분야, 컴퓨터 환경)을 새로 설명하지 않아도 되도록 AI에게 성격과 규칙을 미리 심어두고 싶었다.

  2. 오후: 4주 로드맵을 확정했다. 반도체·배터리·AI로 이직을 준비하는데 이 분야 뉴스가 너무 많아서 하나하나 분석할 시간이 없다는 게 평소 불편함이었다. "뉴스 키워드 요약봇"이라는 어렴풋한 방향을 학습메이트한테 던지고, 로드맵을 구체적으로 짜보기로 했다.

  3. 저녁: 지금까지 로컬(내 컴퓨터)에만 있던 사이트를 실제 인터넷 주소로 배포했다. 이직 포트폴리오로 쓰려면 남들도 들어올 수 있는 진짜 웹사이트여야 하는데, 코딩을 모르니 회원가입부터 명령어 실행까지 전부 AI에게 맡겨서 진행했다.

  4. 밤: 오늘 작업한 걸 "커밋으로 저장해줘"라고 요청했는데, 알고 보니 이미 다 저장·업로드가 되어 있었다. 왜 그런지 파보다가 내 컴퓨터에 켜져 있던 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, gh CLI

  • 오늘 만든 학습일지·사례글·프로젝트 페이지를 "커밋으로 저장해줘"라고 요청했는데, 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 실행 화면을 넣으면 좋아요)

결과와 배운 점

  • 결과물:

  • 배운 점:

    • 저장소 링크 하나만 있으면 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 중 하나로만 커밋하기로!)

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

아루나 프로필 이미지
아루나2026.08.01

이제는 스스로 계획을 구체화시키면서 프로젝트를 만들어 갈 수 있는 모습이 보기 좋습니다. 깃이 데스크탑이 있었군요. 저도 데스크탑은 거의 써 보지가 않아서 그게 충돌이 난다는 것도 처음 알았네요. 저도 좋은 걸 배웠습니다.

제이리 프로필 이미지
제이리2026.08.01
  1. 커밋으로 저장해줘"라고 했다가 이미 GitHub Desktop이 저장해놓은 걸 발견

  2. github desktop과 ai가 충돌이 생긴 것

  3. 진짜 상태는 직접 확인(git status, GitHub API)해봐야 한다는 것.

사용하다 자주 마주칠 수 있는 오류를 설명해주셨네요^^

남은 기간도 화이팅입니다 민철님!

뽀짝이 프로필 이미지
뽀짝이2026.07.31

배포까지 하루에 전부 마쳤네요 — 템플릿 클론, 로드맵 확정, GitHub 업로드, Vercel 배포, 거기에 lock 파일 충돌 디버깅까지. 특히 "커밋 저장해줘"라고 했더니 GitHub Desktop이 이미 해뒀다는 걸 git status와 GitHub API로 실제 상태를 짚어낸 부분이 인상적이었어요. "로컬에만 있겠지"라고 짐작하지 않고 직접 확인하는 습관, 앞으로 디버깅할 때도 계속 도움이 될 거예요.

"뉴스 요약봇" 하나로 시작한 방향이 질문에 답하다 보니 "여러 기사에서 공통 키워드를 뽑아 위키처럼 쌓는 것"으로 뾰족해진 부분도 좋았어요 — AI한테 로드맵을 짜달라고 할 때 실제 사례를 먼저 찾게 한 게 그 차이를 만든 것 같아요. GitHub Desktop은 저장 전용으로 두고, 터미널(AI)이랑 분리하기로 하셨다니 다음 주 n8n·텔레그램 연동도 기대됩니다.

학습메이트 이름이 게릿 콜로 정착한 과정… 조용히 웃겼어요. 고롱고롱 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기