Skip to main content
Code Gateway는 AI 코딩 CLI 도구(Claude Code, Cursor, Codex CLI, Gemini CLI 등)의 LLM API 요청을 Cloosphere를 경유하도록 하는 엔터프라이즈 프록시 게이트웨이입니다. 가드레일, 사용량 추적, 감사 로그, 레이트 리밋을 통해 AI 코딩 도구의 사용을 중앙에서 관리합니다.

​
개념

구성 요소설명
개발자AI 코딩 도구에서 Cloosphere Code Gateway를 BASE_URL로 설정
Code Gateway인증, 가드레일, 레이트 리밋, 사용량 추적을 수행한 후 upstream provider로 프록시
LLM Provider실제 LLM API를 제공하는 서비스 (OpenAI, Anthropic, Azure 등)
Code Gateway는 백엔드 API 전용이며, Cloosphere 웹 UI에서의 채팅과는 별도로 동작합니다. 관리자 설정에서만 구성하며, 사용자는 자신의 코딩 도구에 Cloosphere API 키를 설정하여 사용합니다.

​
활성화 및 설정

​
Code Gateway 활성화

1

관리자 설정 진입

관리자 패널에서 Code Gateway 설정 페이지로 이동합니다.
2

게이트웨이 활성화

“Code Gateway 활성화” 토글을 켭니다.
3

Provider 추가

**”+ Provider 추가”**를 클릭하여 LLM Provider를 등록합니다.
4

보안 설정

허용 모델, 레이트 리밋, 가드레일, 파일 패턴 차단을 구성합니다.

​
전역 설정

설정설명기본값
활성화Code Gateway ON/OFFOFF
허용 모델사용 가능한 모델 목록 (비어있으면 전체 허용)전체
레이트 리밋사용자당 분당 최대 요청 수 (0 = 무제한)0
가드레일적용할 가드레일 ID 목록없음
파일 패턴 차단차단할 파일 패턴 (glob 형식)없음
파일 차단 동작차단 시 동작 (block / warn)block

​
Provider 설정

Provider는 Code Gateway가 요청을 전달할 upstream LLM 서비스입니다. 여러 Provider를 동시에 등록할 수 있으며, 각 Provider는 고유한 provider_id로 식별됩니다.

​
지원 Provider

타입서비스인증 방식
openaiOpenAI, OpenAI-compatible 엔드포인트Bearer token
anthropicAnthropic APIx-api-key 헤더
geminiGoogle Gemini APIx-goog-api-key 헤더
azure_openaiAzure OpenAI Serviceapi-key 헤더
azure_ai_foundryAzure AI FoundryBearer token
vertex_aiGoogle Vertex AI (네이티브)GCP Service Account

​
Provider 추가

설정설명
Provider ID고유 식별자 (URL 경로에 사용)
타입openai / anthropic / gemini
API URLProvider API 엔드포인트
API Key인증 키
모델 ID이 Provider에서 허용할 모델 목록 (비어있으면 전체)
활성화Provider ON/OFF

​
개발자 사용법

개발자는 AI 코딩 도구의 BASE_URL을 Cloosphere Code Gateway로 설정하고, Cloosphere API 키를 사용합니다.

​
엔드포인트 구조

{CLOOSPHERE_URL}/api/v1/code-gateway/{provider_id}/{path}
예시:
  • OpenAI Provider: https://cloosphere.company.com/api/v1/code-gateway/openai/v1/chat/completions
  • Anthropic Provider: https://cloosphere.company.com/api/v1/code-gateway/anthropic/v1/messages

​
인증

Code Gateway는 다음 세 가지 방식으로 API 키를 전달받습니다 (우선순위 순).
방식헤더/파라미터사용 도구
Bearer TokenAuthorization: Bearer {api_key}Claude Code, Cursor, Codex CLI
x-goog-api-keyx-goog-api-key: {api_key}Gemini CLI
Query Parameter?key={api_key}Fallback
API 키는 Cloosphere 사용자 설정의 “API 키” 섹션에서 생성합니다. Provider의 원본 API 키가 아닌 Cloosphere API 키를 사용하세요.

​
도구별 설정 예시

# .bashrc 또는 .zshrc
export ANTHROPIC_BASE_URL="https://cloosphere.company.com/api/v1/code-gateway/anthropic"
export ANTHROPIC_API_KEY="sk-cloosphere-..."

​
보안 기능

​
가드레일

Code Gateway에 가드레일을 적용하여 코딩 도구의 입력에서 PII 감지, 콘텐츠 필터링 등을 수행합니다. 가드레일 관리에서 생성한 가드레일 ID를 지정합니다.

​
허용 모델

특정 모델만 사용하도록 제한합니다. 전역 레벨과 Provider 레벨에서 각각 설정할 수 있습니다.
레벨설명
전역 허용 모델Code Gateway 전체에서 사용 가능한 모델
Provider 허용 모델특정 Provider에서만 사용 가능한 모델
전역과 Provider 모두에서 모델 제한이 설정된 경우, 양쪽 모두에서 허용된 모델만 사용 가능합니다.

​
레이트 리밋

사용자당 분당 최대 요청 수를 제한합니다. 60초 슬라이딩 윈도우 기반으로 동작합니다.
레이트 리밋은 인메모리 방식이므로 서버 재시작 시 리셋됩니다.

​
파일 패턴 차단

코딩 도구가 전송하는 파일 내용에서 특정 패턴의 파일을 차단합니다. glob 형식으로 패턴을 지정합니다.
설정설명예시
패턴차단할 파일 경로 패턴*.env, *credentials*, *.pem
동작block (요청 차단) 또는 warn (로그만 기록)block

​
사용량 추적

Code Gateway를 통한 모든 요청은 자동으로 사용량이 기록됩니다. 관리자는 사용 로그를 조회하여 팀별, 사용자별, 모델별 사용 현황을 확인할 수 있습니다.
항목설명
사용자요청한 사용자
모델사용된 LLM 모델
Provider사용된 Provider
입력/출력 토큰요청/응답 토큰 수
시간요청 시간

​
사용량 통계

기간별 사용량 통계를 조회하여 비용과 사용 추이를 분석합니다.

​
필터

필터설명
사용자특정 사용자로 필터링
모델특정 모델로 필터링
기간시작일 ~ 종료일

​
프록시 처리 흐름

Code Gateway가 요청을 처리하는 전체 흐름입니다.

​
트러블슈팅

관리자 설정에서 Code Gateway가 비활성화 상태입니다. 관리자에게 활성화를 요청하세요.
사용자의 기능 권한에 Code Gateway 접근이 허용되지 않았습니다. 관리자가 그룹 권한 설정에서 features.code_gateway를 활성화해야 합니다.
요청 URL의 provider_id가 등록된 Provider와 일치하지 않습니다. Provider ID를 확인하세요.
요청한 모델이 전역 허용 모델 또는 Provider 허용 모델 목록에 포함되지 않았습니다. 관리자에게 모델 추가를 요청하세요.
분당 요청 한도를 초과했습니다. 잠시 대기 후 재시도하세요.