CLI 설정과 파일
Prism CLI를 제어하는 데 쓸 수 있는 환경 변수와 파일입니다.
CLI에는 설정 명령이 없습니다. 수집은 명령의 명령과 아래 환경 변수로 켜고 끕니다.
환경 변수
섹션 제목: “환경 변수”| 변수 | 효과 |
|---|---|
PRISM_OFF=1 |
이 값을 붙여 시작한 Claude Code나 Codex 세션에서는 CLI와 플러그인의 Prism hook이 아무것도 기록하지 않습니다. 예: PRISM_OFF=1 claude, PRISM_OFF=1 codex. 다른 값은 효과가 없습니다. |
PRISM_HOME |
모든 prism 명령과 백그라운드 전송 프로세스에서 Prism 폴더(아래 파일 참고)를 대신하는 절대 경로입니다. 로컬 상태, 토큰 파일, 객체 폴더, 설치된 버전이 이 경로에 놓입니다. 비어 있거나 상대 경로이면 오류입니다. prism setup 전에 지정해야 prism setup이 쓰는 hook 명령이 이 경로를 따릅니다. |
PRISM_SECRET_STORE |
값이 file이면 로그인 토큰을 macOS 키체인 대신 Prism 폴더 안의 파일에 저장합니다. 파일은 현재 사용자만 읽을 수 있습니다. |
CLAUDE_CONFIG_DIR |
Claude Code 자체의 변수입니다. 값이 있는 환경에서 prism setup을 실행하면 ~/.claude/settings.json 대신 그 디렉터리의 설정 파일에 hook을 등록하고, 그 디렉터리를 기억합니다. prism setup remove, prism status, prism uninstall은 기억한 모든 디렉터리에 적용됩니다. 다른 프로필은 그 환경에서 prism setup을 한 번 더 실행해 더하세요. |
CODEX_HOME |
Codex 자체의 변수입니다. 값이 있는 환경에서 prism setup을 실행하면 ~/.codex/config.toml 대신 그 디렉터리의 설정 파일에 hook을 등록하고, 그 디렉터리를 기억합니다. 기억한 디렉터리에 적용되는 방식과 다른 프로필을 더하는 방법은 CLAUDE_CONFIG_DIR과 같습니다. |
PRISM_OFF=1은 그 값을 물려받은 프로세스에만 영향을 줍니다. 수집을 계속 끄려면 prism setup remove나 prism uninstall을 사용하세요. 데이터 수집과 공개 범위를 참고하세요.
서비스 주소
섹션 제목: “서비스 주소”prism login --server <주소>는 Prism 서비스의 주소를 지정합니다. CLI는 이 주소를 기억해 이후 로그인에 씁니다. 주소는 https://로 시작해야 하며 http://는 이 컴퓨터를 가리킬 때만 허용됩니다. 사용자 이름이나 비밀번호가 들어 있는 주소는 거부됩니다.
| 경로 | 내용 |
|---|---|
~/.claude/settings.json |
Claude Code 설정입니다. prism setup이 hook을 추가하고 prism setup remove가 정확히 그 hook만 뺍니다. 그 밖의 내용은 건드리지 않으며, enabledPlugins에 있는 Prism 플러그인 항목도 그대로 둡니다. |
~/.codex/config.toml |
Codex 설정입니다. prism setup이 표지로 감싼 hook 블록과 신뢰 기록을 추가하고 prism setup remove가 정확히 그 hook과 신뢰 기록만 뺍니다. 그 밖의 내용은 건드리지 않으며, [plugins."prism@optra-prism"]에 있는 플러그인 항목도 그대로 둡니다. |
~/.config/optra-prism/(macOS와 Linux), %APPDATA%\optra-prism(Windows) |
Prism 폴더입니다. CLI와 두 플러그인이 보관하는 나머지 모든 것이 들어 있습니다. 셋이 이 폴더를 함께 쓰므로 컴퓨터 한 대가 기기 하나이고 로그인도 한 번만 합니다. macOS와 Linux에서 XDG_CONFIG_HOME이 절대 경로로 지정되어 있으면, 첫 번째 경로 대신 그 폴더 안의 optra-prism을 씁니다. 현재 사용자만 읽을 수 있습니다. |
state.db(Prism 폴더 안) |
로컬 상태입니다. 전송을 기다리는 기록과 Prism이 지금까지 읽은 위치가 들어 있습니다. 직접 편집하지 마세요. |
credentials |
로그인 토큰입니다. 시스템 비밀 저장소(macOS 키체인, Windows 자격 증명 관리자, Linux 비밀 저장소)를 쓸 수 없거나 PRISM_SECRET_STORE=file을 지정했을 때만 생깁니다. |
flush.log |
버려진 기록과 건너뛴 세션에 대한 메모입니다. 식별자와 개수만 담습니다. |
objects, shim, versions, current |
통계에 쓰는 변경 파일의 전용 사본과 hook이 실행하는 설치된 버전입니다. |
~/.prism/ |
앞선 Prism 플러그인이 키를 포함한 파일을 보관하던 폴더입니다. CLI와 지금의 플러그인은 이 폴더에 아무것도 보관하지 않으며, prism uninstall도 이 폴더를 건드리지 않습니다. Claude Code 플러그인의 /prism:setup은 앞선 플러그인의 항목을 보여 주고, 동의하면 지웁니다. |
prism status는 이메일 주소와 기기 이름을 출력하므로 공유하고 싶지 않다면 지우세요. prism uninstall은 Prism 폴더에서 CLI가 만든 파일을 제거합니다.