관리 설정(Managed settings)

보라색 큰 우산이 노트북이 놓인 똑같은 책상들을 한꺼번에 덮어, 하나의 정책이 모든 컴퓨터를 지키는 모습입니다.

무엇인가요

관리 설정은 조직이 구성원의 모든 에 거는 규칙입니다. IT· 담당이 settings.json 과 같은 모양으로 한 번 쓰고, 모든 컴퓨터에 내려보냅니다. 설정 순서의 맨 위에 있어서, 사용자 파일·프로젝트 파일·--settings 플래그로는 관리 설정의 키를 바꿀 수 없습니다. 회사는 이것으로 .env 파일 읽기 같은 위험한 행동을 막거나, 모든 사람의 우회(bypass) 모드를 한 번에 끕니다.

어떻게 돌아가나요

관리자가 정책을 JSON 으로 씀
콘솔이나 시스템 파일로 내려보냄
모든 컴퓨터의 Claude Code 에 적용
/status 로 출처 확인

이렇게 씁니다

managed-settings.json

시스템 폴더에 두는 파일입니다. 는 /etc/claude-code/, 는 /Library/Application Support/ClaudeCode/ 에 둡니다.
Organization settings > Claude Code > Managed settings

Team·Enterprise 요금제의 Owner 가 JSON 을 붙여 넣는 claude.ai 관리 화면입니다. Claude Code 는 시작할 때 에서 받아 오고, 한 시간마다 새로 받습니다.
allowManagedPermissionRulesOnly

관리 설정에서만 읽는 키입니다. 이 키를 켜면 사용자·프로젝트· 파일의 규칙을 무시합니다.
/status

Setting sources 줄에 어느 관리 설정이 적용되는지 나옵니다. 콘솔이면 (remote), 시스템 파일이면 (file) 로 보입니다.

주의할 점

관리 설정은 Claude Code 안에서 지키는 규칙이지, 단단한 벽이 아닙니다. MDM 으로 관리하지 않는 기기에서는 고친 Claude Code 나 아주 옛 을 실행해 피해 갈 수 있습니다. 관리 설정의 model 은 처음 고르는 기본값일 뿐이라, 고를 수 있는 을 묶으려면 availableModels 를 씁니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서