대시보드 시작하기
http://localhost:8020에서 열립니다.
대시보드는 파일시스템에서 직접 데이터를 읽습니다 — Claude Code 프로젝트 폴더와 failproofai 설정 파일을 참조하며, 외부 서비스에는 아무것도 전송되지 않습니다.
페이지
프로젝트
사용자 머신에서 발견된 모든 Claude Code 프로젝트를 나열합니다. 프로젝트는~/.claude/projects/ 경로(또는 CLAUDE_PROJECTS_PATH로 설정된 경로)에서 검색됩니다.
각 프로젝트에 표시되는 정보:
- 프로젝트 이름 (폴더 경로에서 파생)
- 세션 수
- 가장 최근 세션 활동 날짜
세션
프로젝트 내 모든 세션을 나열합니다. 각 세션에 표시되는 정보:- 세션 ID
- 시작 및 종료 타임스탬프
- 툴 호출 수
- 훅 활동 횟수 (실행된 정책 수)
세션 뷰어
세션 뷰어는 자율 에이전트에 대한 핵심 질문에 답합니다: 에이전트가 무엇을 했으며, 올바른 방향으로 동작했는가? 세션에서 발생한 모든 일의 타임라인을 보여줍니다:- 메시지 - Claude의 텍스트 응답과 사용자 프롬프트
- 툴 호출 - Claude가 실행한 모든 툴과 입력 및 출력 내용
- 정책 활동 - 각 툴 호출에 대해 어떤 정책이 실행되었고 어떤 결정을 내렸는지
정책
정책 관리와 활동 검토를 위한 두 탭 페이지입니다.- 정책 탭
- 활동 탭
- 클릭 한 번으로 개별 정책을 켜거나 끄기 (
~/.failproofai/policies-config.json에 저장됨) - 정책을 펼쳐 파라미터 설정 (
policyParams를 지원하는 정책의 경우) - 지정된 스코프에 훅 설치 또는 제거
- 커스텀 정책 파일 경로 설정
자동 새로고침
대시보드 상단 네비게이션에 자동 새로고침 토글이 있습니다. 활성화하면 현재 페이지가 주기적으로 새로고침되어 새로운 세션과 정책 활동이 나타나는 즉시 확인할 수 있습니다. 장시간 실행되는 자율 에이전트 세션을 모니터링할 때 필수적인 기능입니다.페이지 비활성화
대시보드의 일부 기능만 필요한 경우,FAILPROOFAI_DISABLE_PAGES에 비활성화할 페이지 이름을 쉼표로 구분하여 설정하세요:
policies, projects.
테마
대시보드는 라이트 모드와 다크 모드를 지원합니다. 네비게이션 바의 버튼으로 전환할 수 있습니다. 설정은 브라우저의 로컬 스토리지에 저장됩니다.프로젝트 경로 설정
기본적으로 대시보드는 표준 Claude Code 프로젝트 디렉토리에서 읽습니다. 커스텀 설정이 필요한 경우 경로를 재정의하세요:localhost가 아닌 호스트에서 접근하기
개발 모드(npm run dev)로 대시보드를 실행하면서 localhost가 아닌 호스트 — 예를 들어 커스텀 도메인, 원격 IP, 또는 터널링된 URL — 에서 접근하면 다음과 같은 경고가 표시될 수 있습니다:
--allowed-origins 플래그를 사용하세요:
FAILPROOFAI_ALLOWED_DEV_ORIGINS 환경 변수를 설정할 수도 있습니다:
이 설정은 개발 모드에서만 적용됩니다.
failproofai(프로덕션 모드)로 실행할 때는 HMR 웹소켓이 없으므로 교차 출처 개발 리소스 문제가 발생하지 않습니다.