앤트로픽이 10월 1일 클로드 코드 v2.1.287 에서 모드를 정식으로 내놓고 공식 문서를 열었어요. 모드는 플러그인 안에 든 자바스크립트·타입스크립트 함수로 클로드 코드 프로세스 안에서 도구 호출·프롬프트·화면 그리기 이벤트를 지켜보거나 고치거나 대신 처리하고, 샌드박스 없이 사용자 권한으로 파일·프로세스·네트워크에 닿으며, 9월 얼리 액세스 때와 달리 기본으로 켜지고 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS 는 어떤 값이든 무시돼 끄려면 /plugin 에서 하나씩 끄거나 --safe-mode, disableAllHooks 를 써야 해요. 사용자 모드보다 먼저 도는 내장 보호 모드 sec-default 는 관리 설정이 있거나 Team·Enterprise 로 로그인한 경우에만 로드되고, 그때도 deny 규칙은 지키지만 ask 규칙이 물어볼 호출은 모드가 승인할 수 있고 auto 모드에서는 모드가 승인한 호출이 분류기 검사 없이 실행돼요.
- 샌드박스
- 프로그램이 닿을 수 있는 파일·네트워크를 격리해 제한하는 실행 환경
- 관리 설정
- managed settings. 조직 관리자가 배포하고 사용자가 덮어쓸 수 없는 클로드 코드 설정
- deny 규칙
- 특정 도구 호출을 항상 거부하도록 정한 권한 규칙
- ask 규칙
- 특정 도구 호출 전에 사용자에게 허락을 묻도록 정한 권한 규칙
- Bedrock
- 아마존 클라우드에서 클로드 모델을 쓰는 서비스
9월에 환경변수를 0 으로 둬 모드를 막아 뒀다면 v2.1.287 로 올리는 순간 그 설정이 무시되니, 조직은 관리 설정의 pluginConfigs 에 allowManagedModsOnly 를 넣고, API 키나 Bedrock 으로 쓰는 개발자는 관리 설정이 없으면 보호 모드조차 로드되지 않는다는 점을 확인하세요. 모드를 설치하기 전에는 claude plugin validate 로 $.process.run·$.http.fetch·tool.check 를 쓰는지 먼저 읽어 보는 게 좋아요.
- 공식 발표 10월 1일 블로그는 모드를 클로드 코드 동작을 바꾸는 작은 함수로 소개하고, 샌드박스가 없으니 믿을 수 있는 출처의 모드만 설치하라고 적어요. Anthropic
- 조직 관리 관리자용 문서는 allowManagedModsOnly·prependPlugins 로 조직 모드만 돌리는 방법과, deny 규칙을 넣어도 모드의 $.fs.read 로는 .env 를 읽을 수 있다는 한계를 적어요. Anthropic
- 릴리스 v2.1.287 변경 기록에 '플러그인이 더 깊은 동작을 바꿀 수 있는 클로드 모드 추가'가 한 줄로 올라왔어요. GitHub
- 만들기 안내 애디 오스마니가 쓴 안내 글은 맥락 사용량을 보여 주는 창, rm -rf 같은 명령 전에 영향받는 파일을 보여 주는 확인 단계 등 예제 셋으로 모드를 만드는 과정을 보여 줘요. claude.dev