클로드 코드 플러그인 추천 — 설치 권유 창이 뜨는 조건과 끄는 법

클로드가 명령 하나를 돌렸을 뿐인데 「이 플러그인을 설치하시겠어요」라는 창이 뜨면, 누가 무엇을 보고 권한 건지 궁금해집니다. 권유가 나오는 길은 두 가지이고, 둘 다 조건이 꽤 까다롭습니다.

클로드 코드 플러그인 문서가 개편되면서 추천을 다루는 쪽이 둘 생겼습니다. 하나는 명령줄 도구나 개발 도구 모음을 만드는 쪽이 자기 플러그인을 권하는 방법이고, 다른 하나는 조직 마켓플레이스 운영자가 상황에 맞는 플러그인을 띄우는 방법입니다. 플러그인 설치 글에서 이미 언어 서버를 깔아 둔 프로젝트를 열면 클로드가 먼저 권하기도 한다고 한 줄 적었는데, 그 권유가 어떤 규칙으로 움직이는지 이번에 문서로 확인했습니다.

짧게 정리하면

• 명령줄 도구가 오류 출력에 힌트 줄을 남기면, 클로드 코드는 그 줄을 모델에게 보여 주지 않고 지우고 공식 마켓플레이스 플러그인일 때만 한 번 설치를 권합니다.
• 조직 마켓플레이스는 작업 폴더·읽은 파일·실행한 명령 같은 신호를 정해 둘 수 있고, 관리자가 관리 설정에서 허용해야 추천이 나옵니다.
• 신호 맞추기는 내 컴퓨터 안에서만 하고 결과를 어디에도 보내지 않으며, 어느 경로든 자동 설치는 없고 사용자가 확인해야 설치됩니다.

클로드 코드 공식 문서의 명령줄 도구에서 플러그인 권하기, 조직 플러그인 추천 두 쪽을 처음부터 끝까지 대조했습니다. 설정 이름과 태그 이름은 본문 표기 원칙에 따라 우리말로 풀어 적었습니다.

명령줄 도구가 남기는 힌트 줄

첫째 경로는 도구 제작자 쪽입니다. 명령줄 도구가 클로드 코드 안에서 실행되고 있다는 걸 알아채면, 오류 출력에 한 줄짜리 힌트 태그를 남깁니다. 클로드 코드는 셸과 파워셸 도구의 출력에서 그 줄을 모델이 보기 전에 지우고, 사용자에게 한 번 설치 권유 창을 띄웁니다. 클로드 코드는 자기가 실행하는 명령과 훅 명령에 클로드 코드 표시 환경 변수를 넣고, 2.1.172판부터는 하위 실행 표시 변수도 넣습니다. 도구는 이걸 보고 사람이 직접 실행했을 때는 태그를 내지 않게 거릅니다.

다만 이 경로는 공식 마켓플레이스 이름을 쓰는 마켓플레이스에 올라간 플러그인만 해당합니다. 커뮤니티 마켓플레이스는 포함되지 않습니다. 마켓플레이스 등급과 공식 이름 목록을 다룬 글과 이어지는 대목입니다. 태그는 한 줄을 온전히 차지해야 하고 줄 중간에 끼면 무시되며, 판 번호·종류·플러그인 식별자 세 속성이 모두 필요합니다.

명령줄 힌트 문서 기준, 권유 창이 뜨는 조건

조건	내용
세션 종류	대화형 터미널만, 명령줄 한 번 실행·하위 에이전트·훅 출력에서는 태그만 지우고 창은 안 뜸
플러그인	공식 마켓플레이스 사본에 있고, 아직 안 깔렸고, 정책이 막지 않은 것
사용 분석	꺼져 있으면 권유 없음, 통계 끄기 변수나 외부 클라우드 사업자 세션이 해당
횟수	세션당 한 번, 플러그인마다 답과 상관없이 평생 한 번, 한 기기에서 100개를 넘으면 더 없음
사용자 선택	다시 보지 않기를 고른 적이 없어야 함
작업 위치	내 컴퓨터에서 사람이 지켜보는 세션, 클라우드·원격 제어·에이전트 팀원 세션은 제외

창에는 클로드가 돌린 셸 명령의 첫 단어가 적혀서, 엉뚱한 도구가 권하는 건 아닌지 눈으로 확인할 수 있습니다. 선택지는 설치, 아니요, 아니요 그리고 다시 보지 않기 셋입니다. 설치를 고르면 사용자 범위로 깔리고, 30초 동안 답하지 않으면 아니요로 처리됩니다.

조직 마켓플레이스가 정하는 신호

둘째 경로는 조직용입니다. 마켓플레이스 운영자가 플러그인 항목에 관련성 묶음을 적어 두면, 사용자 세션이 그 신호와 맞을 때 클로드 코드가 그 플러그인을 권합니다. 문서 예시는 테라폼 파일을 읽거나 테라폼 명령을 돌리면 사내 테라폼 도우미 플러그인을 권하는 식입니다. 권유는 세 곳에 나옵니다. 클로드가 답하는 동안 돌아가는 표시 아래의 팁, 작업 폴더가 맞을 때 첫 메시지 전에 뜨는 한 줄 안내, 그리고 플러그인 관리 창 둘러보기 탭 맨 위 고정입니다.

조직 플러그인 추천 문서 기준, 신호 종류

신호	무엇과 맞추나	한도
작업 폴더	세션 작업 폴더의 절대 경로, 깃 저장소 안이면 저장소 기준 상대 경로도	패턴 10개, 각 256자
명령 이름	이번 세션에 클로드가 돌린 셸 명령의 첫 단어, 정확히 일치	10개, 각 64자
호스트 이름	셸 명령 속 웹 주소의 호스트, 대소문자 무시 정확 일치	20개, 각 128자
읽은 파일	이번 세션에 클로드가 읽은 파일 경로 패턴	패턴 10개, 각 256자
패키지 의존성	클로드가 읽은 패키지 목록 파일의 경로와 내용, 둘 다 정규식	10개, 각 256자, 512킬로바이트 넘는 파일은 건너뜀

명령 이름 신호에는 함정이 하나 있습니다. 복합 명령은 맨 앞 명령만 기록되기 때문에, 폴더를 옮긴 뒤 테라폼을 돌리는 명령은 테라폼이 아니라 폴더 이동 명령으로 기록됩니다. 앞에 붙은 환경 변수 지정과 관리자 권한 실행은 건너뛰고 그 다음 단어를 씁니다. 읽은 파일과 패키지 의존성 신호는 클로드가 쓰거나 고친 파일, 자동으로 실리는 지침 파일에도 맞춥니다. 작업 폴더 신호만 첫 메시지 전에 맞을 수 있습니다.

관련성 묶음의 값 하나가 한도를 넘으면 그 플러그인은 설치조차 안 됩니다. 모르는 필드는 무시되어 오래된 클로드 코드도 마켓플레이스를 불러오지만, 알고 있는 필드의 값이 문서의 한도를 넘으면 플러그인 항목 전체가 무효가 되고, 고치기 전까지 사용자는 그 플러그인을 마켓플레이스에서 설치할 수 없습니다. 추천을 붙이려다 배포 자체를 막는 셈이니, 올리기 전에 플러그인 검증 명령으로 마켓플레이스 폴더를 한 번 돌려 보라고 문서가 안내합니다.

관리자가 열어야 보이고, 끄는 법도 따로

마켓플레이스가 관련성을 적어 둬도 관리자가 관리 설정의 추천 허용 마켓플레이스 목록에 그 이름을 넣기 전에는 아무것도 뜨지 않습니다. 공식 마켓플레이스가 아니라면 같은 정책 안에 그 마켓플레이스의 출처도 등록 항목이나 허용 목록 항목으로 적어야 합니다. 같은 이름으로 다른 출처에서 등록된 마켓플레이스가 조직 전체에 추천을 띄우지 못하게 하려는 장치입니다. 허용 목록 표기 규칙은 조직 플러그인 관리 글에 정리해 두었습니다.

횟수도 제한됩니다. 팁과 첫 안내를 합쳐 한 플러그인은 세 세션에 한 번까지만 뜨고, 둘을 합쳐 두 번 보여 준 뒤에는 첫 안내가 멈추며, 설치하면 둘 다 다시 나오지 않습니다. 둘러보기 탭 고정은 신호가 맞는 상태에서 처음 탭을 열 때 한 번이고, 그 뒤로는 평소 순서로 돌아갑니다. 팁과 첫 안내가 거슬린다면 사용자나 프로젝트 설정에서 대기 중 팁 표시를 끄면 둘 다 사라집니다. 둘러보기 탭 고정은 이 설정과 무관합니다.

권유를 받았다고 바로 설치할 이유는 없습니다. 플러그인은 켜 두기만 해도 매 세션 토큰을 차지하니, 플러그인 상시 비용을 재는 방법으로 한 번 확인하고 고르는 편이 낫습니다.

명령줄 힌트로 권유 창을 띄우려면 먼저 플러그인이 마켓플레이스에 올라가 있어야 합니다. 자기 도구와 함께 플러그인을 나눠 주려면 설치 프로그램이나 설치 후 안내에서 마켓플레이스 추가와 플러그인 설치 두 명령을 보여 주라고 공식 문서가 권합니다. 세 가지 배포 경로와 이름을 바꾸면 안 되는 이유를 정리했으니, 추천을 붙이기 전 단계로 함께 보세요.

자주 묻는 질문

추천을 위해 내 작업 내용이 어딘가로 보내지나요

신호 맞추기는 사용자 컴퓨터 안에서 이뤄지고 네트워크 요청을 더하지 않습니다. 어떤 신호가 어떤 값으로 맞았는지는 앤트로픽에도 마켓플레이스 운영자에게도 보고하지 않는다고 문서에 적혀 있습니다.

추천된 플러그인이 저절로 깔리나요

아닙니다. 두 경로 모두 자동 설치는 없고, 사용자가 확인해야 설치됩니다.

명령줄 힌트 권유를 아예 안 보려면요

권유 창에서 다시 보지 않기를 고르면 그 사용자에게는 이후 힌트 권유가 뜨지 않습니다. 통계 전송을 끈 세션에서도 권유는 나오지 않습니다.

사내 도구로 명령줄 힌트를 쓸 수 있나요

명령줄 힌트는 공식 마켓플레이스 이름의 플러그인에만 창이 뜹니다. 사내 플러그인을 권하려면 조직 마켓플레이스의 관련성 신호와 관리 설정의 추천 허용 목록을 쓰는 쪽이 맞습니다.

두 문서를 나란히 읽으면 설계가 꽤 조심스럽다는 인상을 받습니다. 힌트 줄은 모델이 보기 전에 지워서 모델에게는 보이지 않게 하고, 조직 신호는 기기 밖으로 나가지 않으며, 어느 쪽이든 횟수 제한과 끄는 길이 있습니다. 사내 마켓플레이스를 운영한다면 모든 플러그인에 신호를 붙이기보다, 특정 저장소나 특정 명령에서만 필요한 플러그인 몇 개에 좁게 붙이는 게 사용자 입장에서 덜 성가실 것 같습니다.

확인한 곳: 클로드 코드 공식 문서의 명령줄 도구에서 플러그인 권하기(힌트 내기, 형식, 창이 뜨는 조건, 사용자 화면)와 조직 플러그인 추천(작동 방식, 필드와 한도, 폴더·명령·의존성 맞춤, 검증, 관리 설정에서 허용, 사용자 화면과 횟수). 2026년 9월 28일 기준입니다.