Conectar Claude Code a una puerta de enlace LLM

Apunte Claude Code a la puerta de enlace LLM de su organización. Compruebe si su administrador ya la configuró, o establezca la URL base y las credenciales usted mismo, luego verifique la conexión y corrija los errores de la puerta de enlace.

Una puerta de enlace LLM es un proxy que su organización ejecuta entre Claude Code y el proveedor del modelo. Cuando su organización usa una, Claude Code se autentica en la puerta de enlace con una credencial que su organización emite en lugar de su inicio de sesión personal en claude.ai.

Esta página es para desarrolladores que ejecutan Claude Code a través de una puerta de enlace que opera su organización. Cubre dos caminos: comprobar si su administrador ya la configuró para usted, y configurarla usted mismo cuando no lo haya hecho.

Comprobar una configuración existente

Los administradores pueden distribuir la dirección de la puerta de enlace y la credencial a través de configuración administrada, administración de dispositivos, o un apiKeyHelper, para que Claude Code las recoja al iniciar sin que tenga que configurar nada. Para comprobar si su organización ya lo hizo:

Si ambas líneas en el menú /status se ven bien pero el mensaje a Claude falla, consulte la tabla de solución de problemas.

Configurar Claude Code usted mismo

Para configurar Claude Code para la puerta de enlace usted mismo, necesita de su equipo de puerta de enlace:

• La URL base de la puerta de enlace
• Una credencial: una cadena de clave o token, o un comando que obtenga una
  • Si su equipo de puerta de enlace no dijo qué tipo de credencial es, la sección variable de credencial a continuación cubre qué intentar

Las secciones a continuación cubren la configuración en orden:

• Establecer la variable de credencial y establecer la URL base: las dos variables que toda conexión de puerta de enlace necesita
• Verificar la conexión: confirmar que funciona antes de persistir nada
• Configurar cada superficie: si está usando una superficie además de la CLI de Claude Code, como VS Code, vea cómo configurarla con sus credenciales de puerta de enlace
• Configuración adicional: variables que algunas puertas de enlace necesitan más allá de la URL base y la credencial, como un encabezado personalizado, un asistente de credencial, descubrimiento de modelos, una URL base en formato de proveedor, o desactivar el tráfico fuera de la ruta de la puerta de enlace. Establezca estos solo si su administrador los nombró o su red restringe la salida

Establecer la variable de credencial

Para autenticar Claude Code en la puerta de enlace, establezca su credencial en una variable de entorno. Qué variable depende de lo que su equipo de puerta de enlace le dijo:

Si no le dijeron cuál, use ANTHROPIC_AUTH_TOKEN; la solicitud de verificación a continuación muestra cómo saber si necesita cambiar.

Establecer la URL base y la credencial

Establezca la URL base de la puerta de enlace y la variable de credencial que eligió arriba como variables de entorno. Los ejemplos usan ANTHROPIC_AUTH_TOKEN; cámbielo por ANTHROPIC_API_KEY si esa es la variable que eligió. Puede establecerlos en su shell, que dura una sesión de terminal, o en un archivo de configuración de Claude Code, que persiste en todas partes donde se ejecuta Claude Code.

Para su primera conexión, comience con exportaciones de shell y ejecute la solicitud de verificación antes de mover los valores a un archivo de configuración.

Establecer como variables de entorno de shell

Reemplace los valores con los que su equipo de puerta de enlace le dio:

export ANTHROPIC_BASE_URL=https://llm-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=sk-gateway-key

$env:ANTHROPIC_BASE_URL = "https://llm-gateway.example.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-gateway-key"

Las exportaciones de shell se aplican solo a esa sesión de terminal y a los programas iniciados desde ella. Un editor lanzado desde el dock o el menú Inicio no las verá. Para que los valores persistan en nuevas terminales, agregue las mismas líneas a su perfil de shell, como ~/.zshrc, ~/.bashrc, o su $PROFILE de PowerShell.

Si exporta la puerta de enlace solo en su shell, no llega de manera confiable a los agentes de fondo alojados por el supervisor; vea cómo cada sesión de fondo obtiene su puerta de enlace. Use un archivo de configuración para cualquier puerta de enlace que los agentes de fondo siempre deben enrutar a través de.

Establecer en un archivo de configuración

Para que la configuración se aplique en todas partes donde se ejecuta Claude Code, incluyendo agentes de fondo, establezca las variables en el bloque env de un archivo de configuración en lugar de depender de su shell. Los archivos de configuración tienen diferentes alcances:

• ~/.claude/settings.json se aplica a todos sus proyectos. En Windows la ruta es %USERPROFILE%\.claude\settings.json
• .claude/settings.local.json se aplica a un proyecto. Claude Code lo agrega a su gitignore global cuando guarda una configuración allí; si lo crea a mano o tiene Claude escribirlo, agréguelo a su gitignore usted mismo primero para que no cometa accidentalmente su credencial

El bloque env se ve igual en cualquiera de los archivos:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-gateway-key"
  }
}

Cuando tanto una exportación de shell como un bloque env de archivo de configuración establecen la misma variable, se aplica el valor del archivo de configuración. Ejecute /status para ver qué URL base y fuente de credencial está usando Claude Code.

Verificar la conexión

Con las variables exportadas en su shell, envíe una solicitud de un token a la puerta de enlace directamente. Esto confirma que la URL y la credencial funcionan antes de abrir Claude Code, por lo que una falla apunta a la puerta de enlace en lugar de su configuración. Los comandos a continuación leen las variables de shell, por lo que necesitan las exportaciones de shell incluso si también pone los valores en un archivo de configuración.

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
-H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
-Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json" `
-Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Si su puerta de enlace espera claves en el encabezado x-api-key, reemplace el encabezado Authorization con x-api-key: $ANTHROPIC_API_KEY en el comando Bash, o la entrada de tabla hash "Authorization" con "x-api-key" = "$env:ANTHROPIC_API_KEY" en el comando PowerShell.

Una respuesta JSON que comience con {"id":"msg_ e incluya un campo "content":[...] significa que la puerta de enlace es alcanzable y la credencial funciona. Un error que nombre un modelo desconocido aún prueba que la URL y la credencial funcionan, ya que la puerta de enlace autenticó la solicitud antes de rechazar el nombre del modelo; no necesita encontrar un modelo que su puerta de enlace sirva para esta prueba. Un 401 significa que la credencial fue rechazada: si adivinó la variable, cambie a la otra y re-exporte.

Confirmar en Claude Code

Inicie claude desde el mismo shell para que herede las exportaciones, envíe un mensaje, y ejecute /status.

En la pestaña Estado, la línea Anthropic base URL debe mostrar su dirección de puerta de enlace, lo que confirma que las solicitudes se enrutan allí; si la línea no está ahí, la variable no llegó a la sesión. Una línea Auth token o API key que nombre la variable que estableció confirma que la credencial de puerta de enlace está activa en lugar de un inicio de sesión de claude.ai guardado.

Si el mensaje falla, o /status no muestra la URL de la puerta de enlace, consulte la tabla de solución de problemas a continuación.

Cómo la variable de credencial se asigna a un encabezado

Cada variable envía la credencial en un encabezado HTTP diferente: ANTHROPIC_AUTH_TOKEN en Authorization: Bearer, ANTHROPIC_API_KEY en x-api-key, y apiKeyHelper en ambos. Una credencial en la variable incorrecta llega a la puerta de enlace en un encabezado que no lee, y la solicitud falla con 401. Si la solicitud de verificación devolvió 401, cambie a la otra variable e intente de nuevo.

Conflictos con un inicio de sesión existente

Una variable de credencial de puerta de enlace tiene precedencia sobre un inicio de sesión de claude.ai guardado o una clave de Consola. Su inicio de sesión de claude.ai permanece guardado y sin usar mientras la variable está establecida; desestablezca la variable y Claude Code vuelve a ella. Con ANTHROPIC_AUTH_TOKEN, la variable tiene precedencia inmediatamente. Con ANTHROPIC_API_KEY, se le solicita una vez en modo interactivo para aprobar la clave antes de que tome el control.

Ejecute /status para confirmar qué fuente de credencial está activa. Si el inicio muestra una advertencia de conflicto de autenticación que nombra dos fuentes, consulte la primera fila de la tabla de solución de problemas para saber cuál descartar. Para borrar un inicio de sesión guardado para que solo permanezca la credencial de puerta de enlace, ejecute /logout.

Configurar cada superficie

La CLI lee las variables de entorno y archivos de configuración anteriores. Las otras superficies son la extensión de VS Code, la aplicación de escritorio, GitHub Actions, el Agent SDK, y las superficies en la nube como Slack y la web; las secciones a continuación cubren si esa configuración llega a cada una.

Extensión de VS Code

Establezca las variables de puerta de enlace para la extensión de VS Code en claudeCode.environmentVariables, en la configuración de usuario propia de VS Code abierta con el comando Preferences: Open User Settings (JSON). La extensión comprueba las credenciales de esta configuración antes de lanzarse, por lo que es el lugar confiable para la credencial de puerta de enlace; los valores en ~/.claude/settings.json llegan al proceso generado pero no a la comprobación de inicio de sesión propia de la extensión.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}

Aplicación de escritorio

La aplicación de escritorio lee el enrutamiento de puerta de enlace de su configuración de inferencia de terceros, no de ANTHROPIC_BASE_URL o settings.json. Esa configuración puede provenir de su organización o de un formulario en la aplicación misma:

• Distribuida por un administrador: si su organización ha implementado la configuración, la aplicación de escritorio se enruta a través de la puerta de enlace sin configuración de su parte
• Configurada localmente: para dispositivos sin una configuración distribuida por administrador, abra Help → Troubleshooting → Enable Developer Mode, que reinicia la aplicación con un menú Developer. Luego abra Developer → Configure Third-Party Inference e ingrese su URL base de puerta de enlace. Una configuración distribuida por administrador tiene prioridad y hace que este formulario sea de solo lectura

Con la configuración de puerta de enlace activa, la aplicación de escritorio ejecuta sesiones solo en su máquina local: el selector de entorno no ofrece sesiones SSH ni entornos en la nube alojados por Anthropic, y Remote Control no está disponible. Para usar Claude Code en un host remoto a través de la puerta de enlace, ejecute la CLI en ese host con ANTHROPIC_BASE_URL y la credencial de puerta de enlace establecidas allí.

Si la aplicación de escritorio muestra Gateway was unreachable, la aplicación no pudo alcanzar la URL base configurada al iniciar; compruebe la URL y la ruta de red con la prueba de curl anterior.

GitHub Actions

Claude Code GitHub Actions lee ANTHROPIC_BASE_URL y ANTHROPIC_CUSTOM_HEADERS del bloque env del flujo de trabajo. Pase la credencial como la entrada anthropic_api_key de la acción; la acción la establece como ANTHROPIC_API_KEY, por lo que llega a la puerta de enlace en el encabezado x-api-key.

Para una puerta de enlace x-api-key, establezca la URL base en env y pase la clave de puerta de enlace como entrada:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Para una puerta de enlace de token portador, pase el mismo secreto dos veces: como la entrada anthropic_api_key y como ANTHROPIC_AUTH_TOKEN en el bloque env del flujo de trabajo. La acción requiere anthropic_api_key, CLAUDE_CODE_OAUTH_TOKEN, o federación de identidad de carga de trabajo antes de lanzar Claude Code, y no lee ANTHROPIC_AUTH_TOKEN, por lo que la entrada está ahí solo para satisfacer esa comprobación de lanzamiento. La variable de entorno es lo que pone la clave en el encabezado Authorization que la puerta de enlace lee; la copia en x-api-key se ignora:

env:
  ANTHROPIC_BASE_URL: https://llm-gateway.example.com
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.GATEWAY_API_KEY }}

steps:
  - uses: anthropics/claude-code-action@v1
    with:
      anthropic_api_key: ${{ secrets.GATEWAY_API_KEY }}

Para las otras opciones de autenticación de la acción, incluidas CLAUDE_CODE_OAUTH_TOKEN y federación de identidad de carga de trabajo, consulte Claude Code GitHub Actions y el README de la acción.

Agent SDK

El Agent SDK no tiene opciones específicas de puerta de enlace; pasa variables de entorno al proceso de Claude Code que genera. Cada SDK acepta una opción env que establece el entorno del proceso generado, y los SDK de TypeScript y Python lo tratan de manera diferente:

• TypeScript: el proceso generado hereda el entorno principal de forma predeterminada, pero establecer options.env reemplaza el entorno completamente. Extienda process.env en él para mantener sus variables de puerta de enlace.
• Python: ClaudeAgentOptions(env=...) se fusiona en el entorno heredado, por lo que las variables de puerta de enlace establecidas en el proceso principal se transmiten sin extender.

const result = query({
prompt: "...",
options: {
env: {
...process.env,
ANTHROPIC_BASE_URL: "https://llm-gateway.example.com",
ANTHROPIC_AUTH_TOKEN: process.env.GATEWAY_KEY,
},
},
})

options = ClaudeAgentOptions(
env={
"ANTHROPIC_BASE_URL": "https://llm-gateway.example.com",
"ANTHROPIC_AUTH_TOKEN": os.environ["GATEWAY_KEY"],
}
)

Slack, sesiones en la nube y Remote Control

Claude Code en Slack y sesiones en la nube siempre usan la API de Anthropic; no son parte de una implementación de puerta de enlace. Las variables de puerta de enlace establecidas en la configuración de entorno de una sesión en la nube no se aplican. Si su tráfico debe permanecer en la puerta de enlace, no habilite estas superficies para esos usuarios.

Remote Control y voice dictation ambos se basan en una identidad de claude.ai: Remote Control para emparejar una sesión en vivo con su cuenta, y voice dictation para alcanzar el punto final de transcripción de claude.ai. No están disponibles mientras ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, o un apiKeyHelper está activo. Remote Control también está deshabilitado mientras ANTHROPIC_BASE_URL apunta a un host que no es de Anthropic, por lo que iniciar sesión con claude.ai no es suficiente por sí solo. Antes de v2.1.196, una URL base que no es de Anthropic no bloqueaba Remote Control.

Para restaurar cualquiera de estas características, inicie sesión con claude.ai y desestablezca las variables de puerta de enlace que comprueba. La sección Remote Control de claude doctor nombra lo que actualmente está bloqueando Remote Control.

• Voice dictation: desestablezca la credencial de puerta de enlace
• Remote Control: desestablezca la credencial de puerta de enlace y ANTHROPIC_BASE_URL

Configuración adicional

Estas configuraciones cubren casos más allá de la URL base y la credencial. Establézcalas solo si las instrucciones de su administrador, las reglas de salida de su red, o la tabla de solución de problemas llaman a una.

Enviar encabezados adicionales

Algunas puertas de enlace enrutan o etiquetan solicitudes usando un encabezado personalizado además de la credencial, por ejemplo un identificador de inquilino o una clave de enrutamiento. Para enviar uno, establezca ANTHROPIC_CUSTOM_HEADERS con un par Name: Value por línea. El ejemplo a continuación agrega un encabezado de enrutamiento llamado X-Org-Route:

export ANTHROPIC_CUSTOM_HEADERS="X-Org-Route: prod"

$env:ANTHROPIC_CUSTOM_HEADERS = "X-Org-Route: prod"

También puede establecer ANTHROPIC_CUSTOM_HEADERS en el bloque env de un archivo de configuración. Use \n entre pares allí, ya que las cadenas JSON no pueden abarcar múltiples líneas:

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Org-Route: prod\nX-Tenant: example"
  }
}

Los nombres de encabezados de enrutamiento e inquilino como estos cuentan como encabezados que necesitan aprobación. Cuando los encabezados provienen de un archivo de configuración del proyecto, Claude Code los aplica bajo las reglas para cuándo aplica valores env.

Agregar modelos de puerta de enlace al selector de modelos

Con el descubrimiento de modelos habilitado, Claude Code consulta la puerta de enlace para su lista de modelos al iniciar y agrega esos nombres al selector /model junto con las entradas integradas. Si usted o su administrador establecen replaceBuiltInOptions en una alineación modelPicker, Claude Code también oculta los nombres descubiertos. Mantiene una fila para el modelo que la sesión ya está usando.

Habilítelo si su puerta de enlace sirve nombres de modelos que no están en la lista integrada de Claude Code y desea seleccionarlos del selector. Si los modelos integrados son los que usa, no necesita descubrimiento; su administrador también puede haberlo habilitado ya a través de configuración administrada.

Para habilitarlo, establezca CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 en su shell o en el bloque env de ~/.claude/settings.json.

Los modelos descubiertos aparecen como entradas /model adicionales. Cada entrada muestra la descripción que su puerta de enlace proporciona para el modelo, o From gateway cuando no proporciona una.

Para confirmar que el descubrimiento se ejecutó, inicie claude --debug y busque las líneas [gatewayDiscovery] en el registro de depuración en ~/.claude/debug/<session-id>.txt. La primera vez que el descubrimiento tiene éxito, Claude Code registra cuántos modelos almacenó en caché, y registra de nuevo solo cuando la lista de la puerta de enlace cambia. Un 404, tiempo de espera, o redirección también aparece allí. Para cuándo se ejecuta el descubrimiento, qué filtra, y el formato de respuesta que las puertas de enlace sirven, consulte la referencia de descubrimiento de modelos.

Rotar credenciales con apiKeyHelper

Un apiKeyHelper es un comando que Claude Code ejecuta para obtener su credencial de puerta de enlace, en lugar de leerla de una variable de entorno estática.

Use un asistente cuando la credencial expira en un cronograma, viene de un comando de almacén o SSO, o su administrador le dijo que configure uno. Si su credencial es una cadena fija que establece una vez, la variable de credencial es todo lo que necesita y puede omitir esta sección.

El asistente es cualquier comando de shell que imprime la credencial actual en stdout. Claude Code lo ejecuta a través de su shell del sistema, por lo que en Windows puede ser un ejecutable o una invocación de PowerShell. Haga que el comando no imprima nada más que la credencial. En Claude Code v2.1.227 o posterior, un encabezado o una línea de registro impresa junto a la clave hace que el asistente falle. Escriba el script, hágalo ejecutable, y haga referencia a él desde apiKeyHelper en su archivo de configuración:

#!/bin/bash
vault kv get -field=api_key secret/llm-gateway/claude-code

{
"apiKeyHelper": "~/bin/get-gateway-key.sh"
}

vault kv get -field=api_key secret/llm-gateway/claude-code

{
"apiKeyHelper": "powershell -NoProfile -File C:\\scripts\\get-gateway-key.ps1"
}

Claude Code almacena en caché la salida del asistente durante cinco minutos de forma predeterminada y re-ejecuta el asistente después de que vence la duración del caché. Para cambiar la duración, establezca CLAUDE_CODE_API_KEY_HELPER_TTL_MS en milisegundos, por ejemplo CLAUDE_CODE_API_KEY_HELPER_TTL_MS=900000 para 15 minutos.

Consulte apiKeyHelper para los otros casos en los que Claude Code re-ejecuta el asistente.

El valor del asistente se envía en los encabezados Authorization y x-api-key, por lo que funciona cualquiera que sea el encabezado que su puerta de enlace lea.

Desactivar tráfico fuera de la ruta de la puerta de enlace

La puerta de enlace lleva solicitudes de modelo, pero Claude Code también envía tráfico de fondo no esencial fuera de la ruta de la puerta de enlace, a Anthropic y a servicios de terceros como GitHub: comprobaciones de versión, telemetría, notas de lanzamiento, y solicitudes similares. En una red que solo permite salida a la puerta de enlace, estas solicitudes fallan y pueden aparecer como conexiones bloqueadas en su monitoreo de salida.

Claude Code adjunta una credencial a una solicitud de telemetría o métricas de uso solo cuando la solicitud va al host al que pertenece la credencial. Mientras ANTHROPIC_BASE_URL apunta a la puerta de enlace, Claude Code envía sus eventos de telemetría a Anthropic sin su credencial de puerta de enlace. Con una variable de credencial o apiKeyHelper también activos, Claude Code no reporta métricas de uso al panel de análisis de la Consola. Antes de v2.1.246, Claude Code podría adjuntar la credencial de puerta de enlace a solicitudes de telemetría y métricas de uso destinadas a hosts de Anthropic; las solicitudes de modelo siempre iban a la puerta de enlace con la credencial que la puerta de enlace espera.

Para desactivar ese tráfico, establezca CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 junto con las variables de puerta de enlace, en las mismas exportaciones de shell o bloque env del archivo de configuración:

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

Establecer la variable tiene estos efectos y limitaciones:

• Desactiva las actualizaciones automáticas, por lo que planifique otra ruta de actualización, como su gestor de paquetes o distribución administrada.
• Suprime la comprobación de disponibilidad del modo rápido. A menos que una comprobación anterior ya haya habilitado el modo rápido en la máquina, /fast reporta que el modo rápido no está disponible.
• No afecta el descubrimiento de modelos de puerta de enlace, que consulta solo su puerta de enlace. Antes de v2.1.257, la variable también detenía el descubrimiento de actualizarse, por lo que el selector mantenía la lista previamente almacenada en caché.
• La comprobación de seguridad de dominio de la herramienta WebFetch no se ve afectada y aún llama a api.anthropic.com. Desactívela por separado con skipWebFetchPreflight: true en configuración si su red bloquea ese host.
• Para cada flujo de telemetría y la variable que lo controla, consulte servicios de telemetría.

Enrutar a un proveedor en la nube a través de una puerta de enlace

Estas configuraciones apuntan Claude Code a una puerta de enlace a través de una variable de URL base específica del proveedor en lugar de ANTHROPIC_BASE_URL. Las puertas de enlace de Amazon Bedrock y Google Cloud's Agent Platform aceptan los formatos de solicitud nativos de esos proveedores; las puertas de enlace de Microsoft Foundry y Claude Platform en AWS aceptan el formato de Mensajes de Anthropic. En las rutas de Amazon Bedrock y Google Cloud's Agent Platform, Claude Code también limita los encabezados beta y campos de solicitud que envía al conjunto que el proveedor acepta. Para lo que su puerta de enlace recibe en cada ruta, consulte la guía de compatibilidad de puerta de enlace.

Use una solo si su equipo de puerta de enlace nombró específicamente Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, o Claude Platform en AWS. Si la solicitud de verificación anterior devolvió JSON, puede omitir esta sección.

Establezca el bloque para el proveedor que su equipo de puerta de enlace nombró. Las variables de omitir autenticación en los bloques de Amazon Bedrock, Google Cloud's Agent Platform, y Claude Platform en AWS le dicen a Claude Code que no firme solicitudes con credenciales del proveedor en la nube, ya que la puerta de enlace tiene esas. Si la puerta de enlace también necesita su propio token, dónde lo pone depende del proveedor:

• Amazon Bedrock, Google Cloud's Agent Platform, o Claude Platform en AWS: agregue ANTHROPIC_AUTH_TOKEN después del bloque. Claude Code lo envía a la puerta de enlace como un encabezado Authorization: Bearer. Para una credencial en un esquema o encabezado diferente, use ANTHROPIC_CUSTOM_HEADERS en su lugar. Mantenga la variable de omitir autenticación establecida de cualquier forma, ya que sin ella Claude Code elimina cualquier encabezado Authorization que ANTHROPIC_AUTH_TOKEN, un apiKeyHelper, o ANTHROPIC_CUSTOM_HEADERS agregaría.
• Microsoft Foundry: use ANTHROPIC_FOUNDRY_API_KEY como muestra su bloque

Amazon Bedrock

Deje AWS_BEARER_TOKEN_BEDROCK sin establecer cuando la puerta de enlace emite su propia credencial. Si lo establece, Claude Code envía esa clave de API de Amazon Bedrock como el encabezado Authorization en lugar de su token de puerta de enlace, incluso con CLAUDE_CODE_SKIP_BEDROCK_AUTH establecido.

export ANTHROPIC_BEDROCK_BASE_URL=https://llm-gateway.example.com/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

$env:ANTHROPIC_BEDROCK_BASE_URL = "https://llm-gateway.example.com/bedrock"
$env:CLAUDE_CODE_SKIP_BEDROCK_AUTH = "1"
$env:CLAUDE_CODE_USE_BEDROCK = "1"

Google Cloud's Agent Platform

Reemplace el ID del proyecto y la región con sus propios valores. Claude Code incluye ambos en la ruta de cada solicitud que envía a la puerta de enlace:

export ANTHROPIC_VERTEX_BASE_URL=https://llm-gateway.example.com/vertex
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

$env:ANTHROPIC_VERTEX_BASE_URL = "https://llm-gateway.example.com/vertex"
$env:ANTHROPIC_VERTEX_PROJECT_ID = "your-gcp-project-id"
$env:CLAUDE_CODE_SKIP_VERTEX_AUTH = "1"
$env:CLAUDE_CODE_USE_VERTEX = "1"
$env:CLOUD_ML_REGION = "us-east5"

El bloque cubre enrutamiento y autenticación. Las anulaciones de región y fijaciones de modelo de la configuración de Agent Platform se aplican a través de una puerta de enlace también:

• Regiones por modelo: si su puerta de enlace sirve algunos modelos desde una región diferente a CLOUD_ML_REGION, establezca la variable VERTEX_REGION_CLAUDE_* coincidente para cada uno, por ejemplo VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1. La referencia de variables de entorno enumera los nombres exactos.
• Versiones de modelo: fije ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, y ANTHROPIC_DEFAULT_HAIKU_MODEL como en Fijar versiones de modelo. Establecer ANTHROPIC_DEFAULT_HAIKU_MODEL también mueve tareas de fondo como títulos de sesión a ese modelo, y esa sección explica qué modelo las ejecuta de otra forma.
• Capacidades de modelo: si fija un ID de modelo que su versión de Claude Code no reconoce, características como niveles de esfuerzo o pensamiento extendido pueden permanecer deshabilitadas en él. Declare lo que el modelo soporta con ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES y sus contrapartes de Sonnet y Haiku.

Microsoft Foundry

Ponga la credencial de la puerta de enlace en ANTHROPIC_FOUNDRY_API_KEY; se envía a la puerta de enlace como el encabezado x-api-key. Una puerta de enlace que espera un token de portador puede tomar ANTHROPIC_FOUNDRY_AUTH_TOKEN en su lugar. Claude Code envía ese valor como el encabezado Authorization: Bearer, y tiene precedencia sobre ANTHROPIC_FOUNDRY_API_KEY cuando ambos están establecidos. Requiere Claude Code v2.1.203 o posterior.

Para una puerta de enlace que inyecta su propio encabezado Authorization, establezca CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1 y deje ambas variables de credencial sin establecer. Claude Code entonces envía solicitudes sin una credencial de Azure y preserva el encabezado Authorization que suministra, por ejemplo a través de ANTHROPIC_CUSTOM_HEADERS. Antes de v2.1.203, CLAUDE_CODE_SKIP_FOUNDRY_AUTH sin una clave de API dejaba el cliente de Microsoft Foundry incapaz de enviar solicitudes.

export ANTHROPIC_FOUNDRY_BASE_URL=https://llm-gateway.example.com/foundry
export ANTHROPIC_FOUNDRY_API_KEY=sk-gateway-key
export CLAUDE_CODE_USE_FOUNDRY=1

$env:ANTHROPIC_FOUNDRY_BASE_URL = "https://llm-gateway.example.com/foundry"
$env:ANTHROPIC_FOUNDRY_API_KEY = "sk-gateway-key"
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

Claude Platform en AWS

Consulte Claude Platform en AWS para el ID del espacio de trabajo.

export ANTHROPIC_AWS_BASE_URL=https://llm-gateway.example.com/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

$env:ANTHROPIC_AWS_BASE_URL = "https://llm-gateway.example.com/anthropic-aws"
$env:ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN"
$env:CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH = "1"
$env:CLAUDE_CODE_USE_ANTHROPIC_AWS = "1"

Confirmar la ruta del proveedor

Inicie claude desde el shell donde estableció el bloque y ejecute /status. Con el bloque de Amazon Bedrock, la pestaña Status muestra filas como estas:

API provider: Amazon Bedrock
Bedrock base URL: https://llm-gateway.example.com/bedrock
AWS auth skipped

Los otros bloques producen las mismas filas bajo los nombres de su proveedor, por ejemplo Vertex base URL y GCP auth skipped para Google Cloud's Agent Platform; el bloque de Microsoft Foundry muestra una fila de autenticación omitida solo si establece CLAUDE_CODE_SKIP_FOUNDRY_AUTH. Si también enruta a través de un proxy corporativo, una fila Proxy muestra la URL del proxy. Si falta la fila de URL base, la variable no llegó a la sesión.

Solucionar problemas de errores de puerta de enlace

Estos son los errores más comunes al ejecutar Claude Code a través de una puerta de enlace, con la causa del lado de la puerta de enlace y la solución:

Si Claude Code le solicita que inicie sesión repetidamente después de eliminar la configuración de puerta de enlace, la causa es generalmente almacenamiento de credenciales en lugar de la puerta de enlace; consulte errores de autenticación.

Recursos relacionados

• Descripción general de puertas de enlace LLM: qué es una puerta de enlace y cómo interactúa con las suscripciones de claude.ai
• Implementar una puerta de enlace LLM para su organización: la lista de verificación orientada al administrador para implementar y distribuir la configuración de puerta de enlace
• Guía de compatibilidad de puerta de enlace: qué envía Claude Code a una puerta de enlace, incluidos los encabezados y campos que la puerta de enlace debe reenviar
• Configuración: dónde viven los archivos de configuración y cómo se lee el bloque env
• Autenticación: cómo interactúan las variables de credencial, apiKeyHelper, e inicio de sesión OAuth