구성 레퍼런스

플러그인 설정 (~/.prism/config.json)

Prism이 런타임 설정을 읽어 오는 곳은 이 파일 하나뿐입니다.

필드	타입	기본값	편집	설명
show_realtime_summary	boolean	false	가능	턴이 끝난 뒤 서버측 실시간 요약을 출력합니다. 다음 훅 실행부터 적용됩니다.
ingest_url	URL	—	가능	Prism이 ingest·실시간·리포트·config·OTEL 트래픽을 보내는 주소. HTTPS 또는 HTTP 루프백. 재시작이 필요합니다.
apiKey	string	—	불가	Prism API 키. /prism:setup KEY가 관리합니다.
dashboard_url	URL	—	불가	서버가 API 키에서 결정합니다.
debug	boolean	false	직접만	디버그 로그를 터미널(stderr)로도 함께 출력합니다. /prism:config에는 없고 파일을 직접 편집해야 합니다.

show_realtime_summary는 이전 이름인 showRealtimeSummary로도 읽히며, 다음 쓰기 때 현재 이름으로 옮겨집니다.

파일 권한: 600(소유자 읽기·쓰기 전용) · 디렉터리 권한: 700(소유자 전용)

이 파일은 머신에 설치된 모든 플러그인 버전이 공유하므로, 필드는 추가만 될 뿐 이름이 바뀌거나 다른 용도로 재사용되지 않습니다.

OTEL 설정 (~/.claude/settings.json)

플러그인은 세션 시작 시, 자신이 설치된 스코프의 설정 파일에 다음을 기록합니다.

{
  "env": {
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://ingest.optra-prism.com/v1/logs",
    "OTEL_EXPORTER_OTLP_METRICS_ENDPOINT": "https://ingest.optra-prism.com/v1/metrics"
  }
}

플러그인은 로그와 메트릭 엔드포인트만 기록합니다. OTEL_EXPORTER_OTLP_TRACES_ENDPOINT는 설정하지 않습니다. Claude Code가 이 경로로 OTLP 트레이스를 내보내지 않기 때문입니다. URL은 API 키에서 결정됩니다. 전체 키 목록은 환경 변수를 참고하세요.