# Show GN: Claude Code가 어떤 형태로 Claude.md를 서버에 보내고, skill 원문을 서버에 보내는지 알 수 있는 proxy 툴을 만들었습니다.

> Clean Markdown view of GeekNews topic #27582. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27582](https://news.hada.io/topic?id=27582)
- GeekNews Markdown: [https://news.hada.io/topic/27582.md](https://news.hada.io/topic/27582.md)
- Type: show
- Author: [remin1994](https://news.hada.io/@remin1994)
- Published: 2026-03-17T12:25:04+09:00
- Updated: 2026-03-17T12:25:04+09:00
- Original source: [github.com/kangraemin](https://github.com/kangraemin/claude-inspector)
- Points: 29
- Comments: 4

## Summary

**Claude Code의 요청 구조를 시각화하는 프록시 툴 ‘Claude Inspector’가 공개되었습니다.**  
이 도구는 **CLAUDE.md와 스킬, 메시지 히스토리**가 서버로 어떻게 전송되는지를 실시간으로 보여주며, 매 요청마다 전체 컨텍스트가 재전송된다는 점을 확인할 수 있습니다. 이를 통해 CLAUDE.md를 간결히 유지하거나 `/clear` 명령으로 대화 기록을 주기적으로 비우는 것이 토큰 효율에 중요함을 직관적으로 파악할 수 있습니다.

## Topic Body

Claude Code로 작업하다가 문득, CLAUDE.md 파일이나, 스킬, rules / memory 같은 데이터를 Claude 서버가 어떻게 인지하는거지 ? 가 궁금 해 졌습니다.   
  
그래서 직접 MITM 프록시를 만들어서 트래픽을 볼 수 있는 툴을 만들어 보았습니다.   
  
Claude code를 실행 할 때, baseURL 을 변경 하여, claude code 내에서 발생 하는 http 통신을 캡처하여 보여주는 원리 입니다.   
  
이 툴을 이용 하여 알 수 있었던 사항들 입니다.   
  
**`hello` 한 마디에 12KB가 붙어 나간다**  
- Claude code를 켜자마자, hello 를 보냈을 때의 상황입니다.   
- `content[0]` 스킬 목록 ~2KB, `content[1]` CLAUDE.md ~10KB, `content[2]` 실제 입력인 hello 텍스트가 보내집니다.   
- 즉, CLAUDE.md 500줄이면 매 요청마다 통째로 전송 되고 이는 CLAUDE.md를 간결하게 유지해야 하는 이유 입니다.   
  
**대화가 쌓일수록 매 요청이 눈덩이처럼 커진다**  
- `messages[]` 전체를 매 요청마다 재전송 합니다. — 1턴 15KB, 10턴 200KB, 30턴 1MB+  
- 심지어 클로드가 답했던 것도 request message로 포함되어 들어갑니다.   
- 컨텍스트 윈도우를 주기적으로 `/clear`를 해주지 않는다면, 토큰 낭비와 함께 앞의 문맥이 뒤의 문맥과 항상 함께 붙어다녀 성능 저하가 올 수 있음을 알 수 있었습니다.   
  
**MCP 툴은 필요할 때만 로딩된다**  
- 처음엔 빌트인 N개만 ( 클로드 버전에 따라 다릅니다 ) 로드되고, MCP tool을 활용 해야 할 경우에, 서버에서 `ToolSearch`를 호출하여 사용할 툴을 찾습니다.   
- 이후엔 호출마다 위에서 찾은 툴이 추가되어 호출되는 형태입니다.   
- 즉 동적으로 MCP Tool 을 로드하기 때문에, 사용하지 않았던 MCP의 툴은 실제로 큰 토큰 소비가 없음을 알 수 있었습니다.  
  
**서브에이전트는 완전히 격리된 컨텍스트로 실행된다**  
- 서브에이전트는 부모 대화 이력이 전혀 없이 새로운 세션이 열리는것과 같습니다.   
- Inspector에서 부모/서브에이전트 두 호출을 나란히 눈으로 비교 하여 보실 수 있습니다.   
  
**이미지 첨부 한 장이 수백 KB를 추가한다**  
- 스크린샷을 첨부하면 base64 인코딩되어 JSON 바디에 인라인 삽입 됩니다.   
- 이미지가 요청을 얼마나 키우는지 실시간으로 확인 가능 합니다.   
  
---  
  
아래의 명령어로 설치하실 수 있습니다.   
  
```bash  
brew install --cask kangraemin/tap/claude-inspector && sleep 2 && open -a "Claude Inspector"   
```  
  
GitHub: https://github.com/kangraemin/claude-inspector  
  
아직 macOS 전용이고 초기 버전이라, 개선 사항 제안주시면 적극 수용하겠습니다.   
  
써보시고, 공부에 도움되셨으면 좋겠습니다 감사합니다 !

## Comments



### Comment 53279

- Author: winterjung
- Created: 2026-03-18T11:52:58+09:00
- Points: 3

[suspiciously precise floats, or,  
how I got Claude's real limits 글](https://she-llac.com/claude-limits)에서는 api 비용과 다르게 구독 플랜에선 캐시 읽기 비용이 없다는 분석이 있더라구요. 세션이 길어질수록 계산된 비용과 실제 비용에 오차가 좀 있을거같기도합니다.

### Comment 53282

- Author: remin1994
- Created: 2026-03-18T12:21:26+09:00
- Points: 1
- Parent comment: 53279
- Depth: 1

오 .... 전혀몰랐던 글이네요 ... 한번 확인해보겠습니다 ! 감사합니다

### Comment 53310

- Author: kgcrom
- Created: 2026-03-18T22:15:02+09:00
- Points: 1

https://github.com/badlogic/lemmy/tree/main/apps/claude-trace  
이걸로 프롬프트랑 어떤 도구 사용했는지 살펴봤는데 만드신것도 써봐야겠네요.  
공유해주셔서 감사합니다. :+1:

### Comment 53208

- Author: remin1994
- Created: 2026-03-17T13:46:35+09:00
- Points: 1

추가적으로, 요청 후 response 내에서 해당 request 에 쓰인 토큰 양을 볼 수 있습니다 !   
  
모델: claude-sonnet-4-6  
요청 크기: 68.9 KB  
  
  "usage": {  
    "input_tokens": 3,  
    "cache_creation_input_tokens": 12394,  
    "cache_read_input_tokens": 6499,  
    "cache_creation": {  
      "ephemeral_5m_input_tokens": 0,  
      "ephemeral_1h_input_tokens": 12394  
    },  
    "output_tokens": 74,  
    "service_tier": "standard",  
    "inference_geo": "not_available"  
  }  
  
또 이를 모델별 가격을 적용하여 request 당 cost 도 계산 해 두었으니 많은 이용 부탁드려요 ㅎㅎ   
  
  캐시읽기: 6.5K tok × $0.3/MTok = $0.0019  
  캐시쓰기: 12.4K tok × $3.75/MTok = $0.0465  
  미캐시 입력: 3 tok × $3/MTok = $0.0000  
  출력: 74 tok × $15/MTok = $0.0011  
  
  합계: $0.0495  
  캐시 적중률: 34%