문제 해결

찾아보는 장입니다. 증상으로 찾으세요.

먼저 — 로그 보는 법

대부분의 문제는 로그에 답이 있습니다.

bash

cat logs/server.log

마지막 부분만 보려면:

bash

tail -50 logs/server.log

직전 실행에서 죽었다면:

bash

cat logs/server.log.prev

설치·실행

`hyperteams: command not found`

가장 흔한 문제입니다.

새 터미널 창을 여세요. 설치가 경로 설정을 바꾸는데 이미 열린 터미널은 모릅니다.
그래도 안 되면 컴퓨터를 다시 시작
그래도 안 되면 설치가 실패한 것 → 다시 설치

켰는데 바로 꺼집니다

로그를 확인하세요. 대개 준비물 문제입니다.

bash

claude --version   # 나오나?node --version     # 나오나?

둘 중 하나가 안 나오면 준비물부터 해결하세요.

포트가 이미 사용 중입니다

bash

PORT=9000 hyperteams

기본값을 바꾸려면 hyperteams setup.

주소는 뜨는데 브라우저에서 안 열립니다

http://를 포함해 정확히 입력했는지
방화벽이 막고 있는지
다른 포트로 시도 → PORT=9000 hyperteams

접속·인증

비밀번호가 기억나지 않습니다

bash

hyperteams setup

터널을 연결했는데 밖에서 안 열립니다

다시 시작했나요? 터널 연결 후 hyperteams restart가 필요합니다
주소를 정확히 썼는지
대시보드 설정에서 터널 상태가 "연결됨"인지

업무 실행

업무를 맡겼는데 아무 반응이 없습니다

text

□ Claude Code 로그인이 살아 있나?  → 터미널에서 claude 실행해보기□ 작업 폴더 경로가 유효한가?       → 폴더가 실제로 있나□ 로그에 오류가 있나?              → tail -50 logs/server.log

첫 번째가 가장 흔합니다. Claude Code 로그인이 만료되면 하이퍼팀즈(HyperTeams)도 함께 멈춥니다.

엉뚱한 파일을 건드립니다

작업 폴더가 너무 넓게 잡혀 있을 가능성이 큽니다. 좁게 다시 잡으세요.

그리고 지시에 범위를 명시하세요 — 하지 말 것으로 적는 게 효과적입니다.

결과가 계속 마음에 안 듭니다

증상별로 원인이 다릅니다.

증상	원인	대처
일반적인 답만 나옴	맥락 부족	폴더 설명과 지시에 상황 추가
앞의 지시를 잊음	컨텍스트가 밀려남	새 업무로 나누기
하지 말라는 걸 함	범위 미지정	하지 말 것을 명시
끝났는지 애매함	완료 조건 없음	판정 기준 추가

작업이 너무 오래 돕니다

업무가 너무 큰 것입니다. 작게 나누세요 — 하나의 업무가 한 문장으로 설명되는 크기가 적당합니다.

성능·자원

컴퓨터가 느려집니다

text

□ 터미널을 여러 개 띄워두고 잊지 않았나□ 동시에 도는 업무가 너무 많지 않나

안 쓰는 터미널을 정리하세요.

비용이 예상보다 많이 나옵니다

text

□ 예약 실행이 몇 개나 돌고 있나□ 목적이 끝난 예약이 남아 있지 않나□ 단순 작업에 무거운 모델을 쓰고 있지 않나

예약 실행 장의 비용 감각 부분을 참고하세요.

데이터·복구

기록이 사라졌습니다

hyperteams upgrade는 데이터를 건드리지 않습니다. 재설치했다면 데이터가 지워졌을 수 있습니다.

작업이 잘못돼서 되돌리고 싶습니다

git을 쓰고 있다면 그쪽에서 되돌리는 게 가장 확실합니다. 그래서 작업 전 커밋을 권합니다.

git이 없다면 편집기의 되돌리기나 백업에 의존해야 합니다.

그래도 안 되면

로그와 함께 문의하세요.

bash

tail -100 logs/server.log

문의처: [email protected]

복구 순서를 한 번 직접 밟아둡니다. 30분입니다 → 멈춘 업무를 되살려보기

문의할 때 함께 알려주시면 빠릅니다:

text

□ OS와 버전□ hyperteams --version□ claude --version / node --version□ 무엇을 하려다 무엇이 안 됐는지□ 로그 마지막 부분