Claude Code su Amazon Bedrock

​

Prerequisiti

• Un account AWS con accesso a Amazon Bedrock abilitato
• Accesso ai modelli Claude desiderati (ad esempio, Claude Sonnet 4.6) in Amazon Bedrock
• AWS CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
• Autorizzazioni IAM appropriate

​

Accedi con Bedrock

​

Configurazione manuale

​

1. Inviare i dettagli del caso d’uso

1. Assicurarsi di disporre delle autorizzazioni IAM corrette descritte di seguito
2. Navigare alla console di Amazon Bedrock
3. Selezionare un modello Anthropic dal Catalogo modelli
4. Completare il modulo del caso d’uso. L’accesso viene concesso immediatamente dopo l’invio.

​

2. Configurare le credenziali AWS

aws configure

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

aws sso login --profile=your-profile-name

export AWS_PROFILE=your-profile-name

aws login

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

​

Caching delle credenziali e timeout di risoluzione

​

Configurazione avanzata delle credenziali

• awsAuthRefresh: viene eseguito solo quando Claude Code rileva che le credenziali AWS sono scadute, localmente in base al loro timestamp o quando l’API restituisce un errore di credenziale, quindi ritenta la richiesta con credenziali aggiornate.
• awsCredentialExport: viene eseguito all’avvio della sessione e su ogni ricaricamento delle credenziali, anche quando le credenziali nella catena del provider di credenziali predefinito AWS sono ancora valide. Utilizzare questa opzione quando l’account Amazon Bedrock richiede credenziali tra account che differiscono da quelle che la catena del provider predefinito risolverebbe.

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

​

3. Configurare Claude Code

# Enable Bedrock integration
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # optional if your AWS profile already sets a region

# Optional: Override the AWS region for the small/fast model (Bedrock and Mantle).
# On Bedrock, has no effect without ANTHROPIC_DEFAULT_HAIKU_MODEL
# or the deprecated ANTHROPIC_SMALL_FAST_MODEL set.
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# Optional: Override the Bedrock endpoint URL for custom endpoints or gateways
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

• È necessario impostare AWS_REGION solo per sovrascrivere la regione del profilo AWS o quando il profilo non ha una regione. Claude Code risolve la regione in questo ordine:
  • AWS_REGION
  • AWS_DEFAULT_REGION
  • la region impostata sul profilo AWS attivo, letta dal file delle credenziali condivise AWS per primo e poi dal file di configurazione condiviso, corrispondendo alla precedenza dell’SDK AWS
  • us-east-1
  Se un valore da una qualsiasi di queste fonti non ha la forma di un nome di regione, Claude Code lo tratta come non impostato e continua verso il basso nell’ordine. Ad esempio, Claude Code tratta un valore contenente una barra, un punto o uno spazio come non impostato. Il profilo attivo è AWS_PROFILE se impostato, altrimenti default. Impostare AWS_SHARED_CREDENTIALS_FILE o AWS_CONFIG_FILE per puntare a percorsi di file non predefiniti. Eseguire /status per visualizzare la regione risolta. Quando la regione proviene dai file di configurazione AWS o dal fallback predefinito, Claude Code nota anche la fonte nell’output /status.
• Quando si utilizza Amazon Bedrock, il comando /logout non è disponibile poiché l’autenticazione viene gestita tramite credenziali AWS.
• Lo strumento WebSearch non è disponibile su Amazon Bedrock. Vedere Comportamento dello strumento WebSearch.
• È possibile utilizzare file di impostazioni per variabili di ambiente come AWS_PROFILE che non si desidera perdere in altri processi. Vedere Settings per ulteriori informazioni.

​

4. Fissare le versioni del modello

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

• Quando si seleziona un modello primario con --model, ANTHROPIC_MODEL o l’impostazione model, le attività in background utilizzano quel modello. Quando Claude Code avvia la sessione sul modello impostato con ANTHROPIC_DEFAULT_MODEL, le attività in background utilizzano anche quel modello. L’impostazione di ANTHROPIC_DEFAULT_OPUS_MODEL senza ANTHROPIC_DEFAULT_SONNET_MODEL conta anche come una selezione, perché il modello Sonnet integrato potrebbe non essere abilitato in un account che indirizza il proprio Opus.
• Per utilizzare Haiku per le attività in background, impostare ANTHROPIC_DEFAULT_HAIKU_MODEL su un ID modello disponibile nel proprio account.

# Using inference profile ID
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# Using application inference profile ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Optional: Disable prompt caching if needed
# export DISABLE_PROMPT_CACHING=1

# Optional: Request 1-hour prompt cache TTL instead of the 5-minute default
# export ENABLE_PROMPT_CACHING_1H=1

​

Mappare ogni versione del modello a un profilo di inferenza

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}

​

Controlli del modello all’avvio

​

Prefissi del profilo di inferenza tra regioni

export ANTHROPIC_BEDROCK_REGION_PREFIX=global
# In a us-* region, the primary model now resolves to
# global.anthropic.claude-opus-5-5 instead of us.anthropic.claude-opus-5-5

• Quando Claude Code può elencare i profili di inferenza nel vostro account, risolve ogni modello in questo ordine:
  1. Il profilo con il vostro prefisso preferito.
  2. Qualsiasi profilo corrispondente, per un modello che non ha un profilo con quel prefisso.
  3. L’ID del modello incorporato con il vostro prefisso preferito, per un modello che non ha alcun profilo corrispondente. Claude Code applica questo ID senza verificare la disponibilità in questo passaggio; i controlli del modello di avvio coprono comunque i modelli predefiniti della sessione.
• Quando l’individuazione del profilo non è disponibile, Claude Code applica il prefisso senza verificare la disponibilità. Se il vostro account non ha profili di inferenza con quel prefisso abilitati, le richieste non riescono con un errore 400.

• Nelle regioni AWS GovCloud, Claude Code utilizza sempre us-gov., l’unico prefisso che instrada all’interno della partizione GovCloud.
• Quando impostate un valore che non è uno dei valori validi, Claude Code esegue il fallback al prefisso preferito derivato dalla regione.

​

Configurazione IAM

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

​

Finestra di contesto da 1M token

​

Livelli di servizio

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

​

AWS Guardrails

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

​

Utilizza l’endpoint Mantle

​

Abilita Mantle

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

​

Seleziona un modello Mantle

claude --model anthropic.claude-haiku-4-5

​

Esegui Mantle insieme all’API Invoke

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

{
  "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]
}

​

Instrada Mantle attraverso un gateway

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

​

Variabili di ambiente Mantle

​

Risoluzione dei problemi

​

Loop di autenticazione con SSO e proxy aziendali

​

Errori di certificato dietro un proxy che ispeziona TLS

• Scoperta del modello
• Conteggio dei token
• Le chiamate del ruolo di credenziale STS e SSO che risolvono le tue credenziali AWS
• La verifica delle credenziali e i controlli del modello della procedura guidata di configurazione

​

Problemi di regione

• Controlla la disponibilità del modello: aws bedrock list-inference-profiles --region your-region
• Passa a una regione supportata: export AWS_REGION=us-east-1
• Considera l’utilizzo di profili di inferenza per l’accesso tra regioni

• Specifica il modello come ID di profilo di inferenza

​

Errori di streaming dietro un gateway o proxy

​

Conteggi di token zero in /context

​

Errori dell’endpoint Mantle

• Se l’errore nomina un’azione bedrock-mantle:, concedi alla tua identità IAM quell’azione.
• Se l’errore non nomina alcuna azione e le tue credenziali sono valide, il tuo account AWS non ha ricevuto l’accesso al modello che hai richiesto. Contatta il tuo team di account AWS per richiedere l’accesso.

​

Risorse aggiuntive

• Documentazione di Amazon Bedrock
• Prezzi di Amazon Bedrock
• Profili di inferenza di Amazon Bedrock
• Burndown dei token di Amazon Bedrock e quote
• Claude Code su Amazon Bedrock: Guida di configurazione rapida
• Implementazione del monitoraggio di Claude Code (Amazon Bedrock)