Configuración de la puerta de enlace de aplicaciones Claude

​

Estructura del archivo

• listen: dirección de enlace, URL pública, terminación TLS
• oidc: su proveedor de identidad (IdP), incluido emisor, cliente, mapeo de reclamaciones y quién puede iniciar sesión
• session: los tokens portadores que emite la puerta de enlace, con secreto y duración
• store: PostgreSQL, para concesiones de dispositivos y contadores de límite de velocidad
• upstreams: dónde va la inferencia, ya sea Anthropic, Amazon Bedrock, Claude Platform en AWS, Agent Platform de Google Cloud o Microsoft Foundry

• admin: autenticación de API de administración y retención de límites de gasto
• enforcement: comportamiento de límite de gasto de fallo abierto o fallo cerrado
• pricing: tasas contratadas y un multiplicador de descuento para el medidor de gasto y para las cifras de costo que ven los desarrolladores
• models y auto_include_builtin_models: lista de modelos curada por administrador e IDs por upstream
• managed: políticas de configuración administradas por grupo de IdP
• telemetry: reenvío OTLP a su pila de observabilidad
• access_control, limits, timeouts, rate_limits: permitir/denegar IP, límites de tamaño de solicitud, tiempo hasta el primer byte del upstream y límites de inicio de sesión por IP
• load_test_mode: prueba de carga de la puerta de enlace sin llamar a un proveedor de modelos

​

Expansión de secretos

​

Secciones requeridas

​

listen

​

oidc

​

Solicitudes de IdP a través de un proxy directo

​

Egreso solo de proxy

export HTTPS_PROXY=http://proxy.corp.example.com:3128
export NO_PROXY=
export no_proxy=
export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1

• HTTPS_PROXY o HTTP_PROXY está establecido.
• NO_PROXY y no_proxy están vacíos. Si su plataforma inyecta cualquiera en vainas, establezca ambos en un valor vacío en el contenedor de la puerta de enlace. Listar un recopilador de telemetría en NO_PROXY mantiene el egreso solo de proxy desactivado.
• CLAUDE_GATEWAY_ALLOW_LOOPBACK no está activado. Un recopilador o IdP en el propio loopback de la vaina no se puede combinar con egreso solo de proxy, porque una dirección loopback entregada al proxy sería la del propio host del proxy, así que dé a esos servicios una dirección que el proxy pueda alcanzar en su lugar. Por la misma razón, la puerta de enlace rechaza nombres de estilo localhost directamente mientras el egreso solo de proxy está activo.

​

session

​

store

​

upstreams

​

Mensajes de error de upstream

• Un upstream devolvió un estado en el que la puerta de enlace no conmuta por error: esa respuesta del upstream. La puerta de enlace no intenta más upstreams.
• Cada upstream que la puerta de enlace intentó falló de una manera en la que conmuta por error: el último 429. Cuando ninguno devolvió un 429, la puerta de enlace prefiere, en orden, el último 401 o 403, el último 404, y el último 501. Cuando ninguno devolvió ninguno de esos, el propio 502 de la puerta de enlace, all upstreams failed (N attempted), donde N cuenta cada entrada en upstreams, incluyendo entradas que la puerta de enlace omitió porque no sirven el modelo solicitado.

• 400 o 413 en el sobre de error estándar de Anthropic: el mensaje del upstream, como prompt is too long. Claude Platform en AWS, Agent Platform y Microsoft Foundry devuelven este sobre para rechazos de API de modelo.
• 400 o 413 en la forma propia del proveedor: un token capability_rejected:. Cuando la puerta de enlace no puede clasificar el rechazo, upstream rejected the request en un 400 o request too large for this upstream en un 413.
• Cualquier otro estado: copia genérica por estado, como upstream rate limit exceeded en un 429.

​

API de Anthropic

upstreams:
  - provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}
    # O un portador OAuth (p. ej., un token intercambiado por Workload-Identity-Federation):
    #   oauth_token: ${file:/var/run/secrets/anthropic-oauth-token}
    # base_url: https://api.anthropic.com   # predeterminado; anule para un proxy directo

• api_key: envía x-api-key. Rótelo en la Consola Claude y actualice la variable env.
• oauth_token: envía Authorization: Bearer. Use la forma de portador cuando su organización emita tokens de corta duración en lugar de claves API de larga duración. El portador se lee una vez al iniciar, así que actualice remontando el secreto e reiniciando.

upstreams:
  - provider: anthropic
    auth:
      federation_rule_id: ${ANTHROPIC_FEDERATION_RULE_ID}
      organization_id: ${ANTHROPIC_ORGANIZATION_ID}
      identity_token_file: /var/run/secrets/anthropic/id-token
      # workspace_id: wrkspc_...       # requerido si la regla cubre >1 espacio de trabajo
      # service_account_id: svac_...   # verificación de destino esperado opcional

upstreams:
  - provider: anthropic
    base_url: https://upstream-gateway.internal.example.com
    auth:
      api_key: ${PROXY_KEY}
    forward_user_identity: true        # predeterminado false

​

Amazon Bedrock

upstreams:
  - provider: bedrock
    region: us-east-1
    auth: {}                           # preferido: cadena de credenciales predeterminada de AWS
    # O credenciales explícitas:
    # auth:
    #   aws_access_key_id: ${AWS_AKID}
    #   aws_secret_access_key: ${AWS_SK}
    #   aws_session_token: ${AWS_ST}
    # O un token portador de API de Bedrock:
    # auth:
    #   aws_bearer_token: ${AWS_BEARER_TOKEN}
    # Anule el punto final de bedrock-runtime para implementaciones FIPS o de punto final de VPC:
    # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com

​

Claude Platform en AWS

upstreams:
  - provider: anthropicAws
    region: us-east-1
    workspace_id: wrkspc_...
    auth:
      api_key: ${ANTHROPIC_AWS_API_KEY}   # enviado como x-api-key
    # O SigV4 a través de la cadena de credenciales predeterminada de AWS:
    # auth: {}
    # O credenciales SigV4 explícitas:
    # auth:
    #   aws_access_key_id: ${AWS_ACCESS_KEY_ID}
    #   aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}
    # Anule el punto final derivado:
    # base_url: https://aws-external-anthropic.us-east-1.api.aws

​

Plataforma de agentes de Google Cloud

upstreams:
  - provider: vertex
    region: us-east5
    project_id: example-prod
    auth: {}                           # preferido: Credenciales predeterminadas de aplicación
    # O un archivo de clave de cuenta de servicio:
    # auth: { service_account_json: /secrets/sa.json }
    # Anule el punto final de aiplatform para Private Service Connect:
    # base_url: https://us-east5-aiplatform.p.googleapis.com

​

Microsoft Foundry

upstreams:
  - provider: foundry
    resource: example-foundry              # https://example-foundry.services.ai.azure.com
    auth: { use_azure_ad: true }        # preferido: DefaultAzureCredential / Managed Identity
    # O una clave API:
    # auth:
    #   api_key: ${FOUNDRY_API_KEY}

​

Encabezados estáticos en solicitudes de upstream

upstreams:
  - provider: vertex
    region: us-east5
    project_id: example-prod
    base_url: https://upstream-proxy.internal.example.com
    auth: {}
    headers:
      x-source: claude-apps-gateway
      x-proxy-token: ${PROXY_TOKEN}

• authorization y x-api-key
• host, content-type y user-agent
• Cualquier nombre que comience con anthropic-, x-goog-, x-amz- o x-amzn-

​

Múltiples upstreams

upstreams:
  # Primario: rendimiento aprovisionado en su región de inicio.
  - name: bedrock-pt
    provider: bedrock
    region: us-east-1
    auth: {}
  # Desbordamiento: bajo demanda entre regiones.
  - name: bedrock-od
    provider: bedrock
    region: us-west-2
    auth: {}
  # Cuenta diferente: una asignación de Bedrock separada a través de credenciales de rol asumido.
  - name: bedrock-acct2
    provider: bedrock
    region: us-east-1
    auth:
      aws_access_key_id: ${ACCT2_AKID}
      aws_secret_access_key: ${ACCT2_SK}
  # Último recurso: API de Anthropic directo.
  - name: anthropic-fallback
    provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}

# Los IDs de modelo por upstream se clave en el `name:` del upstream.
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    upstream_model:
      bedrock-pt: arn:aws:bedrock:us-east-1:111111111111:provisioned-model/abcdef
      bedrock-od: us.anthropic.claude-opus-4-8
      bedrock-acct2: us.anthropic.claude-opus-4-8
      anthropic-fallback: claude-opus-4-8

​

Secciones opcionales

​

admin

admin:
  # Claves API estáticas nombradas para los puntos finales de administración, enviadas como x-api-key.
  # El id aparece en el registro de auditoría como admin-key:<id> para que cada clave sea
  # atribuible. Array para rotación: agregue la nueva clave, actualice los clientes,
  # elimine la antigua.
  write_keys:
    - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }
    - { id: ci,        key: "${GATEWAY_ADMIN_WRITE_KEY_CI}" }
  read_keys:
    - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }
  # Grupos de IdP con acceso administrativo completo a través del JWT de gateway normal (sin clave API).
  admin_groups: [platform-finops]
  blocked_message: request an increase at https://go.example.com/claude-limits

​

enforcement

​

pricing

• Claude Code v2.1.227 o posterior en el servidor de gateway. Las versiones anteriores rechazan la clave desconocida al iniciar.
• Un bloque admin: o, en v2.1.268 o posterior, un bloque managed: con al menos una política. El gateway se niega a iniciar con pricing establecido y ninguno de los dos bloques, porque nada lo leería.

pricing:
  multiplier: 0.85
  overrides:
    - upstream: bedrock-eu
      model: claude-sonnet-4-6
      input: 3.30
      output: 16.50
      cache_read: 0.33
      cache_write: 4.125

• Una fila reemplaza el precio de lista para solicitudes que upstream, un upstreams[].name, sirve para model. Esto incluye la tasa más alta de modo rápido, por lo que las solicitudes de modo rápido y estándar se miden con las mismas cuatro tasas.
• Un ID integrado como claude-sonnet-4-6, coincidido como models[].id, cubre cada forma fechada, forma regional de Amazon Bedrock, o forma de Google Cloud’s Agent Platform que el medidor precifica como ese modelo. Cualquier otra cadena, como un alias o un ARN de perfil de inferencia, coincide con el ID que el cliente envió o la cadena enviada al upstream, sin distinción de mayúsculas y minúsculas.
• Donde las filas se superponen, el medidor elige la fila más específica en lugar de la primera fila: una fila cuyo model es la cadena de modelo exacta enviada al upstream, luego una fila que coincide con el ID exacto que el cliente envió, luego una fila que nombra el modelo integrado.
• Un nombre de upstream desconocido falla al iniciar, al igual que dos filas para un upstream que nombran el mismo modelo, incluidas dos ortografías de un modelo integrado. El gateway advierte al iniciar sobre una fila que ningún modelo solicitable puede usar.
• Las solicitudes de búsqueda web permanecen al precio de lista de $0.01; el multiplicador aún se aplica a ellas.

​

Marcar precios hacia arriba

pricing:
  multiplier: 1.2

​

Enviar las tasas a clientes conectados

• Lo que agrega el gateway: a menos que el bloque cli de una política ya establezca modelPricing, el gateway agrega el multiplier y, para cada ID de modelo que un cliente pueda solicitar, la fila de anulación del primer upstream que sirve ese ID. Una tasa que solo un upstream de conmutación por error cobra permanece en el gateway.
• Optar una política: establezca modelPricing en {} en el bloque cli de esa política, y sus desarrolladores permanecen al precio de lista.
• Mantener las tasas propias de una política: una política cuyo bloque cli establece modelPricing con su propio multiplier u overrides mantiene ese modelPricing completo, y el gateway no agrega tasas propias a él.

​

models

auto_include_builtin_models: true   # false: expose only the list below
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    # description: optional text shown in clients that surface it
    upstream_model:
      anthropic: claude-opus-4-8
      bedrock: us.anthropic.claude-opus-4-8   # or an inference-profile ARN
      foundry: your-opus-deployment-name

​

managed

managed:
  policies:
    # Grupos específicos primero.
    - match: { groups: [eng-contractors] }
      cli:
        availableModels: [claude-sonnet-4-6]
        permissions: { deny: ["WebFetch", "WebSearch"] }
    # Captura general predeterminada al final: coincide con todos los que se autenticaron.
    - match: {}
      cli:
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

• Listas de permitidos: availableModels y permissions.allow. La lista de una política específica reemplaza completamente la de la base.
• Listas de denegados y arrays de hooks: permissions.deny, permissions.ask, disabledMcpjsonServers, deniedMcpServers, blockedMarketplaces y cada array de tipo de evento hooks. Estos toman la unión de base y política, por lo que un hook de denegación o auditoría en toda la organización no puede ser eliminado accidentalmente por una anulación por rol.
• Claves de tipo registro: env, modelOverrides y skillOverrides. Estas se fusionan superficialmente, por lo que un bloque env por rol anula las claves que establece y hereda el resto de la base.

• Cuando el valor falta o está vacío, el gateway rechaza la solicitud con el mensaje model is required. Esa comprobación requiere un gateway que ejecute Claude Code v2.1.228 o posterior.
• Cuando el valor está presente pero no es una cadena, el gateway rechaza la solicitud con el mensaje model must be a string. Requiere un gateway que ejecute Claude Code v2.1.221 o posterior.

​

Valores de coincidencia que detienen el gateway al iniciar

• Una lista groups vacía
• Una entrada vacía en groups o en admin_groups
• Un email_domain vacío
• Un email_domain que contiene @, espacios en blanco o una coma. El gateway recorta el valor y elimina una @ inicial antes de esta comprobación. Escriba un dominio desnudo, como example.com.

• Un email_domain vacío: el gateway omitía la comprobación de dominio, por lo que una política con un email_domain vacío y sin lista groups coincidía con cada usuario autenticado
• Una lista groups vacía: la política no coincidía con nadie
• Un email_domain que contiene @, espacios en blanco o una coma: la política no coincidía con nadie
• Una entrada vacía en groups o en admin_groups: la entrada coincidía con un usuario solo cuando la reclamación groups del IdP de ese usuario también contenía una entrada vacía. En admin_groups, esa coincidencia otorgaba acceso administrativo. Si su lista admin_groups nunca contenía una entrada vacía, nadie obtenía acceso administrativo de esta manera.

​

Qué va en cli

managed:
  policies:
    - match: {}
      cli:
        # Acceso a modelos (también aplicado en el lado del servidor en /v1/messages)
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

        # Política de permisos
        permissions:
          deny:
            - "WebFetch"
            - "Read(./.env)"
            - "Read(./secrets/**)"
          disableBypassPermissionsMode: disable   # blocks --dangerously-skip-permissions
        allowManagedPermissionRulesOnly: true     # ignore user/project permission rules

        # Entorno insertado en el proceso CLI. DISABLE_UPDATES bloquea
        # actualizaciones de fondo y manuales; DISABLE_AUTOUPDATER detiene solo
        # actualizaciones de fondo.
        env:
          DISABLE_UPDATES: "1"                    # pin versions via your own distribution

        # Hooks en toda la organización. Los comandos de hooks se ejecutan en máquinas de desarrolladores, no en el
        # gateway, por lo que la ruta debe existir en cada SO cliente en la política.
        hooks:
          PostToolUse:
            - matcher: "Edit|Write"
              hooks:
                - { type: command, command: /usr/local/bin/audit-edit.sh }

• hooks
• Variables env que requieren la aprobación del desarrollador, como variables de proxy y URL base
• configuraciones de ejecución de shell como apiKeyHelper y statusLine
• la configuración de binario de sandbox sandbox.bwrapPath, sandbox.socatPath y sandbox.ripgrep
• Configuraciones de Sandbox que interceptan tráfico, inyectan credenciales o debilitan el aislamiento, como sandbox.network.tlsTerminate y la configuración del puerto proxy. Diálogos de aprobación de seguridad los enumera todos.

​

Servidores MCP en una política

​

Superposición de Claude Desktop

• La lista de modelos, de availableModels
• Herramientas deshabilitadas, de entradas permissions.deny de nombre de herramienta desnudo. Si establece disabledBuiltinTools en el bloque desktop de la política, el gateway sirve la unión de su valor y la lista derivada, por lo que puede deshabilitar más herramientas de esta manera pero no puede volver a habilitar una que deshabilitó a través de permissions.deny
• La lista de permitidos de salida, de sandbox.network.allowedDomains. Si establece coworkEgressAllowedHosts en el bloque desktop de la política, el gateway usa ese valor en lugar de la lista derivada
• Un punto final OTLP que apunta al gateway mismo, y los atributos de identidad del usuario conectado. El gateway retransmite las exportaciones que recibe en ese punto final a sus destinos forward_to. Incluye el punto final y los atributos cuando establece tanto telemetry.forward_to como listen.public_url. Claude Desktop exporta cada señal con una codificación: http/protobuf, o http/json cuando establece OTEL_EXPORTER_OTLP_PROTOCOL o uno de sus variantes por señal en http/json en el env de la política. Antes de Claude Code v2.1.261 en el servidor de gateway, la respuesta establecía http/json independientemente, por lo que un recopilador que acepta solo protobuf rechazaba las exportaciones de Claude Desktop

managed:
  policies:
    - match: { groups: [eng-contractors] }
      cli:
        availableModels: [claude-sonnet-4-6]
      desktop:
        isLocalDevMcpEnabled: false
        disableAutoUpdates: true
        banner: { text: "Contractor build: internal use only" }

• Una clave desconocida
• Una clave reconocida cuyo valor Claude Desktop rechazaría o dejaría caer silenciosamente, como un valor vacío o una subclave mal escrita dentro de una entrada anidada. Antes de v2.1.260, el gateway dejaba caer silenciosamente un campo mal escrito dentro de un objeto anidado de una entrada managedMcpServers u orgPluginSettings en lugar de fallar al iniciar.
• Una clave que el gateway calcula a sí mismo: la conexión de inferencia, la lista de modelos y el relé OTLP. Configure esos a través de upstreams, models y la sección telemetry de forward_to.
• Un alias heredado de una clave actual. En el error de inicio, el gateway nombra la clave canónica a escribir.

• disabledBuiltinTools: el gateway usa la unión de la lista de la base y la lista de la política
• builtinToolPolicy: si establece una herramienta en un valor distinto de allow en la base, el gateway mantiene ese valor incluso si establece allow para la misma herramienta en una política de rol

​

Precedencia con otras fuentes administradas

​

telemetry

telemetry:
  forward_to:
    - url: https://otel-collector.internal.example.com
      headers:
        Authorization: ${OTLP_TOKEN}
      # Opción por señal. Predeterminado: solo métricas.
      metrics: true
      logs: false
      traces: false
    - url: https://api.datadoghq.com/api/v2/otlp
      headers:
        DD-API-KEY: ${DD_API_KEY}

• http://localhost:<port> pasa la validación de configuración, pero la guardia SSRF bloquea cada exportación con ECONNREFUSED_SSRF a menos que establezca CLAUDE_GATEWAY_ALLOW_LOOPBACK=1 en el entorno del gateway
• http://127.0.0.1:<port> o http://[::1]:<port> falla al iniciar a menos que esa variable esté establecida

• CLAUDE_CODE_ENABLE_TELEMETRY=1
• OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER y OTEL_TRACES_EXPORTER, cada uno establecido en otlp si al menos un destino forward_to habilita esa señal y en none de lo contrario
• OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>
• OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

• Variables establecidas localmente: Claude Code aplica las variables insertadas en el nivel administrado, por lo que cada una anula el valor que un desarrollador establece localmente.
• Puntos finales configurados localmente: con la exportación OTLP/HTTP habilitada, el CLI ignora cualquier punto final configurado localmente, independientemente de si el gateway insertó las variables de telemetría. Sus exportaciones van al gateway a menos que una política nombre su recopilador como punto final.

​

Agregar sus propias etiquetas

telemetry:
  forward_to:
    - url: https://otel-collector.internal.example.com
  resource_attributes:
    service.namespace: claude
    deployment.environment.name: prod

• Los nombres usan solo letras, dígitos, ., _ y -
• Los nombres no están reservados. Comparados en cualquier caso de letra, los nombres reservados son todo lo que comienza con user., enduser. o identity., más service.name, service.version, claude.deployment_mode, host.arch, os.type, os.version y wsl.version
• Los valores son ASCII imprimible no vacío sin espacio y ninguno de , ; = \ " %
• Los valores tienen como máximo 255 caracteres tal como los cuenta el gateway después de la codificación en porcentaje, por lo que /, : y @ cada uno cuentan como tres
• Los valores son texto, por lo que cite un número, true o false

​

Exportar directamente a su recopilador

• El punto final proviene del gateway mismo. Si establece la misma variable en un perfil MDM o un managed-settings.json local, las exportaciones permanecen en el relé.
• La URL usa https://, o http:// a una dirección de loopback
• La URL se resuelve en una ruta que termina en /v1/<signal>, sin consulta o fragmento. Claude Code construye esa ruta a sí mismo desde la variable genérica. Utiliza una variable por señal como OTEL_EXPORTER_OTLP_METRICS_ENDPOINT tal como está escrita, por lo que incluya la ruta completa allí.
• La URL no es el host del gateway. Un punto final dirigido al gateway mantiene la ruta de relé y su token de sesión.
• Ni usted ni el desarrollador han configurado otelHeadersHelper en ninguna fuente de configuración. Con un ayudante configurado, cada señal permanece en el relé.

• Si el gateway ya inserta las variables de telemetría, cubren habilitación, selectores y protocolo, y su punto final explícito anula el valor <public_url> insertado. Establezca un selector OTEL_*_EXPORTER en otlp usted mismo solo para una señal que ningún destino forward_to habilita.
• Si no, también establezca CLAUDE_CODE_ENABLE_TELEMETRY=1, los selectores OTEL_*_EXPORTER y OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf.

​

Cuando un destino falla

​

Ajuste HTTP

• Al iniciar: una advertencia en el registro operacional recomienda permitir solo los rangos privados 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10, 127.0.0.0/8, ::1/128 y fc00::/7, más cualquier otro rango interno desde el que se conectan sus desarrolladores. Si vincula el gateway a una dirección de loopback y no establece ni trusted_proxies ni public_url, como en desarrollo local, la advertencia no aparece.
• En tiempo de ejecución: la primera vez que llega una solicitud desde una dirección fuera de esos rangos privados, el gateway registra una advertencia y emite un evento de auditoría access.public_client que lleva la dirección IP del cliente. Ambos se disparan una vez por proceso. Las direcciones de enlace local, 169.254.0.0/16 y fe80::/10, no cuentan como públicas. El gateway responde /healthz y /readyz antes de que se ejecute esta comprobación, por lo que los sondeos de salud desde rangos públicos no la activan.

​

load_test_mode

load_test_mode:
  enabled: true
  reply_tokens: 750     # roughly how many tokens of text each canned reply carries
  reply_seconds: 9.5    # how long a streamed reply takes

​

Ejemplo completo

# Ejecutar con:
#   claude gateway --config gateway.yaml
#
# La verbosidad del registro operativo se controla mediante la variable de entorno
# CLAUDE_GATEWAY_LOG_LEVEL (debug | info | warn | error; predeterminado info). debug
# también registra los nombres de reclamaciones en cada id_token, para diagnóstico de groups_claim.
# No afecta los eventos de auditoría, que siempre se emiten.

listen:
  host: 0.0.0.0
  port: 8080
  public_url: https://claude-gateway.internal.example.com
  # Omita el bloque tls cuando se ejecute detrás de una entrada que termina TLS.
  # tls:
  #   cert: /certs/gateway.crt
  #   key: /certs/gateway.key
  # trusted_proxies:
  #   - 10.0.0.0/8

oidc:
  issuer: https://example.okta.com
  client_id: 0oa1example2
  client_secret: ${OIDC_CLIENT_SECRET}
  allowed_email_domains:
    - example.com
  # Requerido cuando el emisor es el servidor de la organización Okta, cuyos id_tokens
  # pueden omitir correo electrónico y grupos; la puerta de enlace los completa desde /userinfo.
  userinfo_fallback: true
  # allowed_groups: [claude-code-users]
  # Okta emite grupos solo cuando se solicita el alcance `groups` y el
  # filtro de reclamación de grupos de la aplicación los permite. La política de contratistas a continuación
  # coincide con grupos, por lo que el alcance se solicita aquí.
  scopes: [openid, profile, email, offline_access, groups]
  # extra_auth_params: { access_type: offline, prompt: consent }  # Google
  # groups_claim: groups          # Roles de aplicación de Entra: use `roles`
  # email_claim: email

session:
  jwt_secret: ${GATEWAY_JWT_SECRET}   # openssl rand -base64 32
  # ttl_hours: 1

store:
  postgres_url: ${GATEWAY_POSTGRES_URL}
  # max_connections: 5
  # connect_timeout_seconds: 5
  # readiness_grace_seconds: 300   # mantener pasando la verificación de disponibilidad durante una conmutación por error de base de datos

# Habilita /v1/organizations/spend_limits (refleja la API de administrador de Anthropic)
# y cumplimiento de gasto por desarrollador en /v1/messages. Omita para deshabilitar.
# Los límites en sí se establecen a través de la API de administrador, no aquí.
# admin:
#   write_keys:
#     - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }
#   read_keys:
#     - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }
#   admin_groups: [platform-finops]
#   blocked_message: request an increase at https://go.example.com/claude-limits
#   # audit_retention_days: 365
#   # spend_retention_months: 13
#   # identity_retention_days: 90
#   # group_limit_mode: min

# enforcement:
#   fail_closed_on_error: false

# Prueba de carga de esta implementación sin llamar a un proveedor de modelo. Nunca en una
# puerta de enlace que usen desarrolladores: cada solicitud obtiene una respuesta enlatada.
# load_test_mode:
#   enabled: true
#   # reply_tokens: 750
#   # reply_seconds: 9.5

# Medir a tasas contratadas en lugar del precio de lista en USD. Requiere admin: o una
# política managed:. Con managed:, las mismas tasas también van a clientes que han iniciado sesión.
# Las tasas a continuación son marcadores de posición, no precios de contrato reales.
# pricing:
#   multiplier: 0.85
#   overrides:
#     - { upstream: anthropic, model: claude-sonnet-4-6, input: 3.30, output: 16.50, cache_read: 0.33, cache_write: 4.125 }

upstreams:
  - provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}

  # - provider: bedrock
  #   region: us-east-1
  #   auth: {}

  # - provider: anthropicAws
  #   region: us-east-1
  #   workspace_id: wrkspc_...
  #   auth:
  #     api_key: ${ANTHROPIC_AWS_API_KEY}

  # - provider: vertex
  #   region: us-east5
  #   project_id: example-prod
  #   auth: {}

  # - provider: foundry
  #   resource: example-foundry
  #   auth: { use_azure_ad: true }

auto_include_builtin_models: true
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    upstream_model:
      anthropic: claude-opus-4-8
      # bedrock: us.anthropic.claude-opus-4-8
      # anthropicAws: claude-opus-4-8
      # vertex: claude-opus-4-8
      # foundry: <your-opus-deployment-name>
  - id: claude-sonnet-4-6
    label: Claude Sonnet 4.6
    upstream_model:
      anthropic: claude-sonnet-4-6
  - id: claude-haiku-4-5
    label: Claude Haiku 4.5
    upstream_model:
      anthropic: claude-haiku-4-5

managed:
  policies:
    - match: { groups: [contractors] }
      cli:
        availableModels: [claude-haiku-4-5]
        # Restrinja la opción del selector predeterminado a availableModels en lugar de
        # el predeterminado de nivel, para que los contratistas no obtengan un 400 en el predeterminado.
        enforceAvailableModels: true
        # allow aprueba automáticamente estas herramientas; no bloquea el resto.
        # Agregue reglas de negación para restringir herramientas.
        permissions: { allow: [Read, Grep] }
    - match: {}
      cli:
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]
        permissions:
          allow: [Read, Grep, Bash, Edit]
          deny: ["WebFetch"]
        env: { HTTP_PROXY: http://proxy.example.com:8080 }

telemetry:
  forward_to:
    - url: https://otel.internal.example.com:4318
      headers:
        Authorization: Bearer ${OTEL_TOKEN}

​

Configuración administrada del lado del cliente

{
  "forceLoginMethod": "gateway",
  "forceLoginGatewayUrl": "https://claude-gateway.internal.example.com",
  "parentSettingsBehavior": "merge"
}

​

Relacionado

• Descripción general de la puerta de enlace de aplicaciones Claude: inicio rápido y conexión de desarrollador
• Guía de implementación: configuración de IdP, imagen de contenedor, Kubernetes y Cloud Run, y operaciones
• Límites de gasto: límites por desarrollador y la API de administración