/usage가 토큰을 얼마나 썼는지 보여 준다면, /insights는 내가 어떻게 쓰는지 보여 줍니다. 공식 문서의 설명대로, 이 컴퓨터의 최근 세션을 분석해 HTML 보고서를 씁니다.
보고서에 나오는 것
- 어떤 작업을 해 왔는지
- 막힌 곳: 요청을 잘못 알아들었거나 버그 있는 코드가 나온 지점
- Claude Code를 더 잘 쓰는 제안
- auto mode를 쓸 수 있는데 최근 세션 대부분을 auto mode 없이 돌렸다면, auto mode가 처리했을 권한 창이 몇 번인지 어림한 값
읽는 범위
한 번 돌릴 때 아직 분석하지 않은 세션을 최대 200개까지 읽고, 아주 짧은 세션은 건너뜁니다. 빠진 세션이 있으면 보고서 머리에 200 sessions (412 total)처럼 분석한 수와 전체 수가 함께 나옵니다. 다른 기기와 claude.ai의 세션은 들어가지 않습니다.
알고 쓸 두 가지
- 토큰이 듭니다. 분석은 평소 세션과 같은 제공자·계정으로 돌고, 쓴 토큰은 내 요금제나 API 사용량에 잡힙니다. 요금제와 제공자에 상관없이 쓸 수 있습니다.
- 보고서는 지워집니다. 최신 보고서는
~/.claude/usage-data/report.html에, 돌릴 때마다 시각이 붙은 사본이 같은 폴더에 쌓입니다. 하지만 다른 세션 기록과 같은 일정으로, Claude Code가 시작할 때cleanupPeriodDays(기본 30일)보다 오래된 파일을 지웁니다.
보관하기
오래 두고 비교하고 싶다면 돌린 뒤 다른 폴더로 복사해 두세요.
mkdir -p ~/Documents/claude-insights
cp ~/.claude/usage-data/report.html ~/Documents/claude-insights/report-$(date +%Y%m%d).html쓰는 법
Claude Code에서 한 번 입력하고, 보고서의 막힌 곳 항목부터 읽어 보세요. 자주 겪는 문제라면 CLAUDE.md 규칙이나 스킬로 옮겨 두면 다음 세션부터 덜 막힙니다.
/insights참고
- Manage costs effectively: Analyze your usage patterns (2026-11-09 확인)