클로드 코드 저장소별 사용량 — 꼬리표 4개·주소는 하나로·내 수집기만

팀 단위로 AI 코딩 비용을 보다 보면 결국 이 질문에 닿습니다 — 그래서 어느 프로젝트가 이걸 다 쓴 건가.

지금까지는 모델별·스킬별로는 쪼갤 수 있어도 저장소 단위로는 갈 수 없었습니다. 이제 환경 변수 하나로 지표에 저장소 신원이 붙습니다. 그런데 켜기 전에 알아 둘 것이 몇 가지 있습니다.

📌 30초 요약

• 붙는 꼬리표는 넷입니다. 주소·소유자·이름·제공자.
• 같은 저장소면 원격을 어떻게 적었든 같은 값이 나옵니다.
• 이 값은 내가 세운 수집기로만 갑니다.
• 꼬리표는 공짜가 아닙니다. 저장 비용이 저장소 수만큼 늘어납니다.

1. 저장소 이름으로 갈라 보기

켜는 방법은 환경 변수 하나를 참으로 두는 것입니다. 그러면 지표와 이벤트 양쪽에 세션이 돌던 저장소의 신원이 붙습니다. 수집기를 여럿이 같이 쓰는 구성이라면 이 값으로 사용량을 저장소별로 나눠 볼 수 있습니다.

값은 세션마다 한 번 계산됩니다. 원본은 그 저장소의 원격 주소고요. 여기서 실용적인 성질이 하나 나옵니다 — 같은 저장소라면 주소를 어떤 방식으로 적었든 똑같은 값이 됩니다. 팀원마다 내려받은 방식이 달라도 대시보드에서는 한 줄로 모인다는 뜻입니다.

비용을 스킬·플러그인 단위로 쪼개는 방법은 사용량 측정을 다룬 글에서 정리했는데, 이번 꼬리표는 그 위에 한 겹을 더 얹는 성격입니다. 「어느 스킬이 비쌌나」와 「어느 저장소에서 비쌌나」는 서로 다른 질문이니까요. 참고로 이 기능은 일정 판 이상에서만 동작합니다.

2. 붙는 꼬리표 넷

꼬리표	담기는 값
저장소 주소	브라우저로 열 수 있는 주소 · 뒤에 붙는 확장자는 떼고
소유자	조직이나 그룹 경로 · 경로가 한 토막뿐이면 아예 빠짐
저장소 이름	앞뒤 없는 이름 그 자체
제공자	알아본 네 곳 중 하나 · 사내에 직접 세운 곳이면 빠짐

값은 전부 소문자로 내려가고, 원격 주소에 섞여 있던 자격증명·질의 문자열·조각은 절대 들어가지 않습니다. 주소에 토큰을 끼워 쓰는 구성이라도 그 부분은 잘려 나간다는 뜻입니다. 그리고 원격이 아예 없는 폴더에서 돌린 세션은 네 꼬리표가 모두 빠집니다.

유도된 값이 마음에 안 들면 내가 직접 덮어쓸 수도 있습니다. 공통 속성을 선언하는 자리에 같은 이름의 키를 적어 두면 계산된 값 대신 내가 적은 값이 나갑니다. 사내 규칙에 맞춘 프로젝트 코드를 쓰고 싶을 때 쓸 만한 구멍입니다. 환경 변수와 설정이 어느 범위까지 먹는지는 설정 키 정리를 같이 보세요.

덮어쓰기와 별개로 내 키를 더 붙일 수도 있습니다. 부서 이름이든 비용 센터든 원하는 값을 실어 보낼 수 있죠. 다만 셈법이 같습니다 — 내가 더하는 키 하나하나가 모든 지표 줄에 라벨로 붙습니다. 값의 가짓수가 많은 키일수록 저장 비용이 가파르게 오릅니다. 그래서 문서는 지표마다 붙이지 않고 공통 블록으로만 보내는 선택지도 함께 안내합니다.

3. 꼬리표는 공짜가 아닙니다

⚠️ 지표 줄 수가 저장소 수만큼 곱해집니다

꼬리표를 하나 붙이면 그 값의 가짓수만큼 지표 계열이 갈라집니다. 저장소가 서른 개인 조직이라면 같은 지표가 서른 줄로 늘어납니다. 문서가 그 대가를 분명히 적어 뒀습니다 — 가짓수가 낮을수록 성능이 좋고 저장 비용이 싸지만, 분석은 거칠어집니다.

그래서 이 기능은 기본으로 꺼져 있습니다. 비용을 재려고 켠 설정이 저장 비용을 만드는 구조라는 점을 먼저 계산해 보세요. 저장소가 아주 많다면 전부 켜는 대신 몇 개 팀에만 적용해 보는 편이 낫습니다.

같은 이유로 애초에 지표에는 절대 안 붙이는 값들이 따로 있습니다. 가짓수가 끝없이 늘어나는 종류라서요. 이런 값들은 이벤트 쪽에만 실립니다.

어디에 실리나	무엇이
지표와 이벤트 양쪽	저장소 꼬리표 넷 · 켠 경우에만
이벤트에만	커밋 신원 · 여러 에이전트를 한 실행으로 묶는 식별자
내 수집기에만	저장소 꼬리표 전부 · 앤트로픽 쪽으로는 안 감

둘째 줄의 묶는 식별자는 따로 알아 둘 값입니다. 여러 에이전트를 한꺼번에 펼쳐 돌리는 구성에서, 그 한 번의 실행에 속한 에이전트들이 전부 같은 식별자를 달고 나옵니다. 이 값으로 걸러 보면 「그 작업 한 번에 총 얼마가 들었나」를 에이전트 수와 무관하게 한 덩어리로 볼 수 있습니다. 펼친 개수를 조절해 가며 비용을 재 볼 때 유용한 조각입니다.

4. 커밋까지 따라 붙일 때

한 겹 더 들어갈 수도 있습니다. 도구 상세 기록을 켜 두면 셸로 성공한 커밋에 대해 그 커밋의 신원이 이벤트에 붙습니다. 리비전·이름·종류 셋이고요. 「이 비용이 실제로 어떤 커밋으로 이어졌나」를 잇고 싶을 때 쓰는 조각입니다.

다만 이건 따로 켜야 하는 설정이고, 도구 상세를 켜면 커밋 말고도 많은 것이 같이 실립니다. 명령 내용까지 나가게 되니 무엇이 함께 딸려 가는지 먼저 확인하는 편이 안전합니다. 한도와 잔여량을 조회하는 쪽은 사용 한도 조회에서 따로 다뤘고, 비용 관리 단계를 순서대로 밟는 중이라면 AI 도입 한 바퀴를 모아 둔 글에서 위치를 잡아 보세요.

켰는데 대시보드에 아무것도 안 나타난다면 꼬리표 문제가 아닐 가능성이 큽니다. 내보내기 자체가 실패하고 있을 수 있거든요. 이럴 때는 진단 모드로 한 번 돌려 기록을 보는 것이 가장 빠릅니다. 내보내기에서 난 오류가 바깥 도구 쪽 문제라는 표시를 달고 따로 찍히기 때문에, 설정이 안 먹은 것인지 수집기가 안 받은 것인지 금방 갈립니다.

자주 묻는 질문 (FAQ)

Q. 우리 저장소 이름이 앤트로픽에 넘어가나요?

아닙니다. 문서가 못 박아 뒀습니다 — 이 꼬리표들은 내가 설정한 수집기로만 흐르고, 앤트로픽 쪽 원격 측정은 해당 키를 전부 버립니다. 다만 반대로 읽지는 마세요. 내가 세운 수집기에는 저장소 이름이 그대로 쌓입니다. 사내 프로젝트명이 드러나도 괜찮은 수집기인지는 따로 판단하셔야 합니다.

Q. 사내에 직접 세운 저장소 서버도 되나요?

주소·소유자·이름 세 개는 그대로 붙습니다. 원격 주소에서 뽑는 값이라 호스트가 어디든 상관없거든요. 빠지는 건 제공자 이름 하나뿐입니다. 알아보는 네 곳의 주소 모양에 맞아떨어질 때만 채워지고, 아니면 그 칸이 비워집니다. 대시보드에서 제공자로 묶어 보려던 계획이 있다면 이 점을 감안하세요.

Q. 저장소가 아닌 폴더에서 돌리면 어떻게 되나요?

네 꼬리표가 통째로 빠집니다. 원격이 없으면 뽑을 값이 없으니까요. 여기서 실무적인 함정이 하나 생깁니다 — 그런 세션의 사용량은 어느 저장소에도 안 잡힙니다. 합계와 저장소별 합이 안 맞을 때 대개 이쪽입니다. 임시 폴더에서 돌린 작업이 많다면 그 차이를 먼저 확인해 보세요.

Q. 한번 켜면 되돌리기 어렵나요?

끄는 것 자체는 환경 변수를 되돌리면 끝입니다. 다만 그 사이에 쌓인 지표 줄은 수집기 쪽에 남으니, 저장 비용이 걱정이라면 보관 기간 설정을 함께 보셔야 합니다. 켜기 전에 저장소 몇 개로 시험해 보고 늘어나는 폭을 재 보는 순서를 권합니다.

정리하면

• 환경 변수 하나로 저장소별 집계가 열립니다.
• 주소를 어떻게 적었든 한 줄로 모입니다.
• 앤트로픽은 못 보지만 내 수집기에는 그대로 쌓입니다.
• 켜기 전에 저장소 수를 세어 보세요.

※ 공개된 판올림 기록과 사용량 측정 문서를 읽고 정리했습니다. 환경 변수·속성 이름은 우리말로 풀어 적었고, 직접 수집기를 세워 찍어 보지는 않았습니다.

※ 저장 비용이 실제로 얼마나 늘어나는지는 쓰는 수집기와 보관 기간에 따라 달라서 수치로 적지 않았습니다. 필요한 최소 판 번호와 알아보는 제공자 목록은 열람 시점 기준이며, 켜기 전에 원문의 가짓수 조절 항목을 함께 확인하세요.