클로드 코드 /claude-api managed-agents-secure로 매니지드 에이전트 보안 설정 점검하는 법

클로드 코드(Claude Code) 2.1.304(10월 19일)에 /claude-api managed-agents-secure가 들어왔다. 매니지드 에이전트(Managed Agents)로 만든 에이전트의 설정을 앤트로픽이 공개한 보안 가이드와 비교해 준다. 설정은 하나도 바꾸지 않으니 이미 운영 중인 에이전트에 돌려도 괜찮다.

1. 클로드 코드 버전이 2.1.304 이상인지 확인한다.

claude --version

1. 클로드 코드 프롬프트에 명령을 입력한다.

/claude-api managed-agents-secure

1. 결과는 보안 가이드 항목과 맞춰 본다. 가이드가 중요한 순서로 꼽는 설정은 이렇다.

• 직접 관리하는 인프라에서 도구를 돌려야 하는 게 아니면 클라우드 환경을 쓴다.
• 환경의 networking.type은 limited로 두고 allowed_hosts에는 필요한 호스트만 넣는다. 환경을 만들 때 networking을 빼면 unrestricted가 될 수 있어서 요청마다 적는다.
• 자격 증명은 볼트에 두고 요청 헤더로만 넣는다.
• web_fetch·web_search에는 도구마다 allowed_domains를 건다.
• 되돌릴 수 없는 일을 하는 도구는 permission_policy를 always_ask로 둔다.
• 도구 묶음은 default_config.enabled를 false로 두고 필요한 도구만 켠다.
• 세션과 배포마다 예상 비용에 맞춘 budget을 건다.

고칠 점이 나오면 직접 바꾼다. 새 에이전트를 처음 만들 때는 같은 스킬의 /claude-api managed-agents-onboard를 쓴다.