AI 코딩 어시스턴트 사용 분석 — 한 줄의 명령어로, AI가 실제로 얼마나 많은 코드를 작성했는지 명확하게 확인하세요.

15개 도구 통합 · 라인별 AI 기여도 추적 · 600+ 모델 비용 추정 · 원클릭 주간 보고서 생성 기능

English · 명령(Command) · MCP · FAQ · 업데이트 로그

'AI가 작성한 코드가 얼마나 될까?', '이런 도구들을 구독할 가치가 있을까?' — 직접 계산할 필요 없이, 단 하나의 명령어로 모든 것을 해결합니다.

시나리오	LumenCode로 해결하는 방법
AI 기여도 정량화	모호한 '꽤 많이 작성했다'가 아니라, 'AI 신규 추가 3,180 라인, 삭제 420 라인'을 각각 보여줍니다. 기여도는 추가된 라인과 삭제된 라인을 조합하여 변경된 라인 수를 기준으로 계산됩니다. 모든 라인은 출처를 확인할 수 있습니다.
AI 투자 대비 효과(ROI) 증명	주간 보고서 자동 생성: '이번 주 AI 지원 12개 커밋, 신규 추가 3,180 라인, 삭제 420 라인, 비용 $18.5'. 모든 수치에 출처가 있습니다.
3초 만에 주간 보고서 작성	주기 선택 → '업무 보고' 클릭 → 복사 → 피쉬(飞书)/딩딩(钉钉)에 붙여넣기. 3초 만에 완성합니다.
프로젝트별 보고	여러 프로젝트를 병행할 때, 개별 프로젝트를 선택하여 독립적인 보고서를 생성하고 각 담당자에게 맞출 수 있습니다.
스프린트 주기 맞추기	임의의 시작일과 종료일을 설정하여, 일/주/월에 고정된 주기에 얽매이지 않습니다.
AI 비용 추적	600개 이상의 모델별 가격 책정이 내장되어 있습니다 (GLM/Kimi/Qwen/DeepSeek 포함). 등가 API 지출 비용을 자동으로 계산합니다.

LumenCode와 ccusage 비교

두 도구 모두 동일한 로컬 로그를 읽고, 동일한 15가지 에이전트 CLI(agent CLI)를 지원합니다. 차이점은 '데이터를 얻었을 때 무엇을 할 수 있는가'입니다. LumenCode는 여기에 Web UI와 MCP 서비스, 라인별 AI 기여도 추적 기능을 추가했습니다.

ccusage	LumenCode
형태	CLI
라인별 AI 기여도 추적	—
주간 보고서 생성 기능	터미널 / JSON
AI 스마트 주간 보고서	—
시각화 탐색 (Drill-down)	—
지원 도구	15개
비용/가격 책정	✅ 오프라인 + 사용자 정의 적용 가능

ccusage는 빠르고 우수한 CLI이며, 저희는 여기서 영감을 얻었습니다. LumenCode는 동일한 로그 파일인 ~/.claude를 읽으며, 두 도구는 공존하며 충돌이 없습니다.

Node.js >= 20.0.0
네이티브 SQLite 의존성 (better-sqlite3, npm install 시 자동 컴파일) - 지원하는 도구 중 최소 하나가 설치되어 있고 세션 로그를 생성한 적이 있어야 합니다.

15가지 AI 코딩 도구 모두 ✅ 완벽하게 지원됩니다 (세션 단위 / 토큰 단위 / 모델 단위 통계).

도구	기본 로그 디렉토리	환경 변수 (선택 사항)
Claude Code	`~/.claude`	`CLAUDE_DIR`
OpenAI Codex	`~/.codex`	`CODEX_DIR`
OpenCode	`~/.opencode`	`OPENCODE_DIR`
Gemini CLI	`~/.gemini`	`GEMINI_DIR`
Qwen Code	`~/.qwen`	`QWEN_DIR`
Goose	`~/.local/share/goose`	`GOOSE_DIR`
Amp	`~/.local/share/amp`	`AMP_DIR`
Hermes Agent	`~/.hermes`	`HERMES_DIR`
OpenClaw	`~/.openclaw`	`OPENCLAW_DIR`
Kimi CLI	`~/.kimi`	`KIMI_DIR`
Codebuff	`~/.config/manicode`	`CODEBUFF_DIR`
Droid	`~/.factory/sessions`	`DROID_DIR`
Pi Agent	`~/.pi/agent/sessions`	`PI_AGENT_DIR`
Kilo	`~/.local/share/kilo`	`KILO_DATA_DIR`
GitHub Copilot CLI	`~/.copilot/otel`	`COPILOT_OTEL_FILE_EXPORTER_PATH` / `COPILOT_DATA_DIR`

환경 변수가 명시되지 않은 경우, 기본 디렉토리를 기준으로 자동 감지합니다. 여러 계정의 경우 쉼표로 구분하여 여러 디렉토리를 지정할 수 있습니다.

전체 설치 (최신 버전 지정)

npm install -g lumencode@latest
lumencode serve # 웹 서비스 시작, 브라우저 자동 열림
...

⚠️ 이전 버전 사용 시? npm cache clean --force && npm install -g lumencode@latest 실행

강제 캐시 플러시 후 재설치.

설정 불필요 (Out-of-the-box) — 최초 실행 시 상단에 있는 15가지 도구의 로그 디렉토리를 자동으로 감지하고, 세션 메타데이터를 통해 프로젝트 경로를 추론하여 수동 설정이 필요 없습니다.

핵심 기능:

행 단위 기여도 분석 × 15개 도구 통합 × 정확한 비용 산정 × 원클릭 주간 보고서 작성 — AI 코딩 투입 대비 성과(ROI)를 모든 행, 모든 돈에 걸쳐 계산합니다.

하이라이트	설명
🎯 행 단위 AI 기여도 분석	단순히 'AI가 이 커밋을 도왔다' 수준을 넘어, '이 코드는 AI가 작성했다'까지 추적 — 후크(hook) 단계 추적 + 단계별 증거로 모든 행에 대해 정확하게 파악합니다.
🔎 기여도 증거 심층 분석	각 커밋에서 행 단위 기여도 증거를 심층적으로 확인할 수 있습니다: 매칭된 행, 출처 도구 / 세션 / 단계, 신뢰도 — 모든 숫자를 추적할 수 있습니다.
🌐 15개 도구 통합	Claude Code / Codex / Copilot 등 15가지 도구의 로그가 자동으로 취합되며, 원클릭 전환 및 크로스 도구 비교 분석이 가능합니다.
🩺 데이터 건전성 투명성	`doctor` 명령어로 각 도구 로그 파싱 상태(성공률, 최근 성공 여부, 이상 징후)를 한 번에 점검하여 데이터 문제를 조기에 발견할 수 있습니다.
📝 원클릭 보고서 작성	상세 보고서 / 간략 보고서를 즉시 생성하며, Markdown / Feishu (飞书) / DingTalk (钉钉) 세 가지 형식으로 지원합니다. 복사-붙여넣기만 하면 되며, 각 섹션마다 통찰력 해석이 첨부됩니다.
🤖 AI 스마트 리포트	로컬 Claude Code / Codex / OpenCode 중 하나를 호출하여 분석 보고서를 생성합니다. 여기에는 하이라이트, 통찰력, 위험 요소, 제안 등이 포함되며, 관리자에게 보고하는 '관리 보고' 스타일을 선택할 수 있습니다.
💰 정확한 비용 추산	600개 이상의 모델 가격 라이브러리(GLM/Kimi/Qwen/DeepSeek 포함)와 Portkey API를 백업으로 사용합니다. 알 수 없는 모델은 $0로 계산하여 실제 발생한 것만 보고하고 추측하지 않습니다.
📂 프로젝트별 독립 보고	여러 프로젝트가 병렬로 진행될 경우, 각 프로젝트마다 독립적인 보고서(커밋 + AI 상호작용량 + 핵심 파일)를 생성하여 담당자별로 맞춤화된 정리가 가능합니다.
📅 스프린트 주기 연동	일/주/월 외에도 임의의 시작일과 종료일을 설정할 수 있어, 반복 개발 주기에 맞춰 보고서를 작성할 수 있습니다.
🔍 추세 통찰력	피크 발생일, 연속 활동 일수, 도구 사용 5가지 분포를 한눈에 파악할 수 있으며, 차트를 클릭하면 세션/커밋으로 심층 분석이 가능합니다.
📦 설정 불필요 (Out-of-the-box)	최초 실행 시 도구 디렉토리를 자동으로 감지하고 프로젝트 경로를 추론하여 설치 후 바로 사용할 수 있습니다.
🌙 라이트 / 다크 테마	기본적으로 어두운 색상(Dark Mode)을 사용하며, 모든 차트는 자동 적응합니다.

왼쪽 데이터 소스 패널에서 원클릭으로 도구를 전환할 수 있으며, 메인 영역에서는 토큰 소비량, 비용, 모델 분포, AI 기여도 분석 결과를 종합적으로 확인할 수 있습니다.

'모든 도구(全部工具)' 뷰로 전환하여 크로스 도구의 종합 데이터 및 비교 분석을 확인할 수 있습니다.

프로젝트별로 토큰, 비용, 세션 수를 통계 내고, 클릭하여 개별 세션 상세 내용을 볼 수 있습니다.

작업 유형별(코딩 / 테스트 / 디버깅 / 문서화 / 검토 / 기획)로 분류하고, 매칭 키워드 예시를 제공합니다.

자연어 단락 형식의 보고서로, 토큰/비용/AI 기여도/프로젝트 하이라이트/코드 산출물을 다루며, 각 섹션마다 통찰력 해석을 첨부합니다.

상세 보고서(详报) — 전체 데이터 + 통찰력 해석 + 섹션 번호가 포함되어 주간/월간 보고서에 적합합니다. 간략 보고서(简报) — 3~5문장의 핵심 요약으로 일일 보고서나 단체 메시지에 적합합니다. 스마트 리포트 — 페이지 내에서 로컬 Claude Code / Codex / OpenCode 중 하나를 호출하여 AI 분석을 생성하며, 데이터 요약, 작업 하이라이트, 주요 통찰력, 위험 및 제안 등이 포함됩니다. 스타일 선택 — 생성 전 기본 스타일 또는 '관리 보고' 스타일을 선택할 수 있어 상사에게 보고하는 데 더 적합한 표현 경향을 출력합니다. 영구 저장 및 업데이트 알림 — 스마트 리포트는 주기, 프로젝트, 보고서 레벨, 스타일에 따라 저장됩니다. 통계 데이터가 변경되면 재생성을 요청하는 알림이 표시됩니다. 다중 플랫폼 형식 — 표준 Markdown / Feishu (飞书) / DingTalk (钉钉)을 원클릭으로 전환할 수 있습니다. 프로젝트별 생성 — 오른쪽 패널에서 프로젝트를 선택하여 해당 프로젝트의 독립적인 보고서를 생성합니다.

|
|
상세 보고서(详报) |
간략 보고서(简报) |

모든 차트 색상은 자동 적응하며, 장시간 읽어도 눈이 피로하지 않습니다.

다크 모드(Dark Mode)가 기본 테마이며, 상단의 스크린샷은 모두 다크 모드 환경의 결과물입니다.

사이드바 '설정' 페이지에서 15개 도구 데이터 소스 디렉토리, 활성화 도구, 비용 계산 기준, 단계 추적 기여도 분석, 시나리오 키워드, 외관 선호도 등을 카드별로 통합 관리할 수 있습니다.

lumencode <명령> [주기] [날짜] [옵션]

명령	설명
`serve`	웹 서비스 시작 (기본 포트 4567)
`report`	명령어 보고서 생성 (기본 명령어)
`doctor`	각 도구 로그의 파싱 건강 상태 확인
`init`	설정 파일 초기화
`hooks`	라인별 기여도(attribution) 후크 활성화/비활성화 (라인별 AI 기여도 참조)
`mcp`	MCP 서버 시작. Claude Code / Cursor 등에서 호출 가능하도록 제공 (MCP 서버 참조)

주기	설명
`daily`	일일 보고서 (기본값)
`weekly`	주간 보고서 (해당 주 자동 계산)
`monthly`	월간 보고서 (해당 월 자동 계산)

# 웹 모드(권장)
lumencode serve
# 명령어 일일 보고서
...

LumenCode는 내장 MCP 서버를 통해 AI 코딩 분석 능력을 7가지 도구로 노출하며, 이는 Claude Code / Cursor / Windsurf 등 MCP를 지원하는 클라이언트가 직접 호출할 수 있습니다. 따라서 웹 인터페이스로 전환할 필요 없이 대화창에서 사용량 확인, 주간 보고서 생성, 코드 기여도 분석이 가능합니다.

도구	설명
`usage_summary`	AI 사용량 개요: 토큰 소모, 비용, 세션 수, 모델 분포
`daily_report`	지정 날짜의 사용 보고서 생성 (Markdown)
`work_report`	업무 보고서 (주간/월간 보고서). normal / brief / boss 세 가지 스타일 지원
`session_list`	지정 시간 범위 내 AI 코딩 세션 목록 표시
`trend_analysis`	사용량 추이: 일별 토큰, 비용, 요청량 변화
`ai_contribution`	특정 저장소의 AI 코드 기여도: 기여율, 커밋 기여도(commit attribution), 주요 파일
`cost_breakdown`	비용 분석: 모델 / 프로젝트별 비용 및 캐시 적중률 통계

방식 1: 전역 설치 후 (권장)

npm install -g lumencode@latest

클라이언트의 MCP 설정에 추가합니다. (Claude Code의 settings.json을 예로):

{
"mcpServers": {
"lumencode": {
...

방식 2: 소스 코드 / 개발 모드

{
"mcpServers": {
"lumencode": {
...

Cursor / Windsurf 등 클라이언트의 설정 필드명은 모두 mcpServers로 동일하므로, 각자의 설정 진입점에 따라 입력하면 됩니다. 또한 npm run mcp 또는 lumencode-mcp를 사용하여 직접 포그라운드 디버깅을 시작할 수도 있습니다.

설정 불필요(Zero Config): 모든 지원 도구의 로그 디렉토리를 자동으로 감지하고, 세션으로부터 프로젝트 경로를 추론하므로 수동 지정이 필요 없습니다. stdio 전송: 표준 MCP stdio 프로토콜입니다. 최초 호출 시에만 로그를 스캔하여 캐싱하며, 이후에는 재사용됩니다. 결과 일관성: 모든 도구는 Web 및 CLI와 공통으로 lib/ 디렉토리 아래의 통계 및 기여도 구현을 공유합니다.

설정 완료 후 AI 어시스턴트에게 직접 질문할 수 있습니다. 예를 들어,

、.opencode/plugins/lumencode-step-tracker.js
)", 전역 설정이나 다른 프로젝트에 영향을 주지 않습니다. 실행 비활성화:

node index.js hooks disable

데이터는 현재 프로젝트의 .lumencode/steps.db에 기록됩니다
(기여도 추적용 파일 스냅샷 포함). 이전 버전의 .ccusage/steps.db는 첫 사용 시 새 경로로 복사되어 마이그레이션되며, 기존 파일은 롤백 백업으로 보존됩니다.

로컬 테이블: Portkey-AI/models에서 가져온 590개의 제조사 원본 이름 및 가격 별칭 매핑: glm-5.1 / kimi-for-coding 등 중계 서비스 별칭을 정확한 가격으로 지정하는 28개 권위 있는 커버리지를 제공합니다.
API 폴백(Fallback): 일치하지 않는 새 모델은 자동으로 Portkey 무료 API를 호출하고, 결과는 data/pricing-cache.json에 캐시됩니다. 로컬 + 폴백을 통해 600개 이상의 모델을 지원합니다.
실패 시 다운그레이드: API를 사용할 수 없을 때 해당 모델은 $0로 계산되어 청구되며, 다른 모델이나 보고서 생성에는 영향을 주지 않습니다.

문제	해결 방법
브라우저에 '데이터 없음' 표시	최초 실행 시 설정 안내가 제공됩니다. 이미 건너뛴 경우, 왼쪽 사이드바에서 '설정' 페이지를 여세요.
...
만약 이 도구가 도움이 되었다면, 다음을 해보세요:

Star 주기 — 더 많은 사람이 이 도구를 볼 수 있게 하세요
Issue 제기하기 — 버그 보고 또는 새 기능 제안
PR 제출하기 — 모델 가격 책정, 시나리오 키워드, 도구 적응에 오신 것을 환영합니다.

AI 코딩 어시스턴트 사용 분석: 한 줄 명령으로 AI가 작성한 코드 양을 파악하다

요약

핵심 포인트

전체 설치 (최신 버전 지정)

댓글

전체 설치 (최신 버전 지정)