Claude Code 조직 기본 모델: /model에서 Org default를 안전하게 쓰는 법 | DAKER 커뮤니티

Claude Code 조직 기본 모델: /model에서 Org default를 안전하게 쓰는 법


Claude Code 조직 기본 모델이란, 관리자가 조직 콘솔에서 기본 모델을 정하고 사용자가 직접 고르지 않은 세션에 적용하는 정책을 의미합니다. 2026년 7월 1일 기준 v2.1.196 릴리스는 /model에 "Org default" 또는 "Role default" 표시가 추가됐다고 안내하므로, 팀은 개인 선택과 관리 정책을 분리해 운영해야 합니다.


클로드 코드 조직 기본 모델 대표 카드

이미지: 조직 관리자가 기본 모델을 정하고 개발자가 /model에서 Org default를 확인하는 장면.


문제 상황: 팀마다 다른 모델을 쓰면 왜 리뷰가 흔들릴까?


AI 코딩 리뷰에서 가장 피곤한 문제는 "누구는 같은 프롬프트로 재현되고 누구는 안 된다"는 상태입니다. 모델, permission, MCP 서버, background agent 설정이 섞이면 원인 분리가 어렵습니다. 조직 기본 모델은 이 중 모델 기준선을 맞추는 장치입니다.


핵심 개념: Org default와 개인 모델 선택은 같은 설정이 아니다


Org default는 사용자가 직접 모델을 고르지 않았을 때 적용되는 기본값입니다. 개인이 /model, --model, ANTHROPIC_MODEL 등으로 선택한 값은 별도 확인이 필요합니다. availableModels와 enforceAvailableModels는 선택 가능한 범위를 제한하는 정책이므로, 기본값을 정하는 Org default와 역할이 다릅니다.


이미 DAKER에는 Claude Code availableModels 글, Claude Code auto mode git 안전장치 글, Claude Code MCP 재연결 글이 있습니다. 이 글은 그 위에 조직 기본 모델 운영 기준을 추가합니다.


클로드 코드 조직 기본 모델 정책 비교표

이미지: Org default, 개인 선택, availableModels, enforceAvailableModels의 역할 비교.


단계별 사용법: 조직 기본 모델을 어떻게 배포할까?



짧은 예시는 이렇게 운영할 수 있습니다.


오늘부터 새 Claude Code 세션은 Org default를 기준으로 시작한다. 예외적으로 다른 모델을 고르면 PR 설명에 모델명과 이유를 남긴다.


팀 적용 체크리스트: 어떤 설정을 나눠 봐야 할까?



비교표: 모델 정책 네 가지는 어떻게 다를까?


구분

역할

실무 질문

Org default

조직 기본 모델 지정

새 세션의 기본값은 무엇인가?

개인 선택

사용자가 특정 모델 선택

이 PR은 예외 모델을 썼는가?

availableModels

선택 가능한 모델 제한

팀이 허용한 모델만 보이는가?

enforceAvailableModels

allowlist 강제

잘못된 값일 때 기본 모델만 남는가?


공식 출처: 어디를 기준으로 봐야 할까?


공식 기준은 Anthropic Claude Code GitHub release v2.1.196과 Claude Code settings documentation입니다. 이 글은 2026년 7월 1일 Asia/Seoul 기준으로 확인했으며, 조직 콘솔 UI와 모델명은 이후 변경될 수 있습니다.


FAQ


Org default가 있으면 availableModels는 필요 없나요?


필요할 수 있습니다. Org default는 기본값이고, availableModels는 사용자가 고를 수 있는 범위를 제한합니다. 팀이 허용 모델을 엄격히 관리해야 하면 둘을 함께 봐야 합니다.


/model에 Org default가 보이지 않으면 어떻게 하나요?


먼저 Claude Code 버전이 v2.1.196 이상인지 확인하세요. 그다음 개인 모델 선택, 환경 변수, 관리형 설정이 기본값을 덮어쓰는지 점검합니다.


Role default는 무엇을 뜻하나요?


릴리스 설명상 사용자의 역할 기준 기본값으로 표시될 수 있는 상태입니다. 조직 정책에서 역할별 기본 모델을 나누는 경우 운영 메모에 역할명과 기준 모델을 함께 남기세요.


모델 정책 변경은 PR에 적어야 하나요?


모든 PR에 쓸 필요는 없습니다. 다만 모델 변경 직후, 대규모 리팩터링, 보안 리뷰, 비용 비교 작업에서는 모델명과 날짜를 남기는 편이 재현성에 유리합니다.


조직 기본 모델을 켰다면, 오늘 바로 /model 표시와 저장소 설정을 비교해 팀의 예외 규칙까지 문서화해 두세요.

Redirecting to Claude Code 조직 기본 모델: /model에서 Org default를 안전하게 쓰는 법 | DAKER 커뮤니티...