문제 해결

자주 나오는 증상과 해결법입니다.

아예 수집이 안 될 때

데이터가 하나도 안 쌓인다면, hook을 실행할 플러그인이 설치되지 않았을 가능성이 큽니다.

플러그인 설치 확인 — 각 도구에서 taco@inflearn이 보이는지 확인합니다.
```
claude plugin list    # Claude Code
codex plugin list     # Codex
```
없으면 taco plugins 재실행(이미 설치됐다고 나오는데 동작이 이상하면 taco plugins --force로 설치 스텝을 강제 재실행).
설치 후 해당 도구를 재시작하고 한 번 사용해 보세요(hook은 재시작해야 활성화).

Cursor·Gemini·Antigravity만 쓴다면 위 절차는 해당되지 않습니다. 이 도구들은 플러그인이 없어 Claude Code·Codex hook에 얹혀 수집되므로, 그 도구들을 안 쓰면 자동 수집이 일어나지 않습니다. taco collect를 직접 실행하세요(주기 실행은 taco plugins가 안내하는 cron 예시 참고). → 지원 도구

진단이 먼저라면 taco doctor가 필터 설정·로그인 상태·플러그인 설치 여부·서버 연결·마지막 hook 실행 시각을 한 번에 보여줍니다.

Codex에서 "already added from a different source" 오류가 나면 — 마켓플레이스가 다른 소스로 등록된 상태입니다. 수동으로 제거 후 재설치하세요.

codex plugin marketplace remove inflearn
taco plugins

taco가 구버전인 것 같으면 — taco update로 최신 버전으로 재설치할 수 있습니다.

일부 repo가 대시보드에 안 떠요

기본값은 **org 제한 없음(모든 레포 수집)**이라 보통은 다 잡히지만, allowed_orgs/allowed_dirs 필터를 설정해 뒀다면 그 범위 밖의 repo는 제외됩니다. (remote가 아예 없는 로컬 폴더는 org 필터와 무관하게 수집됩니다.)

확인:

# 안 뜨는 repo의 remote org 확인
git -C <경로> config --get remote.origin.url
# 현재 설정 확인
cat ~/.config/taco/config.json

해결 — org 제한을 없애거나 필요한 org를 추가한 뒤 소급 재수집:

// ~/.config/taco/config.json
"allowed_orgs": []                       // 제한 없음
// 또는
"allowed_orgs": ["inflearn", "inflab"]   // 여러 org 허용

taco collect --full --sync

심볼릭 링크 주의: allowed_dirs가 설정돼 있는데 작업 폴더가 심볼릭 링크를 통해 접근된다면, 도구가 기록한 실제 cwd가 allowed_dirs 경로 prefix와 안 맞아 걸러질 수 있습니다. allowed_dirs를 비우거나 실제 경로로 맞추세요. → 설정

taco mcp가 안 떠요

/mcp에 taco가 없다면:

/plugin에서 taco 플러그인을 최신으로 업데이트(또는 taco plugins 재실행).
Claude Code 재시작(.mcp.json은 시작 시 로드).
taco -v로 CLI가 설치돼 있는지 확인(플러그인이 taco 바이너리를 실행).

→ MCP 서버

데이터가 서버로 안 올라가요

taco doctor      # 로그인/서버/큐 상태
taco sync        # 미전송분 강제 전송

auto_sync가 꺼져 있으면 hook이 로컬에만 쌓습니다. taco init에서 켜거나 config에서 "auto_sync": true.
로그인이 만료됐으면 taco login으로 재로그인.
지금 상태가 궁금하면 taco status로 마지막 수집·전송 시각을 확인하세요.

로그인 · 세션 문제

대시보드에서 세션이 자주 끊기거나 무한 리다이렉트가 났던 이슈는 배포로 해결됐습니다. 여전히 이상하면 브라우저의 taco_session 쿠키를 지우고 재로그인하세요.

오프라인 · 사내 프록시

비행기/카페에서 써도 되나요 — 됩니다. 수집은 전부 로컬이고, 전송만 못 합니다. 데이터는 로컬 버퍼에 남아 있다가 연결되면 전송됩니다. taco status·taco stats 는 네트워크를 쓰지 않습니다.
연결되면 자동으로 밀린 게 올라가나요 — 다음에 AI 도구를 써서 hook 이 돌 때 전송됩니다. 지금 바로 보내려면 taco sync.
비용에 + 가 붙어요 (🌮 $0.34+) — 단가를 모르는 모델이 섞여 비용이 과소 표시된 상태입니다. 온라인이 되면 taco pricing sync 로 최신 단가를 받으세요.
taco doctor 가 "HTML 응답 — 프록시·캡티브 포털일 수 있어요" — 사내 프록시가 로그인 페이지를 돌려주고 있습니다. 브라우저로 서버 주소를 한 번 열어 로그인한 뒤 다시 시도하세요.
taco doctor 가 "404 — server 주소를 확인하세요" — taco config get server 로 주소를 확인하세요. TACO_SERVER 환경변수가 설정돼 있으면 그게 우선합니다(doctor 의 server= 줄에 실효값이 표시됩니다).
전송 대기가 계속 쌓여요 — 서버에 닿지 못하는 상태면 doctor 가 그렇게 말해 줍니다. 오프라인이면 정상이고, 연결 후 자동 전송됩니다.

원격 개발서버(SSH) · 헤드리스

taco login 은 브라우저 콜백을 이 서버의 127.0.0.1 로 받습니다. SSH 로 접속한 서버에서 실행하면 로컬 브라우저의 리다이렉트가 그 서버에 닿지 못하므로, 먼저 로컬 컴퓨터에서 터널을 여세요:

ssh -L 8765:localhost:8765 <서버>

그 다음 서버에서 taco login 을 실행하고, 출력된 URL 을 로컬 브라우저에서 엽니다. taco login 이 안내하는 포트 번호를 그대로 쓰세요 — 8765 가 점유돼 있으면 다른 포트로 열립니다. 3분 안에 콜백이 오지 않으면 안내와 함께 종료됩니다.

로컬 대시보드도 같은 이유로 주소를 바꿔야 합니다:

taco dashboard --addr 0.0.0.0:7777 --no-open   # 또는 ssh -L 7777:localhost:7777

서버를 반납하기 전에 taco sync 로 대기 큐를 비우세요. 전송하지 않은 사용량은 그 머신과 함께 사라집니다.

그 밖에

taco doctor를 먼저 실행해 보세요 — 설정/로그인/로컬 DB/전송 큐 상태를 점검해 줍니다. 다만 플러그인 설치 여부나 도구 쪽 hook 상태까지 다 잡아주지는 못하므로, 수집 자체가 안 되면 위의 아예 수집이 안 될 때를 함께 확인하세요.

그래도 안 되면

taco@inflearn.com으로 알려주세요. taco doctor 출력과 화면 캡처를 함께 보내주시면 원인을 빨리 찾을 수 있습니다.