설치 스코프

Claude Code는 플러그인을 세 가지 스코프 중 하나에 설치합니다. 이 선택 하나가 Prism이 텔레메트리 설정을 어디에 쓸지도 결정합니다. /prism:setup은 플러그인이 설치된 스코프를 감지해 그 스코프의 설정 파일에만 쓰므로, 스코프는 한 번만 고르면 됩니다.

플러그인 설치 스코프

스코프	설정 파일	팀과 공유
`user`	`~/.claude/settings.json`	아니요 (기본값)
`project`	`.claude/settings.json`	예 (git에 커밋)
`local`	`.claude/settings.local.json`	아니요 (gitignore)

/plugin install prism@optra-prism --scope project

가능한 값은 user(기본값), project, local입니다. /plugin → Discover에서 대화형으로 고를 수도 있습니다.

Prism이 무엇을 어디에 쓰는가

텔레메트리는 Claude Code가 시작될 때 OTEL_* 환경 변수가 있어야 동작하며, 그중 하나인 OTEL_EXPORTER_OTLP_HEADERS에 prism_* 키가 담깁니다. Claude Code는 프로세스 시작 시점에 설정 파일의 "env" 블록에서 이 값들을 읽습니다.

/prism:setup은 플러그인이 설치된 스코프의 설정 파일에 이 값들을 씁니다. user 스코프에 설치하면 모든 프로젝트에서 텔레메트리가 따라오고, project나 local에 설치하면 해당 저장소에만 머뭅니다.

현재 상태 확인

/prism:status

적용 중인 스코프와 OTEL 변수를 담고 있는 설정 파일을 알려 줍니다. both로 보고되면 두 스코프가 경쟁 중이며 Claude Code를 어디서 실행하느냐에 따라 하나만 이깁니다. 이때는 원하지 않는 쪽에서 변수를 제거하세요.

스코프 변경

Claude Code에는 “이동” 명령이 없으므로, 원하는 스코프로 다시 설치합니다.

/plugin uninstall prism@optra-prism --scope user
/plugin install prism@optra-prism --scope project

그다음 /prism:setup prism_YOUR_KEY를 다시 실행해 설정이 새 스코프에 놓이게 하고, Claude Code를 재시작하세요.

팀 배포

플러그인 등록을 project 스코프에 커밋하면, 저장소를 클론한 사람 모두에게 Prism이 활성화됩니다.

{
  "extraKnownMarketplaces": {
    "optra-prism": {
      "source": { "source": "github", "repo": "grumatic/optra-prism-plugin" }
    }
  },
  "enabledPlugins": {
    "prism@optra-prism": true
  }
}

각 사용자는 자기 머신에서 /prism:setup prism_THEIR_KEY를 실행합니다. 저장소는 “여기서 Prism을 쓴다”는 사실만 담고, 누구의 키도 커밋되지 않습니다.