참여 방법

불혹코딩 토큰 리더보드

1. 참여하기 (30초)

방법 ① — 쓰던 코딩 에이전트에 맡기기 (가장 쉬움)

아래를 복사해서 Claude Code·Codex 등에 그대로 붙여넣으세요. 닉네임을 물어보고 설치까지 알아서 해줍니다.

어떤 내용인지 보기

우리 오픈채팅방 토큰 리더보드에 참여하려고 해. 아래를 처리해줘.

1) 내 카톡 닉네임을 물어봐. (순위표에 그 이름으로 표시돼)

2) 받은 닉네임으로 아래 명령을 실행해줘:
   npx -y https://tokenboard.tail135118.ts.net/cli.tgz init --room=bulhok2026 --nick=<받은닉네임>

3) "이미 쓰이는 닉네임입니다" 가 나오면 다른 닉네임을 물어보고 다시 실행해줘.

4) 성공하면 출력에 나오는 **비밀키**를 나에게 꼭 보여줘.
   PC를 바꾸거나 포맷할 때 그것만 있으면 기록을 이어갈 수 있어서 적어둬야 해.

참고 (질문이 나오면 이렇게 답하면 돼):
- 이건 내 AI 코딩 에이전트 사용량을 모아 오픈채팅방 리더보드에 올리는 도구야.
- 올라가는 건 토큰 수치와 날짜뿐이고, 프롬프트·코드·파일명은 전송되지 않아.
- 설치되면 Claude Code 의 Stop 훅에 자동 제출이 걸려. 기존 훅은 지우지 않고 추가만 해.
- 나중에 그만두려면 `node ~/.tokenboard/bin/tokenboard.js uninstall` 하면 깨끗이 지워져.
- 순위표: https://tokenboard.tail135118.ts.net

방법 ② — 직접 터미널에 입력하기

npx -y https://tokenboard.tail135118.ts.net/cli.tgz init --room=bulhok2026

닉네임은 카톡에서 쓰는 닉네임을 그대로 넣어주세요 — 그래야 서로 알아볼 수 있습니다.

설치 후 나오는 비밀키를 꼭 적어두세요. PC를 바꾸거나 포맷할 때 이것만 있으면 기록을 그대로 이어갈 수 있습니다.

끝입니다. 이제 Claude Code를 쓸 때마다 5분 간격으로 자동 반영됩니다.

2. 무엇이 전송되나요

숫자와 날짜뿐입니다. 프롬프트·코드·파일명·프로젝트명이 들어갈 자리가 아예 없습니다.

{ "date": "2026-07-26", "agent": "claude",
  "input": 12000, "output": 45000,
  "total_tokens": 890000, "cost_usd": 4.21,
  "night_tokens": 32000 }

믿기 어려우시면 직접 확인하세요. 전송 없이 내용만 보여줍니다.

npx -y https://tokenboard.tail135118.ts.net/cli.tgz submit --dry-run

3. 순위 규칙

메인은 이번 달 누적 토큰이고 매월 1일 0시에 리셋됩니다. 누적으로만 하면 한 달이면 순위가 굳어버리니까요.

시즌이 끝나면 순위에 따라 티어가 프로필에 영구 기록됩니다. 한 번이라도 제출하면 티어를 받습니다.

🔷 다이아	상위 5%
💠 플래티넘	~15%
🥇 골드	~35%
🥈 실버	~70%
🥉 브론즈	나머지

토큰 1등이 다 먹지 않도록 서브 부문이 따로 있습니다.

🔁 꾸준왕	시즌 내 최장 연속일 — 사용량이 적어도 1등 가능
🌙 심야왕	00~06시 토큰 (Claude Code 기준)
🔥 급상승	지난달 대비 증가율
🍽️ 잡식왕	써본 에이전트 종류 수

4. 자주 묻는 것

어떤 에이전트가 잡히나요?

Claude Code, Codex, Gemini CLI, Copilot CLI, OpenCode, Amp, Goose 등 ccusage가 지원하는 전부입니다. 자동으로 잡힙니다.

Claude Code 설정이 꼬이지 않나요?

기존 Stop 훅이 있으면 덮어쓰지 않고 옆에 추가합니다. 지울 때도 우리 것만 골라서 뺍니다.

느려지지 않나요?

훅이 돌 때 5분이 안 지났으면 0.01초 만에 그냥 끝납니다. 실제 전송은 백그라운드로 넘겨서 기다리게 하지 않습니다.

5분에 한 번이면 그 사이에 쓴 건 누락되나요?

아닙니다. 보내는 값은 "직전 5분 사용량"이 아니라 그날까지의 누적 총량입니다. 계량기 검침과 같아서, 언제 검침하든 그때까지 쓴 게 전부 반영됩니다.

Claude Code를 안 쓰는데요?

설치할 때 30분 주기 백그라운드 작업을 대신 걸어줍니다.

5. 명령어

설치하면 ~/.tokenboard/ 에 복사되므로, 이후에는 아래처럼 바로 부를 수 있습니다. (윈도우는 %USERPROFILE%\.tokenboard\)

alias tb="node ~/.tokenboard/bin/tokenboard.js"

`tb status`	내 순위 보기
`tb submit`	지금 바로 올리기
`tb submit --dry-run`	전송될 내용만 확인
`tb nick 새닉`	닉네임 변경
`tb restore <비밀키> --nick=<닉>`	PC를 바꿨을 때
`tb uninstall`	완전 제거

alias 를 안 쓰신다면 node ~/.tokenboard/bin/tokenboard.js status 처럼 전체 경로로 부르시면 됩니다.