빠른 시작
Claude Code나 Codex를 연결하고 첫 활동을 확인합니다.
Prism 계정과, 같은 컴퓨터에 설치된 Claude Code 또는 Codex가 필요합니다. macOS에서는 CLI(권장), Claude Code 플러그인, Codex 플러그인 중 어느 것으로든 연결할 수 있습니다. Windows와 Linux에서는 CLI를 macOS에서만 설치할 수 있으므로 플러그인으로 연결합니다. 플러그인은 CLI 없이 쓸 수 있으며, 각 플러그인은 자기 도구의 세션만 기록합니다. 연결 방법은 하나만 있으면 됩니다. 연결하기 전에 데이터 수집과 공개 범위를 읽으세요.
설치 안내 열기
섹션 제목: “설치 안내 열기”- Prism 웹 앱에서 가입하세요. 계정을 만들려면 약관에 동의해야 하며, 입력한 주소로 확인 메일이 발송됩니다. 아래의 로그인 단계에서 기기를 승인하려면 주소 확인을 마친 계정이어야 합니다. Google, GitHub, Microsoft로 가입하면 확인 메일이 없습니다.
- 상단의 연결을 여세요. 설치 안내 화면이 열리고, Claude Code와 Codex 연결 아래에서 현재 컴퓨터의 운영체제가 미리 선택되어 있습니다. 선택이 맞지 않으면 다른 운영체제를 선택하세요.
- 연결 방법 아래에서 탭을 고르세요. macOS에는 CLI(권장 표시), Claude Code 플러그인, Codex 플러그인 탭이 있습니다. Windows와 Linux에는 CLI 탭이 없고, CLI는 현재 macOS에서만 설치할 수 있다는 안내가 화면에 표시됩니다.
컴퓨터는 한 번만 로그인하면 됩니다. CLI와 두 플러그인은 로그인을 함께 쓰므로, 이 컴퓨터에서 CLI나 다른 플러그인으로 이미 로그인했다면 플러그인의 로그인 단계는 필요 없습니다.
아래 단계는 화면과 이름과 순서가 같습니다.
CLI로 연결하기
섹션 제목: “CLI로 연결하기”CLI는 macOS용입니다. 이 절의 명령은 모두 터미널에서 실행합니다.
-
CLI 설치
설치 스크립트 탭의 명령을 복사해 실행하세요. Homebrew를 쓴다면 Homebrew 탭의 명령을 복사합니다. 설치 명령은 배포 환경마다 다를 수 있으므로 이 안내서에는 싣지 않습니다.
-
터미널에서 로그인
이 단계에 표시된 명령을 복사해 실행하세요.
터미널 prism login터미널에 주소와 코드가 출력됩니다. SSH로 접속한 경우가 아니라면 Prism이 브라우저에서 주소를 엽니다. 기기 승인 화면의 코드가 터미널의 코드와 같은지 확인한 뒤 승인을 선택하세요. 코드는 10분 동안 유효합니다. 터미널에
Logged in. The token is stored in the macOS Keychain.이 출력되면 로그인이 끝납니다. -
기록 시작
두 방법 중 하나를 고르세요. 두 방법을 모두 할 필요는 없습니다.
세션별로 기록하기
기록하려는 세션을
claude대신prism claude로,codex대신prism codex로 시작하세요. 옵션은 뒤에 그대로 붙입니다.claude --resume은prism claude --resume이 됩니다. 이렇게 시작한 세션만 기록됩니다.터미널 prism claudeprism codex모든 세션 기록하기
터미널에서
prism setup을 한 번 실행하세요. 이 명령은 컴퓨터에서 찾은 Claude Code와 Codex의 설정에 각각 Prism의 hook을 등록하고, 찾지 못한 도구는 건너뜁니다. 그 뒤에claude나codex로 시작하는 세션은 모두 기록됩니다.CLAUDE_CONFIG_DIR이나CODEX_HOME으로 설정 폴더를 바꿔 쓴다면, 쓰는 폴더마다prism setup을 한 번씩 실행하세요. 예를 들어CLAUDE_CONFIG_DIR=<폴더> prism setup이나CODEX_HOME=<폴더> prism setup입니다. 한 번의 실행은 폴더 하나에만 적용됩니다.터미널 prism setup
prism setup은 필수 단계가 아니라 선택입니다. 두 방법의 자세한 내용은 명령에서 설명합니다.
Claude Code 플러그인으로 연결하기
섹션 제목: “Claude Code 플러그인으로 연결하기”-
플러그인 설치
설치할 위치를 고르세요.
Claude Code를 실행하고 입력창에 다음 두 명령을 차례로 입력하세요.
Claude Code /plugin marketplace add grumatic/optra-prism-plugin/plugin install prism@optra-prism터미널에서 다음 두 명령을 차례로 실행하세요. Claude Code가 열려 있었다면 닫고 다시 실행합니다.
터미널 claude plugin marketplace add grumatic/optra-prism-pluginclaude plugin install prism@optra-prism -
로그인
Claude Code 입력창에 다음을 입력하세요.
Claude Code /prism:setupClaude Code에 주소와 코드가 표시됩니다. 주소를 브라우저에서 열고, 화면에 보이는 코드가 같으면 승인하세요. 이 컴퓨터에서 CLI나 Codex 플러그인으로 이미 로그인했다면 이 단계는 필요 없습니다.
쓰는 배포 환경의 서비스 주소가 기본 주소와 다르면, 설치 안내 화면이 이 단계에서
PRISM_SERVER_URL을 지정해 Claude Code를 시작하는 명령을 보여 줍니다. 그 명령으로 Claude Code를 시작한 뒤 로그인하세요. -
확인
Claude Code를 새로 실행해 메시지를 한 번 보낸 뒤 입력창에 다음을 입력하세요.
Claude Code /prism:statusLast trigger줄에 시각이 보이면 기록되고 있는 것입니다. 로그인한 뒤에 새로 시작한 세션부터 기록됩니다.
Codex 플러그인으로 연결하기
섹션 제목: “Codex 플러그인으로 연결하기”-
플러그인 설치
터미널에서 다음 두 명령을 차례로 실행하세요.
터미널 codex plugin marketplace add grumatic/optra-prism-plugincodex plugin add prism@optra-prism -
hook 신뢰
Codex를 실행하고 입력창에 다음을 입력하세요.
Codex /hooksPrism의 hook 4개를 모두 신뢰하세요. 신뢰하지 않은 hook은 Codex가 실행하지 않아 기록되지 않습니다.
-
로그인
Codex 입력창에 다음을 입력하세요. Codex가 명령을 실행해도 되는지 물으면 허락하세요.
Codex $prism:setupCodex에 주소와 코드가 표시됩니다. 주소를 브라우저에서 열고, 화면에 보이는 코드가 같으면 승인하세요. 이 컴퓨터에서 CLI나 Claude Code 플러그인으로 이미 로그인했다면 이 단계는 필요 없습니다. 쓰는 배포 환경의 서비스 주소가 기본 주소와 다르면, 화면이 이 단계에서
PRISM_SERVER_URL을 지정해 Codex를 시작하는 명령을 보여 줍니다. 그 명령으로 Codex를 시작한 뒤 로그인하세요. -
확인
Codex를 새로 실행해 메시지를 한 번 보낸 뒤 입력창에 다음을 입력하세요.
Codex $prism:statusLast trigger줄에 시각이 보이면 기록되고 있는 것입니다. 로그인한 뒤에 새로 시작한 세션부터 기록됩니다.
첫 활동 확인하기
섹션 제목: “첫 활동 확인하기”Claude Code나 Codex를 열고 프롬프트를 입력해 답을 받으세요. Prism에 오신 것을 환영합니다 화면이 세 단계를 보여 주며 스스로 갱신됩니다.
- 기기 연결: 로그인이 승인되었습니다.
- 첫 기록 도착: CLI나 플러그인이 첫 기록을 보냈습니다.
- 첫 프롬프트 도착: Prism이 첫 프롬프트를 받았습니다.
세 단계를 모두 마치면 웹 앱이 실시간으로 이동합니다. 작업의 점수는 더 늦게 표시될 수 있습니다. Prism은 세션이 끝난 뒤, /clear를 실행한 뒤, 또는 마지막 활동 3시간 뒤에 작업을 평가합니다.
터미널에서 prism status를, Claude Code에서 /prism:status를, Codex에서 $prism:status를 실행하면 로그인, 등록, 전송 상태를 언제든 확인할 수 있습니다. 어느 단계가 끝나지 않으면 문제 해결을 참고하세요.
다음 단계
섹션 제목: “다음 단계”- 각
prism명령이 하는 일은 명령에서 확인하세요. - 세션 하나의 수집을 멈추려면
PRISM_OFF=1 claude나PRISM_OFF=1 codex로 시작하세요. 데이터 수집과 공개 범위를 참고하세요. - CLI와 플러그인을 함께 쓰거나, 업데이트하거나, 제거하려면 설치와 업데이트를 읽으세요.
- 앞선 플러그인을 쓰고 있나요? 설치와 업데이트를 확인하세요.