어두운 공간에서 한 줄기 빛이 겹겹이 세워진 반투명 유리판을 가로지르고, 몇몇 지점이 은은하게 빛나는 모습

Blog

Claude Security 플러그인 도입 전 확인할 것

이정민

10월 16일, Claude Code 문서(Claude Code Docs)에 Claude Security 플러그인 안내 페이지가 공개되었습니다. 이 플러그인은 Claude Code 세션 안에서 여러 에이전트가 함께 코드베이스의 보안 취약점을 찾아 주는 도구입니다. 설치는 Anthropic의 공식 플러그인 마켓플레이스에서 명령 하나로 할 수 있습니다. 이 글에서는 문서에 적힌 내용을 정리하고, 조직이 이 플러그인을 들이기 전에 정해야 할 기준을 함께 살펴봅니다.

찾는 에이전트와 검증하는 에이전트가 나뉩니다

이 플러그인은 문제를 찾는 일과 확인하는 일을 나눕니다. 스캔 중에 발견된 항목은 곧바로 보고서에 실리지 않습니다. 독립된 검증 에이전트가 먼저 그 항목을 분석합니다. 이 분석을 거친 항목만 보고서에 나타납니다.

보안 점검을 해 본 조직이라면 이 구조가 왜 중요한지 아실 것입니다. 점검 도구가 내놓는 항목이 많을수록 담당자가 하나씩 확인하는 시간도 늘어납니다. 검증 단계를 한 번 거친 항목만 올라온다면 사람이 검토할 목록의 성격이 달라집니다.

다만 검증 에이전트도 AI입니다. 보고서에 오른 항목을 그대로 확정된 사실로 받아들여서는 안 됩니다. 어떤 항목을 실제 취약점으로 인정하고 언제까지 고칠지는 여전히 사람이 판단할 일입니다.

실행에 필요한 조건과 사용량

플러그인을 실행하려면 유료 요금제, Anthropic API 접근 권한, 서드파티 제공업체 가운데 하나가 필요합니다. 조직이 이미 어떤 경로로 Claude를 사용하고 있는지에 따라 준비할 일이 달라집니다. 개인 계정으로 흩어져 사용하고 있다면 어느 계정으로 스캔을 돌릴지부터 정해야 합니다.

실행 환경도 확인해야 합니다. 플러그인은 Python 3.9 이상이 PATH에 python3로 잡혀 있어야 동작합니다. 개발자마다 노트북 환경이 다른 조직이라면 배포 전에 표준 개발 환경을 먼저 점검하는 편이 좋습니다.

플러그인은 로컬에서 실행됩니다. 그리고 스캔할 때마다 사용자의 사용량에 포함됩니다. 여러 에이전트가 함께 움직이는 스캔이므로 횟수가 늘면 사용량도 그만큼 늘어납니다. 모든 저장소를 매일 스캔할지, 중요한 저장소만 정해진 시점에 스캔할지 미리 정해 두어야 예산을 관리할 수 있습니다.

관리형 제품과 플러그인은 별개입니다

Claude Security라는 이름의 관리형 제품이 따로 있습니다. 이 관리형 제품은 Enterprise 요금제에서 제공됩니다. 이름이 같아서 혼동하기 쉽지만, 문서는 두 가지를 분명히 구분합니다.

플러그인은 관리형 제품이 닿지 못하는 코드도 스캔할 수 있습니다. 문서는 그 예로 저장소 호스팅 서비스인 GitLab이나 Bitbucket에 있는 저장소를 듭니다. 저장소를 여러 서비스에 나누어 관리하는 조직이라면 이 차이가 실제 선택에 영향을 줍니다.

Enterprise 요금제를 사용하는 조직은 관리형 제품과 플러그인을 함께 놓고, 저장소 위치에 따라 역할을 나누어 볼 수 있습니다. 관리형 제품을 도입하지 않은 조직이라면 플러그인이 먼저 검토할 선택지가 됩니다. 어느 쪽이든 어떤 저장소를 어떤 도구로 점검하는지 한 장의 기준으로 정리해 두면 담당자가 바뀌어도 흐름이 유지됩니다.

결과는 GitHub로 이어지고, 수정은 사람이 합니다

스캔 결과에는 같은 내용을 담은 SARIF 2.1.0 로그가 함께 나옵니다. 이 로그는 GitHub의 코드 스캔 기능인 GitHub code scanning이 읽을 수 있습니다. 이미 GitHub에서 보안 점검 결과를 모아 보고 있다면 이 플러그인의 결과도 같은 자리에서 관리할 수 있습니다.

플러그인은 제안한 패치를 자동으로 적용하지 않습니다. 수정안이 나오더라도 개발자가 내용을 읽고 판단한 뒤 직접 반영해야 합니다. 보안 수정은 다른 기능에 영향을 줄 수 있으므로 이 방식은 조직의 승인 절차와 잘 맞습니다. 수정안을 누가 검토하고 누가 승인하는지 정해 두면 됩니다.

스캔은 비결정적입니다. 같은 코드를 두 번 스캔해도 서로 다른 항목이 나올 수 있습니다. 한 번의 스캔에서 아무것도 나오지 않았다고 코드가 안전하다고 단정할 수 없습니다. 반대로 새로운 항목이 보였다고 해서 그사이 코드가 나빠졌다고 볼 수도 없습니다. 결과를 비교할 때는 이 특성을 담당자 모두가 알고 있어야 합니다.

도입 전에 확인할 것

먼저 요금제와 접근 경로를 확인해야 합니다. 유료 요금제, Anthropic API, 서드파티 제공업체 가운데 어느 경로로 스캔을 실행할지 정하고, 그 경로의 사용량이 누구 예산에서 나가는지도 함께 정해야 합니다. 스캔이 사용량에 포함되므로 점검 주기와 대상 저장소를 미리 정하는 것이 비용 관리의 출발점입니다.

다음은 실행 환경과 저장소 범위입니다. Python 3.9 이상이 준비되어 있는지, 플러그인으로 점검할 저장소가 어디에 있는지 확인합니다. GitLab이나 Bitbucket 저장소가 있다면 관리형 제품과 플러그인 가운데 무엇으로 점검할지 나누어 두는 것이 좋습니다.

결과를 다루는 절차도 필요합니다. 보고서와 SARIF 로그를 어디에 모을지, 각 항목을 누가 판단할지, 수정안을 누가 승인할지 정해야 합니다. 스캔이 비결정적이라는 점을 고려하면 한 번의 결과로 판단하기보다 정기적으로 스캔하고 기존 점검 절차와 함께 보는 방식이 적합합니다.

마지막은 교육입니다. 이 플러그인은 취약점을 찾아 주지만 고칠지 말지는 정해 주지 않습니다. 개발자가 보고서의 항목을 읽고, 실제 위험인지 판단하고, 수정안의 영향을 검토하는 역량이 있어야 도구의 결과가 실제 개선으로 이어집니다. 도입 계획에 이 역량을 기르는 시간을 함께 넣어 두시기를 권합니다.

자주 묻는 질문

Claude Security 플러그인을 사용하려면 어떤 요금제가 필요한가요?
유료 요금제, Anthropic API 접근 권한, 서드파티 제공업체 가운데 하나가 있어야 합니다. 실행 환경에는 Python 3.9 이상이 PATH에 잡혀 있어야 합니다.
스캔 비용은 따로 청구되나요?
플러그인은 로컬에서 실행되고, 스캔할 때마다 사용자의 사용량에 포함됩니다. 스캔 횟수를 사용량 계획에 넣어 두는 것이 좋습니다.
GitLab이나 Bitbucket에 있는 저장소도 스캔할 수 있나요?
가능합니다. 문서는 관리형 Claude Security 제품이 닿지 못하는 GitLab이나 Bitbucket 저장소도 플러그인으로 스캔할 수 있다고 설명합니다.
플러그인이 찾은 취약점을 자동으로 고쳐 주나요?
아닙니다. 플러그인은 제안한 패치를 자동으로 적용하지 않으므로, 개발자가 검토한 뒤 직접 반영해야 합니다.
같은 코드를 다시 스캔하면 같은 결과가 나오나요?
그렇지 않을 수 있습니다. 스캔은 비결정적이어서 같은 코드를 두 번 스캔해도 서로 다른 결과가 나올 수 있습니다.

다른 글

AI 도입 성과를 높이는 1분

참여자의 역할, 규모에 맞추어 과정을 구성합니다.
신청 후에는 담당자가 1영업일 내로 연락드릴게요.

1분 내로 문의하기