jianshuo/ccglass

해결하는 문제

많은 AI 코딩 에이전트(Claude Code 또는 Codex 등)는 표준 시스템 프록시 설정을 무시하는 네이티브 앱이나 Node.js 환경을 사용합니다. 이로 인해 복잡한 CA 인증서를 사용하거나 패치를 통해 앱을 수정하지 않고는 시스템 프롬프트, 도구 스키마, 전체 메시지 기록과 같은 LLM 제공업체로 전송되는 실제 트래픽을 검사하는 것이 거의 불가능합니다.

작동 원리

ccglass는 경량 로컬 리버스 프록시 및 웹 대시보드로 작동합니다. 클라이언트의 기본 URL 환경 변수(예: ANTHROPIC_BASE_URL 또는 OPENAI_BASE_URL)를 localhost로 리디렉션하여 코딩 에이전트와 AI API 간의 일반 HTTP 통신을 가로챕니다. URL이 하드코딩된 도구의 경우, TLS MITM을 사용하는 포워드 프록시 모드를 제공하여 대상 트래픽을 복호화하고 기록합니다. 캡처된 모든 요청은 공간 절약을 위해 콘텐츠 주소 지정 형식으로 저장되며 웹 인터페이스를 통해 실시간으로 확인할 수 있습니다.

대상 사용자

AI 코딩 에이전트나 IDE 확장 프로그램(Cursor, Cline, Continue 등)을 사용하는 개발자 중 에이전트의 동작을 디버깅하거나, 전송되는 정확한 프롬프트를 감사하거나, 토큰 사용량 및 비용을 추적하려는 분들에게 적합합니다.

주요 특징

• 실시간 요청 스트림: 전체 시스템 프롬프트, 도구 호출 및 메시지 기록을 실시간으로 확인합니다.
• 에이전트 루프 시각화: 모델의 도구 선택과 로컬 실행 결과 간의 흐름을 보여주는 시퀀스 다이어그램을 제공합니다.
• 턴 간 차이 비교: 두 요청을 비교하여 턴 사이에 어떤 컨텍스트가 추가되거나 변경되었는지 정확하게 파악할 수 있습니다.
• 비용 및 토큰 추적: 입력/출력/캐시 토큰과 요청당 예상 USD 비용을 실시간으로 계산합니다.
• 광범위한 호환성: Claude Code, DeepSeek-TUI, Ollama, OpenRouter 및 다양한 IDE 확장 프로그램을 포함한 광범위한 제공업체를 지원합니다.
• 자기 검사 (MCP): Claude Code와 함께 사용할 경우, 에이전트는 MCP 도구를 사용하여 채팅 내에서 자신의 프록시 요청을 직접 검사할 수 있습니다.