콘텐츠로 이동

명령

prism 명령을 실행하고 결과를 읽습니다.

이 명령들은 Mac의 터미널에서 실행하세요. 등록이나 로그인을 보고하는 명령의 결과는 새 활동이 Prism에 도착했다는 증거가 아닙니다. 도착 여부는 실시간에서 확인하세요.

터미널
prism login
prism login --server <주소>

이 Mac을 Prism 계정에 연결합니다. 터미널에 주소와 코드가 출력됩니다.

Open this URL to approve this device:
<코드가 포함된 주소>
Or open <주소> and enter the code <코드>.
Check that the code shown there is <코드>. Waiting for approval...

SSH로 접속한 경우가 아니라면 Prism이 브라우저에서 주소를 엽니다. 기기 승인 화면의 코드가 같은지 확인하고 승인을 선택하세요. 코드는 10분 동안 유효합니다.

성공하면 터미널에 Logged in. The token is stored in the macOS Keychain.이 출력됩니다. 키체인을 쓸 수 없으면 Logged in. The macOS Keychain is unavailable, so the token is stored in <경로>.가 출력되며, 이 경로는 Prism 폴더(~/.config/optra-prism)의 토큰 파일입니다. 이후 이 기기는 설정 → 기기에 표시됩니다. 이 컴퓨터의 Claude Code 플러그인과 Codex 플러그인은 같은 로그인을 쓰므로, 여기서 로그인했다면 플러그인에서 다시 로그인하지 않아도 되고, 플러그인에서 먼저 로그인했다면 여기서 다시 로그인하지 않아도 됩니다.

--server가 없으면 CLI는 Prism 서비스에 로그인합니다. --server는 다른 서비스 주소를 지정하는 옵션이며, 설치 안내 화면의 로그인 명령에 이 옵션이 표시될 때만 필요합니다. CLI는 이 주소를 기억해 이후 로그인에 씁니다. 주소는 https://로 시작해야 하며, http://는 이 컴퓨터를 가리킬 때만 허용됩니다.

다른 계정이나 다른 서비스로 로그인하면, 이전 로그인으로 전송하려고 대기하던 기록은 버려지고 그 이전에 기록된 세션은 새 로그인으로 전송되지 않습니다.

자주 보는 메시지입니다.

메시지 의미
Could not reach <server>: <reason>. 서비스가 응답하지 않았습니다. 네트워크와 주소를 확인하세요.
The login was denied in the browser. 거절을 선택했거나 요청이 거부되었습니다. prism login을 다시 실행하세요.
The login code expired. 유효 시간 안에 코드가 승인되지 않았습니다. prism login을 다시 실행하세요.
The login was approved but not stored: a flusher is still running; try again in a moment. 백그라운드 전송이 아직 실행 중이었습니다. 바뀐 것은 없습니다. prism login을 다시 실행하세요.
터미널
prism logout

서버에서 이 기기를 로그아웃하고 저장된 토큰을 삭제합니다. 이 컴퓨터의 플러그인도 같은 로그인을 쓰므로 함께 로그아웃됩니다. 터미널에 Logged out.이 출력됩니다. 서버에 연결하지 못하면 Logged out on this computer, but the server could not be told가 출력되며, 이때 기기는 설정 → 기기에서 제거하기 전까지 서버에 등록된 상태로 남습니다. 로그인하지 않은 상태였다면 Not logged in.이 출력됩니다. 전송하려고 대기하던 기록은 버려집니다. hook은 등록된 채로 남지만 다시 로그인하기 전까지 아무것도 전송되지 않으며, 로그아웃한 동안 Claude Code에서 한 작업은 다시 로그인한 뒤에도 전송되지 않습니다.

터미널
prism setup

기록 시작 단계의 모든 세션 기록하기에 해당하는 명령입니다. 필수는 아니며, 대신 prism claude와 prism codex로 세션별로 기록할 수도 있습니다. 터미널에서 prism setup을 한 번 실행하면, 그 뒤에 claude나 codex로 시작하는 세션이 모두 기록됩니다.

컴퓨터에서 찾은 Claude Code와 Codex에 Prism hook을 등록합니다. Claude Code 설정 파일(~/.claude/settings.json 또는 CLAUDE_CONFIG_DIR로 지정한 디렉터리의 파일)에는 hook 다섯 개를, Codex 설정 파일(~/.codex/config.toml 또는 CODEX_HOME으로 지정한 디렉터리의 파일)에는 hook 네 개를 등록하며, 파일의 다른 내용은 바꾸지 않습니다. 도구마다 결과는 다음 중 하나입니다. Codex의 줄은 Claude Code 자리에 Codex가 들어갑니다.

  • Registered the Prism hooks for Claude Code in <경로>.
  • The Prism hooks for Claude Code were already registered in <경로>.
  • Claude Code was not found (no configuration directory and no `claude` on PATH); skipped.
  • Codex was not found (no configuration directory and no `codex` on PATH); skipped.

Codex는 승인하지 않은 hook을 실행하지 않습니다. 지원하는 Codex 버전이면 prism setup이 Prism hook 네 개의 승인 기록을 남겨도 되는지 묻고, 동의하면 Codex trust records written for Codex <버전>; Codex will not ask to approve the Prism hooks.를 출력합니다. 동의하지 않거나 지원하지 않는 버전이면 Codex가 다음 실행에서 승인을 요청하며, 승인하기 전에는 Codex에서 아무것도 수집되지 않습니다.

이전 빌드의 CLI가 등록한 hook이 파일에 남아 있으면 prism setup이 그 hook을 새 hook으로 바꾸고 Removed <n> Prism hook entries of an earlier build from <경로>.를 출력합니다. 하나뿐이면 entries 대신 entry로 출력되고, Codex는 Removed the Prism hooks of an earlier build from <경로>.를 출력합니다.

prism setup은 Prism 플러그인을 끄지 않습니다. 이 컴퓨터의 플러그인은 CLI와 같은 로그인과 같은 로컬 파일을 쓰며, CLI의 hook과 플러그인의 hook이 같은 이벤트를 함께 받으면 한 번만 기록됩니다. 출력에도 이 내용이 A Prism plugin on this machine uses the same state and sign-in as the CLI; one event of a session is recorded once.로 표시됩니다.

로그인하지 않았다면 You are not logged in. Run `prism login` first; nothing is collected until you do.가 덧붙습니다. 마지막에는 hook을 등록한 도구의 목록과 다른 설정 디렉터리를 더하는 방법이 출력됩니다. 다시 실행해도 바뀌는 것은 없습니다.

이 명령은 로그인하지도, 아무것도 전송하지도 않습니다. prism login과 prism setup을 마친 뒤에 새로 시작한 세션이 기록되며, 이미 열려 있던 세션은 기록되지 않습니다. prism setup은 실행한 환경의 설정 디렉터리에 등록하고 그 경로를 기억합니다. 설정 폴더를 바꿔 쓴다면 쓰는 폴더마다 한 번씩 실행하세요. 예를 들면 CLAUDE_CONFIG_DIR=<폴더> prism setup이나 CODEX_HOME=<폴더> prism setup입니다. 한 번의 실행은 폴더 하나에만 적용됩니다.

터미널
prism setup remove

Prism이 등록한 hook만 정확히 제거합니다. Claude Code 설정 파일에서는 Removed the Prism hooks from <경로>.를, Codex 설정 파일에서는 hook과 함께 Prism의 신뢰 기록을 제거하고 Removed the Prism hooks and trust records from <경로>.를 출력합니다. 등록된 것이 없으면 No Prism hooks were registered in <경로>.를 출력합니다. 어떤 플러그인도 바꾸지 않습니다. prism setup이 기억한 모든 설정 디렉터리에 적용되며, 없어진 디렉터리는 Skipped <경로>: the directory no longer exists. It is dropped from Prism's list.처럼 알리고 목록에서 뺍니다. 제거한 뒤에는 Run `prism setup` to register them again.를 출력합니다. 로그인과 로컬 파일은 그대로 남습니다.

터미널
prism status

설정 상태를 다섯 묶음으로 보여 줍니다. 출력은 다음과 같은 모양입니다.

Account
E-mail: you@example.com
Device: <기기 이름>
Login: logged in
Token: valid
New sessions are collected under: Personal
Hosts
Claude Code hooks: registered in <경로>
Claude Code version: <버전>
Earlier plugin OTEL values: none
Codex hooks: registered in <경로>
Codex version: <버전>
Codex trust: approved
Claude Code config dirs recorded by setup: 1
<경로>: hooks registered
Codex homes recorded by setup: 1
<경로>: hooks registered
Collection
Last trigger: <시각> (Stop)
Last successful send: <시각>
Unsent envelopes: 0 (0 B)
Last error: none
Unclassified records (last 7 days): none
Skipped sessions (last 7 days): none
Version
prism <버전>
Upgrade needed: no
Server
Address: <주소>
Connection: ok (collection policy version <n>)

읽는 방법입니다.

  • Login과 Token은 이 Mac이 로그인되어 있는지, 서버가 토큰을 받아들이는지 보여 줍니다. 정상 값은 logged in과 valid입니다.
  • New sessions are collected under는 새 세션이 속하는 계정 맥락으로 Personal 또는 organization <이름>이 표시됩니다.
  • Claude Code hooks와 Codex hooks는 prism setup을 실행했다면 registered로 표시됩니다. prism claude나 prism codex로만 세션을 시작한다면 not registered로 표시되며, 이는 정상입니다. Codex trust는 Codex가 Prism hook을 승인했는지 보여 주며, approved가 아니면 Codex가 승인을 요청하고 그때까지 Codex에서는 수집되지 않습니다.
  • Plugin newer than this CLI는 같은 컴퓨터에 설치된 Prism 플러그인이 CLI보다 새 버전일 때만 나옵니다. 이 줄이 보이면 CLI를 업데이트하세요.
  • Earlier plugin OTEL values는 앞선 플러그인이 Claude Code 설정에 남긴 텔레메트리 값이 있는지 보여 줍니다. 있으면 prism setup으로 지울 수 있습니다.
  • config dirs recorded by setup와 homes recorded by setup은 prism setup이 기억한 설정 디렉터리를 나열합니다. 디렉터리마다 hooks registered, hooks not registered, directory not found 중 하나를 보여 줍니다.
  • Last trigger와 Last successful send는 hook이 동작하는지, 전송이 한 번이라도 성공했는지 보여 줍니다. 첫 세션 전에는 none yet과 never가 정상입니다.
  • Unsent envelopes는 전송을 기다리는 기록의 수입니다. 수가 계속 늘면 전송이 실패하고 있다는 뜻이므로 Last error를 읽으세요.
  • Connection은 서버가 응답했는지 보여 줍니다.

플러그인에서 /prism:status나 $prism:status로 같은 명령을 실행하면 Hosts에는 그 플러그인의 호스트만 Claude Code collection: this plugin이나 Codex collection: this plugin으로 표시됩니다. 로그인, 전송하지 못한 기록, 연결은 CLI와 두 플러그인이 함께 쓰는 것이 표시됩니다. 앞선 플러그인의 키로 자동 로그인한 Claude Code 플러그인에는 Account에 Sign-in: through the earlier plugin's key (key exchange) 줄이 추가됩니다.

각 메시지는 문제 해결에서 설명합니다. 출력을 마친 뒤 prism status는 실행 중인 백그라운드 전송이 없다면 전송을 한 번 시도하게 합니다.

터미널
prism uninstall
prism uninstall --yes

CLI가 Mac에 둔 것을 제거합니다. 대상은 Claude Code와 Codex의 hook과 Codex 신뢰 기록, 서버의 이 기기 로그인과 저장된 토큰, Prism 폴더(~/.config/optra-prism)에 Prism이 보관하는 파일입니다. 이 로그인을 함께 쓰는 플러그인이 아직 설치되어 있다면 그 플러그인도 로그아웃되므로, 플러그인으로 계속 기록하려면 /prism:setup이나 $prism:setup으로 다시 로그인하세요. 앞선 Prism 플러그인이 파일을 보관하던 ~/.prism은 건드리지 않습니다. 먼저 이 목록과 Unsent envelopes that will be lost: <n>을 출력한 뒤 Continue? [y/N]을 묻습니다. y 또는 yes로 답하면 진행하고, 그 밖의 답에는 Cancelled. Nothing was removed.를 출력합니다. --yes는 질문을 건너뜁니다.

Homebrew처럼 Prism이 설치하지 않은 프로그램은 그대로 남으며, 명령이 brew uninstall prism을 실행하라고 안내합니다. Prism이 이미 받은 데이터는 삭제되지 않습니다. 데이터 수집과 공개 범위를 참고하세요.

터미널
prism claude [인자]

해당 세션에 이 버전의 Prism hook을 붙여 Claude Code를 시작합니다. 인자는 claude에 그대로 전달됩니다. 기록 시작 단계의 세션별로 기록하기에 해당하며, prism setup 없이도 동작합니다. prism setup의 hook이나 Claude Code 플러그인이 함께 동작하고 있어도 이렇게 시작한 세션은 한 번만 기록되며, 이 세션에서는 플러그인이 꺼진 채로 시작됩니다. prism setup을 실행했다면 이 명령은 필요하지 않습니다. PATH에 claude가 없으면 `claude` was not found on PATH.라고 알립니다. 서버가 로그인을 더 이상 받아들이지 않으면 Prism is not sending your sessions because the login is no longer valid. Run `prism login`.을 출력하고 Claude Code는 그대로 시작합니다.

터미널
prism codex [인자]

해당 세션에 Prism hook을 붙여 Codex를 시작합니다. 인자는 codex에 그대로 전달됩니다. 지원하는 Codex 버전이면 hook의 승인도 함께 전달하며, 이 승인은 그 세션에만 적용되고 디스크에 남지 않습니다. 기록 시작 단계의 세션별로 기록하기에 해당하며, prism setup 없이도 동작합니다. prism setup의 hook이나 Codex 플러그인이 함께 동작하고 있어도 이렇게 시작한 세션은 한 번만 기록되며, 이 세션에서는 플러그인이 꺼진 채로 시작됩니다. prism setup을 실행했다면 이 명령은 필요하지 않습니다. PATH에 codex가 없으면 `codex` was not found on PATH.라고 알립니다. Prism이 승인 방법을 아는 버전이 아니면 Codex <버전> is not a version Prism knows how to approve hooks for; Codex may ask you to approve the Prism hooks.를 출력하며, Codex가 승인을 요청하면 승인해야 수집됩니다. 서버가 로그인을 더 이상 받아들이지 않을 때의 안내는 prism claude와 같고 Codex는 그대로 시작합니다.