콘텐츠로 이동

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가 만든 파일을 제거합니다.