Claude apps gateway for AWS: Claude Code와 Claude Desktop을 위한 자체 호스팅 제어 계층
개발팀 전반에 Claude Code와 Claude Desktop을 배포하기 시작하면 곧 같은 문제에 부딪힙니다. 개발자마다 개별 자격 증명을 발급해야 하고, 설정 파일은 노트북 한 대 한 대에 손으로 밀어 넣어야 하며, 누가 얼마나 쓰는지 추적하거나 상한을 두기가 어렵습니다. 중앙 제어 지점이 없으면 거버넌스는 각 팀이 알아서 구현하는 수준에 머물게 됩니다.
AWS가 이 문제를 겨냥한 Claude apps gateway for AWS를 공개했습니다. Claude Code와 Claude Desktop의 접근 권한, 비용, 정책을 한 곳에서 통제하는 자체 호스팅 제어 계층입니다. 개발자별로 별도의 클라우드 자격 증명을 발급하거나, 설정을 모든 장비에 수동으로 배포하거나, 지출 추적용 도구를 따로 세우던 작업을 대체합니다.
게이트웨이가 어디에 들어가는가
이 게이트웨이는 Anthropic이 제공하며, 개발자가 이미 쓰고 있는 Claude Code CLI 바이너리 안에 함께 들어 있습니다. 클라이언트와 게이트웨이가 같이 빌드되기 때문에 /login 흐름 자체가 게이트웨이를 인식합니다. 로그인 시점에 관리 설정이 자동으로 적용되고, 정책은 모든 요청에서 일관되게 강제됩니다.
배포 방식은 두 갈래입니다. Amazon Bedrock을 통해 배포하면 데이터가 AWS 보안 경계 안에 머무릅니다. Claude Platform on AWS를 통해 배포하면 동일한 게이트웨이 제어를 유지하면서 Claude 플랫폼의 네이티브 경험을 사용합니다. Bedrock으로 연결하면 추론 요청은 설정한 리전의 Amazon Bedrock을 거치며, 계정 내 다른 Bedrock 워크로드와 같은 데이터 처리 및 프라이버시 제어를 따릅니다. Claude Platform on AWS로 연결하면 요청은 Anthropic이 처리합니다.
게이트웨이가 맡는 다섯 가지 역할
게이트웨이는 다섯 가지 핵심 책임을 처리합니다.
신원(Identity) 은 표준을 따르는 OpenID Connect(OIDC) 자격 증명 공급자와 연결됩니다. 개발자가 브라우저 SSO로 로그인하면 게이트웨이가 수명이 짧은 토큰을 발급하고, CLI는 이후 모든 요청에 이 토큰을 사용합니다.
정책(Policy) 은 서버에서 한 번 정의합니다. 클라이언트는 로그인 시점에 정책을 받고, 게이트웨이는 요청마다 이를 강제합니다. 허용 모델, 도구 권한, 기본 설정을 중앙에서 조정할 수 있고, IdP 그룹 단위로 범위를 지정할 수 있습니다.
텔레메트리(Telemetry) 는 클라이언트가 요청마다 사용량 지표를 찍고, 게이트웨이가 이를 OpenTelemetry Protocol(OTLP)로 지정한 수집기에 전달하는 방식입니다. 수집기는 자체 계정의 Amazon CloudWatch나 Amazon Managed Service for Prometheus, 또는 서드파티 플랫폼일 수 있습니다. 텔레메트리를 어디로 보내고 얼마나 보관할지는 사용자가 정합니다.
라우팅(Routing) 에서는 게이트웨이가 상위(upstream) 자격 증명을 보유하고, 개발자를 대신해 추론 요청을 Amazon Bedrock 또는 Claude Platform on AWS로 라우팅합니다. AWS 리전 간 또는 여러 계정 간 페일오버를 선택적으로 구성할 수 있습니다.
지출 상한(Spend caps) 은 조직, 그룹, 사용자 단위로 일간·주간·월간 한도를 설정합니다. 개발자가 한도를 넘으면 게이트웨이가 이후 요청을 차단하며, 기간이 초기화되거나 관리자가 한도를 올릴 때까지 유지됩니다.
온보딩과 오프보딩
권한 관리는 기존 신원 워크플로를 그대로 따릅니다. 접근을 허용하려면 개발자를 IdP에 추가하고, 회수하려면 제거합니다. 제거된 사용자의 세션은 설정한 토큰 수명 안에 만료됩니다. 기본값은 1시간입니다. 개발자 장비에는 장기 비밀 정보가 남지 않습니다.
배포 구성
게이트웨이는 시작 시 YAML 파일 하나를 읽습니다. 이 파일은 여섯 개 섹션으로 구성되고, 비밀 정보는 환경 변수에 둡니다. Bedrock upstream은 컨테이너의 IAM 역할을 사용하므로 관리해야 할 정적 자격 증명이 없습니다.
Claude Platform on AWS로 라우팅하려면 upstreams 블록을 교체합니다.
upstreams:
- provider: anthropicAws
region: us-east-1
workspace_id: wrkspc_...
auth: {} # AWS default credential chain (IAM role)
모델 ID는 Anthropic API와 동일합니다(claude-sonnet-5, claude-opus-4-8). Amazon Bedrock ARN이나 추론 프로파일은 필요하지 않습니다.
게이트웨이는 프라이빗 네트워크 안에서 상태를 갖지 않는(stateless) 컨테이너로 실행되며, Amazon ECS, Amazon EKS, Amazon EC2 위에 올릴 수 있습니다. AWS Certificate Manager의 TLS 인증서를 붙인 내부 Application Load Balancer 뒤에 배치합니다. 로그인 상태와 속도 제한 카운터 같은 수명이 짧은 데이터는 Amazon RDS for PostgreSQL에 저장합니다. 개발자는 프라이빗 네트워크를 통해 게이트웨이에 접근하고, 게이트웨이는 IAM 태스크 역할로 상위 공급자를 대신 호출합니다.
개발자 로그인 경험
배포가 끝나면 개발자는 claude /login을 실행합니다. 관리자는 기기 관리 도구로 관리 설정 파일을 개발자 장비에 배포해 게이트웨이 URL을 미리 채워 두므로, 개발자는 Claude apps gateway 화면을 바로 보게 됩니다. Enter를 누르면 브라우저가 열리고 회사 SSO로 이어집니다.
한 번 로그인하면 연결이 유지됩니다. 세션은 OIDC 리프레시 토큰을 사용해 백그라운드에서 조용히 갱신되므로, 재시작을 하더라도 브라우저 로그인을 반복하지 않고 인증 상태를 유지합니다. 사용자가 IdP에서 제거되면 다음 갱신 시점에 세션이 만료됩니다.
로그인 이후의 동작
로그인한 뒤 개발자는 다른 인증 방식과 똑같이 Claude Code를 사용합니다. 코드를 작성하고, 명령을 실행하고, Claude와 상호작용하는 흐름은 그대로입니다. 차이는 개발자에게 드러나지 않습니다. 모든 요청은 게이트웨이를 통해 인증되고, 구성된 upstream으로 라우팅되며, 중앙에서 설정한 정책을 따릅니다.
/model 선택기에는 정책이 허용한 모델만 표시됩니다. 모델 접근 외에도 정책은 파일 쓰기나 웹 접근 제한 같은 도구 권한을 통제할 수 있습니다. 개발자가 로컬에서 재정의할 수 없는 권한 규칙을 강제하고, 환경 변수나 훅을 배포해 팀 간 워크플로를 표준화하는 것도 가능합니다. 사용량은 각 개발자의 신원에 귀속되고, 지출은 개인 한도에 대비해 추적됩니다. 퇴사자는 IdP에서 제거하는 것으로 설정한 세션 수명 안에 접근 권한이 회수됩니다.
도입 전 확인할 점
게이트웨이는 자체 호스팅이므로 어느 AWS 리전에나 배포할 수 있고, 추론은 Amazon Bedrock 또는 Claude Platform on AWS로 라우팅합니다. 리전 간, 계정 간 구성도 포함됩니다. 데이터가 AWS 보안 경계 안에 머물러야 한다면 Amazon Bedrock을, AWS 인증과 결제를 사용하면서 Anthropic의 네이티브 플랫폼 경험이 필요하다면 Claude Platform on AWS를 선택합니다.
토큰 수명 기본값은 1시간이며, 이는 설정으로 조정할 수 있습니다. 요금 등 세부 사항은 AWS 공식 문서에서 확인할 수 있습니다.
시작하려면 Claude Code CLI를 내려받고 Claude apps gateway 문서를 확인하면 됩니다. 피드백은 Amazon Bedrock용 AWS re:Post나 평소 이용하는 AWS Support 연락처를 통해 보낼 수 있습니다.
원문: Introducing Claude apps gateway for AWS · 발행일 2026-07-08