cctrace

cctrace는 로컬에서 실행되는 제로 구성 TLS 인터셉트 프록시로, 코딩 에이전트(Claude Code, OpenAI Codex CLI, Grok CLI, Kimi Code CLI, opencode)와 해당 API 사이에 위치하여 모든 HTTP 호출을 실시간으로 캡처합니다. 채팅 엔드포인트만 보는 기본 URL 프록시와 달리, cctrace는 전송 계층에서 인터셉트하여 OAuth 흐름, 사용량/크레딧 엔드포인트, MCP 레지스트리 호출, 부트스트랩 요청, 그리고 단순 URL 재작성으로는 관찰할 수 없는 텔레메트리까지 도달합니다. 이 도구는 CA 인증서를 자동 생성하고 HTTPS_PROXY를 통해 에이전트가 이를 경유하도록 구성하므로 수동 설정이 필요 없습니다. 자사 호스트는 복호화되어 완전히 캡처되고, 외부 호스트(npm, GitHub, apt)는 불투명한 바이트 카운트 터널로 통과시켜 트레이스를 간결하게 유지합니다. 라이브 웹 UI는 필터 칩이 있는 카테고리별 요청 보기, 디코딩된 SSE 스트림, 추론 노력 및 프롬프트 캐시 판정, 첫 토큰 지연 시간, 요청당 예상 비용을 제공합니다. 세션은 사람이 세는 방식대로 재구성되며, 시간 경과에 따른 레인을 보여주는 궤적 바, 접촉한 파일을 명명하는 도구 행, 하위 에이전트 분기, 모델 에포크, 압축 경계를 포함합니다. 세션 재생은 캡처된 세션을 단계별로 또는 재생하며, 활성 실행 중에는 라이브 테일링을 지원합니다. 컨텍스트 보기는 시간 경과에 따른 에이전트 창을 대화형 개요로 보여줍니다: 여섯 가지 컨텍스트 범주로 색칠된 와이어 요청별 누적 열, 압축 마커, 벽시계 시간 분석. 선택 항목은 세 가지 방식으로 읽을 수 있습니다: 컨텍스트 그래프(고드름 분해), 레코드의 선형 스트림, 또는 주입 및 압축의 이벤트 타임라인. 비용 추적은 캐시 읽기/쓰기/입력/출력 분석으로 할당량이 어디에 사용되는지 보여주고, 캐시 미스 원인(만료된 TTL, 접두사 변경, 529 재시도)을 식별하며, 클라이언트가 폴링한 계정 할당량을 표시합니다. insights 명령은 일별, 프로젝트별, 클라이언트별로 실행을 집계하며, 캐시 분할 및 할당량 비율에 대한 심층 스캔을 선택적으로 제공합니다. doctor 명령은 세션의 최신 요청 창을 진단하여 사용되지 않는 도구 스키마, 반복되는 하네스 주입, 중복 콘텐츠, 캐시 비효율성을 식별하고 실행 가능한 개선 방안을 제시합니다. 트레이스는 .jsonl 파일로 저장되며(.jsonl.zst로 아카이브), cctrace view로 언제든 다시 열 수 있고, 마크다운 트랜스크립트 또는 오프라인 HTML 스냅샷으로 내보낼 수 있습니다. 프로젝트 간 대시보드는 모든 라이브 및 완료된 실행을 원클릭 세션 보기, 중지 컨트롤, 저장소 관리와 함께 보여줍니다. 자격 증명은 디스크에 기록되기 전에 헤더, 본문, URL에서 삭제됩니다. 트레이스는 프로젝트 트리 외부의 ~/.local/share/cctrace/에 저장됩니다. 이 도구는 Bun, openssl, 대상 CLI가 필요하며, npm 또는 독립 실행형 컴파일 바이너리로 제공됩니다.