Claude 토큰 사용량 추적 확장프로그램 설치

claude.ai 한도에 자꾸 걸린다면, 대부분 원인은 정리하지 않고 쌓아둔 프로젝트 Knowledge입니다. 토큰이 어디서 새는지 보여주는 오픈소스 확장프로그램 Claude Usage Tracker 설치와 설정 가이드.

들어가며

Claude를 매일 쓰다 보면 한 번쯤 마주치는 화면이 있습니다.

메시지 한도에 도달했습니다. 오후 3시에 다시 시도하세요.

문제는 한도에 부딪히기 전까지 내가 얼마나 썼는지 알 수 없다는 점입니다. 게이지도, 남은 횟수 표시도 없습니다. 그래서 "왜 벌써 다 썼지?"라는 의문만 남고, 다음에도 똑같이 반복됩니다.

원인을 짚어보면 대개 이렇습니다. LLM은 상태를 기억하지 않기 때문에, 대화를 이어갈 때마다 지금까지의 맥락 전체를 매번 다시 전송합니다.

내가 입력한 건 짧은 질문 한 줄인데, 실제로 전송되는 건 저 전부입니다. 프로젝트에 200페이지짜리 PDF를 올려뒀다면, 그 프로젝트에서 "안녕"이라고만 해도 200페이지가 함께 갑니다.

이 보이지 않는 비용을 눈에 보이게 만들어 주는 것이 Claude Usage Tracker 확장프로그램입니다.

Claude Usage Tracker란

lugia19 개발자가 만든 오픈소스 브라우저 확장프로그램으로, claude.ai에서 소비하는 토큰량을 실시간으로 추적해 보여줍니다.

10만 명이 쓰고 평점 4.8을 유지한다는 점보다 중요한 건 소스코드가 GitHub에 공개되어 있다는 사실입니다. 브라우저 확장프로그램은 구조상 페이지의 내용을 읽을 권한을 갖습니다. Claude에 붙이는 확장이라면 곧 내 대화 내용을 읽을 수 있다는 뜻이므로, 코드를 검증할 수 있는지가 설치 판단의 기준이 되어야 합니다.

설치 방법

Chrome

1. Chrome 웹스토어 - Claude Usage Tracker 페이지로 이동
2. Chrome에 추가 클릭
3. 권한 안내 팝업에서 확장 프로그램 추가 클릭

⚠️ 확장프로그램 ID는 knemcdpkggnbhpoaaagmjiigenifejfo 입니다. 웹스토어에서 검색해서 설치할 경우, 이름이 비슷한 다른 확장프로그램이 여럿 있으니 ID가 일치하는지 확인하세요.

Firefox

Mozilla 애드온 스토어에서 claude-usage-tracker 로 검색해 설치합니다.

데스크톱 앱 (MacOS / Windows)

Claude 데스크톱 클라이언트를 쓰는 경우에도 적용할 수 있습니다. GitHub 저장소에서 제공하는 Claude-WebExtension-Launcher 설치 프로그램을 실행하면 데스크톱 앱에 확장프로그램을 주입해 줍니다.

화면에 무엇이 표시되나

설치하고 claude.ai에 접속하면 별도의 로그인이나 계정 연동 없이 바로 사용량이 표시됩니다.

Chrome 웹스토어에 공개된 실행 화면. 위쪽은 현재 대화의 통계, 아래쪽은 계정 전체의 한도 현황입니다.

표시는 두 층으로 나뉩니다.

1. Conversation stats — 지금 이 대화의 비용

대화 제목 바로 아래에 붙습니다.

여기서 눈여겨볼 것이 Cached for 입니다. 같은 대화를 짧은 간격으로 이어가면 캐시가 살아 있어 비용이 크게 줄고, 한참 쉬었다 돌아오면 캐시가 만료되어 전체 맥락을 다시 계산합니다. 작업을 몰아서 하는 편이 유리한 이유가 이 한 줄에 드러납니다.

2. Usage estimate — 계정 전체의 한도

화면 하단 패널에 표시됩니다.

Claude의 한도는 세션 단위와 주 단위가 함께 걸립니다. 둘 중 하나만 봐서는 판단이 어긋납니다. 세션 잔여량이 넉넉해도 주간 한도가 바닥이면 곧 멈추게 되고, 반대라면 한두 시간만 기다리면 풀립니다. 두 값을 나란히 보여주는 것이 이 확장프로그램의 실질적인 핵심입니다.

특히 Messages left 는 현재 대화의 길이를 기준으로 계산되기 때문에, 대화가 길어질수록 이 숫자가 줄어듭니다. 47개 남았다고 떴다가 몇 번 주고받은 뒤 30개로 떨어지는 건 오류가 아니라 정상 동작입니다. 이 숫자가 빠르게 줄면 새 대화를 시작하라는 신호로 읽으면 됩니다.

한도에 도달하기 전 경고 알림도 뜨므로, 작업을 마무리할 타이밍을 확보할 수 있습니다.

💡 처음에는 수치가 비어 있거나 부정확할 수 있습니다. 확장프로그램은 설치 시점 이후의 대화부터 계산하므로 과거 소모량은 소급되지 않습니다. 하루 정도 평소처럼 쓰면 안정화됩니다.

무엇을 추적하는가

이 도구가 유용한 진짜 이유는 눈에 보이지 않는 토큰까지 계산한다는 점입니다.

• 업로드한 파일 — 채팅 첨부 파일, Google Drive · GitHub 연동으로 동기화된 파일
• 프로젝트 Knowledge — 프로젝트에 등록한 지식 파일과 커스텀 지시사항
• 개인 설정(Personal preferences) — 설정에 저장해 둔 개인 선호 지침
• 메시지 히스토리와 시스템 프롬프트 — 대화가 길어질수록 누적되는 부분
• MCP / 통합 도구 — 연결한 도구의 정의(schema)

특히 프로젝트 Knowledge와 MCP 도구 정의가 체감상 가장 큽니다. 둘 다 UI에 표시되지 않으면서 매 요청마다 전송되고, 한 번 설정해 두면 존재 자체를 잊게 되는 항목이기 때문입니다.

MCP를 여러 개 붙여둔 경우 도구 정의만으로 수천 토큰이 고정 비용으로 나갑니다. 실제로 안 쓰는 MCP를 해제하는 것만으로 체감이 달라지는 경우가 있는데, 그 판단을 수치로 할 수 있게 해 주는 것이 이 확장프로그램의 값어치입니다.

마치며

정리하면 이렇습니다.

• 설치는 클릭 두 번, 설정은 사실상 없음
• Session limit · Weekly limit을 동시에 확인, Reset in 으로 초기화까지 카운트다운
• 대화별 Conversation stats 로 토큰·크레딧·캐시 상태까지 확인
• 보이지 않던 프로젝트 Knowledge · MCP 도구 정의의 비용이 수치로 드러남
• 웹 검색 · Research는 잡히지 않으므로 표시값은 하한선으로 해석
• 오픈소스라 개인정보 처리 방식을 직접 검증할 수 있음

며칠만 켜두면 "내가 어디서 토큰을 태우고 있었는지"가 눈에 보입니다. 그리고 대부분의 경우 답은 하나로 수렴합니다 — 정리하지 않고 쌓아둔 프로젝트 Knowledge입니다.

측정할 수 없으면 개선할 수 없다는 말은 여기에도 그대로 적용됩니다.

---

참고 링크

• Chrome 웹스토어: https://chromewebstore.google.com/detail/claude-usage-tracker/knemcdpkggnbhpoaaagmjiigenifejfo
• GitHub 저장소: https://github.com/lugia19/Claude-Usage-Extension
• Firefox 애드온: https://addons.mozilla.org/firefox/addon/claude-usage-tracker/

본문의 버전 · 사용자 수 · 평점은 2026년 7월 기준입니다.