Claude Code 플러그인 동기화 끄기: 웹 사용은 유지하고 로컬 로드를 점검하는 법

TL;DR

핵심 3줄 요약

이 글에서 다룰 내용

기능 정의

언제 점검하면 좋은가

웹에서는 계속 쓰고 싶은 플러그인이지만 로컬 코드 작업에는 필요하지 않을 때 점검합니다. 조직에서 플러그인을 배포한 뒤 로컬 로드 범위를 다시 살필 때도 쓰는 절차입니다.

이 글은 편집부가 제안하는 점검안입니다. 실제 계정에서 설정을 변경하거나 사용 성공을 확인한 후기가 아닙니다.

시작 전 범위 확인

대상은 컴퓨터 한 대의 본인 터미널 환경입니다. 사용자 설정은 본인의 모든 프로젝트에 영향을 줍니다. 다른 사용자나 기기 전체, Cowork·VS Code·cloud·SDK까지 일괄 검증하는 절차는 아닙니다.

기본 파일은 ~/.claude/settings.json 입니다. 다만 CLAUDE_CONFIG_DIR 가 설정되어 있으면 설정·기록·플러그인 위치가 달라지므로 실제 경로부터 확인합니다. 파일이 없다는 이유로 설치에 실패했다고 판단하지 않습니다.

Windows의 기본 폴더 표기는 %USERPROFILE%\.claude 입니다. 여러 플랫폼 경로를 섞지 말고 실제 사용할 환경 하나만 대상으로 삼습니다.

지원 플랜·지역·나이·언어·최소 OS는 이 두 문서만으로 추정하지 않습니다. 현재 계정, 설치 버전, 조직 정책을 별도로 확인합니다.

동기화를 끄고 양쪽을 점검하는 순서

1. 기존 상태와 기준선을 기록합니다

계정은 별칭으로 기록합니다. 설치 버전·실제 설정 경로·기존 키 상태·원복 승인자를 내부 메모에 남깁니다. 웹에서 이미 활성화된 승인 플러그인 하나를 P-A로 부릅니다.

웹의 활성 표시만 적지 말고 변경 전 승인된 짧은 입력과 실제 사용 결과도 별도로 남깁니다. 변경 후에는 같은 입력을 사용합니다. 입력을 바꾸면 플러그인의 사용 가능 여부와 내용 차이가 뒤섞여 비교하기 어렵습니다.

외부 연결 없는 정적 문장 정리 플러그인을 우선 대상으로 제안합니다. 터미널에서는 P-A의 동기화 출처와 버전을 확인합니다. 비민감 일반 질문의 정상 동작도 기록합니다.

적합한 기존 플러그인이 없다면 새로 설치하지 말고 검증 불충분으로 남깁니다.

2. 승인받고 원본을 보관합니다

조직 기기에서는 관리자 승인과 배포 정책 검토가 먼저입니다. 승인 전에는 읽기와 재고 확인까지만 진행합니다. managed 파일·MDM·조직 정책을 임의로 수정하지 않습니다.

기존 설정 원본은 승인된 안전한 내부 위치에 별도 보관합니다. 이는 제품 자동 백업이 아닙니다. 작업 저장과 세션 종료 시점도 사람에게 확인받습니다.

3. 사용자 설정의 한 키만 편집합니다

기존 파일의 JSON 최상위에서 syncClaudeAiPlugins 를 불리언 false 로 추가하거나 수정합니다. 문자열 "false" 와 구분합니다.

설정 파일이 없을 때만 최소 객체 {"syncClaudeAiPlugins": false} 를 사용합니다. 기존 파일 전체를 이 예시로 덮어쓰지 않습니다. 나머지 키 보존, 중복 키, JSON 문법 오류를 대조합니다.

이 키의 false 는 managed· --settings ·user·project-local에서 유효합니다. 공유 프로젝트의 .claude/settings.json 에 쓴 값은 무시됩니다. managed의 true 보다 제한적인 값이 유효한 예외입니다.

조직 필수 플러그인 정책을 우회하는 용도로 사용하지 않습니다.

이 글에서는 user 경로 하나만 편집합니다. 이미 false 라면 시험하려고 true 로 바꾸지 않습니다.

4. 안전하게 종료하고 새 세션을 확인합니다

사람이 기존 터미널 작업을 안전하게 마친 뒤 Claude Code를 새로 시작합니다. 현재 세션이 실제 사용자 설정을 읽었는지, P-A의 동기화 출처가 로드 상태에서 어떻게 표시되는지 직접 확인합니다.

공식 동작은 다운로드 중단과 다음 시작 시 기존 동기화 플러그인의 기본 ~/.claude/plugins/.trash/ 이동, 이후 로드 제외입니다. 다만 새 세션의 실제 다운로드·로드 상태는 별도로 관측해야 합니다.

폴더 이동이나 목록 부재 하나만으로 전체 안전을 판정하지 않습니다. 정확히 확인할 수 없다면 ‘미확인’으로 기록합니다. .trash 는 보조 대조에만 사용합니다.

계정에서 들어온 플러그인은 <name>@synced 식별자로 구분됩니다. 점검 기록에서는 실제 이름 대신 P-A를 사용하되 출처가 동기화인지 직접 설치인지 따로 적습니다. 같은 이름의 직접 설치본이 남았다는 이유로 동기화 설정을 반복해서 바꾸지 않습니다.

설정 파일을 읽은 사실, 새 세션의 플러그인 로드 상태, 폴더 이동 흔적은 서로 다른 증거입니다. 사용자 설정이 빠진 세션이나 다른 인증 경로에서는 애초에 계정 플러그인을 내려받지 않을 수 있습니다. 변경 전 기준선이 없다면 원래 로드되지 않았던 상태를 이번 설정의 차단 성공으로 쓰지 않습니다.

5. 웹 사용과 로컬 일반 작업을 대조합니다

동일 계정의 웹에서 P-A가 기존 활성 상태인지 확인합니다. 새 업로드 없이, 승인된 비민감 텍스트 정리 작업으로 기존 사용이 유지되는지 관측합니다.

터미널에서는 플러그인에 의존하지 않는 비민감 일반 질문도 대조합니다. 웹 활성 표시, 웹 실제 사용, 로컬 일반 작업을 따로 적고 답변 내용의 정확성도 별개로 판단합니다.

가상 입력은 Alpha: review pending / Beta: review pending 처럼 민감하지 않은 두 항목으로 정할 수 있습니다. 이는 저자가 제안하는 입력 예시이지 제품 출력이 아닙니다. 실제 응답이 없으면 결과 칸을 채우지 않으며 두 항목의 상태가 유지됐는지는 사람이 원문과 대조합니다.

웹 스위치 변경이나 새 설치는 하지 않습니다. 관측하지 않은 제품 출력이나 성공 결과를 만들어 기록하지 않습니다.

6. 결과와 원복 조건을 남깁니다

로컬 제한, 웹 정상 사용, 일반 작업, 미확인 항목, 사람 승인자를 내부 메모로 마감합니다. 결과가 상충하면 다른 기기나 프로젝트로 확대하지 않습니다.

원복은 승인 후 이전 한 키의 값으로 돌리거나, 원래 없던 키라면 그 상태를 복원한 뒤 새로 시작해 재시험합니다. true 복구는 재다운로드와 코드 로드를 허용할 수 있으므로 별도 권한 검토가 필요합니다.

.trash 수동 복원, 원격 해제, 인증 환경 수정, 삭제로 해결하려 하지 않습니다.

내부 기록은 대상 별칭, 변경 전후 값, 새 시작 시각, 로컬 로드 관측, 웹 사용 관측, 일반 작업 관측, 남은 문제, 승인자로 나눕니다. 확인 완료·확인 필요·미실행은 저자가 제안하는 상태값입니다. 제품이 자동으로 감사기록이나 이 검수표를 생성한다는 뜻은 아닙니다.

복사해서 쓰는 검토 프롬프트

다음은 일반 채팅에서 관측 메모를 정리하는 선택적 요청입니다. 설정 UI 전용 프롬프트나 실행 명령이 아닙니다. 프롬프트 자체는 보안 설정이 아닙니다.

실전 인사이트

주의할 점

자주 묻는 질문

출처

마무리

플러그인 동기화 끄기는 한 키 변경으로 시작합니다. 완료 여부는 실제 관측으로 판단합니다. 기존 설정을 보존하고 새 터미널 세션, 웹 실제 사용, 로컬 일반 작업을 각각 확인해야 합니다.

한 줄 요약: 웹은 건드리지 않고 로컬 동기화만 제한하되, 실제 관측과 미확인을 구분합니다.