Claude Code 마스터 완독 후기

최근 Claude Code 마스터를 완독했다.

처음에는 단순히 Claude Code를 잘 쓰는 방법을 배우기 위한 책이라고 생각했다.
AI에게 어떤 식으로 질문하고, 어떤 방식으로 코드를 생성시키는지에 대한 “사용법” 중심의 책일 것이라 예상했다.

하지만 끝까지 읽고 나니 결이 완전히 달랐다.

이 책은 단순한 AI 활용법이 아니라 AI 시대 개발자의 작업 방식과 개발 시스템 설계에 대한 이야기에 더 가까웠다.

---

Claude Code는 단순한 도구가 아니었다

Claude Code는 단순히 코드 생성 AI가 아니라 다음을 포함하는 개발 환경에 가까웠다.

• 프로젝트 규칙 관리
• 개발 프로세스 구조화
• 설계 방식 정리
• 자동화
• 문서 기반 협업

처음에는 “AI 코딩 도구”라고 생각했지만,
읽고 나서는 “개발 시스템 전체를 다루는 도구”라는 인식으로 바뀌었다.

---

Opus와 Sonnet의 역할 분리

가장 인상 깊었던 부분은 모델 활용 방식이었다.

• Opus: 설계, 분석, 구조화, 복잡한 문제 해결
• Sonnet: 구현, 리팩토링, 일반 개발 작업

즉,

설계는 Opus, 구현은 Sonnet

이라는 구조였다.

단순히 하나의 모델을 쓰는 것이 아니라
역할을 나누는 것이 생산성을 높이는 방식이라는 점이 인상적이었다.

---

AGENTS.md와 /init의 중요성

AGENTS.md는 단순한 설정 파일이 아니라
AI가 프로젝트를 이해하는 기준 문서였다.

여기에 포함되는 내용은 다음과 같다:

• 코드 스타일
• 폴더 구조
• 개발 규칙
• 기술 스택
• 아키텍처 원칙

이전에는 세션이 바뀔 때마다 같은 설명을 반복했지만,
이제는 문서 하나로 기준을 유지할 수 있다는 점이 중요했다.

---

Hook은 자동화가 아니라 안전장치

Hook 기능도 단순 자동화가 아니라 다음 역할을 한다.

• 포맷 자동화
• 테스트 자동 실행
• 작업 완료 알림
• 위험 작업 방지
• 초기화/삭제 방지

즉,

생산성 도구가 아니라 실수 방지 장치

라는 점이 핵심이었다.

---

수치화된 요구사항의 중요성

가장 크게 느낀 변화 중 하나는 “요구사항 표현 방식”이었다.

기존 방식

• 빠르게 동작해야 한다
• 안정적이어야 한다

개선된 방식

• API 응답 300ms 이하
• 에러율 1% 이하
• 초기 로딩 2초 이내

즉,
추상적인 요구가 아니라 측정 가능한 기준으로 바꾸는 것이 중요했다.

---

MCP는 많을수록 좋은 것이 아니다

MCP를 통해 다양한 외부 도구를 연결할 수 있지만,
무분별하게 추가하면 오히려 문제가 발생한다.

• 컨텍스트 증가
• 토큰 낭비
• 속도 저하

결론은 단순했다.

필요한 것만 연결하는 것이 중요하다

---

Next.js + PostgreSQL에 대한 관점 변화

기존에는 React + NestJS 구조를 선호했다.

하지만 책과 실습을 통해 생각이 조금 바뀌었다.

• Next.js: 통합 구조, 빠른 개발
• PostgreSQL: 운영 안정성 + 확장성
• Vercel: 배포 단순화 + 무료 DB 옵션

결국 MVP 단계에서는:

Next.js + PostgreSQL 조합이 더 현실적인 선택일 수 있다

는 결론에 도달했다.

---

가장 큰 변화: 개발 관점 자체의 변화

책을 읽기 전에는:

AI를 어떻게 잘 사용할까?

를 고민했다.

 

읽고 난 후에는:

개발 시스템과 기준을 어떻게 설계할까?

로 관점이 바뀌었다.

---

마무리

이 책을 통해 얻은 가장 큰 인사이트는 특정 기능 사용법이 아니라
“AI와 함께 개발하는 방식 자체”였다.

• AI는 구현을 돕는 도구
• 개발자는 기준과 방향을 결정하는 주체

이 구조가 핵심이었다.