코딩 도구 사용량 추적하기

Claude Code, Roo Code, Gemini CLI, OpenAI Codex 같은 AI 코딩 도구의 사용량과 비용을 LiteLLM을 통해 추적하는 방법을 알려드릴게요. User-Agent 헤더로 각 코딩 도구의 요청, 비용, 사용자 참여 지표를 모니터링할 수 있어요.

출처: 문서

본문

이런 분들을 위한 문서

개발자에게 LiteLLM을 통해 코딩 도구에 대한 접근을 제공하는 중앙 AI 플랫폼 팀을 위한 문서예요. 도구 참여를 모니터링하고 개별 사용자의 사용 패턴을 추적해요.

추적할 수 있는 것

요약 지표

코딩 도구별 비용
도구별 성공 요청 및 토큰 사용량

사용자 참여 지표

각 User-Agent에 대한 일일, 주간, 월간 활성 사용자

빠른 시작

1. 코딩 도구를 LiteLLM에 연결

적절한 User-Agent 헤더와 함께 코딩 도구가 LiteLLM 프록시를 통해 요청을 보내도록 구성해요.

설정 가이드:

Claude Code와 함께 LiteLLM 사용하기
Gemini CLI와 함께 LiteLLM 사용하기
OpenAI Codex와 함께 LiteLLM 사용하기

2. User-Agent 헤더로 요청 보내기

코딩 도구가 API 요청에 식별용 User-Agent 헤더를 포함하는지 확인해요.

3. LiteLLM 로그에서 추적 확인

예상되는 User-Agent 값이 로그에 있는지 확인해 LiteLLM이 요청을 제대로 추적하는지 확인해요.

4. 사용량 대시보드 보기

LiteLLM 대시보드에서 집계된 사용량 지표와 사용자 참여 데이터를 확인해요.

요약 지표

각 코딩 도구의 총 비용과 성공 요청을 확인해요.

일일, 주간, 월간 활성 사용자

각 코딩 도구의 활성 사용자 지표를 확인해요.

LiteLLM이 코딩 도구를 식별하는 방법

LiteLLM은 들어오는 API 요청(/chat/completions, /responses 등)의 User-Agent 헤더를 모니터링해 코딩 도구를 추적해요. 각 고유 User-Agent는 사용량 분석에서 따로 추적돼요.

요청 예시

User-Agent를 claude-cli로 사용한 예시를 보여드릴게요.

curl -X POST \  -H "Content-Type: application/json" \  -H "Authorization: Bearer ***" \  -H "User-Agent: claude-cli/1.0" \  -d '{"model": "claude-sonnet-5", "messages": [{"role": "user", "content": "Hello, how are you?"}]}' \  http://localhost:4000/chat/completions

코딩 도구 사용량 추적하기