비용 코드로 지출 추적 및 프로젝트 태그 사용

이 문서에서는 조직에서 이미 사용 중인 코드(예: 작업 분해 구조(WBS) 코드, 청구 코드 또는 클라이언트-사건 번호)로 프로젝트에 태그를 지정하는 방법을 설명합니다. 그 후 조직 설정이나 API를 통해 해당 프로젝트의 대부분의 지출을 태그별로 볼 수 있습니다.

프로젝트 태그는 Claude Enterprise 플랜에서 베타 버전으로 제공됩니다. HIPAA 구성, 고객 관리 암호화 키(CMEK), 제로 데이터 보존(ZDR)(Claude Code용 ZDR 포함), 최소 데이터 보존 또는 미국 외부에 저장된 데이터가 있는 조직에서는 사용할 수 없습니다. 또한 Claude Desktop을 자체 모델 제공자를 통해 라우팅하는 조직에서도 사용할 수 없습니다.

중요: 프로젝트 태그는 프로젝트 내에서만 작동합니다. 프로젝트 외부의 작업에는 태그가 지정되지 않습니다.

프로젝트 태그 작동 방식

프로젝트 태그는 두 가지 요소를 사용합니다:

태그: cost_code 또는 client_matter와 같이 보고하는 카테고리입니다.
값: CC-1042와 같은 코드 자체입니다.

소유자가 태그와 해당 값을 만들고, 프로젝트를 편집할 수 있는 모든 사용자가 해당 프로젝트의 값을 설정할 수 있습니다. 각 태그는 프로젝트당 하나의 값을 보유하며, 프로젝트는 최대 16개의 태그를 가질 수 있습니다.

시작하기 전에

태그를 만들고 해당 값을 관리하는 데 필요한 역할: 주 소유자, 소유자 또는 소유자 액세스 권한이 있는 사용자 정의 역할
프로젝트의 태그를 설정하는 데 필요한 역할: 프로젝트에 대한 "편집 가능" 액세스
태그별 지출을 보는 데 필요한 역할: 주 소유자, 소유자 또는 분석 보기 및 청구 보기 액세스 권한이 있는 사용자 정의 역할
API 키를 만드는 데 필요한 역할: 주 소유자

프로젝트 태그가 적용되는 위치

작업이 수행되는 위치	지출이 프로젝트별로 보고되나요?
프로젝트에서 채팅	예
프로젝트의 통합 채팅 및 Cowork 환경	예
컴퓨터의 Cowork 작업	예. Claude Desktop 3.6556.1 이상으로 업데이트하고 작업에 대해 하나의 프로젝트를 선택합니다.
터미널 또는 데스크톱의 Claude Code	예, Claude Code에 대한 프로젝트를 설정한 후입니다. Claude Code 2.1.305 이상 또는 Claude Desktop 3.6556.1 이상이 필요합니다.

프로젝트 태그가 적용되지 않는 항목:

웹의 Claude Code
Claude for Office
Chrome의 Claude
Claude Design
Slack 및 Microsoft Teams의 Claude
아티팩트
음성 모드
Claude API 또는 Claude Console
Amazon Bedrock, Google Cloud Vertex AI, 게이트웨이 또는 API 키를 통한 Claude Code

프로젝트 태그 설정

프로젝트 태그는 적격 조직에 대해 자동으로 켜져 있으며, 켜는 설정이 없습니다. 시작하려면 태그를 만듭니다.

태그 만들기 및 해당 값 추가

소유자는 다음 단계에 따라 태그를 만들 수 있습니다:

조직 설정 > 조직 > 프로젝트 태그로 이동합니다.
"태그 만들기"를 클릭합니다.
cost_code와 같은 이름을 입력합니다. 이름은 소문자이고 공백이 없으며, 나중에 이름을 변경할 수 없습니다.
허용된 값 아래에서 "사전 정의된 값만"을 선택하여 사용자가 목록에서 선택하도록 하거나 "모든 값"을 선택하여 사용자가 자신의 값을 입력하도록 합니다.
"사전 정의된 값만"을 선택한 경우 값 아래에 목록을 추가합니다. 한 줄에 하나의 값을 입력하거나 value를 헤더로 하는 단일 열이 있는 CSV 파일을 추가합니다.
(선택 사항) "필수" 토글을 켜서 사용자가 새 프로젝트에 값을 설정하도록 합니다.
"계속"을 클릭합니다.

나중에 값을 추가하려면 프로젝트 태그 페이지에서 태그를 열고 "값 추가" 또는 "CSV 가져오기"를 클릭합니다.

참고: 태그 이름과 값은 조직의 모든 사용자에게 표시되므로 민감한 정보를 포함하지 마십시오.

프로젝트에 태그 추가

"편집 가능" 액세스 권한이 있는 모든 사용자는 프로젝트에 태그를 추가할 수 있습니다:

프로젝트를 엽니다.
태그 아래에서 "태그 추가"를 클릭합니다.
태그를 선택한 다음 값을 선택하거나 입력합니다.

참고: 태그 이름과 값은 조직의 모든 사용자에게 표시되므로 민감한 정보를 포함하지 마십시오.

Claude Code에 대한 프로젝트 설정

Claude Code에는 프로젝트 선택기가 없으므로 사용자는 설정 파일에서 프로젝트를 설정합니다. 프로젝트가 설정되지 않으면 Claude Code 사용이 태그되지 않으며 경고가 없으므로 사용자에게 알립니다.

Claude에서 프로젝트를 열고 해당 ID를 복사합니다. ID는 URL의 마지막 부분입니다: claude.ai/project/this-part.
리포지토리에서 .claude/settings.json을 열거나 리포지토리 전체에 적용하려면 ~/.claude/settings.json을 엽니다.
프로젝트 ID를 사용하여 아래 줄을 추가합니다.
리포지토리의 설정 파일을 사용한 경우 Claude Code에서 요청할 때 폴더를 신뢰합니다. 그 후 설정이 적용됩니다.

{ "attributionProject": "PROJECT_ID" }

경고: 파일이 유효한 JSON으로 유지되는지 확인합니다. 잘못된 쉼표는 해당 컴퓨터의 Claude Code를 손상시킬 수 있습니다.

태그별 지출 보기

주 소유자, 소유자 및 분석 보기 및 청구 보기 액세스 권한이 있는 사용자 정의 역할은 태그별 지출을 볼 수 있습니다:

조직 설정 > 사용량 > 프로젝트별 지출로 이동합니다.
"그룹화 기준" 메뉴를 사용하여 태그를 선택합니다.
"기간" 및 "제품" 메뉴를 사용하여 결과를 좁힙니다.

데이터는 어제 끝까지 실행됩니다(UTC). 결과를 다운로드하려면 "CSV 내보내기"를 클릭합니다.

참고: 비공개 프로젝트의 이름은 이 페이지 및 CSV에서 "비공개 프로젝트"로 표시됩니다. 분석 대시보드, 분석 API 및 규정 준수 API는 여전히 실제 이름을 표시합니다.

숫자를 읽을 때 다음 사항을 염두에 두십시오:

작업이 시작되기 전에 태그를 추가합니다. 지출은 태그가 적용되는 시점(약 2시간 소요)부터만 태그에 계산됩니다. 해당 프로젝트의 이전 지출은 계산되지 않습니다.
사용량이 없는 프로젝트는 표시되지 않습니다. 프로젝트는 선택한 날짜에 사용된 후에 표시됩니다.
보고는 프로젝트 태그가 조직에서 사용 가능해질 때 시작됩니다. 이전 날짜를 전체 기록으로 취급하지 마십시오.
새 태그는 표시되는 데 약 2시간이 걸립니다. 해당 기간 동안의 사용량은 이전 태그 또는 태그 없음으로 유지될 수 있습니다.
태그를 변경해도 과거 지출은 변경되지 않습니다. 사용량은 당시 프로젝트가 가진 태그 아래에 유지됩니다.
프로젝트 외부의 지출은 "프로젝트에 없음"으로 표시됩니다. 여기에는 프로젝트가 설정되지 않은 Claude Code 세션이 포함됩니다. 프로젝트에서 태그에 대한 값이 없는 지출은 "태그 값 없음"으로 표시됩니다.
금액이 청구서와 일치하지 않을 수 있습니다. 할인 후 크레딧 전에 표시되며, 최근 숫자는 월말 후 약 1주일까지 변경될 수 있습니다.
좌석으로 적용되는 사용량은 계산되지 않습니다. 주로 좌석에서 사용되는 프로젝트는 지출이 거의 없거나 전혀 없을 수 있습니다.

API를 사용하여 태그 관리 및 지출 가져오기

자신의 시스템에서 태그를 설정하고 지출을 가져올 수 있습니다. 두 API 모두 베타 버전이므로 경로와 이름이 변경될 수 있습니다. 주 소유자는 조직 설정 > 조직 > API에서 API 키를 만듭니다.

Admin API를 사용하여 태그 설정

read:project_tags 및 write:project_tags 범위가 있는 키를 만듭니다. Admin API는 태그를 나열하고, 태그의 목록에 값을 추가하고, 프로젝트의 태그를 설정할 수 있습니다. 태그를 만들거나, 값을 보관하거나, 프로젝트를 만들 수 없습니다.

POST /v1/organizations/apps/projects/claude_proj_.../tags

Header: anthropic-beta: ce-project-tags-2026-10-09

Body: {"tags": {"cost_code": "CC-1042"}}

Admin API는 프로젝트의 URL에 있는 ID가 아닌 claude_proj_ ID를 사용합니다. ID를 나열하려면 최소 1일 이상 된 날짜로 GET /v1/organizations/analytics/apps/chat/projects?date=YYYY-MM-DD를 호출합니다. 해당 날짜에 채팅 활동이 있었던 프로젝트만 반환합니다. 이 호출에는 read:analytics 범위가 필요하므로 분석 API를 켜고 해당 범위를 키에 추가합니다.

사용량 및 비용 보고서로 지출 가져오기

분석 API를 켜고 read:analytics 범위가 있는 키를 만듭니다. 일일 버킷은 호출당 최대 31일을 포함하므로 이를 사용하여 전체 월을 가져옵니다.

GET /v1/organizations/analytics/cost?starting_at=...&ending_at=...&time_bucket_width=1d&group_by[]=tags.claude_project[cost_code]&limit=1000

Header: anthropic-beta: analytics-usage-cost-2026-08-24

금액은 센트 단위이며 센트의 분수를 포함할 수 있으며 이미 할인을 포함하지만 청구서와 일치하지 않을 수 있습니다.
각 호출은 최대 1000개의 행을 반환합니다. has_more가 true이면 계속 페이징하거나 합계가 부족할 것입니다.
태그 필터 텍스트는 URL로 이동하므로 요청 로그에 나타날 수 있습니다.

현재 제한 사항

공유: 태그 이름과 값은 조직의 모든 사용자에게 표시되므로 민감한 정보를 포함하지 마십시오.
편집: 프로젝트를 편집할 수 있는 모든 사용자는 해당 태그를 변경할 수 있으며, 필수가 아닌 경우 하나를 지울 수 있습니다. 태그를 잠글 수 없습니다.
필수 태그: 이는 웹에서 만든 새 프로젝트에만 적용되므로 기존 프로젝트는 영향을 받지 않습니다. 웹에서 필수 태그의 값은 변경할 수 있지만 제거할 수 없습니다. Admin API는 여전히 제거할 수 있습니다.
문자: 값은 최대 256자이며 공백과 쉼표를 포함할 수 있습니다. 결합된 이모지 또는 일부 페르시아어 또는 싱할라어 단어와 같이 보이지 않는 문자에 의존하는 값은 거부됩니다.
이 베타에 포함되지 않음: 단일 채팅 또는 세션의 태그, 태그 간 지출 분할, 태그 또는 값 이름 바꾸기, 태그별 지출 제한.

자주 묻는 질문

프로젝트가 둘 이상의 태그를 가질 수 있나요?

예, cost_center 및 client_matter와 같은 별도의 태그를 사용하여 프로젝트당 최대 16개까지 가능합니다. 각 태그는 하나의 값을 보유하므로 프로젝트의 지출을 같은 태그의 두 값으로 분할할 수 없습니다.

Claude가 태그 값을 확인하나요?

아니요. 목록은 사용자가 선택할 수 있는 항목을 제한하지만 값은 재무 시스템에 대해 확인되지 않습니다.

프로젝트 태그를 끄려면 어떻게 하나요?

프로젝트 태그는 소유자가 태그를 만들 때까지 아무것도 변경하지 않습니다. 끄려면 계정 팀에 문의하십시오.