Claude Code와 Codex를 사용한 일주일간의 작업은 구체적인 질문에 답할 수 있는 충분한 로컬 증거를 남깁니다.

언제 세션이 활성화되었는가? 어떤 제공업체(provider)가 활동을 생성했는가? 어떤 모델(model)들이 나타났는가? 일별로 토큰(token) 구성이 어떻게 변했는가?

이것은 코드가 정확했다거나, 해당 주가 생산적이었다거나, 혹은 API 가치 추정치가 실제 지출된 비용임을 증명하지는 않습니다.

그 경계가 바로 주간 보고서를 유용하게 만드는 요소입니다.

로컬 달력 날짜를 사용하세요

읽기 쉬운 보고서는 오늘을 포함하여 이전 6일간의 로컬 달력 날짜를 다루어야 합니다. 헤드라인, 일별 막대 그래프, 제공업체 합계, 모델 행은 반드시 동일한 경계를 사용해야 합니다.

만약 차트는 달력 날짜를 사용하는데 모델 행은 이동 168시간 윈도우(rolling 168-hour window)를 사용한다면, 각 부분이 서로 일치하지 않을 수 있습니다. 개별 계산이 모두 타당해 보이더라도 특정 행이 헤드라인 수치를 초과할 수 있습니다.

시간대(Timezone)와 자정 처리 방식은 회계 규칙입니다.

토큰 합계는 활동을 설명합니다

입력(Input), 출력(output), 캐시 생성(cache creation), 캐시 읽기(cache reads)는 서로 다른 작업을 설명합니다. 저는 다음 두 가지 합계를 유지하는 것이 유용하다고 생각합니다:

• 로컬에 기록된 모든 카테고리를 포함하는 와이어 토큰 합계 (wire-token total)
• 캐시 트래픽을 제외한 입력/출력 합계 (input/output total)

둘 중 어느 것도 생산성 점수가 아닙니다.

캐시 비중이 높은 리팩터링(refactor)은 작지만 영향력이 큰 수정 작업보다 더 많은 토큰을 이동시킬 수 있습니다. 실패한 실행은 비용이 많이 들 수 있습니다. 조용한 세션은 아무것도 하지 않는 것이 아니라 사람의 응답을 기다리고 있는 상태일 수 있습니다.

동등성을 가정하지 말고 제공업체를 비교하세요

제공업체별 분할(provider split)을 통해 Claude Code에서 발생한 기록된 활동과 Codex에서 발생한 활동이 각각 얼마인지 보여줄 수 있습니다. 하지만 이는 각 제공업체의 토큰 1개가 작업량, 지연 시간(latency), 품질 또는 할당량 압박(quota pressure) 측면에서 동일한 가치를 나타낸다는 것을 보여주지는 못합니다.

제공업체 할당량(Provider quota)은 보고된 상태(reported state)입니다. 로컬 토큰 활동은 재구성된 원장(reconstructed ledger)입니다. 두 가지를 모두 표시하는 것은 괜찮지만, 하나를 사용하여 다른 쪽의 누락된 데이터를 채우는 것은 안 됩니다.

각 이벤트에 모델 컨텍스트를 유지하세요

세션 중에 모델을 전환할 수 있습니다. 이후의 토큰 이벤트에는 파일 상단에 나타나는 모델이 아니라, 해당 시점에 활성화되어 있던 모델 컨텍스트(model context)가 필요합니다.

이름이 지정되지 않은(Unknown) 모델은 그대로 표시되어야 하며 가격이 책정되어서는 안 됩니다. 근처의 모델 제품군(model family)을 추측하는 것은 과거 보고서를 감사(audit)하는 것을 불가능하게 만듭니다.

토큰 순위(Token rank)와 API 가치 순위(API-value rank) 또한 다릅니다. 저렴한 캐시 읽기(cache reads)가 많은 모델은 볼륨 측면에서 앞설 수 있는 반면, 다른 모델은 추정 가치 측면에서 앞설 수 있습니다.

나의 5분 주간 검토

나는 이 보고서를 단 하나의 운영 결정을 내리기 위한 프롬프트(prompt)로 사용합니다:

1. 로컬의 7일 치 데이터가 모두 있는지 확인합니다.
2. 공백, 재생 스파이크(replay spikes), 또는 오래된 제공자(provider) 데이터를 찾습니다.
3. 제공자와 모델의 혼합(mix)을 품질로 간주하지 않고 비교합니다.
4. 추정 API 가치는 표시된 요율 날짜(rate date) 하에서만 읽습니다.
5. 다음 주를 위한 하나의 워크플로(workflow) 변경 사항을 작성합니다.

그 변경 사항은 방치된 실행을 줄이거나, 반복되는 인증 실패를 수정하거나, 긴 세션을 시작하는 시점을 변경하는 것일 수 있습니다.

숫자 그 자체는 워크플로를 개선하지 않습니다. 결정이 개선합니다.

공유는 별도의 작업이어야 합니다

로컬 보고서는 기본적으로 로컬에 머물러야 합니다. Agent Island는 이미 기기에 저장된 기록을 바탕으로 보고서를 생성하며, 트랜스크립트(transcript) 콘텐츠는 Agent Island 서비스로 업로드되지 않습니다.

공유 가능한 카드(shareable card)는 렌더링된 요약본이며, 자동 방송이 아닙니다. 이를 복사하거나 내보내려면 명시적인 작업이 필요합니다. 공유하기 전에 표시된 날짜, 합계, 모델 이름, 프로젝트 컨텍스트를 검토하여 공개하고 싶지 않은 내용이 있는지 확인하십시오.

주간 보고서는 각 숫자가 무엇을 의미하는지, 그리고 무엇을 증명할 수 없는지를 명시함으로써 신뢰를 얻습니다.

전체 워크플로와 현재 검증된 범위는 공식 가이드에서 확인할 수 있습니다: AI coding weekly report.