$ whoami 앱 만드는 1인 개발자 $ cat stack.txt Flutter · Next.js · TypeScript · Claude API $ cat now.txt 사이드 프로젝트 여러 개를 동시에 굴리는 중. 막히면 여기에 기록하고, 풀리면 글로 남깁니다. $
지금 많이 읽는 글
독자들이 가장 많이 조회한 트러블슈팅이에요.
새로 올라온 글
커밋처럼 차곡차곡 쌓이는 기록들
AI WORKFLOW
CLAUDE.md는 덮어쓰지 않습니다, 이어붙입니다 — CLAUDE.md 우선순위와 4단계 로드 순서
CLAUDE.md 우선순위: 여러 파일은 덮어쓰지 않고 이어붙습니다. 전역·프로젝트·로컬 로드 순서와 충돌 규칙.
AI WORKFLOW
같은 실수를 두 번 하면 적을 때입니다 — CLAUDE.md란, 비개발자가 AI에게 주는 프로젝트 지침 파일
CLAUDE.md란 무엇인가. AI에게 주는 헌법 비유, 언제 적나, 3줄짜리 첫 파일과 적용 확인법.
AI WORKFLOW
Max 20x의 20배는 5시간 기준입니다 — Claude Code 요금제 Pro·Max 선택 기준과 한도가 터지는 순간
Claude Code 요금제 Pro·Max 선택 기준. 20배는 5시간 창 기준, 주간 한도·토큰 실측·사용량 확인법.
AI WORKFLOW
45개 중 손댈 건 2개입니다 — .claude 디렉터리 설정 파일 지도, settings.json 위치부터 skills 폴더까지
.claude 디렉터리 설정 파일 지도. settings.json 위치, skills 폴더, 겹칠 때 규칙, gitignore까지.
AI WORKFLOW
외울 건 입력 5개입니다 — 설치 다음 Claude Code 사용법, 첫 세션 10분과 권한 모드
Claude Code 사용법 첫 세션 10분. 외울 입력 5개, 첫 질문, 권한 모드와 Shift+Tab, 대화 이어가기.
AI WORKFLOW
~/.claude/는 내 화면 어디에 있는 폴더인가 — 터미널 폴더 경로와 숨김 폴더를 10분 만에 읽는 법
터미널 폴더 경로 읽는 법. 물결표 기호, 홈 디렉터리, 숨김 폴더, .claude 위치까지.
AI WORKFLOW
설치 전에 깔아야 할 프로그램은 0개입니다 — 비개발자를 위한 클로드 코드 설치, 명령어 한 줄
클로드 코드 설치 방법을 맥·윈도우별로. 명령어 한 줄, Python·Node.js 없이 설치하고 오류까지.
ARCHITECTURE
테스트는 됩니다, 실결제는 안 됩니다 — 사업자 등록 없이 토스페이먼츠 어디까지 연동되나
사업자 등록 없이 토스페이먼츠 테스트 연동은 되고 실결제는 안 됩니다. 결제위젯 v2 코드와 계약 조건.
TROUBLESHOOTING
리젝의 40%는 가이드라인 2.1입니다 — 앱스토어 심사 리젝 사유별 원문과 제출 전 체크리스트
앱스토어 심사 리젝 사유별 가이드라인 원문과 제출 전 체크리스트. 2.1·2.3·4.8·5.1.1 정리.
AI WORKFLOW
CLAUDE.md는 시스템 프롬프트가 아닙니다 — 그래서 규칙이 안 먹습니다 (복붙용 템플릿 3종)
CLAUDE.md 작성법과 시스템 프롬프트 템플릿 3종. 계층·분량 기준과 IFScale 근거.
TROUBLESHOOTING
애드센스 한 줄이면 약관 위반입니다 — Vercel에서 Cloudflare로 Next.js 옮긴 기록
Vercel Hobby 상업적 사용 금지 조항과 Next.js Cloudflare 이전. vinext·OpenNext 선택과 깨진 것들.
RETROSPECTIVE
6개월 뒤 열어본 AI 코드 — 코드는 쌓이는데 이해는 안 쌓인다는 인지 부채 이야기
바이브 코딩 부작용과 인지 부채. METR 19% 실험, AI 생성 코드 CWE 실측으로 본 유지보수 문제.
TROUBLESHOOTING
Supabase 로그인이 새로고침에 풀릴 때 — 원인 4가지를 순서대로 짚는 진단 체크리스트
Supabase 세션이 새로고침에 풀리는 원인 4가지. persistSession, SSR 쿠키, Invalid Refresh Token.
ARCHITECTURE
7일 안 쓰면 프로젝트가 멈춥니다 — Supabase 무료 티어 한계와 Pro 전환 시점
Supabase 무료 티어 한도 표와 7일 미접속 일시정지 조건, Pro 전환 신호와 비용 줄이는 법.
AI WORKFLOW
로컬 DB를 Claude에 직접 연결하기 — MCP SQLite 연동과 아카이브된 서버 살리기
MCP로 Claude에 로컬 SQLite 연결하기. 아카이브된 레퍼런스 서버가 깨지는 원인과 설정 JSON.
AI WORKFLOW
Claude Code가 있는데 Cursor를 또 결제해야 할까 — 실무자용 AI 코딩 툴 비교
Cursor와 Claude Code 요금제·작업 유형별 비교. 2026년 9월 기준 가격과 사용량 정책, 선택 기준.
AI WORKFLOW
프롬프트 캐싱으로 API 비용 90% 줄이기 — cache_control을 어디에 박아야 하는가
프롬프트 캐싱 쓰기 1.25배·읽기 0.1배 비대칭, 손익분기, cache_control 위치, 최소 토큰, 캐시 깨는 안티패턴.
AI WORKFLOW
바이브 코딩 뜻은 'AI로 코딩'이 아니다 — 카파시의 원래 정의와 1년 뒤 그가 한 말
바이브 코딩 뜻과 유래를 카파시 원문으로 정리. 2025년 트윗, 콜린스 올해의 단어, METR 생산성 연구, 에이전틱 엔지니어링까지.
AI WORKFLOW
Claude Code 명령어 100개 중 당신이 쓰는 건 6개 — 슬래시 명령어 전체 정리 (v2.1.251 기준)
Claude Code 슬래시 명령어 전체 목록. /effort, /teleport 등 신규 명령어, 커스텀 명령어, 단축키, CLI 플래그.
TROUBLESHOOTING
테스터 12명 × 14일을 건너뛰는 방법 — 개인사업자 D-U-N-S 번호 발급 전 과정
구글 플레이 조직 계정·애플 개발자 등록용 D-U-N-S 번호 발급법. 영문 사업자등록증명, 신청 폼 해설, 소요 기간.
AI WORKFLOW
OpenAI는 5개월간 100만 줄을 짰다, 손으로는 한 줄도 — 하네스 엔지니어링이란
프롬프트 엔지니어링에서 하네스 엔지니어링으로. OpenAI 100만 줄 실험과 우아한형제들 토큰 95% 절감 사례로 보는 설계법.
AI WORKFLOW
LLM 디자인 스킬 Top 5 — Claude Code와 Codex에 감각 이식하기
AI UI가 다 비슷한 이유와 해결책. ui-ux-pro-max 등 디자인 스킬 5종 설치법을 Claude Code·Codex·Cursor별로.
AI WORKFLOW
Figma MCP 무료 연동 — Claude Code와 Codex에 디자인 붙이기
Figma를 유료로 안 쓰고 Claude Code·Codex에 붙이는 3가지 방법. 공식 MCP 월 20회 제한과 Framelink 우회까지.
ARCHITECTURE
Cloudflare Pages 배포와 커스텀 도메인 연결, 실제로 걸린 시간은 10분
Cloudflare Pages에 GitHub 저장소 연결, 커스텀 도메인, 네임서버 이전, SSL 오류와 Error 1014 해결까지.
TROUBLESHOOTING
카카오 로그인 이메일은 심사부터 통과해야 합니다 — Supabase 카카오 OAuth 설정 가이드
Supabase 카카오 OAuth 설정 전 과정. REST API 키, Client Secret, 동의항목, 이메일 심사(영업일 3~5일)까지.
AI WORKFLOW
Claude Code로 30분 만에 붙이는 Supabase 구글 소셜 로그인 (OAuth 설정 전 과정)
Supabase 구글 OAuth 로그인 설정 순서. 리디렉션 URI 등록, redirect_uri_mismatch, Site URL 함정까지.
TROUBLESHOOTING
Claude API 툴 호출이 조용히 실패할 때 — input_schema와 tool_choice부터 의심하세요
Claude API 툴이 에러 없이 안 불릴 때 stop_reason, tool_choice, input_schema 순으로 찾는 진단 순서.
AI WORKFLOW
'알아서 예쁘게'가 재작업을 부른다 — 바이브 코딩 프롬프트 작성법과 완성 기준 체크리스트
바이브 코딩 프롬프트를 스펙처럼 쓰는 법. 컨텍스트·요구사항·완성 기준 3블록 템플릿과 부정 조건, 작업 분할로 재작업 줄이기.
ARCHITECTURE
SQL 두 줄로 백엔드 권한 코드를 지웠다 — 1인 개발자 Vercel + Supabase RLS 구성
Vercel+Supabase 1인 개발자 최소 인프라. RLS로 권한 코드 없애기, using/with check 차이, 무료 티어 조건.