[Claude Code #10] /doctor·/context·/usage 진단 정리

Claude Code 진단 명령 6종을 정리했습니다. /context 컨텍스트 시각화, /usage 사용량, /status 세션 정보, /doctor 설정 점검, /debug 로그 추적, /insights 사용 패턴 보고서까지.

AI 에이전트를 오래 쓰다 보면 궁금해지는 순간이 옵니다. 컨텍스트가 얼마나 찼지, 오늘 얼마나 썼지, 설정이 꼬인 건 아닌지.

Claude Code에는 이 질문들에 하나씩 답해 주는 진단 명령이 있습니다. 이번 편에서 여섯 개를 묶어 정리할게요.

Claude Code 9편까지가 일 시키는 법이었다면, 이번엔 계기판 보는 법입니다.

/context: 컨텍스트가 얼마나 찼나

/context는 현재 컨텍스트 사용량을 색깔 격자로 시각화합니다.

공식 명령어 문서 기준으로 어떤 도구가 컨텍스트를 많이 먹는지 알려 줍니다. 메모리가 비대해졌는지, 용량 경고가 떴는지도 같이 나와요. all을 붙이면 항목별 상세가 펼쳐집니다.

CLAUDE.md가 제대로 로드됐는지 확인할 때도 씁니다. Memory files 목록에 안 보이면 Claude가 그 파일을 못 읽고 있는 거예요.

/usage는 공식 비용 문서 기준으로 토큰 사용량과 비용, 요금제 한도 현황을 보여 줍니다. /cost라고 쳐도 같은 화면이 떠요.

구독 플랜이라면 한도를 얼마나 썼는지, API 과금이라면 세션 비용이 얼마인지 가늠할 때 씁니다. 스킬·MCP 서버별 사용량 비중도 나와서 뭐가 한도를 먹는지 찾기 좋아요.

/status를 치면 설정 화면의 Status 탭이 열립니다. 버전, 모델, 로그인 계정, 연결 상태를 한 화면에서 확인할 수 있어요.

“내가 지금 어떤 계정으로, 어떤 모델을 쓰고 있지?“가 궁금할 때 가장 빠른 답입니다. 응답 중에도 끊지 않고 바로 실행돼요.

/doctor는 설치와 설정 전반을 훑는 종합검진입니다(별칭 /checkup). 발견한 문제를 고쳐 주는 데까지 갑니다.

점검 범위가 꽤 넓습니다.

바로 고치지 않고 발견 사항을 먼저 보고한 뒤 확인을 받습니다. 세션 밖에서 claude doctor를 치면 읽기 전용 진단만 출력돼요. 한 달에 한 번쯤 돌려 볼 만합니다.

뭔가 이상하게 동작하면 /debug를 입력하세요. 그 시점부터 디버그 로그를 켜고 그 로그를 읽어 문제를 추적합니다.

“MCP 연결이 자꾸 끊겨” 같은 설명을 붙이면 분석 초점이 잡힙니다.

/insights는 이 컴퓨터의 최근 세션들을 분석한 HTML 보고서를 만들어 줍니다.

어떤 프로젝트에서 어떻게 쓰는지, 어디서 자주 막히는지, 시도해 볼 만한 기능은 뭔지를 짚어 줍니다. 도구 쓰는 습관 자체를 점검하고 싶을 때 한 번씩 열어 보면 좋아요.

여섯 개를 상황으로 묶으면 이렇게 됩니다.

다음 편에서는 명령 실행 전후에 자동으로 스크립트를 거는 훅(hooks)을 다룹니다. 진단을 넘어 자동화로 가는 첫걸음이에요.