Claude Code 잘 쓰고 있나? 자가 진단 10문항과 읽을 글

Claude Code를 몇 달 썼는데도 제대로 쓰고 있는지 감이 안 온다면 이 체크리스트부터 해 보세요. 막연히 글을 더 찾아 읽으면, 이미 아는 내용만 반복해서 보고 빠진 부분은 계속 놓치게 됩니다.

 

이 블로그에 쌓인 40편 넘는 Claude Code 글을 수준별로 다시 묶어 정리했습니다. 10문항에 답하고 나면 지금 먼저 읽을 글이 서너 편으로 추려집니다.

쓰는 법 — 3분이면 끝

1. 아래 10문항에 예 / 아니요로 답합니다. "가끔 한다"는 아니요로 칩니다.
2. "예" 개수로 지금 수준을 봅니다.
3. "아니요"가 나온 문항의 글만 읽습니다. 다 읽을 필요는 없습니다.

"예" 개수	수준	먼저 볼 곳
0~3개	입문	1~3번 중 "아니요" 나온 글
4~7개	기본기	4~7번 중 "아니요" 나온 글
8~10개	확장	8~10번 중 "아니요" 나온 글 + 맨 아래 관련 글

자가 진단 10문항

#	수준	문항	"아니요"면 읽을 글
1	입문	CLAUDE.md에 빌드·테스트 명령과 하지 말아야 할 것이 적혀 있다	CLAUDE.md 작성법
2	입문	주제가 바뀌면 대화를 새로 시작한다	망치는 습관 3개와 살리는 습관 7개
3	입문	큰 작업은 계획부터 확인하고 시킨다	계획부터 자동 검증까지 워크플로 · Plan 모드
4	기본기	요청할 때 "어디까지 하면 끝인지"를 적는다	Opus 5.5 프롬프트 팁 · 프롬프트를 스펙으로 쓰는 법
5	기본기	결과를 테스트나 변경 내용(diff)으로 확인하고 받는다	자동 검증 워크플로 · AI가 짠 코드 리뷰하는 법 · 테스트 코드 제대로 짜게 하는 법
6	기본기	작업 난이도에 따라 모델이나 effort(생각하는 깊이 단계)를 바꿔 쓴다	Opus 5.5 effort 고르는 법
7	기본기	같은 실수가 반복되면 CLAUDE.md에 적어 둔다	CLAUDE.md 작성법 (1번과 같은 글)
8	확장	매번 반복하는 지시를 스킬로 만들어 뒀다	Claude 스킬 만들기
9	확장	코드 포맷이나 위험한 명령 차단을 훅으로 자동화했다	Claude Code Hooks 실전
10	확장	자주 쓰는 도구(GitHub·노션 등)를 MCP로 연결했다	MCP 서버 연동하기

수준별로 무엇을 보는 문항인가

입문(1~3번)은 결과가 들쭉날쭉할 때 가장 먼저 볼 곳입니다. Claude는 프로젝트 규칙을 모르면 매번 추측하고, 한 대화에 여러 작업이 섞이면 앞의 맥락에 끌려갑니다. 큰 작업을 계획 없이 시키면 방향이 틀린 걸 다 만든 뒤에야 알게 됩니다.

 

기본기(4~7번)는 "시키는 법"과 "받는 법"입니다. 끝나는 조건이 없으면 Claude가 어디서 멈출지 모르고, 결과를 확인 없이 받으면 겉보기만 멀쩡한 코드가 그대로 들어갑니다. 7번은 실수가 나올 때마다 1번의 CLAUDE.md를 고쳐 나가는지 묻는 문항입니다.

 

확장(8~10번)은 반복을 줄이는 단계입니다. 같은 설명을 매번 치고 있다면 스킬로, 매번 직접 확인하는 일이 있다면 훅으로, 브라우저를 오가며 복사하는 일이 있다면 MCP로 넘길 수 있습니다. 1~7번이 안 된 상태에서 여기부터 손대면 자동화할 것 자체가 정리되지 않아 효과가 적습니다.

팀 리드라면 2문항 더

팀에서 같이 쓰고 있다면 아래 두 개도 확인해 보세요.

• 팀 공용 CLAUDE.md와 설정 파일(.claude/settings.json)이 저장소(레포)에 들어 있다
• 팀원들이 쓰는 스킬이나 프롬프트를 서로 공유하는 곳이 있다

둘 다 "아니요"라면, 팀원마다 각자 다른 규칙으로 Claude를 쓰고 있다는 뜻입니다. 같은 저장소인데 사람마다 결과 품질이 다르다면 이 부분부터 맞추세요.

 

한 달쯤 지나 다시 체크해 보면, "예"가 늘어난 만큼 무엇이 달라졌는지 직접 보입니다.

관련 글

• Claude Code 서브에이전트 실전 배치 — 역할 분리부터 병렬 3~5개 스윗스팟까지
• Claude Code 플러그인 만들기 — 스킬·훅·MCP를 하나로 묶어 배포하기
• Claude Code 업데이트, 지금 켜둘 것 6가지 (매주 쏟아지는 것 중)

설치 환경: Windows 11, Claude Code (Claude Max)