플러그인 개요

Prism 플러그인은 Claude Code 안에서 자동 훅 여섯 개와 슬래시 명령 여덟 개로 동작합니다. 훅은 뒤에서 조용히 돌고, 명령은 필요할 때 직접 실행합니다.

자동 훅

명령 없이 동작합니다. 플러그인을 설치하면 늘 활성 상태입니다.

훅	시점	하는 일
SessionStart	세션 시작	API 키와 OTEL 설정을 확인하고 결과를 알려 줍니다
UserPromptSubmit	프롬프트 전송 전	프롬프트를 Prism으로 수집합니다
CwdChanged	작업 디렉터리 변경	세션의 프로젝트 컨텍스트를 정확하게 유지합니다
PostCompact	/compact 이후	compaction 단위 세션 상태를 초기화합니다
PostToolUse	SendMessage 도구 호출 후	변경 내용을, 그 변경을 이끌어 낸 프롬프트와 연결하는 git·프롬프트 “증거(evidence)“를 수집합니다
Stop	응답 완료 후	응답과 해당 턴의 메타데이터를 Prism으로 보냅니다

훅은 프롬프트를 결코 차단하지 않습니다. 무엇이 실패해도 프롬프트는 그대로 전달됩니다.

터미널에서 하지 않는 일

프롬프트를 로컬에서 채점하지 않고, 코칭 문구나 재작성 제안을 출력하지도 않습니다. 채점은 프롬프트가 수집된 뒤 서버에서 실행되고, 코칭은 대시보드에 표시됩니다.

터미널에 출력할 수 있는 유일한 것은 턴이 끝난 뒤의 짧은 실시간 요약이며, 켜지 않으면 나오지 않습니다.

/prism:config set show_realtime_summary true

슬래시 명령

세션 중에 직접 실행합니다.

명령	용도
/prism:setup [key]	API 키를 설정하고 텔레메트리를 활성화
/prism:status	연결 상태, 설치 스코프, 무엇이 어디에 설정됐는지
/prism:config	바꿀 수 있는 설정 확인·변경
/prism:doctor	설정과 연결 문제 진단
/prism:realtime	이 세션의 실시간 요약(등급, 비용, 턴)
/prism:report	주간 리뷰 — 이번 주 대 지난주, 프롬프트 점수, 습관, 최악의 프롬프트
/prism:help	모든 명령 나열
/prism:uninstall	Prism 설정과 OTEL 구성 제거

자세한 내용은 명령을 참고하세요.

코칭은 어디에 있나

플러그인은 터미널 내 프롬프트 코칭·재작성·상시 어드바이저를 제공하지 않습니다. 분석은 프롬프트가 수집된 뒤 서버에서 실행되고, 결과는 대시보드에 나타납니다.

• 세션 리플레이의 인라인 주석 — 어떤 루브릭 항목이 왜 실패했는지
• 개인 리포트의 코칭 카드
• 실시간 화면의 Task 어드바이저 — 서브세션별, 재작성 예시 포함
• 어드바이저 & 요약

설정

플러그인은 설정을 ~/.prism/config.json에 저장하며, 설정을 읽는 곳은 이 파일뿐입니다. 직접 바꿀 수 있는 값은 두 개입니다.

필드	용도
show_realtime_summary	턴이 끝난 뒤 터미널에 짧은 요약 출력. 기본값 꺼짐.
ingest_url	어느 Prism과 통신할지. 직접 운영하는 경우에만 해당.

apiKey와 dashboard_url도 같은 파일에 저장되지만 자동으로 관리됩니다. 키는 /prism:setup이 맡아 관리하고, 대시보드 주소는 서버가 알려 줍니다. 설정을 참고하세요.