SpyBara
Go Premium

claude-platform-on-aws.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

37 added, 195 removed.

2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Claude Code en Claude Platform on AWS

Configure Claude Code para usar la API de Claude operada por Anthropic con autenticación de AWS, control de acceso IAM y facturación de AWS Marketplace.

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 obtiene los mismos modelos y características que la Claude API en el mismo calendario de lanzamientos. Se autentica con credenciales de AWS o una clave API de espacio de trabajo, y paga a través de AWS Marketplace.

Utilice esta guía para dirigir Claude Code a un espacio de trabajo que ya haya aprovisionado a través de Claude Platform on AWS. Para la suscripción de AWS y la configuración del espacio de trabajo que viene antes, consulte la documentación de Claude Platform on AWS.

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

1. Configurar credenciales de AWS

Claude Code admite dos métodos de autenticación para Claude Platform on AWS. Elija el método que se ajuste a cómo su equipo gestiona el acceso.

Opción A: Credenciales de AWS con SigV4

Claude Code firma solicitudes con SigV4 utilizando 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 el SDK de AWS admita.

Para uso local, inicie sesión con la CLI de AWS antes de iniciar Claude Code. El ejemplo a continuación utiliza un perfil de SSO, pero cualquier método que produzca credenciales en las ubicaciones estándar funciona.

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

Para CI y automatización, proporcione al ejecutor un rol de IAM con permiso para invocar el servicio de Anthropic y establezca AWS_REGION. La cadena de credenciales recoge el rol automáticamente.

Si sus credenciales de SSO expiran durante la sesión, configure awsAuthRefresh para que Claude Code vuelva a ejecutar su comando de inicio de sesión y reintente en lugar de fallar. Agregue el comando a su settings.json:

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

Opción B: Clave API del espacio de trabajo

Una clave API del espacio de trabajo es un secreto de larga duración, útil cuando no desea gestionar credenciales de AWS federados. Genere una en la Consola de AWS en Claude Platform on AWS → API keys y establézcala como ANTHROPIC_AWS_API_KEY:

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

La clave se envía como x-api-key y tiene prioridad sobre SigV4, por lo que cualquier credencial de AWS en su entorno se ignora. Las claves API de una organización separada de Claude Console no funcionarán aquí.

Trate las claves API del espacio de trabajo como cualquier otra credencial de producción. El bloque env del archivo de configuración del usuario es una forma conveniente de limitar la clave a su máquina sin exportarla globalmente.

2. Configurar Claude Code

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

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 y se envía en cada solicitud como el encabezado anthropic-workspace-id. La URL base se calcula a partir de AWS_REGION como https://aws-external-anthropic.{region}.api.aws. Para anular la URL directamente, establezca ANTHROPIC_AWS_BASE_URL.

Claude Platform on AWS es opcional incluso cuando hay credenciales de AWS presentes en su entorno. Bedrock y Foundry tienen prioridad en el enrutamiento de proveedores, por lo que desactive CLAUDE_CODE_USE_BEDROCK y CLAUDE_CODE_USE_FOUNDRY si están establecidos.

3. Fijar versiones de modelo

Claude Platform on AWS utiliza los mismos ID de modelo que la API de Claude directa. Los alias predeterminados opus, sonnet y haiku se resuelven a las versiones más recientes disponibles en su espacio de trabajo.

Si implementa Claude Code en un equipo, fije explícitamente los ID de modelo para que un nuevo lanzamiento no mueva a todos a la vez:

export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Para la lista completa de ID de modelo y alias, consulte Descripción general de modelos. Para otras variables relacionadas con modelos, consulte Configuración de modelo.

Prompt caching está habilitado automáticamente. Para solicitar un TTL de caché de 1 hora en lugar del predeterminado de 5 minutos, establezca ENABLE_PROMPT_CACHING_1H=1. Las escrituras de caché de 1 hora se facturan a una tasa más alta. Consulte precios de prompt caching para conocer las tarifas.

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 Workspaces en la página del servicio de la Consola de 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: