Category 클로드 코드

같은 작업을 두 번 시켰는데 결과가 다르게 나온 적이 있을 것이다. Claude에게 버그를 고쳐 달라고 했더니 어느 날은 테스트까지 돌리지만 다음 날은 코드만 수정하고 끝낸다. 이 차이는 모델의 잘못이 아니라 LLM이 본질적으로 확률 기반으로 다음 토큰을 고르기 때문이다. 그러나 실제…

오전에는 새 기능을 만들고, 오후에는 코드 리뷰를 하고, 저녁에는 보안 점검을, 밤늦게는 테스트를 돌린다. 각각의 작업은 서로 다른 전문 지식을 요구한다. 인테리어를 한 사람이 디자인부터 전기, 타일까지 모두 맡으면 어느 하나도 제대로 끝나지 않듯, Claude Code에 모든 관점을 동시에 요구하면…

같은 프롬프트를 매일 반복해서 붙여 넣고 있다면 그 프롬프트는 이미 자동화 대상이다. Claude Code는 반복 프롬프트를 슬래시 명령어 한 줄로 줄여 주는 커스텀 명령어 기능을 제공한다. 마크다운 파일 하나만 만들면 끝난다. 이 글에서는 커스텀 명령어의 기본 구조, 프로젝트와 사용자 단위의…

“PHP 프로젝트를 Java로 변환해 달라”고 한 줄 던졌더니 600개 엔드포인트가 담긴 Swagger가 떴다. 호출하면 전부 500과 400이었다. 한 번에 다 맡기면 안 된다는 말은 들었지만, 직접 데이고 나서야 이유를 알게 됐다 첫 번째 실수: 껍데기 600개를 만들었다 라우트 600개짜리 PHP(Laravel)…

세 개를 구분해야 Claude Code가 제대로 돌아간다 Claude Code를 쓰다 보면 이름이 비슷한 개념들 때문에 헷갈리기 쉽다. Plan Mode와 plan.md는 다르고, plan.md와 handoff.md도 다르다. 셋의 역할을 명확히 구분하면 긴 작업도 세션이 끊겨도 흔들리지 않는다 Plan Mode – Claude의 실행 상태…

처음부터 제대로 시작하기 Claude Code를 쓰다 보면 어느 순간 같은 설명을 반복하고 있는 자신을 발견하게 된다. 프로젝트 구조, 금지 규칙, 완료 기준. 매번 대화창에 길게 쓰는 대신, 파일로 한 번만 정의해두면 된다 이 글에서 소개하는 템플릿은 정답이 아니라 출발점이다. 그대로…

Claude Code에게 “Next.js 프로젝트 만들어줘”라고 바로 요청하는 것과, 공식 문서를 기반으로 직접 설치한 뒤 Claude Code를 붙이는 것은 결과가 다르다. 이 글은 claude-nextjs-starters 프로젝트를 세팅하면서 두 방식의 차이를 직접 보여준다 공식 CLI로 Next.js 직접 설치 Claude Code에게 처음부터 전부 맡기면…

매번 프로젝트를 시작할 때마다 같은 초기 설정을 반복하는 게 번거롭다면, 한 번 잘 만들어둔 스타터킷이 답이다. 이번 글에서는 Claude Code를 활용해 claude-nextjs-starterkit 을 세팅하는 과정을 정리한다 기술 스택 역할 선택 이유 프레임워크 Next.js 15 (App Router) 업계 표준, 커뮤니티 풍부…

Claude Code를 쓰다 보면 어느 순간 AI가 갑자기 바보가 된다. 분명 잘 돌아가던 게 어느 순간 이상한 코드를 반복해서 짜거나, 이미 만든 기능을 다시 만들려고 한다. 토큰이 빠르게 소진되거나 사용량 제한에 자주 걸린다면, 대부분 컨텍스트 관리가 문제다 토큰이 뭔지 먼저…

Claude Code를 처음 쓰는 사람들이 가장 많이 하는 실수는 바로 요청하는 것이다. “로그인 기능 만들어줘”, “회원가입 페이지 만들어줘”. 운이 좋으면 원하는 결과가 나오지만, 조금만 복잡해지면 금방 방향을 잃는다. AI가 아무리 똑똑해도, 요청하는 사람이 맥락을 잘 전달해야 좋은 결과가 나온다. 건축…