# 실패 진단·복구

| 증상 | 먼저 확인할 증거 | 안전한 다음 단계 |
|---|---|---|
| 명령을 찾지 못함 | 현재 셸·설치 경로·PATH | 새 터미널, 공식 OS 안내, 진단. 설치 폴더 전체 삭제 금지 |
| 로그인 실패 | 제공자·오류 코드·계정 권한 | 공식 로그인 흐름 재확인. 키를 채팅에 붙이지 않음 |
| 429 또는 잔액 부족 | 제공자 대시보드·한도·재시도 기록 | 반복 재시도 중지, 대기/모델 변경/예산 결정 |
| 도구가 안 보임 | 활성 toolset·계정·필요 권한 | 필요한 도구만 확인. 모든 도구 활성화로 해결하지 않음 |
| 기억했다고 했는데 잊음 | 실제 memory 도구 호출·파일·프로필 | 저장 여부 확인 후 새 세션 시험 |
| 예약했는데 안 옴 | 예약 ID·시간대·Gateway·실행 로그·전달 로그 | 실행 실패와 전달 실패 분리. 수신 확인 없이 재발송 금지 |
| 파일을 잘못 바꿈 | 원본 사본·변경 diff·백엔드·체크포인트 | 복구 미리 보기. 컨테이너는 별도 사본/스냅샷 사용 |
| 답이 꾸며짐 | 원자료·도구 결과·출처 | unsupported 항목 분리, 모델/입력/평가 수정 |
| 비밀 노출 의심 | 노출 범위·원본 파일·로그 위치 | 실행 중지, 해당 제공자에서 비밀 교체·권한 철회, 공개본 제거와 영향 확인 |

관련 근거: [품질 진단](https://hermes-agent.nousresearch.com/docs/guides/troubleshooting-agent-quality), [예약 진단](https://hermes-agent.nousresearch.com/docs/guides/cron-troubleshooting), [복구 범위](https://hermes-agent.nousresearch.com/docs/user-guide/checkpoints-and-rollback)