Claude Code en Claude Platform on AWS

Claude Platform on AWS es la API de Claude operada por Anthropic con autenticación de AWS, control de acceso IAM y facturación de AWS Marketplace. Las solicitudes llegan directamente a la API de Anthropic, por lo que obtienes los mismos modelos y características de API que la Claude API en el mismo calendario de lanzamientos. Te autenticas con credenciales de AWS o una clave de API de espacio de trabajo, y pagas a través de AWS Marketplace. Usa esta guía para dirigir Claude Code a un espacio de trabajo que ya hayas aprovisionado a través de Claude Platform on AWS. Para la suscripción de AWS y la configuración del espacio de trabajo que vienen antes, consulta la documentación de Claude Platform on AWS.

Suscribirse a través de AWS Marketplace aprovisiona una nueva organización de Anthropic vinculada a tu cuenta de AWS. Esta organización es independiente de cualquier organización que ya tengas con Anthropic, y las credenciales no se transfieren entre ellas. Usa el ID del espacio de trabajo y las claves de API de la organización vinculada a AWS, no de una cuenta de Claude Console preexistente.

Algunas características de Claude Code no están disponibles o funcionan de manera diferente en Claude Platform on AWS. Consulta la matriz de disponibilidad de características y las características que necesitan la obtención de feature flags.

Requisitos previos

Antes de configurar Claude Code, necesita:

Una suscripción activa a Claude Platform on AWS a través de AWS Marketplace
Un espacio de trabajo en su organización de Anthropic vinculada a AWS, con su ID de espacio de trabajo
Un principal de IAM con permiso para invocar el servicio de Anthropic, o una clave API limitada al espacio de trabajo
Credenciales de AWS en su entorno, en ~/.aws/credentials, o de un rol de IAM adjunto si desea autenticación SigV4. La CLI de AWS es necesaria solo para el flujo de inicio de sesión SSO.

Configuración

Configura las credenciales de AWS

Claude Code admite dos métodos de autenticación para Claude Platform on AWS. Elige el método que se ajuste a la forma en que tu equipo gestiona el acceso:

Credenciales de AWS con SigV4: autentícate como una entidad principal de IAM, con credenciales de la cadena de credenciales estándar de AWS
Clave de API del espacio de trabajo: autentícate con una clave de larga duración que generas en la consola de AWS

Usa credenciales de AWS con SigV4

Claude Code firma las solicitudes con SigV4 usando la cadena de credenciales estándar de AWS: variables de entorno, credenciales compartidas en ~/.aws/credentials, roles de IAM, sesiones de AWS SSO y cualquier otra fuente que admita el AWS SDK. Para uso local, inicia sesión con el AWS CLI antes de iniciar Claude Code. El siguiente ejemplo usa un perfil de SSO, pero funciona cualquier método que genere credenciales en las ubicaciones estándar.

aws sso login --profile my-profile
export AWS_PROFILE=my-profile

Para CI y automatización, asigna al runner un rol de IAM con permiso para invocar el servicio de Anthropic y establece AWS_REGION. La cadena de credenciales detecta el rol automáticamente. Si tus credenciales de SSO caducan a mitad de la sesión, configura awsAuthRefresh para que Claude Code vuelva a ejecutar tu comando de inicio de sesión y reintente en lugar de fallar. Agrega el comando a tu archivo de configuración, como ~/.claude/settings.json:

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

Claude Code también ejecuta este comando al inicio cuando no puede validar tus credenciales de AWS existentes, y muestra la salida del comando en un panel Authentication hasta que se completa el inicio de sesión. Con awsAuthRefresh configurado, ejecuta /login, selecciona 3rd-party platform y luego selecciona Claude Platform on AWS · refresh credentials en Using 3rd-party platforms. Claude Code ejecuta el comando configurado y vuelve a leer tus credenciales de AWS sin necesidad de reiniciar.

Usa una clave de API del espacio de trabajo

Una clave de API del espacio de trabajo es un secreto de larga duración, útil cuando no quieres gestionar credenciales federadas de AWS. Genera una en la consola de AWS en Claude Platform on AWS → API keys y establécela como ANTHROPIC_AWS_API_KEY:

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

La clave se envía como x-api-key y tiene precedencia sobre SigV4, por lo que se ignoran las credenciales de AWS presentes en tu entorno. Las claves de API de una organización independiente de Claude Console no funcionan aquí. Trata las claves de API del espacio de trabajo como cualquier otra credencial de producción. El bloque env del archivo de configuración de usuario es una forma práctica de limitar la clave a tu máquina sin exportarla globalmente.

Los comandos /login y /logout no inician sesión en una suscripción de claude.ai para Claude Platform on AWS. La autenticación se realiza mediante tus credenciales de AWS o tu clave de API del espacio de trabajo.

Configura Claude Code

Establece las variables de entorno que enrutan Claude Code a través de Claude Platform on AWS en lugar de la API predeterminada de Anthropic.

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1

ANTHROPIC_AWS_WORKSPACE_ID es obligatorio. Claude Code lo envía en cada solicitud como el encabezado anthropic-workspace-id. Reemplaza el valor de ejemplo wrkspc_01ABCDEFGHIJKLMN por tu propio ID de espacio de trabajo de tu configuración de Claude Platform on AWS. Claude Code calcula la URL base como https://aws-external-anthropic.{region}.api.aws a partir de la región de AWS, que resuelve con la misma precedencia que Amazon Bedrock. Para sobrescribir la URL directamente, establece ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS debe activarse explícitamente incluso cuando hay credenciales de AWS presentes en tu entorno. Amazon Bedrock y Microsoft Foundry tienen precedencia en el enrutamiento de proveedores, así que elimina CLAUDE_CODE_USE_BEDROCK y CLAUDE_CODE_USE_FOUNDRY si están establecidas.

Fija las versiones de los modelos

Claude Platform on AWS usa los mismos IDs de modelo que la Claude API directa. Los alias predeterminados fable, opus, sonnet y haiku se resuelven en los valores predeterminados integrados de Claude Code para Claude Platform on AWS, que pueden ir por detrás de la versión más reciente. Sin ANTHROPIC_DEFAULT_OPUS_MODEL, el alias opus se resuelve en Opus 5.5. Antes de v2.1.280, se resolvía en Opus 5 a partir de v2.1.219. Si implementas Claude Code para un equipo, fija los IDs de modelo explícitamente para que una nueva versión no cambie a todos a la vez:

export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Para ver la lista completa de IDs de modelo y alias, consulta Descripción general de los modelos. Para otras variables relacionadas con los modelos, consulta Configuración del modelo. La caché de prompts se habilita automáticamente. Para solicitar un TTL de caché de 1 hora en lugar del predeterminado de 5 minutos, establece ENABLE_PROMPT_CACHING_1H=1. La API factura las escrituras en caché de 1 hora a una tarifa más alta. Consulta los precios de la caché de prompts para ver las tarifas. Para establecer TTL diferentes para tu conversación principal y para las solicitudes que Claude Code realiza fuera de ella, elige el TTL tú mismo.

Inicia y verifica

Inicia Claude Code y confirma el enrutamiento:

claude

El banner de inicio muestra Claude Platform on AWS cuando el proveedor está activo. Ejecuta /status para comprobar los detalles: la línea API provider indica Claude Platform on AWS, y la salida incluye tu Workspace ID, la AWS region y la Claude Platform on AWS base URL si estableciste una sobrescritura.

Usar el Agent SDK

El Agent SDK lee las mismas variables de entorno que la CLI, por lo que cualquier programa que genere el subproceso de Claude Code puede dirigirse a Claude Platform on AWS exportando CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID y ANTHROPIC_AWS_API_KEY o credenciales de AWS antes de la llamada.

import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}

Este ejemplo se basa en la cadena de credenciales de AWS ambiental para SigV4. Para autenticarse con una clave API del espacio de trabajo en su lugar, establezca ANTHROPIC_AWS_API_KEY de la misma manera. Para la superficie más amplia del Agent SDK, consulte Descripción general del Agent SDK.

Enrutar a través de un proxy corporativo

Para enrutar el tráfico a través de un proxy o puerta de enlace LLM, establezca ANTHROPIC_AWS_BASE_URL en la dirección del proxy. Claude Code envía solicitudes a esa URL con los mismos encabezados de espacio de trabajo y autenticación, por lo que cualquier puerta de enlace que los reenvíe sin cambios funciona.

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

Si su puerta de enlace firma solicitudes por sí misma, establezca CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 para que Claude Code envíe solicitudes sin firmar y permita que la puerta de enlace agregue encabezados SigV4 antes de reenviar a AWS. Si la puerta de enlace requiere su propio token, establézcalo en ANTHROPIC_AUTH_TOKEN.

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

Solución de problemas

Ejecute /status para ver el proveedor resuelto y cualquier ID de espacio de trabajo configurado explícitamente, región, anulación de URL base y configuración de omisión de autenticación. Esta es la forma más rápida de confirmar que Claude Code se dirige a Claude Platform on AWS en absoluto.

`403 Forbidden` o `AccessDenied` en cada solicitud

El principal de IAM que Claude Code resolvió probablemente carece de permiso para invocar el servicio de Anthropic en su espacio de trabajo. Verifique el rol adjunto a su perfil de AWS o al ejecutor que inició Claude Code, y verifique que tenga las acciones aws-external-anthropic documentadas en la referencia de acciones de IAM. Si estableció ANTHROPIC_AWS_API_KEY, la clave tiene prioridad sobre SigV4 y una clave obsoleta produce el mismo error. Regenere la clave en la Consola de AWS en Claude Platform on AWS → API keys o desactive la variable para volver a sus credenciales de AWS.

Las solicitudes fallan con un error de espacio de trabajo faltante

ANTHROPIC_AWS_WORKSPACE_ID probablemente no esté establecido o esté vacío. Cada solicitud de Claude Platform on AWS debe incluir el ID del espacio de trabajo. No está implícito en sus credenciales de AWS. Encuentre el ID en su configuración de Claude Platform on AWS y expórtelo antes de iniciar Claude Code.

Las solicitudes aún van a `api.anthropic.com`

CLAUDE_CODE_USE_ANTHROPIC_AWS probablemente no esté establecido o esté establecido en un valor que no se analice como verdadero. Establézcalo en 1 y ejecute /status para confirmar el proveedor resuelto. Si CLAUDE_CODE_USE_BEDROCK o CLAUDE_CODE_USE_FOUNDRY también está establecido, esos tienen prioridad sobre Claude Platform on AWS.

Recursos adicionales

La suscripción a Claude Platform on AWS, la configuración del espacio de trabajo e IAM que viene antes de configurar Claude Code se cubre en la documentación de la plataforma:

Descripción general de Claude Platform on AWS: suscripción, configuración del espacio de trabajo y referencia del producto
Referencia de acciones de IAM: permisos y políticas administradas

Configuración y acceso

Despliegue

Gateways

Uso y costos

Seguridad y datos

Adopción

Claude Code en Claude Platform on AWS

Requisitos previos

Configuración

Configura las credenciales de AWS

Usa credenciales de AWS con SigV4

Usa una clave de API del espacio de trabajo

Configura Claude Code

Fija las versiones de los modelos

Inicia y verifica

Usar el Agent SDK

Enrutar a través de un proxy corporativo

Solución de problemas

`403 Forbidden` o `AccessDenied` en cada solicitud

Las solicitudes fallan con un error de espacio de trabajo faltante

Las solicitudes aún van a `api.anthropic.com`

Recursos adicionales

​Requisitos previos

​Configuración

​ Configura las credenciales de AWS

​Usa credenciales de AWS con SigV4

​Usa una clave de API del espacio de trabajo

​ Configura Claude Code

​ Fija las versiones de los modelos

​ Inicia y verifica

​Usar el Agent SDK

​Enrutar a través de un proxy corporativo

​Solución de problemas

​403 Forbidden o AccessDenied en cada solicitud

​Las solicitudes fallan con un error de espacio de trabajo faltante

​Las solicitudes aún van a api.anthropic.com

​Recursos adicionales

Requisitos previos

Configuración

Configura las credenciales de AWS

Usa credenciales de AWS con SigV4

Usa una clave de API del espacio de trabajo

Configura Claude Code

Fija las versiones de los modelos

Inicia y verifica

Usar el Agent SDK

Enrutar a través de un proxy corporativo

Solución de problemas

`403 Forbidden` o `AccessDenied` en cada solicitud

Las solicitudes fallan con un error de espacio de trabajo faltante

Las solicitudes aún van a `api.anthropic.com`

Recursos adicionales