Claude Code로 Next.js 스타터킷 세팅하기
매번 프로젝트를 시작할 때마다 같은 초기 설정을 반복하는 게 번거롭다면, 한 번 잘 만들어둔 스타터킷이 답이다. 이번 글에서는 Claude Code를 활용해 claude-nextjs-starterkit 을 세팅하는 과정을 정리한다 기술 스택 역할 선택 이유 프레임워크 Next.js 15 (App Router) 업계 표준, 커뮤니티 풍부…
매번 프로젝트를 시작할 때마다 같은 초기 설정을 반복하는 게 번거롭다면, 한 번 잘 만들어둔 스타터킷이 답이다. 이번 글에서는 Claude Code를 활용해 claude-nextjs-starterkit 을 세팅하는 과정을 정리한다 기술 스택 역할 선택 이유 프레임워크 Next.js 15 (App Router) 업계 표준, 커뮤니티 풍부…
개인 프로젝트 · 회사 프로젝트 분리 — SourceTree 없이, 터미널만으로 이 글에서 다루는 것 왜 이 설정이 필요한가 GitHub 계정이 두 개 있다면 — 예를 들어 개인 계정(xxxx@gmail.com)과 회사 계정(yyyy@company.com) — 아무 설정 없이 사용하면 모든 commit이 글로벌로 설정된 한…
Claude Code를 쓰다 보면 어느 순간 AI가 갑자기 바보가 된다. 분명 잘 돌아가던 게 어느 순간 이상한 코드를 반복해서 짜거나, 이미 만든 기능을 다시 만들려고 한다. 토큰이 빠르게 소진되거나 사용량 제한에 자주 걸린다면, 대부분 컨텍스트 관리가 문제다 토큰이 뭔지 먼저…
Claude Code를 처음 쓰는 사람들이 가장 많이 하는 실수는 바로 요청하는 것이다. “로그인 기능 만들어줘”, “회원가입 페이지 만들어줘”. 운이 좋으면 원하는 결과가 나오지만, 조금만 복잡해지면 금방 방향을 잃는다. AI가 아무리 똑똑해도, 요청하는 사람이 맥락을 잘 전달해야 좋은 결과가 나온다. 건축…
바이브코딩으로 프로토타입을 만드는 것과 실제 사용자가 쓰는 서비스를 운영하는 것은 완전히 다른 문제다. 많은 개발자들이 보안과 운영환경 결정을 뒤로 미루고 코드부터 짠다. 그 대가는 나중에 전체를 뜯어고치는 것으로 돌아온다. 보안 — 설계에 늦게 반영할수록 기술부채가 된다 보안을 “나중에 붙이면 된다”고…
처음 30분부터 팀 도입까지 Claude Code를 처음 켜면 “이걸 어떻게 쓰지?”보다 “이걸 계속 써도 되는 건지”를 먼저 판단하게 된다. 그 판단이 첫 30분 안에 거의 결정된다 이 글은 그 30분을 잘 쓰는 것에서 시작해서, 팀으로 확장하는 것까지의 실전 흐름을 정리한다…
CLAUDE.md부터 모듈형 규칙까지 Claude Code는 세션이 끝나면 이전 내용을 기억하지 못한다. 새 세션을 시작할 때마다 백지 상태가 된다 그래서 “이 프로젝트에서는 이렇게 해줘”를 매번 다시 설명하는 대신, 파일로 만들어두면 된다. Claude Code가 세션을 시작할 때 자동으로 읽는 이 파일이 CLAUDE.md다…
Skills부터 Hooks까지 Claude Code를 처음 쓰면 “프롬프트 잘 쓰면 되는 거 아닌가”라고 생각하게 된다. 그런데 비슷한 작업을 열 번 쯤 반복하다 보면 매번 같은 설명을 하고 있는 자신을 발견하게 된다. 회의록 형식을 다시 설명하고, 코드 리뷰 기준을 다시 설명하고, 이…
작업에 맞는 모델을 골라야 하는 이유 Claude Code를 쓰면서 토큰이 빨리 소진된다면, 모델 설정을 한 번도 바꾸지 않았을 가능성이 높다. 기본 모델로만 작업하면 간단한 작업에 과한 리소스를 쓰게 된다. 작업 유형에 맞게 모델을 선택하는 것만으로도 토큰 소비를 크게 줄일 수…
개발 흐름은 내가 설계한다 이전 글에서 특정 도구나 명령어에 대한 개별 권한 규칙을 살펴봤다면, 이번엔 한 단계 위의 개념이다 권한 모드는 Claude Code가 기본적으로 어떻게 행동할지를 결정하는 모드다. 개별 규칙이 “이 명령어는 허용한다”라면, 권한 모드는 “Claude Code가 전반적으로 어떤 방식으로…