설치와 업데이트
Prism CLI와 플러그인을 설치하고, 업데이트하고, 제거하고, 함께 쓰는 방법을 설명합니다.
설치하기 전에
섹션 제목: “설치하기 전에”Prism은 세 가지 방법으로 설치할 수 있습니다. CLI를 권장합니다. Claude Code 플러그인과 Codex 플러그인은 CLI를 설치하지 않고 Claude Code나 Codex 안에서 같은 기록 기능을 쓰게 해 줍니다. 각 플러그인은 자기 도구의 세션만 기록합니다.
| 운영체제 | 설치 방법 |
|---|---|
| macOS | CLI(권장), Claude Code 플러그인 또는 Codex 플러그인 |
| Windows | Claude Code 플러그인 또는 Codex 플러그인. CLI는 macOS에서만 설치할 수 있습니다. |
| Linux | Claude Code 플러그인 또는 Codex 플러그인. CLI는 macOS에서만 설치할 수 있습니다. |
같은 컴퓨터에 Claude Code나 Codex가 있어야 합니다. prism setup으로 모든 세션을 기록한다면, 이 명령은 두 도구를 따로 찾습니다. Claude Code는 설정 디렉터리(~/.claude 또는 CLAUDE_CONFIG_DIR로 지정한 디렉터리)나 PATH에 있는 claude 프로그램으로, Codex는 설정 디렉터리(~/.codex 또는 CODEX_HOME으로 지정한 디렉터리)나 PATH에 있는 codex 프로그램으로 찾습니다. 찾지 못한 도구는 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.처럼 그 도구만의 줄을 출력하고 건너뛰며, 찾은 도구에는 hook을 등록합니다.
먼저 Prism 계정을 만들고 CLI가 수집하는 정보를 확인하세요.
CLI 설치하기
섹션 제목: “CLI 설치하기”빠른 시작을 따르세요. 단계의 이름은 상단의 연결로 여는 설치 안내 화면과 같습니다. 단계는 CLI 설치, 터미널에서 로그인, 기록 시작입니다. 설치 명령은 첫 단계의 설치 스크립트 탭과 Homebrew 탭에 있습니다. 설치 명령은 배포 환경마다 다를 수 있으므로 이 안내서에는 싣지 않습니다.
설치하고 로그인한 뒤, 터미널에서 다음을 실행해 결과를 확인하세요.
prism statusprism status에는 Login: logged in이 표시되어야 합니다. 모든 세션 기록하기(prism setup)를 골랐다면, 사용하는 도구마다 Claude Code hooks: registered나 Codex hooks: registered도 표시되어야 합니다. prism claude나 prism codex로만 세션을 시작한다면 hook은 등록되지 않은 상태로 남으며, 이는 정상입니다. 전체 출력은 명령에서 설명합니다.
Claude Code 플러그인 설치하기
섹션 제목: “Claude Code 플러그인 설치하기”빠른 시작의 플러그인 설치, 로그인, 확인 단계를 따르세요. 플러그인은 다른 것을 설치하지 않으며 터미널에 prism 명령도 생기지 않습니다.
Claude Code에 /prism:setup을 입력하면 로그인이 진행됩니다. 로그인이 끝나면 앞선 Prism 플러그인이 이 컴퓨터에 남긴 항목도 찾아 봅니다. 찾은 항목이 있으면 목록을 보여 주고, 동의한 뒤에만 지웁니다. 앞선 플러그인에서 업데이트했다면 앞선 플러그인의 키로 이미 로그인되어 있을 수 있으며, 이 경우 코드를 입력하지 않아도 됩니다. 상태는 /prism:status로 확인하고, 플러그인이 보관하는 항목은 /prism:uninstall로 제거합니다. /prism:uninstall이 하는 일은 Prism 제거하기에서 설명합니다.
Claude Code 플러그인은 Claude Code 세션만 기록합니다. CLI나 Codex를 확인하거나 바꾸지 않습니다.
Codex 플러그인 설치하기
섹션 제목: “Codex 플러그인 설치하기”빠른 시작의 플러그인 설치, hook 신뢰, 로그인, 확인 단계를 따르세요. /hooks에서 Prism의 hook 4개를 신뢰하기 전에는 아무것도 기록되지 않습니다.
$prism:setup으로 로그인하는 동안 Codex가 명령 실행 허락을 물으면 허락하세요. 로그인 명령은 샌드박스 안에서는 실행되지 않습니다. 플러그인은 다른 것을 설치하지 않으며 터미널에 prism 명령도 생기지 않습니다. 상태는 $prism:status로 확인하고, 플러그인이 보관하는 항목은 $prism:uninstall로 제거합니다. Codex 플러그인은 Codex 세션만 기록합니다. CLI나 Claude Code를 확인하거나 바꾸지 않습니다.
codex exec로 시작한 Codex 세션은 실행되는 동안이 아니라 끝날 때 한 번에 수집됩니다.
CLI와 플러그인을 함께 설치했을 때
섹션 제목: “CLI와 플러그인을 함께 설치했을 때”CLI와 두 플러그인은 로그인과 로컬 파일을 함께 쓰므로, 컴퓨터 한 대가 기기 하나입니다. 세 가지 가운데 가장 먼저 설정한 것으로 한 번만 로그인하면 나머지는 그 로그인을 그대로 씁니다. 웹 앱에서는 이 컴퓨터가 설정 → 기기에 한 번만 표시됩니다.
로컬 파일은 하나의 Prism 폴더에 있습니다. macOS와 Linux에서는 ~/.config/optra-prism이며(XDG_CONFIG_HOME이 절대 경로로 지정되어 있으면 그 폴더 안의 optra-prism), Windows에서는 %APPDATA%\optra-prism입니다. 폴더에 무엇이 있는지는 CLI 설정과 파일에서 확인하세요. 로그인 토큰은 macOS에서는 macOS 키체인에, Windows에서는 Windows 자격 증명 관리자에, Linux에서는 시스템 비밀 저장소에 저장됩니다. 이 저장소를 쓸 수 없으면 Prism 폴더 안에 현재 사용자만 읽을 수 있는 파일로 저장됩니다.
하나를 설정해도 다른 것은 바뀌지 않습니다.
prism setup은 Claude Code와 Codex에 hook을 등록합니다. 플러그인을 끄지 않습니다.prism setup remove와prism uninstall은 플러그인을 끈 적이 없으므로 플러그인을 다시 켜지도 않습니다.- CLI의 hook과 플러그인의 hook이 같은 이벤트를 함께 받으면 Prism은 그 이벤트를 한 번만 기록합니다. CLI를 설정한 뒤에 플러그인을 제거할 필요는 없습니다.
각 플러그인은 여전히 자기 도구의 세션만 기록합니다.
업데이트
섹션 제목: “업데이트”Claude Code 플러그인을 쓴다면 새 버전은 플러그인 업데이트로 받습니다. Claude Code에 /plugin marketplace update optra-prism을 입력해 업데이트하세요. 공식이 아닌 마켓플레이스는 자동 업데이트가 기본으로 꺼져 있습니다.
Codex 플러그인은 터미널에서 codex plugin marketplace upgrade optra-prism을 실행해 업데이트하세요. 그러면 Codex가 바뀐 hook을 /hooks에서 다시 신뢰하라고 요청합니다.
CLI를 설치했다면 처음 설치한 방법과 같은 방법으로 새 버전을 설치한 뒤, 터미널에서 아무 prism 명령이나 실행하세요. 새 프로그램은 Prism 폴더의 versions 폴더에 자신을 복사하고, 버전 번호가 현재 버전보다 높으면 hook이 실행하는 버전이 됩니다. 등록과 로그인은 그대로 유지됩니다.
업데이트가 필요한지는 prism status의 Upgrade needed 줄에 표시됩니다.
no: 할 일이 없습니다.yes, the server needs prism <version> or newer; <업데이트 방법>: 해당 버전 이상으로 업데이트하세요.yes, the server refused the last send; <업데이트 방법>: 서버가 이 버전의 마지막 전송을 받아들이지 않았습니다.
<업데이트 방법>에는 CLI라면 설치 스크립트를 다시 실행하거나 brew upgrade를 실행하라는 안내가, 플러그인이라면 위의 플러그인 업데이트 명령이 표시됩니다. CLI보다 새 버전의 Prism 플러그인이 같은 컴퓨터에 설치되어 있으면 prism status에 Plugin newer than this CLI 줄이 나옵니다. 이때는 CLI를 업데이트하세요.
새 버전은 거절된 전송이 세션에 건 차단을 풀고 전송을 다시 시작합니다. 업데이트한 뒤 prism status를 한 번 더 실행해 확인하세요.
Prism 제거하기
섹션 제목: “Prism 제거하기”제거할 범위를 고르세요.
| 명령 | 실행하는 곳 | 제거하는 대상 |
|---|---|---|
prism setup remove |
터미널 | prism setup이 Claude Code 설정 파일(~/.claude/settings.json)과 Codex 설정 파일(~/.codex/config.toml)에 등록한 hook과 Codex 신뢰 기록만 제거합니다. prism setup이 기억한 모든 설정 디렉터리에 적용됩니다. 로그인과 로컬 파일은 그대로 남고, 플러그인도 그대로 남습니다. 다시 등록하려면 prism setup을 실행하세요. |
prism uninstall |
터미널 | hook과 Codex 신뢰 기록, 서버의 이 기기 로그인과 저장된 토큰, Prism 폴더에 Prism이 만든 파일을 제거합니다. 제거할 항목을 보여 주고 확인을 받습니다. 아직 설치되어 있는 플러그인은 이 로그인을 함께 쓰므로 로그아웃됩니다. 계속 기록하려면 /prism:setup이나 $prism:setup으로 다시 로그인하세요. |
/prism:uninstall |
Claude Code 내 | 플러그인에서 이 기기를 로그아웃하고 Prism 폴더의 파일을 지웁니다. 제거할 항목을 보여 주고, 계속하기 전에 확인을 받습니다. |
$prism:uninstall |
Codex 내 | Codex 플러그인에서 /prism:uninstall과 같은 일을 합니다. |
확인하기 전에 prism uninstall과 플러그인 명령은 아직 보내지 못한 기록의 수를 Unsent envelopes that will be lost로 출력합니다. prism uninstall의 확인을 건너뛰려면 --yes를 붙이세요.
플러그인의 제거 명령은 이 컴퓨터에 CLI가 설정되어 있지 않을 때만 로그인과 파일을 제거합니다. prism setup으로 hook을 등록한 컴퓨터라면 CLI가 설정되어 있다고 알려 주고, 아무것도 제거하지 않으며, 기기는 로그인된 상태로 둡니다. 이때는 prism uninstall을 쓰세요. 로그인을 함께 쓰므로 한 플러그인으로 로그인을 제거하면 다른 플러그인도 로그아웃되고, prism setup을 실행한 적 없는 CLI도 로그아웃됩니다. prism login, /prism:setup, $prism:setup으로 다시 로그인하세요.
플러그인의 제거 명령은 플러그인 자체를 지우지 않으므로, 직접 제거하기 전까지 플러그인의 hook은 등록된 채로 남습니다. Claude Code 안에서 /plugin uninstall prism@optra-prism을 입력하거나, 터미널에서 codex plugin remove prism@optra-prism을 실행해 플러그인을 제거하세요.
Homebrew로 설치했다면 prism uninstall은 그 프로그램을 그대로 두고 brew uninstall prism을 실행하라고 안내합니다.
컴퓨터에서 Prism을 제거해도 Prism이 이미 받은 데이터는 삭제되지 않습니다. 데이터를 삭제하려면 데이터 수집과 공개 범위를 참고하세요.
이미 플러그인을 쓰고 있다면
섹션 제목: “이미 플러그인을 쓰고 있다면”Prism은 정해진 날짜부터 지금 버전의 Claude Code용 Prism 플러그인으로는 기록을 받지 않습니다. 웹 앱은 그 날짜를 알리고 설치 안내를 여는 동작이 있는 배너를 표시할 수 있습니다. 계속 기록하려면 두 방법 중 하나를 따르세요.
- 플러그인을 업데이트하고 설정을 실행하세요. Claude Code에
/plugin marketplace update optra-prism을 입력한 뒤/prism:setup을 입력합니다. 업데이트한 플러그인은 앞선 버전이 Claude Code 설정에 쓴 텔레메트리 값을 지웁니다. 앞선 플러그인의 키는 폐기되지 않으며, 업데이트한 플러그인은 그 키로 자동으로 로그인합니다. 이 로그인이 되지 않을 때만/prism:setup이 코드로 로그인하도록 안내합니다. 로그인이 끝나면/prism:setup이 보내지 못한 프롬프트 내용을 포함한 앞선 플러그인의 로컬 항목을 보여 준 뒤 동의를 받고 지웁니다. - CLI를 설치하고 플러그인을 제거하세요. 빠른 시작처럼 CLI를 설치하고
prism login과prism setup을 실행한 뒤 Claude Code에서 플러그인을 제거합니다. 플러그인을 업데이트하지 않았다면prism setup이 플러그인이 쓴 텔레메트리 값을 찾아 동의를 받고 지웁니다.
prism uninstall은 CLI가 만든 것만 제거합니다. prism uninstall과 prism setup remove 모두 어떤 플러그인의 hook이나 설정도 바꾸지 않습니다.