Claude Code에서 /insights를 실행하면, 지난 한 달치 대화 기록을 전부 읽고 리포트를 만들어줘요. 어떤 프로젝트를 했는지, 도구를 제대로 쓰고 있는지, 어디서 삽질했는지까지. 공짜로 AI 코칭 받는 셈이에요.
이게 뭔데?
2026년 2월 3일, Claude Code v2.1.30에 조용히 추가된 빌트인 슬래시 커맨드예요. 공식 릴리즈 노트에도 안 올라갔고, 공식 문서도 없어요. Anthropic 엔지니어 Thariq가 X에 한 줄 올린 게 전부였는데 — 써본 사람들 사이에서 "팩폭 기능"이라고 입소문이 퍼졌어요.
한 줄로 요약하면, "지난 30일간의 모든 Claude Code 대화를 읽고, 당신의 AI 활용 습관을 객관적으로 평가해주는 리포트"예요. 터미널에서 /insights 치면 끝이에요. 설치도, 설정도, 별도 플랜도 필요 없어요.
기술적으로는 6단계 파이프라인을 거쳐요. 로컬에 저장된 세션 로그(~/.claude/projects/)를 수집하고, 필터링하고(1분 미만 세션이나 서브에이전트 세션 제거), 메타데이터를 추출하고, Claude Haiku로 정성 분석을 돌리고, 7개 분석 프롬프트로 종합한 뒤, 인터랙티브 HTML 리포트를 생성해요.
리포트가 분석하는 것들이 꽤 구체적이에요.
/insights 리포트에 포함되는 것
프로젝트 영역: 한 달간 뭘 만들었는지 4~5개 영역으로 정리
상호작용 스타일: AI와 어떤 방식으로 대화하는지 분석
잘하고 있는 것: 인상적인 워크플로우 3가지 선정
마찰 분석: 어디서 시간을 낭비했는지 구체적 사례와 함께
개선 제안: CLAUDE.md에 복붙할 수 있는 룰 + 시도해볼 기능 추천
미래 방향: 더 야심차게 시도해볼 워크플로우 제안
재밌는 순간: 대화 중 기억에 남을 순간 하나 (디저트)
중요한 건, 소스코드를 분석하는 게 아니라 대화 기록(세션 트랜스크립트)만 읽는다는 거예요. 코드가 업로드되거나 유출될 걱정 없이, 로컬에서 API 호출로 처리해요.
실제 사용자 데이터가 인상적이에요. 한 풀스택 개발자는 35일간 1,042 세션, 4,516 메시지, 6,267개 파일 수정을 기록했는데 — /insights가 "컨텍스트 리밋 종료가 가장 큰 마찰 요인"이라고 짚어줬고, 체크포인트 파일(.claude/task-status.md) 패턴을 제안했어요.
뭐가 달라지는 건데?
지금까지 "내가 AI를 잘 쓰고 있나?"를 알 방법이 없었어요. 열심히 쓰긴 하는데, 비효율적으로 쓰는지 아닌지는 본인이 모르잖아요. /insights는 이걸 데이터로 보여줘요.
| 기존 (자기 감각) | /insights (데이터 기반) | |
|---|---|---|
| 활용도 파악 | "많이 쓰는 것 같은데…" | 세션 수, 메시지 수, 도구별 사용 횟수 정확히 |
| 문제점 발견 | 같은 실수 반복 (인지 못함) | 마찰 패턴 분류 + 실제 대화 사례 제시 |
| 개선 방법 | 블로그/유튜브 찾아보기 | 내 습관에 맞춘 CLAUDE.md 룰 자동 생성 |
| 도구 활용 | 아는 기능만 반복 사용 | 안 쓰고 있는 기능 추천 (MCP, Task 에이전트 등) |
| 시간 투자 | 수동 회고에 1시간+ | 1분 실행, 자동 리포트 |
Nate Meyvis는 이 경험을 이렇게 표현했어요 — "잘 훈련된 인간 매니저에게 피드백 받는 느낌"이라고요. GeekNews 댓글에서도 "마치 인간 관리자가 리포트 해주는 정도의 느낌"이라는 반응이 나왔어요.
커뮤니티에서는 이미 대안도 나오고 있어요. Corca AI의 cwf:retro 스킬은 /insights와 비슷하지만 접근이 달라요 — 한 달 전체가 아니라 세션 하나를 깊이 파는 회고예요. 4개 병렬 서브에이전트를 돌려서 5-Whys 근본 원인 분석까지 해줘요.
| /insights (빌트인) | cwf:retro (커뮤니티) | |
|---|---|---|
| 범위 | 30일 전체 세션 | 세션 1개 깊이 분석 |
| 출력 | 인터랙티브 HTML | 마크다운 (retro.md) |
| 설치 | 빌트인 (설치 불필요) | claude plugin install 필요 |
| 분석 깊이 | 패턴 탐지 (매크로) | 5-Whys 근본 원인 (마이크로) |
| 적합 대상 | 모든 Claude Code 사용자 | 구조화된 AI 워크플로우 팀 |
둘은 경쟁이 아니라 보완 관계예요. /insights로 월간 큰 그림을 보고, cwf:retro로 중요한 세션을 깊이 복기하면 최적이에요.
주의할 점
리포트의 서사(narrative) 부분에서 간혹 실제와 다른 수치가 나올 수 있다는 보고가 있어요. 통계 대시보드는 정확하지만, 문장으로 풀어쓴 부분은 교차 확인하세요.
핵심만 정리: 시작하는 법
- 버전 확인
터미널에서claude --version으로 v2.1.30 이상인지 확인. 아니면npm update -g @anthropic-ai/claude-code로 업데이트. - /insights 실행
Claude Code 터미널에서/insights입력. 끝이에요. 30일치 세션이 자동 분석돼요. - HTML 리포트 확인
분석이 끝나면~/.claude/usage-data/report.html에 리포트가 생겨요. 브라우저에서 열면 인터랙티브 차트와 함께 볼 수 있어요. - CLAUDE.md 룰 복붙
리포트 하단의 "Suggestions" 섹션에 CLAUDE.md에 추가할 룰이 바로 복사할 수 있게 나와요. 내 마찰 패턴에 맞춘 맞춤형 룰이에요. - 한 달 뒤 다시 실행
개선 사항을 적용하고 한 달 뒤 다시 돌려보세요. 이전 분석은 캐시되어 있어서, 새 세션만 추가 분석해요. 변화를 추적할 수 있어요.
