← 모든 프로젝트SKILL / OPEN SOURCE

Codex Token Xray

어디에 쓰였는지
먼저 확인합니다.

실제 세션 기록을 분석해 도구 결과, 스킬 본문, 지침의 사용량을 살펴봅니다. 줄일 수 있는 부분을 찾고 변경안을 먼저 보여줍니다.

02 / CODEX
CONTEXT BREAKDOWN↗
도구 결과스킬 본문지침
세션 기록을 읽고 사용처를 구분합니다.
분석 항목 예시
LUCIANLABS / CODEX TOKEN XRAY직접 만들고, 함께 씁니다.
HOW IT WORKS

이렇게 사용합니다.

01

세션 기록을 읽습니다.

로컬 Codex 세션 기록을 분석합니다. 분석 결과와 백업도 내 컴퓨터에 저장합니다.

02

많이 쓰인 곳을 찾습니다.

도구 결과, 스킬 본문, 프로젝트 지침의 사용량을 살펴봅니다. 전체 사용량은 기록을, 항목별 비중은 크기 기반 추정을 사용합니다.

03

변경안을 보고 정리합니다.

직접 만든 긴 스킬과 지침을 정리하고, 쓰지 않는 스킬은 선택해서 제거합니다. 변경안과 백업을 먼저 확인합니다.

IN DEPTH

자세히 알아보기

실제 세션 12개에서 측정한 숫자와, 이 스킬이 무엇을 바꾸고 무엇을 건드리지 않는지 정리했습니다.

실제 세션에서 본 것

한 컴퓨터의 실제 Codex 세션 12개를 읽은 결과입니다. 토큰이 어디로 가는지에 대한 짐작과 실제가 꽤 달랐습니다.

약 33,000아무것도 입력하기 전에 쓰는 토큰. 앱 지침 12,000 · 기본 지침 5,000 · 스킬 목록 6,000
절반 이상작업 중 도구가 돌려준 결과가 차지하는 비중
39 vs 36,000한 스킬의 설명(세션당) vs 본문이 19번 읽히며 쓴 토큰

시작할 때 쓰는 33,000토큰은 사용자가 줄일 수 없는 부분입니다. 작업 중에는 파일을 통째로 읽을 때마다 그 내용이 그대로 쌓입니다. 그리고 줄였을 때 효과가 나는 건 스킬 설명이 아니라 본문이었습니다.

하는 일은 세 가지뿐

  • 최근 90일 동안 어떤 세션에서도 읽히지 않은 스킬을 보여주고, 고른 것만 지웁니다. 지우기 전에 폴더 전체를 zip으로 백업하고, 명령 하나로 되돌릴 수 있습니다. 직접 만든 스킬은 도구가 지우지 않습니다.
  • 직접 만든 긴 스킬을 줄입니다. 매번 필요한 내용만 SKILL.md에 남기고 나머지는 references 파일로 옮깁니다. 지우는 내용은 없습니다.
  • 프로젝트의 AGENTS.md도 같은 방식으로 줄입니다.

바꾸기 전에는 diff를 보여주고 한 번 묻습니다. 다른 사람이 만든 스킬과 Codex 기본 스킬·플러그인은 고치지 않습니다. 만든 사람이 계속 다듬고 있어서, 업데이트되면 수정이 덮어써지기 때문입니다.

숫자를 믿어도 될까

  • 토큰 합계는 Codex가 남긴 사용량 기록 그대로입니다. 추정이 들어가지 않습니다.
  • 항목별 비율(도구 결과, 스킬 본문, 지침)은 크기로 추정합니다. 실제 증가량과 비교하면 0.85 수준으로 맞았고, 보고서마다 이 비율을 함께 표시합니다.
  • 줄인 효과는 정리한 뒤에 새로 시작한 세션부터 보입니다.

내 기록은 어디에 남나

세션 기록은 내 컴퓨터의 ~/.codex/sessions에서 읽고, 네트워크는 쓰지 않습니다. 보고서와 백업은 ~/.codex-token-xray 아래에만 저장합니다. 현재 폴더에서 시작한 세션만 보고 싶으면 --project를 붙이세요.

자주 묻는 질문

Astra Xray와는 무엇이 다른가요?

Astra Xray는 Codex가 GPT-6 Astra에게 넘기는 스킬 목록과 지침을 정리합니다. Codex Token Xray는 모델과 상관없이 토큰이 실제로 어디에 쓰였는지 재고, 많이 쓰는 곳을 줄입니다.

무엇이 필요하나요?

Python 3.9 이상이 필요합니다. 모든 프로젝트에서 쓰려면 설치 명령에 -g를 붙이세요.

GET STARTED

내 작업에
바로 써보세요.

설치 후 Codex에서 $codex-token-xray를 입력하세요. Python 3.9 이상이 필요합니다.

TERMINAL
npx skills add Seokwoooo/codex-token-xray
GitHub에서 자세한 사용 방법 보기 ↗
← 다른 프로젝트 둘러보기