[Claude Code] Claude Chat에서 Claude Code로 이사한 비개발자의 솔직 후기

📝 한줄 요약

Claude Chat으로 2달 동안 관리해온 네이버 블로그 자동화 프로젝트를 Claude Code로 이전했다. 코드 복붙이 사라지고, 변경이력 관리가 자동화됐으며, AI가 스스로 틀렸다고 인정하며 더 나은 방향을 제시했다.

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

• Claude Chat → Claude Code 이전, 7개 설명 파일 → CLAUDE.md 하나로

• Claude Code는 파일을 직접 읽으니 코드 복붙 불필요

• git을 몰라도 Claude가 도입부터 설명까지 같이 해줌

• AI에게 "그거 틀렸잖아"라고 말하면 더 나은 답이 나온다

• CLAUDE.md 하나가 프로젝트의 핵심 — 새 대화마다 프로젝트 재설명 불필요

• 이전 완료 후 미해결 문제 수정 + GitHub 연동 예정

🎯 이런 분들께 도움돼요

• Claude Code를 처음 시작하려는 비개발자

• Claude Chat으로 프로젝트를 운영 중인데 한계를 느끼는 분

• AI와 함께 프로젝트를 장기 운영하는 방법이 궁금한 분

😫 문제 상황 (Before)

네이버 블로그에 화재 관련 포스팅을 자동으로 올리는 시스템을 Claude Chat으로 유지보수하고 있었다. GAS(구글 앱스 스크립트)가 글을 만들고, 파이썬이 블로그에 올리는 구조다. 코드 파일만 10개가 넘고, 해결된 문제 기록만 31건이 쌓였다.

ALT

Google Analytics를 사용하는 과정을 보여주는 다이어그램

문제는 두 가지였다.

첫째, Claude Chat은 파일을 직접 읽지 못한다. 코드를 수정할 때마다 파일 내용을 복사해서 대화창에 붙여넣어야 했다. 파일이 길면 잘라서 여러 번. 코드가 10개 넘으니 매번 이 과정이 반복됐다.

둘째, 프로젝트가 커질수록 관리가 힘들어졌다. 이를 보완하려고 시스템 구조, GAS 설정, Python 코드 설명, 친구 PC 설정, 해결된 문제, 미해결 문제, 변경이력까지 총 7개의 설명 txt 파일을 따로 만들어뒀다. Claude가 프로젝트를 이해할 수 있도록. 그런데 이 파일들 자체가 또 관리 대상이 됐다.

더 이상 이 방식으로는 한계라는 걸 느꼈고, Claude Code로 이전을 결심했다.

🛠️ 사용한 도구

• 도구: Claude Code

• 모델: Claude Sonnet

• 특이사항: git 사전 지식 없이 시작, 비개발자

🔧 작업 과정

Claude Code가 뭔지도 모르는 채로 시작

난 클로드 코드를 처음 써봐. 클로드 챗에서 만들고 유지보수 해온 네이버 블로그
자동화를 클로드 코드로 옮겨서 계속 진행하고 싶어. 어떻게 하면 좋을까?

Claude Code가 뭔지, CLAUDE.md가 뭔지, 메모리 파일이 뭔지 아무것도 몰랐다. 그냥 "옮기고 싶다"는 말 하나로 시작했다. (도로시J님, 윤스케어님, 테크권님이 첫 시간 Claude Code 강의로 용기를 주셨음!!!) Claude는 프로젝트 파일 7개를 먼저 읽고 싶어했고, 기존 자동화 시스템 전체를 파악한 뒤 이전 전략을 세웠다.

첫 번째로 한 일은 CLAUDE.md 생성이었다. Claude Code에서 가장 중요한 파일로, 새 대화를 시작할 때마다 Claude가 자동으로 읽는 프로젝트 지침서다. 여기에 시스템 개요, 작업 규칙, 핵심 파일 목록을 담았다.

폴더 구조를 두고 Claude와 한판 논쟁

기존 Claude Chat으로 관리했을 때 파일들:

ALT

문서에 있는 한국어 단어 목록

처음 Claude가 제안한 구조는 이랬다:

fire_blog_project/
├── step1.py ~ step5.py     ← 핵심 코드
├── docs/                   ← 기존 설명 파일들 이동
│   ├── fire_blog_01_시스템구조.txt
│   ├── fire_blog_02_GAS설정.txt
│   └── ... (7개)
├── gas/
├── tests/
└── scripts/

얼핏 정리된 것처럼 보였다. 근데 뭔가 이상했다.

이렇게 진행하면 추후 코드 수정이 생길 때 docs 폴더에 있는 파일을 수정하는 거야?

Claude가 "네, 맞습니다"라고 했다. 그러자 더 근본적인 질문이 떠올랐다.

클로드 코드로 시작했으면 txt 파일 같은 건 안만든다고 하지 않았니?

위 파일들은 왜 계속 사용해? 원래 클로드 코드로 시작했다면 어떻게 관리했을까?

Claude가 스스로 인정했다. docs/ 폴더로 이동해도 본질은 그대로 "Claude Chat 방식"이라고. 7개 txt 파일은 Claude Chat이 파일을 직접 읽지 못해서 생긴 임시방편이었고, Claude Code에서는 필요 없다고.

그래서 최종 구조는 완전히 달라졌다:

D:\ClaudeCode\fire_blog_code\
├── CLAUDE.md               ← 프로젝트 지침 (7개 파일 역할 대체)
├── README.md               ← 친구 PC 셋업 가이드 (신규)
├── .gitignore
└── fire_blog_project\
    ├── step1.py ~ step5.py ← 핵심 코드 (flat 유지)
    ├── diagnostic.py
    ├── gas\
    │   └── GAS_코드.gs
    ├── tests\
    │   └── test_diagnostic.py
    ├── scripts\
    │   ├── auto_run.bat
    │   └── start_chrome.bat
    └── backup\             ← 기존 15개 파일 보관 (정보 손실 없음)

txt 파일 7개는 모두 backup/으로, 내용 중 꼭 필요한 것만 CLAUDE.md에 흡수했다. 폴더 하나로 Claude Chat 시절 파일 관리의 흔적이 깔끔하게 정리됐다.

git을 몰랐는데 Claude가 제안했다

git 도입해

사실 이 한마디가 나오기까지 과정이 있었다. "변경이력.txt를 수동으로 관리하는데 Claude Code에서도 이걸 써야 하나?"라는 고민에 Claude가 git을 소개했다. 그것도 이 프로젝트에 딱 맞는 예시로.

"지금 파일명에 날짜를 붙여서 버전 관리하고 있잖아요 (GAS_코드_20260518.txt). git을 쓰면 파일은 하나만 유지하고, 커밋 메시지가 자동으로 변경이력이 됩니다."

바로 이해됐다. 변경이력.txt에 수동으로 적던 것들이 git commit 하나로 대체된다는 게. git이 뭔지 몰랐지만 Claude가 설치부터 첫 커밋까지 단계별로 안내해줬다. 보안 파일(서비스 계정 키, 로그인 쿠키)은 자동으로 제외하도록 .gitignore도 설정해줬다.

✅ 결과 (After)

Before vs After

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

효과적이었던 것

1. CLAUDE.md를 가장 먼저 만들어라 — 새 대화를 시작해도 프로젝트를 처음부터 설명할 필요가 없다. Claude Code의 핵심이 여기 있다.

2. Claude Code에서 txt 설명 파일은 불필요하다 — Claude Chat 시절의 습관을 버려야 한다. Claude Code는 코드를 직접 읽는다.

3. git을 몰라도 괜찮다 — Claude와 함께 쓰다 보면 자연스럽게 배우게 된다. 처음엔 그냥 시키는 대로 따라하면 된다.

이렇게 하면 안 돼요

1. Claude의 첫 번째 제안을 그냥 수락하지 말 것 — 이번에 docs/ 폴더 제안처럼 반쪽짜리 답이 나올 때가 있다. "클로드 코드로 처음 시작했다면 이렇게 했을까?"라고 되물어보면 더 좋은 방향이 나온다.

2. Claude Chat 방식을 그대로 이식하려 하지 말 것 — 도구가 바뀌면 방식도 바뀌어야 한다.

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

Claude Chat으로 장기 프로젝트를 운영 중이라면 이 이전 과정이 그대로 적용된다. 특히:

• 반복적으로 코드나 문서를 복붙하고 있다면 → Claude Code 이전 시점

• 설명용 파일이 따로 쌓이고 있다면 → CLAUDE.md 하나로 정리할 때

• 변경 기록을 수동으로 남기고 있다면 → git 도입할 때

🚀 앞으로의 계획

이전 작업이 완료됐으니 이제 본격적인 작업이 시작된다.

1. 미해결 문제 수정: Claude Code로 미뤄뒀던 10건의 미해결 이슈를 하나씩 해결해나갈 예정

2. GitHub 연동: 로컬 git 저장소를 GitHub에 올려 원격 백업 + 히스토리 온라인 보관

📋 재사용 가능한 프롬프트

프롬프트 1: Claude Code 이전 시작

나는 Claude Chat 프로젝트에서 [어떤 작업]을 해왔어. 이걸 Claude Code로 옮겨서 계속 진행하고 싶어. 프로젝트 파일들이 [경로]에 있어. 어떻게 시작하면 좋을까?

프롬프트 2: 폴더 구조 점검

지금 제안한 폴더 구조가 Claude Code로 처음 시작했다면 이렇게 했을까? 아니라면 어떻게 달라져야 해?

프롬프트 3: git 도입 (비개발자용)

git이 뭔지 모르는데, 이 프로젝트에서 git을 쓰면 구체적으로 뭐가 달라지는지 이 프로젝트 상황에 맞게 설명해줘. 그리고 도입해줘.