# 문제 해결 > **찾아보는 장입니다.** 증상으로 찾으세요. ## 먼저 — 로그 보는 법 대부분의 문제는 로그에 답이 있습니다. ```bash cat logs/server.log ``` 마지막 부분만 보려면: ```bash tail -50 logs/server.log ``` 직전 실행에서 죽었다면: ```bash cat logs/server.log.prev ``` --- ## 설치·실행 ### `hyperteams: command not found` **가장 흔한 문제입니다.** 1. **새 터미널 창을 여세요.** 설치가 경로 설정을 바꾸는데 이미 열린 터미널은 모릅니다. 2. 그래도 안 되면 컴퓨터를 다시 시작 3. 그래도 안 되면 설치가 실패한 것 → [다시 설치](/guide/ht-install) ### 켰는데 바로 꺼집니다 로그를 확인하세요. 대개 준비물 문제입니다. ```bash claude --version # 나오나? node --version # 나오나? ``` 둘 중 하나가 안 나오면 [준비물](/guide/ht-prerequisites)부터 해결하세요. ### 포트가 이미 사용 중입니다 ```bash PORT=9000 hyperteams ``` 기본값을 바꾸려면 `hyperteams setup`. ### 주소는 뜨는데 브라우저에서 안 열립니다 - `http://`를 포함해 정확히 입력했는지 - 방화벽이 막고 있는지 - 다른 포트로 시도 → `PORT=9000 hyperteams` --- ## 접속·인증 ### 비밀번호가 기억나지 않습니다 ```bash hyperteams setup ``` ### 터널을 연결했는데 밖에서 안 열립니다 1. **다시 시작했나요?** 터널 연결 후 `hyperteams restart`가 필요합니다 2. 주소를 정확히 썼는지 3. 대시보드 설정에서 터널 상태가 "연결됨"인지 --- ## 업무 실행 ### 업무를 맡겼는데 아무 반응이 없습니다 ``` □ Claude Code 로그인이 살아 있나? → 터미널에서 claude 실행해보기 □ 작업 폴더 경로가 유효한가? → 폴더가 실제로 있나 □ 로그에 오류가 있나? → tail -50 logs/server.log ``` **첫 번째가 가장 흔합니다.** Claude Code 로그인이 만료되면 하이퍼팀즈(HyperTeams)도 함께 멈춥니다. ### 엉뚱한 파일을 건드립니다 [작업 폴더가 너무 넓게](/guide/ht-working-directory) 잡혀 있을 가능성이 큽니다. 좁게 다시 잡으세요. 그리고 지시에 **범위를 명시**하세요 — [하지 말 것으로 적는 게 효과적](/guide/ai-intent-context)입니다. ### 결과가 계속 마음에 안 듭니다 증상별로 원인이 다릅니다. | 증상 | 원인 | 대처 | |---|---|---| | 일반적인 답만 나옴 | 맥락 부족 | 폴더 설명과 지시에 상황 추가 | | 앞의 지시를 잊음 | [컨텍스트가 밀려남](/guide/ai-context-overflow) | 새 업무로 나누기 | | 하지 말라는 걸 함 | 범위 미지정 | 하지 말 것을 명시 | | 끝났는지 애매함 | 완료 조건 없음 | 판정 기준 추가 | ### 작업이 너무 오래 돕니다 업무가 너무 큰 것입니다. [작게 나누세요](/guide/ha-micro-sprint) — 하나의 업무가 한 문장으로 설명되는 크기가 적당합니다. --- ## 성능·자원 ### 컴퓨터가 느려집니다 ``` □ 터미널을 여러 개 띄워두고 잊지 않았나 □ 동시에 도는 업무가 너무 많지 않나 ``` 안 쓰는 터미널을 정리하세요. ### 비용이 예상보다 많이 나옵니다 ``` □ 예약 실행이 몇 개나 돌고 있나 □ 목적이 끝난 예약이 남아 있지 않나 □ 단순 작업에 무거운 모델을 쓰고 있지 않나 ``` [예약 실행 장](/guide/ht-schedule)의 비용 감각 부분을 참고하세요. --- ## 데이터·복구 ### 기록이 사라졌습니다 `hyperteams upgrade`는 데이터를 건드리지 않습니다. 재설치했다면 데이터가 지워졌을 수 있습니다. ### 작업이 잘못돼서 되돌리고 싶습니다 **git을 쓰고 있다면** 그쪽에서 되돌리는 게 가장 확실합니다. 그래서 [작업 전 커밋](/guide/ht-autonomy)을 권합니다. git이 없다면 편집기의 되돌리기나 백업에 의존해야 합니다. --- ## 그래도 안 되면 로그와 함께 문의하세요. ```bash tail -100 logs/server.log ``` 문의처: **hyperteamsnet@gmail.com** --- 복구 순서를 한 번 직접 밟아둡니다. 30분입니다 → [멈춘 업무를 되살려보기](/guide/ht-try-recovery) 문의할 때 함께 알려주시면 빠릅니다: ``` □ OS와 버전 □ hyperteams --version □ claude --version / node --version □ 무엇을 하려다 무엇이 안 됐는지 □ 로그 마지막 부분 ```