Claude 앱·Claude Code CLI·Codex 3총사로 완성하는 AI 바이브코딩 실전 — 안드로이드에서 배포까지, 오류 대응까지

# 새 글 생성 요청
"article-nas-mobile.html에 Plex + Antigravity + Tailscale
파이프라인 섹션을 추가해줘. 코드 블록과 비교 테이블 포함.
기존 article-nas.html의 레이아웃 구조를 그대로 따라줘."

# 기존 글 섹션 추가
"article-homeserver.html의 하드웨어 벤치마크 섹션 뒤에
'전력 효율 최적화' 섹션을 추가해줘. 인텔 N100과
라이젠 5 5600G를 비교하는 benchmark-table 포함."

# 인덱스 페이지 카드 교체
"index.html의 3-col 섹션에서 애드센스 승인 관련 카드를
SEO 키워드 전략 카드로 교체해줘. 기존 카드의 클래스
구조(.col-article)는 유지해줘."

# CSS 버그 수정
"다크모드에서 .info-box 배경이 너무 밝아.
css/article.css에서 --info-bg CSS 변수를 확인하고
.dark 클래스 오버라이드도 추가해줘."

# JavaScript 오류
"main.js에서 TOC 자동 생성이 h2만 잡는데,
h3도 포함해서 2단계 목차(들여쓰기 포함)로 만들어줘.
기존 IntersectionObserver 로직은 유지해줘."

# 반응형 레이아웃 오류
"스마트폰(375px)에서 .benchmark-table이 가로로 넘쳐.
overflow-x: auto 래퍼를 추가하고, 첫 번째 컬럼은
sticky로 고정해줘."

# 배포 상태 확인
"현재 main 브랜치 최신 커밋 5개 내용과
Vercel 배포 URL 알려줘."

# Open Graph 태그 추가
"모든 article-*.html 파일에 OG 태그가 없어.
각 파일의 title과 description을 읽어서
og:title, og:description, og:type, og:url을
일괄로 추가해줘. og:image는 /images/og-default.png 사용."

# 구조화 데이터
"article-homeserver.html에 JSON-LD BlogPosting
스키마 마크업을 추가해줘. author는 'IT Architecture Times',
datePublished는 파일 내 byline-date에서 추출해줘."

# 내부 링크 강화
"article-nas.html에서 Tailscale이 언급되는 모든 곳에
article-tailscale.html로 연결되는 인라인 링크를 추가해줘."

# 프로젝트 폴더에서 CLI 실행
cd /home/user/serverguchuk1024
claude

# 단일 파일 수정 요청
claude "article-ai.html에서 다크모드 버그 수정해줘"

# 여러 파일 동시 수정
claude "css/article.css의 .info-box 다크모드 스타일과
article-ai.html의 info-box 구조를 함께 검토해서
다크모드에서 텍스트 가독성 문제 해결해줘"

# 파일 생성
claude "기존 article-homeserver.html을 참고해서
article-docker.html을 새로 만들어줘.
섹션 구조와 CSS 클래스는 동일하게 유지해줘."

# 특정 함수/코드 블록 디버깅
claude "js/main.js의 TOC 생성 로직을 분석해서
h3 서브섹션도 포함하는 2단계 목차로 업그레이드해줘"

# 터미널 명령어 오류 분석
claude "npm run build 실행하면 아래 오류가 나.
원인과 해결 방법 알려줘:
ERROR: Cannot find module './utils/parser'
  at Function.Module._resolveFilename"

# Git 충돌 해결
claude "git merge main 후 아래 충돌이 났어.
어느 쪽 코드를 살려야 할지 판단해줘:
<<<<<<< HEAD (현재 브랜치 코드)
======= (머지 대상 코드) >>>>>>>"

# 배포 파이프라인 디버깅
claude "Vercel 빌드 로그에 이런 오류가 나왔어.
수정해야 할 파일과 코드 알려줘:
[Error] Missing required environment variable: NEXT_PUBLIC_API_URL"

# 성능 분석
claude "Lighthouse에서 LCP가 4.2초로 나왔어.
현재 index.html과 css/style.css를 분석해서
가장 빠른 개선 방법 3가지 알려줘"

/help          # 사용 가능한 모든 명령어 목록
/clear         # 현재 대화 컨텍스트 전체 초기화 (새 세션 시작)
/compact       # 긴 대화를 AI가 요약·압축 (토큰 절약)
/cost          # 현재 세션에서 사용한 API 토큰 및 비용 확인
/status        # Claude Code 버전, API 연결 상태 확인
/model         # 사용 중인 모델 확인 및 변경
/add-dir       # 추가 작업 디렉토리 등록
/permissions   # 파일 접근·터미널 실행 권한 설정 확인
/review        # 현재 변경사항 코드 리뷰 요청
/commit        # 현재 변경사항 커밋 메시지 생성 및 커밋
/pr            # Pull Request 생성 및 설명 작성

# 시나리오 1: Plex 미인식 문제
상황: /media/anime/ 폴더에 파일을 넣었는데 Plex 라이브러리에서 안 보임
파일명: "기동전사 건담 SEED - 01화 [1080p].mkv"

Antigravity 프롬프트:
"이 파일명으로 Plex가 인식 못 하는 이유와
올바른 파일명 형식으로 변환하는 방법 알려줘.
시리즈명은 'Mobile Suit Gundam SEED'로 하고
에피소드 번호는 S01E01 형식으로."

# 시나리오 2: 한글 파일명 NFS 마운트 후 깨짐
상황: NAS에서 NFS로 마운트한 폴더의 한글 파일명이
      ??? 형태로 깨져서 Plex/Jellyfin 모두 인식 불가

Antigravity 프롬프트:
"NFS 마운트 후 한글 파일명이 깨지는 원인과
/etc/fstab NFS 마운트 옵션에서 인코딩 설정
수정 방법 알려줘. Ubuntu 22.04 환경."

# 시나리오 3: 특수문자 파일명 일괄 정리
상황: 다운로드 폴더에 특수문자가 섞인 파일 300개

Antigravity 프롬프트:
"Python 스크립트로 현재 폴더의 모든 .mkv 파일에서
특수문자(:, *, ?, \", <, >, |)를 제거하고
공백을 언더스코어로 교체하는 일괄 변환 스크립트.
원본 파일명을 rename_log.txt에 백업 포함."

# 시나리오 1: 다크모드 스타일 버그
증상: 다크모드 전환 시 .info-box 텍스트가 배경과 같은 색이 됨

claude "article-ai.html을 열고 .info-box 안의 텍스트
렌더링을 확인해줘. css/article.css에서 다크모드
오버라이드 규칙이 누락된 것 같아. 수정해줘."

# 시나리오 2: 모바일 레이아웃 깨짐
증상: iPhone SE(375px)에서 article-layout이 overflow 발생

claude "article-ai.html과 css/article.css를 분석해서
375px 뷰포트에서 .article-layout이 가로로
넘치는 원인 찾고 media query 수정해줘"

# 시나리오 3: JavaScript 오류
증상: 브라우저 콘솔에서 "Cannot read properties of null" 오류

claude "js/main.js에서 'Cannot read properties of null'
오류가 나고 있어. articleToc 요소가 없는 페이지에서
TOC 생성 코드가 실행되는 것 같아. null 체크 추가해줘."

# 시나리오 4: Git 충돌 해결
증상: git pull 후 충돌 발생, 수동 해결이 복잡함

claude "현재 git status와 충돌 파일들을 확인하고
안전하게 머지할 수 있는 방법 제안해줘.
main 브랜치의 변경사항을 기준으로 해결해줘."

# 시나리오 1: npm 패키지 오류
오류 메시지:
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree

claude "npm install 중 ERESOLVE 오류가 났어.
package.json을 확인하고 의존성 충돌 원인과
해결 방법 알려줘. --legacy-peer-deps 없이 해결하고 싶어."

# 시나리오 2: Docker 컨테이너 시작 실패
오류 메시지:
Error response from daemon: driver failed programming
external connectivity on endpoint (iptables 오류)

claude "Docker 컨테이너 시작 시 iptables 관련 오류가 나.
docker ps -a 결과와 /var/log/docker.log 를 확인해서
원인 파악하고 해결 방법 알려줘."

# 시나리오 3: Vercel 배포 실패
오류 메시지:
Error: ENOENT: no such file or directory, open 'dist/index.html'

claude "Vercel 빌드가 dist/index.html을 못 찾아서 실패해.
프로젝트 루트와 vercel.json 설정을 확인해서
outputDirectory 설정 문제인지 진단해줘."

# 시나리오 4: SSH 연결 오류
오류 메시지:
ssh: connect to host 192.168.1.100 port 22: Connection refused

claude "홈서버 SSH 연결이 안 돼. Connection refused 오류야.
Ubuntu 서버에서 SSH 서비스 상태 확인·재시작 방법과
방화벽 설정 확인 명령어 알려줘."

# 패턴 1: 주석으로 함수 생성 (VS Code에서)
# VS Code에서 주석을 입력하면 Copilot이 함수를 제안

// 다크모드 토글 버튼을 클릭하면 localStorage에 상태 저장하고
// html 요소에 dark 클래스 추가/제거하는 함수
function toggleDarkMode() {
  // Copilot이 아래 코드를 자동 제안
  const html = document.documentElement;
  const isDark = html.classList.toggle('dark');
  localStorage.setItem('darkMode', isDark ? '1' : '0');
}

# 패턴 2: 반복 구조 자동완성
// benchmark-table의 첫 번째 행을 입력하면
// 나머지 행들의 구조를 Copilot이 예측


  GitHub
  소스코드 저장소
  무료
  // 다음 행부터 Copilot이 유사한 패턴으로 제안

# 패턴 3: CSS 오류 인라인 수정
/* 다크모드에서 info-box 배경이 너무 밝은 문제 */
.dark .info-box {
  /* Copilot이 적절한 CSS 변수나 색상값 제안 */
  background: var(--info-bg-dark, #1a2030);
  border-color: var(--info-border-dark, #2a3a50);
}

# 토픽 클러스터 설계
"나는 홈서버(Intel N100, 16GB RAM)와 Synology NAS DS923+를
운영하는 1인 IT 블로그를 시작할 것이다.
타겟 독자: 홈랩에 관심 있는 30~40대 직장인, 초중급 수준.
SEO 관점에서 월 검색량이 300~3000회인
롱테일 키워드 기반 블로그 주제 15개를 추천해줘.
각 주제마다 예상 키워드, 경쟁도(상/중/하), 내용 요약 포함."

# 콘텐츠 캘린더 생성
"위 15개 주제 중 SEO 효과와 독자 관심도 균형이 좋은
6개를 선택해서 6주 발행 캘린더를 만들어줘.
각 주제의 발행 순서(pillar → cluster 구조),
내부 링크 설계, 발행 후 업데이트 주기도 포함."

# 경쟁 분석 기반 차별화
"'홈서버 구축'을 주제로 Google 상위 10개 결과를
분석했을 때 공통으로 다루지 않는 독창적인 앵글은?
실제 운영 경험 기반의 트러블슈팅에 초점을 맞춰줘."

# 기술 블로그 초안 생성 템플릿
"""
주제: Intel N100 홈서버에서 Plex + Tailscale 설정하기
독자 수준: Linux 기본 명령어는 알지만 서버 운영은 초보

작성 조건:
- 총 2,500자 이상
- 섹션 7개 (각 섹션 제목은 h2 태그)
- 섹션 구성: 개요 → 요구사항 → 설치 → 설정 → 테스트 → 트러블슈팅 → 결론
- 각 섹션에 실제 터미널 명령어 또는 설정 파일 예시 포함
- 트러블슈팅 섹션에는 실제 오류 메시지와 해결법 3가지 이상
- 마지막 섹션에 '다음 단계' 내부 링크 제안 포함
- 어조: 친근하지만 기술적으로 정확하게
"""

# 특정 경험 기반 초안
"""
나의 실제 경험을 바탕으로 글을 작성해줘:
- 환경: Ubuntu 22.04, Intel N100 8GB, Synology DS923+
- 문제: Plex가 DS923+의 SMB 공유 폴더 마운트 후 미디어를 인식 못 함
- 해결: NFS 마운트로 전환 후 해결 (설정 값 포함)
- 소요 시간: 약 3시간
이 경험을 1,800자 내외 트러블슈팅 가이드로 작성해줘.
제목에 실제 오류 메시지 일부를 포함하면 SEO에 유리해.
"""

# 나쁜 패턴 (한 대화에 너무 많은 작업)
대화 1: "article-ai.html 다크모드 버그 수정해줘"
대화 2: "index.html 카드 레이아웃 바꿔줘"
대화 3: "SEO 메타태그 추가해줘"
대화 4: "새 글 article-docker.html 만들어줘"
대화 5: "앞서 만든 글의 스타일 수정해줘"  ← 컨텍스트 오염 위험

# 좋은 패턴 (작업 단위로 대화 분리)
[새 대화] article-ai.html 다크모드 버그 수정 전용
[새 대화] index.html 레이아웃 개선 전용
[새 대화] article-docker.html 신규 작성 전용

# 대화 시작 시 컨텍스트 프라이밍
"이번 대화에서는 css/article.css 파일만 수정할 거야.
다른 파일은 건드리지 말고, 변경 시 반드시 확인 요청해줘.
현재 목표: .info-box 다크모드 스타일 수정"

# 대화가 길어졌을 때
"지금까지 작업 내용을 3줄로 요약해줘.
그리고 아직 완료되지 않은 작업이 있으면 알려줘."

# Git 가비지 컬렉션 (불필요한 오브젝트 압축·삭제)
git gc --aggressive --prune=now
# --aggressive: 더 강력한 압축 (속도 느리지만 저장소 크기 최소화)
# --prune=now: 2주 이상 된 미참조 오브젝트 즉시 삭제

# 원격 브랜치 추적 정리
git remote prune origin
# 이미 삭제된 원격 브랜치의 로컬 추적 참조 제거

# 로컬 브랜치 정리 (머지 완료된 브랜치)
git branch --merged main | grep -v "main\|master" | xargs git branch -d
# main에 머지된 모든 브랜치 목록 중 main/master 제외하고 삭제

# 큰 파일이 들어간 커밋 찾기
git rev-list --objects --all | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' | sort -k3 -n -r | head -20

# 저장소 크기 확인
git count-objects -vH

# Stale 원격 브랜치 확인
git branch -r --merged origin/main

# .github/workflows/cleanup.yml
name: Auto Cleanup Merged Branches

on:
  pull_request:
    types: [closed]

jobs:
  cleanup:
    runs-on: ubuntu-latest
    if: github.event.pull_request.merged == true
    steps:
      - name: Delete merged branch
        uses: actions/github-script@v7
        with:
          script: |
            const branch = context.payload.pull_request.head.ref;
            if (branch !== 'main' && branch !== 'develop') {
              await github.rest.git.deleteRef({
                owner: context.repo.owner,
                repo: context.repo.repo,
                ref: `heads/${branch}`
              });
              console.log(`Deleted branch: ${branch}`);
            }

# /clear — 현재 대화 컨텍스트 완전 초기화
# 언제: 작업 주제가 완전히 바뀔 때, 오류 응답이 반복될 때
/clear

# /compact — 긴 대화를 AI가 요약·압축
# 언제: 작업이 계속되지만 컨텍스트 창이 가득 찰 것 같을 때
# 이전 내용의 핵심만 남기고 압축 → 토큰 절약 + 품질 유지
/compact

# 현재 세션 상태 확인
/status
# 출력 예시:
# Model: claude-sonnet-4-6
# Context: 45,230 / 200,000 tokens (22%)
# Session: 1h 23m
# Cost: $0.34

# 컨텍스트 관리 모범 사례
# 1. 작업 시작 시 목표 명시
"이번 세션 목표: article-ai.html 완전 재작성.
다른 파일은 수정하지 말 것."

# 2. 작업 완료 후 /clear
# 3. 새 작업 시작 전 목표 재명시
# 4. 1~2시간 세션 후 /compact 또는 /clear

# node_modules 완전 삭제 후 재설치 (월 1회 권장)
rm -rf node_modules package-lock.json
npm install
# 또는 pnpm 사용 시:
rm -rf node_modules pnpm-lock.yaml
pnpm install

# npm 캐시 정리
npm cache clean --force

# 전역 패키지 업데이트 확인
npm outdated -g

# 전역 패키지 업데이트
npm update -g

# npx 캐시 정리
npx clear-npx-cache

# Claude Code CLI 업데이트
npm update -g @anthropic-ai/claude-code

# node_modules 크기 확인 (정리 전후 비교)
du -sh node_modules/

# Docker 전체 정리 (사용하지 않는 모든 리소스)
docker system prune -af --volumes
# -a: 미사용 이미지 모두 포함 (태그 있는 것도)
# -f: 확인 없이 강제 실행
# --volumes: 마운트되지 않은 볼륨도 삭제 (주의!)

# 더 안전한 방법 (단계별)
docker container prune -f     # 정지된 컨테이너 삭제
docker image prune -af        # 미사용 이미지 삭제
docker volume prune -f        # 미사용 볼륨 삭제
docker network prune -f       # 미사용 네트워크 삭제

# 디스크 사용량 확인
docker system df

# 실행 중 컨테이너 로그 크기 확인
docker ps -q | xargs docker inspect --format='{{.LogPath}}' | xargs ls -lh

# 컨테이너 로그 크기 제한 설정 (/etc/docker/daemon.json)
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

# 머지된 로컬 브랜치 일괄 삭제
git branch --merged main | grep -v "^\*\|main\|master\|develop" | xargs -r git branch -d

# 원격에서 삭제된 브랜치 로컬 추적 정리
git fetch --prune

# 오래된 stash 정리 (목록 확인 후)
git stash list
git stash drop stash@{0}    # 특정 stash 삭제
git stash clear             # 전체 stash 삭제 (주의!)

# reflog 정리 (오래된 복구 포인트 삭제)
git reflog expire --expire=30.days.ago --all

# 전체 정리 스크립트 (월 1회 실행)
#!/bin/bash
echo "=== Git 저장소 정리 시작 ==="
git fetch --prune
git branch --merged main | grep -v "main\|master" | xargs -r git branch -d
git gc --aggressive --prune=now
echo "=== 정리 완료 ==="
git count-objects -vH

# Google Drive API v3를 사용한 중복 파일 탐지 스크립트
# 설치: pip install google-api-python-client google-auth

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials
from collections import defaultdict

def find_duplicates(service):
    """파일명이 같은 중복 파일 탐지"""
    results = service.files().list(
        pageSize=1000,
        fields="nextPageToken, files(id, name, size, modifiedTime, parents)"
    ).execute()

    files = results.get('files', [])
    name_map = defaultdict(list)

    for f in files:
        name_map[f['name']].append(f)

    duplicates = {name: group for name, group in name_map.items() if len(group) > 1}

    print(f"중복 파일 그룹 수: {len(duplicates)}")
    for name, group in list(duplicates.items())[:10]:
        print(f"\n파일명: {name}")
        for f in group:
            print(f"  ID: {f['id']}, 수정일: {f['modifiedTime']}, 크기: {f.get('size', 'N/A')}")

    return duplicates

# Claude Code CLI를 통한 자동화
# claude "Google Drive API로 중복 파일 탐지하고
# 오래된 버전을 trash로 이동하는 Python 스크립트 작성해줘.
# credentials.json은 이미 있어. 실행 전 목록 출력해서 확인 가능하게."