Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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.
Suscribirse a través de AWS Marketplace aprovisiona una nueva organización de Anthropic vinculada a su cuenta de AWS. Esta organización es independiente de cualquier organización que ya tenga con Anthropic, y las credenciales no se transfieren entre ellas. Utilice el ID del espacio de trabajo y las claves API de la organización vinculada a AWS, no de una cuenta de Claude Console preexistente.

​
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.
Los comandos /login y /logout no cambian la autenticación de Claude Platform on AWS. La autenticación se ejecuta a través de sus credenciales de AWS o clave API del espacio de trabajo, no a través de una suscripción de Claude.ai.

​
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. Las escrituras de caché de 1 hora se facturan a una tasa más alta que las escrituras de 5 minutos. Para solicitar un TTL de caché de 1 hora en lugar del predeterminado de 5 minutos, establezca ENABLE_PROMPT_CACHING_1H=1.

​
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: