문제 해결
설치, 로그인, 수집, 점수에 문제가 있을 때 다음에 할 일을 찾습니다.
보이는 증상에서 시작하고, 설치, 로그인, 수집, 분석 지연 네 가지를 구분해서 확인하세요. 모든 경우에 가장 먼저 확인할 것은 prism status입니다. 전체 출력은 명령에 있습니다.
prism을 찾을 수 없습니다
섹션 제목: “prism을 찾을 수 없습니다”- 새 터미널 창을 열고
prism status를 실행하세요. - 그래도 셸이
prism을 찾지 못하면 설치 안내 화면의 설치 명령을 다시 실행하세요. 상단의 연결로 이동할 수 있습니다.
prism setup이 Claude Code나 Codex를 찾지 못했다고 합니다
섹션 제목: “prism setup이 Claude Code나 Codex를 찾지 못했다고 합니다”모든 세션을 기록하도록 실행한 prism setup은 두 도구를 따로 찾습니다. Claude Code의 설정 디렉터리도, PATH의 claude 프로그램도 찾지 못하면 Claude Code was not found (no configuration directory and no `claude` on PATH); skipped.를 출력합니다. Codex는 Codex was not found (no configuration directory and no `codex` on PATH); skipped.를 출력합니다. 찾은 도구에는 hook이 등록되므로 사용하는 도구의 줄만 확인하세요.
~/.claude나~/.codex가 있는지, 같은 터미널에서claude --version이나codex --version이 동작하는지 확인하세요.- 설정이 다른 곳에 있다면
CLAUDE_CONFIG_DIR이나CODEX_HOME을 그 디렉터리로 지정하고prism setup을 다시 실행하세요.
prism setup이 설정 파일에서 실패합니다
섹션 제목: “prism setup이 설정 파일에서 실패합니다”the settings file is not valid JSON 또는 the settings file is not a JSON object는 Claude Code 설정 파일을 안전하게 편집할 수 없다는 뜻입니다. 파일을 고친 뒤 prism setup을 다시 실행하세요. Prism을 초기화하려고 설정 파일 전체를 삭제하지 마세요. prism setup은 자신의 항목만 바꿉니다.
prism status에 hook이 등록되지 않았다고 표시됩니다
섹션 제목: “prism status에 hook이 등록되지 않았다고 표시됩니다”Claude Code hooks: not registered (<경로>)나 Codex hooks: not registered (<경로>)는 그 경로의 설정 파일에 Prism hook이 없다는 뜻입니다. prism setup을 실행하세요. 그 경로가 사용 중인 도구가 읽는 파일이 아니라면 CLAUDE_CONFIG_DIR이나 CODEX_HOME을 확인하세요. Codex에서 Codex trust:가 approved가 아니라면 Codex가 승인을 요청할 때 Prism hook을 승인해야 수집됩니다.
업데이트가 적용되지 않았습니다
섹션 제목: “업데이트가 적용되지 않았습니다”prism status를 실행해 Upgrade needed를 읽으세요. yes, the server needs prism <버전> or newer 또는 yes, the server refused the last send, update prism이면 설치와 업데이트대로 새 버전을 설치하고 아무 prism 명령이나 실행하세요. 그러면 prism <버전> 줄에 새 버전이 표시됩니다.
로그인
섹션 제목: “로그인”prism login이 끝나지 않습니다
섹션 제목: “prism login이 끝나지 않습니다”- 기기 승인 화면의 코드가 터미널의 코드와 같은지 확인하세요. 코드는 10분 동안 유효합니다.
The login code expired.가 나오면prism login을 다시 실행하세요. - 이메일 인증을 마친 계정만 기기를 승인할 수 있다는 안내가 보이면, 가입할 때 받은 메일로 주소를 인증한 뒤
prism login을 다시 실행하세요. Could not reach <server>는 네트워크나 주소의 문제를 가리킵니다. 설치 안내 화면의 로그인 명령에--server <주소>가 표시되어 있다면, CLI가 올바른 서비스에 연결되도록 그 명령을 복사해 실행하세요.
prism status가 다시 로그인하라고 합니다
섹션 제목: “prism status가 다시 로그인하라고 합니다”다음 줄은 서버가 이 기기의 로그인을 더 이상 받아들이지 않는다는 뜻입니다.
Login: login expired, run `prism login`과Token: refused by the serverLogin: login required, run `prism login`과Token: valid, but the server refused the last sendConnection: the server refused the loginConnection: reached <server>, login required
prism login을 실행하세요. 기기가 아직 활성이라고 생각된다면 먼저 설정 → 기기를 확인하세요. 로그아웃됨으로 표시된 기기는 그곳에서 또는 prism logout으로 일부러 로그아웃된 것입니다.
prism status가 로그인을 확인하지 못합니다
섹션 제목: “prism status가 로그인을 확인하지 못합니다”Login: not logged in, run `prism login`과Token: none: 저장된 토큰이 없습니다.prism login을 실행하세요.Login: could not be checked, the stored login cannot be read: 키체인이나 토큰 파일을 읽지 못했습니다.prism login을 다시 실행하세요.Token: not checked, a send is running: 백그라운드 전송이 토큰을 쓰고 있었습니다. 잠시 뒤prism status를 다시 실행하세요.Token: could not be checked (...)와Connection: could not reach <server>: 서비스가 응답하지 않았습니다. 네트워크를 확인한 뒤prism status를 다시 실행하세요.
웹 앱에 활동이 나타나지 않습니다
섹션 제목: “웹 앱에 활동이 나타나지 않습니다”다음을 순서대로 확인하고, 처음으로 맞지 않는 항목에서 멈추세요.
- 로그인했나요?
prism status에Login: logged in이 있어야 합니다. 아니라면 위의 로그인 항목을 보세요. - hook이 등록되었나요? CLI로 모든 세션을 기록한다면 사용하는 도구마다
Claude Code hooks: registered in <경로>나Codex hooks: registered in <경로>가 있어야 합니다. 아니라면prism setup을 실행하세요.prism claude나prism codex로 세션을 시작한다면 hook은 등록되지 않은 채로 남으므로 이 확인은 해당하지 않습니다. 플러그인을 쓴다면 대신/prism:status나$prism:status를 실행하세요.Login이logged in이어야 하고, Codex는/hooks에서 hook 4개를 신뢰했어야 합니다. - 새 세션인가요? 로그인한 뒤에, 그리고 모든 세션을 기록하는 방법이라면
prism setup을 실행한 뒤에 새로 시작한 세션이 기록됩니다. 이미 열려 있던 세션은 기록되지 않습니다. 새 세션을 열고 프롬프트를 입력해 에이전트가 턴을 마치게 하세요. - 수집이 꺼져 있나요? Claude Code나 Codex의 환경에
PRISM_OFF=1이 있으면 hook이 동작하지 않습니다. 그 도구를 시작하는 터미널에서echo $PRISM_OFF를 실행하고 셸 프로필도 확인하세요. - hook이 동작했나요?
Last trigger: none yet이면 기록한 hook이 없습니다. 시각이 표시되면 hook은 동작하므로 아래로 이어서 확인하세요. - 전송이 성공했나요?
Last successful send: never이거나Unsent envelopes가 늘어나면 전송이 실패하고 있습니다.Last error와Connection을 읽으세요. 연결 줄이ok가 아니면 네트워크, 프록시, 서비스 주소를 확인하세요. - 건너뛴 세션이 있나요?
Skipped sessions (last 7 days): <n> (<이유>)는 CLI가 전송하지 않은 세션을 보여 줍니다.session_id_too_long은 세션 식별자가 512바이트를 넘어 서버가 거절한다는 뜻입니다. 이런 세션은 Mac에 남고 다시 시도되지 않습니다. - 맞는 맥락인가요?
New sessions are collected under에Personal또는 조직이 표시됩니다. 보고 있는 화면이 그 맥락과 맞는지 확인하세요.
수집은 지연되거나 불완전할 수 있습니다. CLI는 전송하지 못한 기록을 최대 14일, 256 MiB까지만 보관합니다. 버려진 기록과 건너뛴 세션에 대한 메모는 Prism 폴더(macOS에서는 ~/.config/optra-prism)의 flush.log에 남으며, 식별자와 개수만 기록하고 텍스트는 기록하지 않습니다. 이미 버려진 기록은 다시 설치해도 복구되지 않습니다.
분류되지 않은 기록
섹션 제목: “분류되지 않은 기록”Unclassified records (last 7 days): <n> unknown, <m> ignored in <k> sessions는 Claude Code와 Codex의 세션 파일에서 CLI가 분류하지 않은 기록의 수입니다. 이 수는 Mac에만 남습니다. 도움을 요청할 때 이 줄을 함께 알려 주세요.
분석 지연
섹션 제목: “분석 지연”활동은 보이는데 점수는 보이지 않습니다
섹션 제목: “활동은 보이는데 점수는 보이지 않습니다”Prism은 작업 구간이 닫힌 뒤에 평가합니다. 구간은 세션이 끝날 때, /clear를 실행할 때, 마지막 활동 3시간 뒤에 닫힙니다. 그래서 세션을 열어 둔 채라면 첫 프롬프트의 첫 결과가 최대 3시간 걸릴 수 있습니다. 실시간이나 세션에서 활동을 열어 상태를 읽으세요. 점수와 작업 상태와 기간과 데이터 상태를 참고하세요.
점수를 얻으려고 정당한 작업을 바꾸지 마세요.
지원 요청 준비하기
섹션 제목: “지원 요청 준비하기”증상, prism status 출력(플러그인이면 /prism:status나 $prism:status 출력), 운영체제, 사용하는 도구(Claude Code 또는 Codex)와 버전, 설치 방법(CLI 또는 플러그인), 활동이 빠진 시각과 시간대를 포함하세요. 붙여 넣는 내용에서 개인 텍스트는 지우세요. 웹 앱의 지원에서 팀에 문의할 수 있습니다.