콘텐츠로 이동

빠른 시작

Claude Code나 Codex를 연결하고 첫 활동을 확인합니다.

Prism 계정과, 같은 컴퓨터에 설치된 Claude Code 또는 Codex가 필요합니다. macOS에서는 CLI(권장), Claude Code 플러그인, Codex 플러그인 중 어느 것으로든 연결할 수 있습니다. Windows와 Linux에서는 CLI를 macOS에서만 설치할 수 있으므로 플러그인으로 연결합니다. 플러그인은 CLI 없이 쓸 수 있으며, 각 플러그인은 자기 도구의 세션만 기록합니다. 연결 방법은 하나만 있으면 됩니다. 연결하기 전에 데이터 수집과 공개 범위를 읽으세요.

  1. Prism 웹 앱에서 가입하세요. 계정을 만들려면 약관에 동의해야 하며, 입력한 주소로 확인 메일이 발송됩니다. 아래의 로그인 단계에서 기기를 승인하려면 주소 확인을 마친 계정이어야 합니다. Google, GitHub, Microsoft로 가입하면 확인 메일이 없습니다.
  2. 상단의 연결을 여세요. 설치 안내 화면이 열리고, Claude Code와 Codex 연결 아래에서 현재 컴퓨터의 운영체제가 미리 선택되어 있습니다. 선택이 맞지 않으면 다른 운영체제를 선택하세요.
  3. 연결 방법 아래에서 탭을 고르세요. macOS에는 CLI(권장 표시), Claude Code 플러그인, Codex 플러그인 탭이 있습니다. Windows와 Linux에는 CLI 탭이 없고, CLI는 현재 macOS에서만 설치할 수 있다는 안내가 화면에 표시됩니다.

컴퓨터는 한 번만 로그인하면 됩니다. CLI와 두 플러그인은 로그인을 함께 쓰므로, 이 컴퓨터에서 CLI나 다른 플러그인으로 이미 로그인했다면 플러그인의 로그인 단계는 필요 없습니다.

아래 단계는 화면과 이름과 순서가 같습니다.

CLI는 macOS용입니다. 이 절의 명령은 모두 터미널에서 실행합니다.

  1. CLI 설치

    설치 스크립트 탭의 명령을 복사해 실행하세요. Homebrew를 쓴다면 Homebrew 탭의 명령을 복사합니다. 설치 명령은 배포 환경마다 다를 수 있으므로 이 안내서에는 싣지 않습니다.

  2. 터미널에서 로그인

    이 단계에 표시된 명령을 복사해 실행하세요.

    터미널
    prism login

    터미널에 주소와 코드가 출력됩니다. SSH로 접속한 경우가 아니라면 Prism이 브라우저에서 주소를 엽니다. 기기 승인 화면의 코드가 터미널의 코드와 같은지 확인한 뒤 승인을 선택하세요. 코드는 10분 동안 유효합니다. 터미널에 Logged in. The token is stored in the macOS Keychain.이 출력되면 로그인이 끝납니다.

  3. 기록 시작

    두 방법 중 하나를 고르세요. 두 방법을 모두 할 필요는 없습니다.

    세션별로 기록하기

    기록하려는 세션을 claude 대신 prism claude로, codex 대신 prism codex로 시작하세요. 옵션은 뒤에 그대로 붙입니다. claude --resume은 prism claude --resume이 됩니다. 이렇게 시작한 세션만 기록됩니다.

    터미널
    prism claude
    prism 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 플러그인으로 연결하기”
  1. 플러그인 설치

    설치할 위치를 고르세요.

    Claude Code를 실행하고 입력창에 다음 두 명령을 차례로 입력하세요.

    Claude Code
    /plugin marketplace add grumatic/optra-prism-plugin
    /plugin install prism@optra-prism
  2. 로그인

    Claude Code 입력창에 다음을 입력하세요.

    Claude Code
    /prism:setup

    Claude Code에 주소와 코드가 표시됩니다. 주소를 브라우저에서 열고, 화면에 보이는 코드가 같으면 승인하세요. 이 컴퓨터에서 CLI나 Codex 플러그인으로 이미 로그인했다면 이 단계는 필요 없습니다.

    쓰는 배포 환경의 서비스 주소가 기본 주소와 다르면, 설치 안내 화면이 이 단계에서 PRISM_SERVER_URL을 지정해 Claude Code를 시작하는 명령을 보여 줍니다. 그 명령으로 Claude Code를 시작한 뒤 로그인하세요.

  3. 확인

    Claude Code를 새로 실행해 메시지를 한 번 보낸 뒤 입력창에 다음을 입력하세요.

    Claude Code
    /prism:status

    Last trigger 줄에 시각이 보이면 기록되고 있는 것입니다. 로그인한 뒤에 새로 시작한 세션부터 기록됩니다.

  1. 플러그인 설치

    터미널에서 다음 두 명령을 차례로 실행하세요.

    터미널
    codex plugin marketplace add grumatic/optra-prism-plugin
    codex plugin add prism@optra-prism
  2. hook 신뢰

    Codex를 실행하고 입력창에 다음을 입력하세요.

    Codex
    /hooks

    Prism의 hook 4개를 모두 신뢰하세요. 신뢰하지 않은 hook은 Codex가 실행하지 않아 기록되지 않습니다.

  3. 로그인

    Codex 입력창에 다음을 입력하세요. Codex가 명령을 실행해도 되는지 물으면 허락하세요.

    Codex
    $prism:setup

    Codex에 주소와 코드가 표시됩니다. 주소를 브라우저에서 열고, 화면에 보이는 코드가 같으면 승인하세요. 이 컴퓨터에서 CLI나 Claude Code 플러그인으로 이미 로그인했다면 이 단계는 필요 없습니다. 쓰는 배포 환경의 서비스 주소가 기본 주소와 다르면, 화면이 이 단계에서 PRISM_SERVER_URL을 지정해 Codex를 시작하는 명령을 보여 줍니다. 그 명령으로 Codex를 시작한 뒤 로그인하세요.

  4. 확인

    Codex를 새로 실행해 메시지를 한 번 보낸 뒤 입력창에 다음을 입력하세요.

    Codex
    $prism:status

    Last 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와 플러그인을 함께 쓰거나, 업데이트하거나, 제거하려면 설치와 업데이트를 읽으세요.
  • 앞선 플러그인을 쓰고 있나요? 설치와 업데이트를 확인하세요.