taco — AI 코딩 사용량·비용 추적문서문제 해결버그 제보문의하기taco@inflearn.com
taco docs
설치대시보드GitHub
비용 보는 분들께
비용 확인하기 (설치 없이)
AI 도구 쓰는 분들께
개요빠른 시작윈도우 설치 (터미널 없이)설치설정
수집
지원 도구CLI 명령
대시보드
대시보드 둘러보기티켓별 비용
연동
MCP 서버Jira·GitHub 연동
기타
문제 해결

윈도우 설치 (비개발자용)

개발 경험이 없어도, 파일 하나 더블클릭으로 taco 설치 → 도구 플러그인 연동 → 로그인까지 전부 자동으로 끝낼 수 있습니다. 이 문서는 윈도우 사용자를 위한 가장 쉬운 방법입니다.

터미널·명령어에 익숙하다면 빠른 시작이 더 짧습니다.

미리 알아두면 좋은 말 세 가지

  • 플러그인 — AI 도구에 붙는 자동 기록 장치. 설치하면 사용량이 알아서 모입니다.
  • hook — AI 도구의 세션이 끝날 때 자동으로 실행되는 연결고리. 플러그인이 이걸로 기록을 보냅니다.
  • PATH — 터미널이 명령을 찾는 목록. 여기 없으면 taco 명령을 못 찾습니다(새 터미널을 열면 보통 해결).

한눈에

  1. 설치 파일(taco-setup.bat)을 받아 더블클릭합니다.
  2. 자동으로 설치 → 감지된 도구(Claude Code·Codex 등)에 플러그인 전체 설치 → 브라우저 로그인 창이 뜹니다.
  3. 로그인하면 끝. 이후 대시보드에서 내 사용량을 봅니다.

한 번 설치하면 이후엔 아무것도 안 해도 됩니다. AI 코딩 도구를 쓰면 taco가 알아서 모아 보냅니다.

방법 A — 더블클릭 설치 (권장)

  1. 설치 파일 내려받기: taco-setup.bat 다운로드
  2. 다운로드된 taco-setup.bat을 더블클릭합니다.
  3. 파란 경고창이 뜨면("Windows의 PC 보호") → 추가 정보 클릭 → 실행 클릭.
    • taco는 안전하지만 아직 서명 인증서가 없어 뜨는 경고입니다.
  4. 검은 창에서 설치가 진행되고, 잠시 뒤 브라우저 로그인 창이 열립니다 → 인프런 계정으로 로그인.
  5. [OK] 설치 완료 메시지가 보이면 끝. 아무 키나 누르면 창이 닫힙니다. ([실패]가 보이면 그 화면을 캡처해 taco@inflearn.com으로 보내주세요.)

설치 위치: C:\Users\사용자\AppData\Local\taco\bin\taco.exe · 설정/로그인 정보: %USERPROFILE%\.config\taco · 수집한 데이터: %USERPROFILE%\.local\share\taco

방법 B — PowerShell 한 줄 (터미널이 편하면)

PowerShell을 열고 아래 한 줄 — 설치·플러그인·로그인까지 한 번에:

iex "& { $(irm https://inf.run/taco.ps1) } -Setup"

설치만 하고 직접 진행하려면:

irm https://inf.run/taco.ps1 | iex   # 설치
taco plugins                          # 감지된 도구 플러그인 설치
taco login                            # 로그인 + 전송 시작

잘 되고 있는지 확인

대시보드에 접속해 홈에서 내 사용량·비용이 보이면 그걸로 끝입니다 — 다른 확인은 필요 없습니다. (설치 직후엔 비어 있을 수 있어요. Claude Code를 재시작하고 한 번 사용한 뒤 다시 보세요.)

(선택) 터미널로 바로 확인하고 싶으면 PowerShell에서:

taco collect --sync   # 지금 즉시 수집 + 전송
taco doctor           # 설정/로그인/수집 상태 점검

자동 수집은 어떻게 동작하나요

설치 시 감지된 도구(Claude Code·Codex 등)에 taco 플러그인이 설치됩니다(taco plugins).

Cursor·Gemini CLI·Antigravity·Claude Desktop은 플러그인이 없어서, Claude Code나 Codex를 함께 쓸 때 그 플러그인이 돌 때 묻어 같이 수집됩니다(둘 중 하나만 깔려 있어도 됩니다). 이 도구들만 쓰고 아무 플러그인도 없다면 자동으로 수집되지 않으니 가끔 taco collect를 직접 실행하세요(taco login 할 때도 한 번 전체 수집됩니다).

  • 플러그인이 세션이 끝날 때마다(hook) 도구가 남긴 기록을 읽어 서버로 보냅니다.
  • 설치 후 해당 도구를 한 번 재시작하면 hook이 활성화됩니다. 이후엔 그냥 쓰면 알아서 수집됩니다.
  • 나중에 도구를 추가했거나 다시 연동하려면 taco plugins.
  • Claude Code에서 확인: /plugin → taco 활성 여부, /mcp → taco·taco-remote 사용량 조회 도구.

자주 막히는 곳

  • "Windows의 PC를 보호했습니다" 경고: 추가 정보 → 실행. (서명 미적용으로 뜨는 정상 경고)

  • 로그인 창이 안 뜸 / 스크립트가 막힘: 회사 정책으로 스크립트 실행이 차단될 수 있습니다. PowerShell에서 아래 한 줄을 그대로 복사해 실행해 보세요(이번 실행만 정책을 우회).

    powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://inf.run/taco.ps1 | iex; taco plugins; taco login"
    
  • taco 명령을 못 찾음: 설치 후 새 터미널을 열어야 인식됩니다(PATH 반영).

  • 데이터가 안 보임: Claude Code를 실제로 한 번 사용해야 기록이 생깁니다. 이후 taco collect --sync로 즉시 반영해 보세요.

제거

가장 간단한 방법은 taco 자신에게 맡기는 것입니다 — 설정·데이터까지 한 번에 정리합니다.

taco uninstall                # 플러그인 등록 해제 + 설정·데이터 삭제
taco uninstall --keep-data    # 설정·데이터는 남기고 제거

윈도우는 실행 중인 taco.exe를 지울 수 없어서, 명령이 끝나며 지울 경로를 알려줍니다 — 새 PowerShell 창에서 안내대로 Remove-Item을 실행하면 됩니다.

설치 스크립트로 제거할 수도 있습니다.

iex "& { $(irm https://inf.run/taco.ps1) } -Uninstall"

이때 taco.exe, Claude Code 플러그인 등록(taco@inflearn + marketplace inflearn), 그리고 user PATH에 추가된 설치 경로가 정리됩니다.

  • 로그인/설정(%USERPROFILE%\.config\taco)과 수집 데이터(%USERPROFILE%\.local\share\taco)는 남습니다 — 함께 지우려면 taco uninstall을 쓰거나 두 폴더를 직접 삭제하세요.
  • Codex를 쓴다면 %USERPROFILE%\.codex\config.toml의 [marketplaces.inflearn] · [plugins."taco@inflearn"] 블록은 직접 지워야 합니다.

예전 버전이 만들던 예약 작업(자동 수집 작업)은 v0.10.3 이후 더 이상 만들지 않습니다. 제거 스크립트가 혹시 남아 있는 레거시 작업만 정리하고 넘어갑니다.

이 페이지
한눈에방법 A — 더블클릭 설치 (권장)방법 B — PowerShell 한 줄 (터미널이 편하면)잘 되고 있는지 확인자동 수집은 어떻게 동작하나요자주 막히는 곳제거