Integrações Bedrock & Vertex
Configure o Claude Code para trabalhar com Amazon Bedrock e Google Vertex AI, e conecte através de proxies.
Configuração do modelo
Por padrão, o Claude Code usa claude-3-7-sonnet-20250219
. Você pode substituir isso usando as seguintes variáveis de ambiente:
Você também pode definir essas variáveis usando a configuração global:
Veja nossa referência de nomes de modelos para todos os modelos disponíveis em diferentes provedores.
Uso com APIs de terceiros
O Claude Code requer acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku, independentemente do provedor de API que você usar.
Conectar ao Amazon Bedrock
Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_BEDROCK_BASE_URL
:
Se você não tiver o cache de prompts habilitado, também defina:
Requer credenciais padrão do AWS SDK (por exemplo, ~/.aws/credentials
ou variáveis de ambiente relevantes como AWS_ACCESS_KEY_ID
, AWS_SECRET_ACCESS_KEY
). Para configurar as credenciais AWS, execute:
Entre em contato com o Amazon Bedrock para cache de prompts para custos reduzidos e limites de taxa mais altos.
Os usuários precisarão ter acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku em sua conta AWS. Se você tiver uma função de acesso ao modelo, pode precisar solicitar acesso a esses modelos se eles ainda não estiverem disponíveis. O acesso ao Bedrock em cada região é necessário porque os perfis de inferência requerem capacidade entre regiões.
Conectar ao Google Vertex AI
Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_VERTEX_BASE_URL
:
Se você não tiver o cache de prompts habilitado, também defina:
O Claude Code no Vertex AI atualmente suporta apenas a região us-east5
. Certifique-se
de que seu projeto tenha cota alocada nesta região específica.
Os usuários precisarão ter acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku em seu projeto Vertex AI.
Requer credenciais GCP padrão configuradas através do google-auth-library. Para configurar as credenciais GCP, execute:
Para a melhor experiência, entre em contato com o Google para limites de taxa mais elevados.
Conectar através de um proxy
Ao usar o Claude Code com um proxy LLM (como LiteLLM), você pode controlar o comportamento de autenticação usando as seguintes variáveis de ambiente e configurações. Observe que você pode combinar estas com as configurações específicas do Bedrock e Vertex.
Variáveis de ambiente
ANTHROPIC_AUTH_TOKEN
: Valor personalizado para os cabeçalhosAuthorization
eProxy-Authorization
(o valor que você definir aqui será prefixado comBearer
)ANTHROPIC_CUSTOM_HEADERS
: Cabeçalhos personalizados que você deseja adicionar à requisição (no formatoNome: Valor
)HTTP_PROXY
: Define a URL do proxy HTTPHTTPS_PROXY
: Define a URL do proxy HTTPS
Se você preferir configurar via arquivo em vez de variáveis de ambiente, você pode adicionar qualquer uma dessas variáveis ao objeto env
em sua configuração global do Claude (em ~/.claude.json).
Opções de configuração global
apiKeyHelper
: Um script shell personalizado para obter uma chave de API (invocado uma vez na inicialização e armazenado em cache durante cada sessão)