Prism CLI
Claude Code가 실행되는 동안 prism이 하는 일과 전송 시점을 설명합니다.
prism CLI는 Claude Code와 Codex의 활동을 Prism에 연결합니다. prism login으로 로그인하면 작업하는 동안 지원하는 활동을 기록합니다. 모든 세션을 기록하려면 prism setup을 한 번 실행하고, 세션별로 기록하려면 prism claude나 prism codex로 세션을 시작합니다. Claude Code 플러그인과 Codex 플러그인도 같은 기록 기능을 실행하며 CLI의 로그인과 로컬 파일을 함께 씁니다. 자세한 내용은 설치와 업데이트를 참고하세요. 연결하기 전에 데이터 수집과 공개 범위를 읽으세요.
작업하는 동안 일어나는 일
섹션 제목: “작업하는 동안 일어나는 일”프롬프트나 답변마다 Prism 명령을 실행할 필요는 없습니다. 모든 세션을 기록하도록 prism setup을 실행하면 Claude Code 설정 파일에 hook 다섯 개(Stop, SessionEnd, StopFailure, TeammateIdle, SubagentStop)를, Codex 설정 파일(config.toml)에 hook 네 개(Stop, SubagentStop, Interrupt, SessionEnd)를 등록합니다. 이후에는 다음 순서로 진행됩니다.
- 이 이벤트 가운데 하나가 일어나면 Claude Code나 Codex가 hook을 시작합니다. hook은 Prism 폴더(macOS에서는
~/.config/optra-prism)의 로컬 데이터베이스에 짧은 메모만 남기고 바로 끝납니다. 네트워크를 쓰지 않고 Prism을 기다리지도 않으므로 Claude Code를 느리게 하지 않습니다. - 실행 중인 백그라운드 전송 프로세스가 없으면 hook이 하나를 시작합니다.
- 전송 프로세스는 세션 기록에서 새로 늘어난 부분을 읽고, 비밀 값을 가린 뒤, 로그인으로 받은 토큰과 함께 HTTPS로 Prism에 보냅니다. 전송은 키 입력마다가 아니라 위 이벤트가 일어날 때 이루어집니다.
- 전송 프로세스가 전달하지 못한 기록은 Mac에 대기했다가 나중에 전송됩니다.
CLI는 수시로 서버에 수집 설정도 확인합니다.
로그인하지 않았다면 CLI는 아무것도 보내지 않습니다. 이 경우 prism setup은 nothing is collected until you do를 출력합니다.
할 일 고르기
섹션 제목: “할 일 고르기”| 하려는 일 | 명령 또는 안내 |
|---|---|
| 로그인 또는 로그아웃 | prism login, prism logout |
| 모든 세션 기록하기: Claude Code와 Codex의 hook 등록 또는 제거 | prism setup, prism setup remove |
| 로그인, 등록, 전송 상태 확인 | prism status |
| CLI가 Mac에 둔 모든 것 제거 | prism uninstall |
| 세션별로 기록하기: Prism을 거쳐 Claude Code 또는 Codex 시작 | prism claude, prism codex |
| 세션 하나의 수집 중단 | PRISM_OFF=1 claude, PRISM_OFF=1 codex, 수집 중단하기 참고 |
| CLI 업데이트 | 설치와 업데이트 |
| 문제 해결 | 문제 해결 |
각 명령이 보여 주고 하는 일은 명령에 정리되어 있습니다.
결과가 표시되는 곳
섹션 제목: “결과가 표시되는 곳”최근 프롬프트는 실시간, 지난 작업은 세션, 선택한 기간의 돌아보기는 리포트에서 확인하세요. CLI 자체는 점수를 출력하지 않습니다.
작업은 평가 구간이 닫힌 뒤에 평가됩니다. 구간은 세션이 끝날 때, /clear를 실행할 때, 마지막 활동 3시간 뒤에 닫힙니다. 그래서 점수는 프롬프트보다 늦게 도착할 수 있습니다.