클로드코드 팀 사용량 대시보드 만들기, 연동 한 번으로 코덱스까지 통합

요즘 개발 조직들 사이에서 눈에 띄는 변화가 하나 있습니다. 클로드 코드 같은 AI 코딩 툴을 각자 알아서 쓰게 두지 않고 팀 전체가 사용량 대시보드를 함께 보면서 운영합니다. 누가 얼마나 쓰는지, 어떤 모델을 어떤 작업에 쓰는지 같이 확인하고 잘 쓰는 사람의 패턴을 조직에 퍼뜨립니다. AI 도입을 비용 통제 문제로만 보지 않고 AI Native 조직으로 가는 훈련 과정으로 여기는 관점인데요. 그 출발점이 사용량을 보이게 만드는 일입니다.

문제는 이 대시보드를 어떻게 마련하느냐입니다. 여기서는 클로드 코드·코덱스 같은 툴을 설정 변경 한 번으로 팀 대시보드에 묶는 방법을 다룹니다.

팀 대시보드, 왜 어려울까요

개인용 도구는 이미 충분합니다. 클로드 코드 안에서 /usage나 /cost를 치면 내 사용량이 나오고 ccusage 같은 오픈소스 CLI로 일별·월별 히스토리도 볼 수 있죠. 상태줄(statusline)을 꾸며 터미널에 상시 띄워두는 방법도 잘 알려져 있고요. 전부 훌륭한 도구지만 공통점이 하나 있습니다. 내 로컬의 클로드 코드만 보여준다는 겁니다.

조직에서는 질문 자체가 다르죠.

• 팀원 열 명이 각자 클로드 코드를 쓰는데, 누가 얼마나 쓰는지 아무도 모릅니다

• 어떤 팀원은 코덱스를, 어떤 팀원은 커서를 쓰는데 결제는 툴마다 따로 돌아갑니다

• 재무팀은 매달 흩어진 영수증을 모아 정산하고 개발팀장은 예산 초과를 청구서가 온 뒤에야 압니다

• 사용을 촉진하고 싶어도 지금 누가 잘 쓰고 누가 손을 놓았는지 보이지 않습니다

공식 옵션이 없는 건 아닙니다. Anthropic의 Team/Enterprise 플랜에는 관리자용 분석 대시보드가 있고 OpenTelemetry로 조직 전체 텔레메트리를 수집하는 경로도 문서에 나와 있습니다. 커서도 Business 플랜에 팀원별 사용량 대시보드를 제공하고요.

다만 이 방법들은 전부 툴 하나씩만 커버합니다. Anthropic 대시보드는 클로드 코드만, 커서 대시보드는 커서만 보여줍니다. 결국 전체를 보려면 직접 구축으로 넘어가게 되는데, 여기서부터 일이 커집니다.

직접 구축하면 해야 하는 일들

공식 경로인 OpenTelemetry로 팀 대시보드를 만든다고 해보죠. 문서에 적힌 대로라면 필요한 게 이렇습니다.

• 수집 서버 구축: OpenTelemetry Collector를 배포하고 상시 운영합니다

• DB 연동: 메트릭을 저장할 시계열 백엔드(Prometheus 등)에 로그 저장소(Elasticsearch 등)까지 따로 붙입니다

• 대시보드 제작: Grafana에서 차트를 직접 만들거나 SigNoz 같은 도구를 또 세팅해 템플릿을 가져옵니다

• 전 팀원 설정 배포: 텔레메트리 활성화부터 엔드포인트, 인증 헤더까지 환경변수 예닐곱 개를 팀원 전원에게 배포하고 관리 설정으로 잠급니다

• 운영: 인증 토큰 갱신, 버전 관리, 수집이 끊겼을 때의 장애 대응이 전부 팀 몫입니다

이 공사를 다 마쳐도 커버되는 건 클로드 코드 하나입니다. 코덱스 사용량은 별도 파이프라인을 또 만들어야 하죠. LiteLLM 같은 오픈소스 프록시를 자체 호스팅하는 우회로도 있지만 이번엔 프록시 서버와 지출 추적용 DB를 직접 띄우고 업그레이드와 장애까지 떠안게 됩니다. 어느 쪽이든 대시보드 하나 보자고 인프라 운영 업무가 새로 생기는 셈입니다. 관리할 사람이 따로 없는 팀이라면 시작하기도 전에 부담스럽습니다.

클로드 코드 팀 대시보드, 10분이면 세팅됩니다

렛서 AI Gateway에는 이 팀 대시보드가 기본 기능으로 들어 있습니다. 직접 만들 필요가 없다는 뜻입니다. 팀원들이 쓰는 클로드 코드와 코덱스를 게이트웨이에 연결해 두면 모든 요청이 한 지점을 지나가고, 그 기록이 그대로 대시보드가 됩니다. Collector 서버도, 시계열 DB도, Grafana 세팅도 없습니다. 수집과 저장, 시각화는 이미 만들어져 있으니까요. 위에서 나열한 구축 작업이 가입, 키 발급, 환경변수 변경 세 단계로 줄어듭니다. 10분이면 끝나는 일이죠.

대시보드에서 이런 게 보입니다

사용 현황 화면에서는 누적 비용, 활성 사용자, 세션·요청·토큰 수가 한눈에 잡힙니다. 비용은 모델별로도 도구별로도 분해됩니다. 클로드 코드·코덱스 같은 도구 단위 필터, 최근 24시간·7일·30일 기간 필터로 잘라볼 수도 있습니다. 시간 추이 그래프를 보면 어느 날 어떤 모델 사용이 튀었는지도 바로 드러나고요.

사용자 랭킹 화면은 팀원별 비용·세션·요청·토큰을 순위로 보여줍니다. 이 화면의 용도는 감시가 아니라 촉진입니다. 누가 AI를 가장 적극적으로 쓰는지 보이면 자연스럽게 그 사람의 워크플로가 화제가 되고 잘 쓰는 방법이 팀에 퍼집니다. AI Native 조직을 만들려는 팀들이 대시보드를 함께 보는 이유가 여기에 있죠.

새 팀원이 합류해도 온보딩이 따로 없습니다. 각자 쓰던 툴에서 설정 하나만 바꾸면 그 순간부터 대시보드에 잡히거든요.

연동은 설정 하나 바꾸면 끝납니다

클로드 코드는 공식적으로 LLM 게이트웨이 연동을 지원합니다. ANTHROPIC_BASE_URL 환경변수를 게이트웨이 주소로 바꾸면 모든 요청이 게이트웨이를 거쳐 나가고, 대시보드에 잡히기 시작합니다. 클로드 코드만이 아닙니다. 공식 연동 가이드가 준비된 도구는 현재 다섯 가지입니다.

이 밖에도 베이스 URL과 인증 헤더를 바꿀 수 있는 OpenAI 호환 도구라면 같은 방식으로 연결됩니다. 다만 "OpenAI 호환"이라는 표기만으로 모든 기능이 다 동작한다고 보긴 어렵고, 도구별로 모델과 엔드포인트 지원 범위는 확인이 필요합니다. 어느 쪽이든 별도 개발 없이 설정 변경만으로 끝나는 건 같고요.

가입해서 키를 발급받고 팀원들이 각자 쓰던 툴의 환경변수를 바꾸면 그날부터 대시보드에 사용량이 쌓입니다. 영업 미팅이나 개발 일정을 잡을 필요가 없거든요.

클로드 코드는 환경변수 두 줄이면 됩니다

export ANTHROPIC_BASE_URL="https://gw.letsur.ai"
export ANTHROPIC_API_KEY="<게이트웨이에서 발급받은 키>"

주의할 점은 하나입니다. 주소 끝에 /v1을 붙이지 않습니다. 클로드 코드가 경로를 알아서 조합하거든요. 터미널을 열 때마다 입력하기 번거로우면 ~/.claude/settings.json의 env 항목에 ANTHROPIC_BASE_URL을 넣어둡니다. 키는 설정 파일 대신 환경변수로 관리하는 편이 안전합니다. 연결 확인은 claude -p "ping" 한 번이면 끝납니다.

코덱스는 config.toml에 provider를 등록하면 됩니다

~/.codex/config.toml에 렛서 게이트웨이를 provider로 등록합니다.

model_provider = "letsur"

[model_providers.letsur]
name = "Letsur Gateway"
base_url = "https://gw.letsur.ai/v1"
env_key = "LETSUR_API_KEY"
wire_api = "responses"

클로드 코드와 달리 여기는 주소 끝에 /v1을 붙입니다. OpenAI 호환 경로를 쓰기 때문입니다. opencode와 Claude Desktop을 포함한 툴별 상세 절차는 공식 연동 문서에 정리돼 있습니다.

대시보드 숫자를 운영에 연결하는 기능들

대시보드는 보는 데서 끝나지 않습니다. 거기서 확인한 숫자를 바로 팀 운영에 쓸 수 있게 같이 붙어 있는 기능이 있습니다.

• 코딩 툴 너머까지 한 키로: 텍스트 모델은 물론 이미지·영상·오디오 API까지 90종 이상의 모델이 같은 키, 같은 대시보드로 연동됩니다. 디자인팀의 이미지 생성과 개발팀의 클로드 코드가 한 화면에서 집계됩니다

• 커스텀 키그룹: 워크스페이스 안에 키그룹을 여러 개 만들고 그룹별로 사용자를 지정합니다. 프론트엔드팀, 백엔드팀, 데이터팀처럼 조직 구조를 그대로 옮겨 두면 대시보드 집계도 팀 단위로 나뉩니다

• 그룹별 예산과 모델 제한: 그룹 단위로 예산을 걸고 쓸 수 있는 모델을 제한합니다. 대시보드에서 본 추세를 설정으로 바로 막는 거죠. 예산 초과를 청구서로 아는 일이 없어집니다

• 키 단위 한도·만료일: 외주 인력이나 단기 프로젝트에는 만료일 있는 키를 발급합니다

• 정산 일원화: 툴별·팀원별로 흩어지던 결제가 원화 정산, 세금계산서, 매월 청구서 한 장으로 정리됩니다. 선불 약정과 후불 모두 지원합니다

코딩 툴 모니터링에서 시작했더라도 쓰임새는 거기서 끝나지 않습니다. 서비스에 AI 기능을 넣느라 API를 직접 호출해야 할 때도 같은 게이트웨이 키를 그대로 쓰면 되거든요. 모델 라우팅부터 키 관리까지 게이트웨이가 해주는 일은 AI 게이트웨이 소개 글에 따로 정리해 뒀습니다.

방법별 비교

정리

팀 대시보드는 만드는 게 아니라 연동하는 겁니다. 툴마다 대시보드를 하나씩 열어보거나 수집 인프라를 새로 짓는 것보다, 요청이 지나가는 길목을 하나로 모으는 쪽이 구조적으로 낫죠. 연동은 팀원 각자의 환경변수 변경이면 끝나고 사용량 집계·랭킹·예산 통제·정산까지 같이 따라옵니다. AI Native 조직으로 가는 시도는 결국 사용량이 보이는 데서 시작합니다.

시작은 간단합니다. ai-gateway.kr에서 가입하고 키를 발급받으면 됩니다. 팀 규모에 맞는 예산 설계나 정산 방식이 궁금하시다면 렛서에 문의 주세요.