2개월 전 (2026년 8월 15일)

Claude Code Deep Dive - 3(Admin Setup)

0 views

블로그 불러오는 중...

이 블로그는 NextJS 14, Strapi를 이용해 만들었습니다

문의사항은 admin@devchanki.com 으로 주시면 감사 하겠습니다.

Blog

LinkedIn GitHub

문의 보내기

남겨주면 블로그 주인에게 바로 전달돼요.

조직에서 Claude Code 를 관리하는 방법

3장의 경우 조직에서 Claude Code 를 관리하는 방법이다.

설치 방법

조직의 경우 수 많은 PC 를 관리하게 된다. 조직 단위로 배포할 경우에는 운영체제와 업데이트 방식, 버전 통제 등을 고려해 설치 방법을 선택할 필요가 있다.

Claude Code는 크게 다음과 같은 방식으로 설치할 수 있다.

리눅스 플릿

리눅스 플릿(Linux Fleet)은 여러 대의 리눅스 서버, 가상머신, 또는 IoT 기기를 하나의 그룹(함대)으로 묶어 중앙에서 일괄 관리하는 체계라고 한다.

bash

$	sudo	install	-d	-m	0755	/etc/apt/keyrings
$	sudo	curl	-fsSL	https://downloads.claude.ai/keys/claude-code.asc	\-o	/etc/apt/keyrings/claude-code.asc
$	gpg	--show-keys	/etc/apt/keyrings/claude-code.asc
#	지문 대조:	31DD	DE24	DDFA	B679	F42D	7BD2	BAA9	29FF	1A7E	CACE
$	echo	"deb	[signed-by=/etc/apt/keyrings/claude-code.asc]	\
https://downloads.claude.ai/claude-code/apt/stable	stable	main"	\
|	sudo	tee	/etc/apt/sources.list.d/claude-code.list
$	sudo	apt	update	&&	sudo	apt	install	claude-code

사내 미러 운영 외부 다운로드가 막힌 망이나, 감사 요구가 있는 조직은 공식 저장소를 사내 아티팩트 서버로 미러링 한다.

Nexus 저장소 및 Artifactory 등이 있다.

윈도우 대량 배포 윈도우의 경우 WinGet 플릿이 있다.

bash

#	Intune,	SCCM	배포 스크립트 골격
winget	install	Anthropic.ClaudeCode	--silent	\--accept-package-agreements
#	관리 정책은 HKLM	레지스트리로 (Part	5	상세)
#		HKLM\SOFTWARE\Policies\ClaudeCode
#		
관리자 권한 필요,	변조 저항
#	WSL	병행 조직
#		wslInheritsWindowsSettings:	true	로
#		Windows	정책을 WSL까지 상속

표준 컨테이너 이미지 도커 이미지를 이용하여 사용한다.

bash

FROM	ubuntu:24.04
RUN	apt-get	update	&&	apt-get	install	-y	\
curl	git	ca-certificates	ripgrep	jq
RUN	curl	-fsSL	https://claude.ai/install.sh	|	bash	-s	2.1.201
ENV	PATH="/root/.local/bin:${PATH}"
ENV	DISABLE_AUTOUPDATER=1
COPY	managed-settings.json	/etc/claude-code/
WORKDIR	/workspace
#	버전 고정 +	자동갱신 차단 +	정책 내장이 3원칙

도커 이미지에 정책을 넣어 사용한다. 버전 등을 고정해서 사용할 수 있다.

버전 통제

모든 라이브러리나 저장소의 경우에 공급망 공격이 있다. 실제 배포할 수 있는 사람의 계정이 탈취되어 취약점을 가진 라이브러리 버전이 있어 항상 최신 버전을 사용하지 않고 어느정도 검증된 버전을 사용한다.

공급자와 자격증명

1단원에서 인증에 우선순위가 있다고 하였다.

Bedrock 을 사용해 Claude 의 모델을 사용할 수 있고, AWS 내의 IAM 정책으로 특정 모델이라던지 권한을 상세히 컨트롤 할 수 있다.

권한의 경우에도 Access Key 등이 아닌 단기 인증(AWS SSO Center) 등을 사용해 인증할 수 있다. 정적 키의 경우, 유출의 위험과 회전과 관리가 어렵다.

아래 정리를 보면 다음과 같은 형태로 키를 관리한다.

Claude Apps Gateway

왜 게이트웨이를 사용할까? 게이트웨이를 사용 시 한도를 강제화 할 수 있고, OIDC SSO 사인인, OLTP 로 요청등을 관측이 가능하다.

아래와 같은 형태로 Gateway 를 바라보면, 결국 Gateway 에서 컨트롤 하므로 관리가 쉬워질 것이다.

bash

#	클라이언트는 게이트웨이만 바라봄
export	ANTHROPIC_BASE_URL=https://claude-gw.corp.example
$	claude
#	브라우저가 열리고 조직 IdP	로그인 (OIDC)
#	세션 수립,	이후 요청은 게이트웨이가 상류 인증 대행
>	/status
#	공급자:	gateway	경유,	그룹과 허용 모델 확인
#	AWS	프로파일,	정적 키,	리전 설정이 전부 사라짐

위 형태와 같이 IDP 의 그룹으로 모델이라던지 이런 부분을 통제하는 예시이다. 부서별로 모델이나 이런 것을 통제할 수 있다.

개발자별로 지출이라던지 이런 것도 통제가 가능하다.

거버넌스와 정책

managed settings 4채널이 있다.

Server Managed

인증 시점에 기기로 내려오고 매 시간 갱신된다. 인프라가 필요 없으나 Teams, Enterprise 플랜 전용이라고 한다.

위와 같이 JSON 형태로 정의하고, 개발자 로컬과 프로젝트의 값을 병합한다고 한다. 병합의 경우 개발자가 확장을 하나, 개발자가 제거할 수는 없다고 한다. Deny 의 경우 누구도 제거할 수 없다.

관리형 전용 설정

관리형 전용 설정이 있다. https://code.claude.com/docs/ko/permissions#managed-only-settings

위의 링크를 참고하여 여러가지 관리형 설정들을 확인 할 수 있다. 사용할 수 있는 MCP, 명시적 차단 MCP 등 여러가지 컨트롤이 가능하다.

조직의 CLAUDE.md 정책

관리 정책 경로에 CLAUDE.md 를 둘 수 있다고 한다. 행동 지침을 배포하여 개인의 CLAUDE.md 보다 우선으로 적용된다.

감사 훅, 조직 로그

정책 확인

모니터링과 비용

OTel 설정이 가능하다. OTel 설정 시 세션, 토큰,비용 도구, 코드 변화, 이벤트 등을 관리가 가능하다.

SIEM 연계

SIEM이란?

SIEM(보안 정보 및 이벤트 관리)은 조직의 IT 인프라에서 발생하는 보안 데이터를 수집, 집계, 분석하여 위협 탐지와 사고 대응을 지원하는 보안 솔루션입니다. SIEM은 로그 및 이벤트 데이터를 실시간으로 처리하며, 이를 통해 조직은 보안 상태를 종합적으로 파악하고 잠재적인 위협을 신속히 탐지할 수 있습니다.

SIEM은 다양한 소스(서버, 네트워크 장치, 애플리케이션 등)에서 데이터를 수집하고 이를 표준화하여 분석합니다. 이를 통해 이벤트 상관 관계를 파악하고, 보안 사고를 탐지하거나 경고를 생성합니다. 또한, SIEM은 규정 준수를 지원하며, 보안 팀이 감사 및 보고를 효율적으로 수행할 수 있도록 돕습니다.

SIEM 은 위의 내용과 같다. 내용을 수집하면 수집한 내용을 기반으로 특정 규칙에 따라 보한 위협등을 탐지 할 수 있다.