콘텐츠로 이동

문제 해결

설치, 로그인, 수집, 점수에 문제가 있을 때 다음에 할 일을 찾습니다.

보이는 증상에서 시작하고, 설치, 로그인, 수집, 분석 지연 네 가지를 구분해서 확인하세요. 모든 경우에 가장 먼저 확인할 것은 prism status입니다. 전체 출력은 명령에 있습니다.

  1. 새 터미널 창을 열고 prism status를 실행하세요.
  2. 그래도 셸이 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이 등록되므로 사용하는 도구의 줄만 확인하세요.

  1. ~/.claude나 ~/.codex가 있는지, 같은 터미널에서 claude --version이나 codex --version이 동작하는지 확인하세요.
  2. 설정이 다른 곳에 있다면 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 <버전> 줄에 새 버전이 표시됩니다.

  1. 기기 승인 화면의 코드가 터미널의 코드와 같은지 확인하세요. 코드는 10분 동안 유효합니다. The login code expired.가 나오면 prism login을 다시 실행하세요.
  2. 이메일 인증을 마친 계정만 기기를 승인할 수 있다는 안내가 보이면, 가입할 때 받은 메일로 주소를 인증한 뒤 prism login을 다시 실행하세요.
  3. Could not reach <server>는 네트워크나 주소의 문제를 가리킵니다. 설치 안내 화면의 로그인 명령에 --server <주소>가 표시되어 있다면, CLI가 올바른 서비스에 연결되도록 그 명령을 복사해 실행하세요.

prism status가 다시 로그인하라고 합니다

섹션 제목: “prism status가 다시 로그인하라고 합니다”

다음 줄은 서버가 이 기기의 로그인을 더 이상 받아들이지 않는다는 뜻입니다.

  • Login: login expired, run `prism login`과 Token: refused by the server
  • Login: login required, run `prism login`과 Token: valid, but the server refused the last send
  • Connection: the server refused the login
  • Connection: 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를 다시 실행하세요.

웹 앱에 활동이 나타나지 않습니다

섹션 제목: “웹 앱에 활동이 나타나지 않습니다”

다음을 순서대로 확인하고, 처음으로 맞지 않는 항목에서 멈추세요.

  1. 로그인했나요? prism status에 Login: logged in이 있어야 합니다. 아니라면 위의 로그인 항목을 보세요.
  2. 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개를 신뢰했어야 합니다.
  3. 새 세션인가요? 로그인한 뒤에, 그리고 모든 세션을 기록하는 방법이라면 prism setup을 실행한 뒤에 새로 시작한 세션이 기록됩니다. 이미 열려 있던 세션은 기록되지 않습니다. 새 세션을 열고 프롬프트를 입력해 에이전트가 턴을 마치게 하세요.
  4. 수집이 꺼져 있나요? Claude Code나 Codex의 환경에 PRISM_OFF=1이 있으면 hook이 동작하지 않습니다. 그 도구를 시작하는 터미널에서 echo $PRISM_OFF를 실행하고 셸 프로필도 확인하세요.
  5. hook이 동작했나요? Last trigger: none yet이면 기록한 hook이 없습니다. 시각이 표시되면 hook은 동작하므로 아래로 이어서 확인하세요.
  6. 전송이 성공했나요? Last successful send: never이거나 Unsent envelopes가 늘어나면 전송이 실패하고 있습니다. Last error와 Connection을 읽으세요. 연결 줄이 ok가 아니면 네트워크, 프록시, 서비스 주소를 확인하세요.
  7. 건너뛴 세션이 있나요? Skipped sessions (last 7 days): <n> (<이유>)는 CLI가 전송하지 않은 세션을 보여 줍니다. session_id_too_long은 세션 식별자가 512바이트를 넘어 서버가 거절한다는 뜻입니다. 이런 세션은 Mac에 남고 다시 시도되지 않습니다.
  8. 맞는 맥락인가요? 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 또는 플러그인), 활동이 빠진 시각과 시간대를 포함하세요. 붙여 넣는 내용에서 개인 텍스트는 지우세요. 웹 앱의 지원에서 팀에 문의할 수 있습니다.