Tokentop

Release

Go Report Card

Go Version

License: MIT

Claude Code, OpenAI Codex, OpenRouter, VelociRouter의 API 사용량을 실시간으로 모니터링하는 터미널 대시보드입니다.

설치 (Install)

curl -fsSL https://raw.githubusercontent.com/lwlee2608/tokentop/main/install.sh | sh

Homebrew를 사용하는 경우 (macOS):

brew install lwlee2608/tap/tokentop

소스 코드를 빌드하는 방법:

git clone https://github.com/lwlee2608/tokentop.git
cd tokentop
make install

위 스크립트와 소스 코드 방식 모두 바이너리를 ~/.local/bin/tokentop에 설치합니다. 경로를 변경하려면 PREFIX=/usr/local을 사용하세요.

전제 조건 (Prerequisites)

• Claude: 활성화된 Claude Code 세션이 필요합니다. 인증 정보는 Claude Code로 로그인한 후 macOS Keychain (Claude Code-credentials) 또는 ~/.claude/.credentials.json에서 자동으로 가져옵니다.
• Codex: ~/.codex/auth.json에 인증 정보가 있는 활성화된 Codex 세션이 필요합니다 (사용자가 Codex CLI를 사용하면 자동으로 생성됩니다).
• OpenRouter: 환경 변수 OPENROUTER_API_KEY를 설정해야 합니다. 활동 및 크레딧 상세 정보를 위해서는 관리 키(management key)가 필요합니다.
• VelociRouter: 환경 변수 VELOCIROUTER_API_KEY를 설정해야 합니다. VelociRouter 콘솔에서 키를 생성하세요.

문서 (Documentation)

• 설정 (Configuration) — 모든 설정 필드, 기본값 및 예시
• 프로바이더 (Providers) — Codex, OpenRouter, VelociRouter, Claude 인증 정보가 감지되는 방법
• 키 바인딩 & CLI 플래그 (Keybindings & CLI flags)
• 문제 해결 (Troubleshooting)

라이선스 (License)

MIT