Instale o NodeJS 18+ e, em seguida, execute: 
npm install -g @anthropic-ai/claude-code
NÃO use sudo npm install -g, pois isso pode levar a problemas de permissão e riscos de segurança. Se você encontrar erros de permissão, consulte configurar Claude Code para soluções recomendadas.
Claude Code é uma ferramenta de codificação baseada em agente que vive no seu terminal, entende sua base de código e ajuda você a codificar mais rapidamente por meio de comandos em linguagem natural. Ao se integrar diretamente com seu ambiente de desenvolvimento, o Claude Code otimiza seu fluxo de trabalho sem exigir servidores adicionais ou configuração complexa. As principais capacidades do Claude Code incluem:
  • Editar arquivos e corrigir bugs em toda a sua base de código
  • Responder perguntas sobre a arquitetura e lógica do seu código
  • Executar e corrigir testes, linting e outros comandos
  • Pesquisar no histórico do git, resolver conflitos de mesclagem e criar commits e PRs
Prévia de pesquisaO Code está em beta como uma prévia de pesquisa. Estamos coletando feedback de desenvolvedores sobre preferências de colaboração com IA, quais fluxos de trabalho mais se beneficiam da assistência de IA e como melhorar a experiência do agente.Esta versão inicial evoluirá com base no feedback dos usuários. Planejamos melhorar a confiabilidade da execução de ferramentas, suporte para comandos de longa duração, renderização de terminal e o autoconhecimento do Claude sobre suas capacidades nas próximas semanas.Relate bugs diretamente com o comando /bug ou através do nosso repositório GitHub.

​
Antes de começar

​
Verifique os requisitos do sistema

  • Sistemas Operacionais: macOS 10.15+, Ubuntu 20.04+/Debian 10+ ou Windows via WSL
  • Hardware: mínimo de 4GB de RAM
  • Software:
    • Node.js 18+
    • git 2.23+ (opcional)
    • GitHub ou GitLab CLI para fluxos de trabalho de PR (opcional)
    • ripgrep (rg) para busca avançada de arquivos (opcional)
  • Rede: Conexão com a internet necessária para autenticação e processamento de IA
  • Localização: Disponível apenas em países suportados
Solução de problemas de instalação do WSLAtualmente, o Claude Code não é executado diretamente no Windows e requer o WSL. Se você encontrar problemas no WSL:
  1. Problemas de detecção de OS/plataforma: Se você receber um erro durante a instalação, o WSL pode estar usando o npm do Windows. Tente:
    • Execute npm config set os linux antes da instalação
    • Instale com npm install -g @anthropic-ai/claude-code --force --no-os-check (NÃO use sudo)
  2. Erros de Node não encontrado: Se você vir exec: node: not found ao executar claude, seu ambiente WSL pode estar usando uma instalação do Windows do Node.js. Você pode confirmar isso com which npm e which node, que devem apontar para caminhos Linux começando com /usr/ em vez de /mnt/c/. Para corrigir isso, tente instalar o Node através do gerenciador de pacotes da sua distribuição Linux ou via nvm.

​
Instalar e autenticar

1

Instale o Claude Code

Execute no seu terminal: npm install -g @anthropic-ai/claude-code
NÃO use sudo npm install -g, pois isso pode levar a problemas de permissão e riscos de segurança. Se você encontrar erros de permissão, consulte configurar Claude Code para soluções recomendadas.
2

Navegue até seu projeto

cd diretório-do-seu-projeto
3

Inicie o Claude Code

Execute claude para iniciar
4

Complete a autenticação

O Claude Code oferece duas opções de autenticação:
  • Console Anthropic: A opção padrão. Conecte-se através do Console Anthropic e complete o processo OAuth. Requer faturamento ativo em console.anthropic.com.
  • Plano Max: Assine o plano Max do Claude para uma única assinatura que inclui tanto o Claude Code quanto a interface web. Obtenha mais valor pelo mesmo preço enquanto gerencia sua conta em um só lugar. Faça login com sua conta Claude.ai. Durante o lançamento, escolha a opção que corresponde ao seu tipo de assinatura.

​
Recursos e fluxos de trabalho principais

O Claude Code opera diretamente no seu terminal, entendendo o contexto do seu projeto e realizando ações reais. Não é necessário adicionar arquivos manualmente ao contexto - o Claude explorará sua base de código conforme necessário.

​
Segurança e privacidade por design

A segurança do seu código é primordial. A arquitetura do Claude Code garante:
  • Conexão direta com a API: Suas consultas vão diretamente para a API da Anthropic sem servidores intermediários
  • Funciona onde você trabalha: Opera diretamente no seu terminal
  • Entende o contexto: Mantém consciência de toda a estrutura do seu projeto
  • Toma ação: Realiza operações reais como edição de arquivos e criação de commits

​
De perguntas a soluções em segundos

# Faça perguntas sobre sua base de código
claude
> como funciona nosso sistema de autenticação?

# Crie um commit com um comando
claude commit

# Corrija problemas em vários arquivos
claude "corrija os erros de tipo no módulo de autenticação"

​
Inicialize seu projeto

Para usuários de primeira vez, recomendamos:
  1. Inicie o Claude Code com claude
  2. Experimente um comando simples como resuma este projeto
  3. Gere um guia de projeto CLAUDE.md com /init
  4. Peça ao Claude para fazer commit do arquivo CLAUDE.md gerado no seu repositório

​
Use o Claude Code para tarefas comuns

O Claude Code opera diretamente no seu terminal, entendendo o contexto do seu projeto e realizando ações reais. Não é necessário adicionar arquivos manualmente ao contexto - o Claude explorará sua base de código conforme necessário.

​
Entenda código desconhecido

> o que o sistema de processamento de pagamento faz?
> encontre onde as permissões de usuário são verificadas
> explique como funciona a camada de cache

​
Automatize operações Git

> faça commit das minhas alterações
> crie um pr
> qual commit adicionou testes para markdown em dezembro?
> rebase na main e resolva quaisquer conflitos de mesclagem

​
Edite código de forma inteligente

> adicione validação de entrada ao formulário de cadastro
> refatore o logger para usar a nova API
> corrija a condição de corrida na fila de trabalho

​
Teste e depure seu código

> execute testes para o módulo de autenticação e corrija falhas
> encontre e corrija vulnerabilidades de segurança
> explique por que este teste está falhando

​
Incentive um pensamento mais profundo

Para problemas complexos, peça explicitamente ao Claude para pensar mais profundamente: 
> pense sobre como devemos arquitetar o novo serviço de pagamento
> pense bem sobre os casos extremos em nosso fluxo de autenticação
O Claude Code mostrará quando o Claude estiver usando pensamento estendido (disponível no Claude Sonnet 3.7, Claude Opus 4). Você pode proativamente pedir ao Claude para “pensar” ou “pensar profundamente” para tarefas que exigem mais planejamento. Sugerimos que você primeiro conte ao Claude sobre sua tarefa e deixe-o reunir contexto do seu projeto. Em seguida, peça para ele “pensar” para criar um plano.
O Claude pensará mais com base nas palavras que você usa. Por exemplo, “pense bem” acionará mais pensamento estendido do que dizer apenas “pense”.Para mais dicas, veja Dicas de pensamento estendido.

​
Automatize fluxos de trabalho de CI e infraestrutura

O Claude Code vem com um modo não interativo para execução sem interface. Isso é especialmente útil para executar o Claude Code em contextos não interativos como scripts, pipelines e Github Actions. Use --print (-p) para executar o Claude em modo não interativo. Neste modo, você pode definir a variável de ambiente ANTHROPIC_API_KEY para fornecer uma chave de API personalizada. O modo não interativo é especialmente útil quando você pré-configura o conjunto de comandos que o Claude pode usar: 
export ANTHROPIC_API_KEY=sk_...
claude -p "atualize o README com as últimas alterações" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Write --disallowedTools ...

​
Controle o Claude Code com comandos

​
Comandos CLI

ComandoDescriçãoExemplo
claudeIniciar REPL interativoclaude
claude "consulta"Iniciar REPL com prompt inicialclaude "explique este projeto"
claude -p "consulta"Executar consulta única e sairclaude -p "explique esta função"
cat arquivo | claude -p "consulta"Processar conteúdo canalizadocat logs.txt | claude -p "explique"
claude configConfigurar definiçõesclaude config set --global theme dark
claude updateAtualizar para a versão mais recenteclaude update
claude mcpConfigurar servidores de Protocolo de Contexto de ModeloVeja a seção MCP nos tutoriais
Flags CLI:
  • --print (-p): Imprimir resposta sem modo interativo
  • --json: Retornar saída JSON no modo --print, útil para scripts e automação
  • --verbose: Habilitar registro detalhado, mostra saída completa turno a turno (útil para depuração em ambos os modos, print e interativo)
  • --dangerously-skip-permissions: Pular prompts de permissão

​
Comandos de barra

Controle o comportamento do Claude dentro de uma sessão:
ComandoFinalidade
/bugRelatar bugs (envia a conversa para a Anthropic)
/clearLimpar histórico de conversa
/compact [instruções]Compactar conversa com instruções de foco opcionais
/configVisualizar/modificar configuração
/costMostrar estatísticas de uso de tokens
/doctorVerifica a saúde da sua instalação do Claude Code
/helpObter ajuda de uso
/initInicializar projeto com guia CLAUDE.md
/loginAlternar contas Anthropic
/logoutSair da sua conta Anthropic
/memoryEditar arquivos de memória CLAUDE.md
/pr_commentsVisualizar comentários de pull request
/reviewSolicitar revisão de código
/terminal-setupInstalar atalho de tecla Shift+Enter para novas linhas (apenas iTerm2 e VSCode)
/vimEntrar no modo vim para alternar entre modos de inserção e comando

​
Gerencie a memória do Claude

O Claude Code pode lembrar suas preferências entre sessões, como diretrizes de estilo e comandos comuns em seu fluxo de trabalho.

​
Determine o tipo de memória

O Claude Code oferece três locais de memória, cada um servindo a um propósito diferente:
Tipo de MemóriaLocalizaçãoPropósitoExemplos de Casos de Uso
Memória do projeto./CLAUDE.mdConvenções e conhecimento compartilhados pela equipeArquitetura do projeto, padrões de codificação, fluxos de trabalho comuns
Memória do projeto (local)./CLAUDE.local.mdPreferências pessoais específicas do projetoSuas URLs de sandbox, dados de teste preferidos
Memória do usuário~/.claude/CLAUDE.mdPreferências pessoais globaisPreferências de estilo de código, atalhos de ferramentas pessoais
Todos os arquivos de memória são automaticamente carregados no contexto do Claude Code quando iniciado.

​
Como o Claude procura memórias

O Claude Code lê memórias recursivamente: começando no cwd, o Claude Code percorre recursivamente até / e lê quaisquer arquivos CLAUDE.md ou CLAUDE.local.md que encontrar. Isso é especialmente conveniente ao trabalhar em repositórios grandes onde você executa o Claude Code em foo/bar/, e tem memórias tanto em foo/CLAUDE.md quanto em foo/bar/CLAUDE.md.

​
Adicione memórias rapidamente com o atalho #

A maneira mais rápida de adicionar uma memória é começar sua entrada com o caractere #: 
# Sempre use nomes de variáveis descritivos
Você será solicitado a selecionar em qual arquivo de memória armazenar isso.

​
Edite memórias diretamente com /memory

Use o comando de barra /memory durante uma sessão para abrir qualquer arquivo de memória no editor do seu sistema para adições ou organização mais extensas.

​
Melhores práticas de memória

  • Seja específico: “Use indentação de 2 espaços” é melhor que “Formate o código adequadamente”.
  • Use estrutura para organizar: Formate cada memória individual como um ponto de marcador e agrupe memórias relacionadas sob títulos markdown descritivos.
  • Revise periodicamente: Atualize as memórias conforme seu projeto evolui para garantir que o Claude esteja sempre usando as informações e o contexto mais atualizados.

​
Gerencie permissões e segurança

O Claude Code usa um sistema de permissões em camadas para equilibrar poder e segurança:
Tipo de FerramentaExemploAprovação NecessáriaComportamento “Sim, não pergunte novamente”
Somente leituraLeituras de arquivo, LS, GrepNãoN/A
Comandos BashExecução de shellSimPermanentemente por diretório de projeto e comando
Modificação de ArquivoEditar/escrever arquivosSimAté o fim da sessão

​
Ferramentas disponíveis para o Claude

O Claude Code tem acesso a um conjunto de ferramentas poderosas que o ajudam a entender e modificar sua base de código:
FerramentaDescriçãoPermissão Necessária
AgentExecuta um sub-agente para lidar com tarefas complexas de múltiplas etapasNão
BashExecuta comandos de shell em seu ambienteSim
GlobEncontra arquivos com base em padrões de correspondênciaNão
GrepPesquisa padrões no conteúdo de arquivosNão
LSLista arquivos e diretóriosNão
ReadLê o conteúdo de arquivosNão
EditFaz edições direcionadas em arquivos específicosSim
WriteCria ou sobrescreve arquivosSim
NotebookEditModifica células de notebook JupyterSim
NotebookReadLê e exibe conteúdo de notebook JupyterNão
WebFetchBusca conteúdo de uma URL especificadaSim
As regras de permissão podem ser configuradas usando /allowed-tools ou nas configurações de permissão.

​
Proteção contra injeção de prompt

Injeção de prompt é uma técnica onde um atacante tenta substituir ou manipular as instruções de um assistente de IA inserindo texto malicioso. O Claude Code inclui várias salvaguardas contra esses ataques:
  • Sistema de permissão: Operações sensíveis requerem aprovação explícita
  • Análise consciente do contexto: Detecta instruções potencialmente prejudiciais analisando a solicitação completa
  • Sanitização de entrada: Previne injeção de comandos processando entradas do usuário
  • Lista de bloqueio de comandos: Bloqueia comandos arriscados que buscam conteúdo arbitrário da web como curl e wget
Melhores práticas para trabalhar com conteúdo não confiável:
  1. Revise os comandos sugeridos antes da aprovação
  2. Evite canalizar conteúdo não confiável diretamente para o Claude
  3. Verifique alterações propostas em arquivos críticos
  4. Relate comportamento suspeito com /bug
Embora essas proteções reduzam significativamente o risco, nenhum sistema é completamente imune a todos os ataques. Sempre mantenha boas práticas de segurança ao trabalhar com qualquer ferramenta de IA.

​
Configure o acesso à rede

O Claude Code requer acesso a:
  • api.anthropic.com
  • statsig.anthropic.com
  • sentry.io
Inclua essas URLs na lista de permissões ao usar o Claude Code em ambientes em contêineres.

​
Variáveis de ambiente

O Claude Code suporta as seguintes variáveis de ambiente para controlar seu comportamento:
VariávelFinalidade
DISABLE_AUTOUPDATERDefina como 1 para desativar o atualizador automático
DISABLE_BUG_COMMANDDefina como 1 para desativar o comando /bug
DISABLE_COST_WARNINGSDefina como 1 para desativar mensagens de aviso de custo
DISABLE_ERROR_REPORTINGDefina como 1 para optar por não participar do relatório de erros do Sentry
DISABLE_TELEMETRYDefina como 1 para optar por não participar da telemetria do Statsig (observe que os eventos do Statsig não incluem dados do usuário como código, caminhos de arquivo ou comandos bash)
HTTP_PROXYEspecifique o servidor proxy HTTP para conexões de rede
HTTPS_PROXYEspecifique o servidor proxy HTTPS para conexões de rede
MCP_TIMEOUTTempo limite em milissegundos para inicialização do servidor MCP
MCP_TOOL_TIMEOUTTempo limite em milissegundos para execução de ferramentas MCP

​
Configure o Claude Code

Configure o Claude Code executando claude config no seu terminal, ou o comando /config ao usar o REPL interativo.

​
Opções de configuração

O Claude Code suporta configuração global e em nível de projeto. Para gerenciar suas configurações, use os seguintes comandos:
  • Listar configurações: claude config list
  • Ver uma configuração: claude config get <chave>
  • Alterar uma configuração: claude config set <chave> <valor>
  • Adicionar a uma configuração (para listas): claude config add <chave> <valor>
  • Remover de uma configuração (para listas): claude config remove <chave> <valor>
Por padrão, config altera sua configuração de projeto. Para gerenciar sua configuração global, use a flag --global (ou -g).

​
Configuração global

Para definir uma configuração global, use claude config set -g <chave> <valor>:
ChaveValorDescrição
autoUpdaterStatusdisabled ou enabledAtivar ou desativar o atualizador automático (padrão: enabled)
envJSON (ex. '{"FOO": "bar"}')Variáveis de ambiente que serão aplicadas a cada sessão
preferredNotifChanneliterm2, iterm2_with_bell, terminal_bell, ou notifications_disabledOnde você deseja receber notificações (padrão: i term2)
themedark, light, light-daltonized, ou dark-daltonizedTema de cores
verbosetrue ou falseSe deve mostrar saídas completas de bash e comandos (padrão: false)

​
Opções de permissão do atualizador automático

Quando o Claude Code detecta que não tem permissões suficientes para escrever no diretório de prefixo npm global (necessário para atualizações automáticas), você verá um aviso que aponta para esta página de documentação. Para soluções detalhadas para problemas do atualizador automático, consulte o guia de solução de problemas.

​
Recomendado: Criar um novo prefixo npm gravável pelo usuário

# Primeiro, salve uma lista de seus pacotes globais existentes para migração posterior
npm list -g --depth=0 > ~/npm-global-packages.txt

# Crie um diretório para seus pacotes globais
mkdir -p ~/.npm-global

# Configure o npm para usar o novo caminho de diretório
npm config set prefix ~/.npm-global

# Nota: Substitua ~/.bashrc por ~/.zshrc, ~/.profile ou outro arquivo apropriado para seu shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Aplique a nova configuração PATH
source ~/.bashrc

# Agora reinstale o Claude Code no novo local
npm install -g @anthropic-ai/claude-code

# Opcional: Reinstale seus pacotes globais anteriores no novo local
# Olhe para ~/npm-global-packages.txt e instale os pacotes que deseja manter
# npm install -g pacote1 pacote2 pacote3...
Por que recomendamos esta opção:
  • Evita modificar permissões de diretório do sistema
  • Cria um local limpo e dedicado para seus pacotes npm globais
  • Segue as melhores práticas de segurança
Como o Claude Code está em desenvolvimento ativo, recomendamos configurar atualizações automáticas usando a opção recomendada acima.

​
Desativando o atualizador automático

Se você preferir desativar o atualizador automático em vez de corrigir permissões, você pode usar: 
claude config set -g autoUpdaterStatus disabled

​
Configuração de projeto

Gerencie a configuração do projeto com claude config set <chave> <valor> (sem a flag -g):
ChaveValorDescrição
allowedToolsarray de ferramentasQuais ferramentas podem ser executadas sem aprovação manual
ignorePatternsarray de strings globQuais arquivos/diretórios são ignorados ao usar ferramentas
Por exemplo: 
# Permitir que npm test seja executado sem aprovação
claude config add allowedTools "Bash(npm test)"

# Permitir que npm test e qualquer um de seus subcomandos sejam executados sem aprovação
claude config add allowedTools "Bash(npm test:*)"

# Instruir o Claude a ignorar node_modules
claude config add ignorePatterns node_modules
claude config add ignorePatterns "node_modules/**"
Veja Permissões para o formato de regras allowedTools.

​
Otimize sua configuração de terminal

O Claude Code funciona melhor quando seu terminal está configurado adequadamente. Siga estas diretrizes para otimizar sua experiência. Shells suportados:
  • Bash
  • Zsh
  • Fish

​
Temas e aparência

O Claude não pode controlar o tema do seu terminal. Isso é gerenciado pelo seu aplicativo de terminal. Você pode combinar o tema do Claude Code com seu terminal durante a integração ou a qualquer momento através do comando /config

​
Quebras de linha

Você tem várias opções para inserir quebras de linha no Claude Code:
  • Escape rápido: Digite \ seguido de Enter para criar uma nova linha
  • Atalho de teclado: Pressione Option+Enter (Meta+Enter) com a configuração adequada
Para configurar Option+Enter no seu terminal: Para Mac Terminal.app:
  1. Abra Configurações → Perfis → Teclado
  2. Marque “Usar Option como tecla Meta”
Para iTerm2 e terminal VSCode:
  1. Abra Configurações → Perfis → Teclas
  2. Em Geral, defina a tecla Option Esquerda/Direita para “Esc+”
Dica para usuários de iTerm2 e VSCode: Execute /terminal-setup dentro do Claude Code para configurar automaticamente Shift+Enter como uma alternativa mais intuitiva.

​
Configuração de notificações

Nunca perca quando o Claude completa uma tarefa com a configuração adequada de notificações:
Notificações de campainha do terminal
Ative alertas sonoros quando as tarefas forem concluídas: 
claude config set --global preferredNotifChannel terminal_bell
Para usuários de macOS: Não se esqueça de ativar as permissões de notificação em Configurações do Sistema → Notificações → [Seu Aplicativo de Terminal].
Notificações do sistema iTerm 2
Para alertas do iTerm 2 quando as tarefas forem concluídas:
  1. Abra as Preferências do iTerm 2
  2. Navegue até Perfis → Terminal
  3. Ative “Silenciar campainha” e “Enviar notificação quando inativo”
  4. Defina seu atraso de notificação preferido
Observe que essas notificações são específicas do iTerm 2 e não estão disponíveis no Terminal padrão do macOS.

​
Lidando com entradas grandes

Ao trabalhar com código extenso ou instruções longas:
  • Evite colar diretamente: O Claude Code pode ter dificuldades com conteúdo colado muito longo
  • Use fluxos de trabalho baseados em arquivos: Escreva conteúdo em um arquivo e peça ao Claude para lê-lo
  • Esteja ciente das limitações do VS Code: O terminal do VS Code é particularmente propenso a truncar colagens longas

​
Modo Vim

O Claude Code suporta um subconjunto de atalhos de teclado do Vim que podem ser ativados com /vim ou configurados via /config. O subconjunto suportado inclui:
  • Alternância de modo: Esc (para NORMAL), i/I, a/A, o/O (para INSERT)
  • Navegação: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Edição: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)

​
Gerencie custos efetivamente

O Claude Code consome tokens para cada interação. O custo médio é de $6 por desenvolvedor por dia, com custos diários permanecendo abaixo de $12 para 90% dos usuários.

​
Acompanhe seus custos

  • Use /cost para ver o uso da sessão atual
  • Usuários do Console Anthropic:
  • Usuários do plano Max: O uso está incluído na sua assinatura do plano Max

​
Reduza o uso de tokens

  • Compacte conversas:
    • O Claude usa compactação automática por padrão quando o contexto excede 95% da capacidade
    • Alterne a compactação automática: Execute /config e navegue até “Auto-compact enabled”
    • Use /compact manualmente quando o contexto ficar grande
    • Adicione instruções personalizadas: /compact Foque em amostras de código e uso de API
    • Personalize a compactação adicionando ao CLAUDE.md: 
      # Instruções de resumo

Quando estiver usando compact, por favor foque na saída de testes e mudanças de código
  • Escreva consultas específicas: Evite solicitações vagas que acionem escaneamento desnecessário
  • Divida tarefas complexas: Divida grandes tarefas em interações focadas
  • Limpe o histórico entre tarefas: Use /clear para redefinir o contexto
Os custos podem variar significativamente com base em:
  • Tamanho da base de código sendo analisada
  • Complexidade das consultas
  • Número de arquivos sendo pesquisados ou modificados
  • Comprimento do histórico de conversas
  • Frequência de compactação de conversas
Para implantações em equipe, recomendamos começar com um pequeno grupo piloto para estabelecer padrões de uso antes de uma implantação mais ampla.

​
Configuração de modelo

Por padrão, o Claude Code usa claude-opus-4-20250514. Você pode substituir isso usando as seguintes variáveis de ambiente: 
# API Anthropic
ANTHROPIC_MODEL='claude-opus-4-20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-opus-4@20250514'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'
Você também pode definir essas variáveis usando a configuração global: 
# Configurar para API Anthropic
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-20250514"}'

# Configurar para Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-opus-4-20250514-v1:0"}'

# Configurar para Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-opus-4@20250514"}'
Veja nossa referência de nomes de modelos para todos os modelos disponíveis em diferentes provedores.

​
Use com APIs de terceiros

O Claude Code requer acesso aos modelos Claude Sonnet 3.7 e Claude Haiku 3.5, independentemente do provedor de API que você usar.

​
Conecte-se ao Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1
Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_BEDROCK_BASE_URL: 
ANTHROPIC_BEDROCK_BASE_URL='https://seu-url-de-proxy'
Se você não tiver o cache de prompt ativado, também defina: 
DISABLE_PROMPT_CACHING=1
Requer credenciais padrão do SDK AWS (por exemplo, ~/.aws/credentials ou variáveis de ambiente relevantes como AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Para configurar credenciais AWS, execute: 
aws configure
Entre em contato com o Amazon Bedrock para cache de prompt para custos reduzidos e limites de taxa mais altos.
Os usuários precisarão de acesso aos modelos Claude Sonnet 3.7 e Claude Haiku 3.5 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.

​
Conecte-se ao Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=seu-id-de-projeto
Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_VERTEX_BASE_URL: 
ANTHROPIC_VERTEX_BASE_URL='https://seu-url-de-proxy'
Se você não tiver o cache de prompt ativado, também defina: 
DISABLE_PROMPT_CACHING=1
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 de acesso aos modelos Claude Sonnet 3.7 e Claude Haiku 3.5 em seu projeto Vertex AI.
Requer credenciais GCP padrão configuradas através da google-auth-library. Para configurar credenciais GCP, execute: 
gcloud auth application-default login
Para a melhor experiência, entre em contato com o Google para limites de taxa elevados.

​
Conecte-se 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 essas configurações com as configurações específicas do Bedrock e do Vertex.

​
Variáveis de ambiente

  • ANTHROPIC_AUTH_TOKEN: Valor personalizado para os cabeçalhos Authorization e Proxy-Authorization (o valor que você definir aqui será prefixado com Bearer )
  • ANTHROPIC_CUSTOM_HEADERS: Cabeçalhos personalizados que você deseja adicionar à solicitação (no formato Nome: Valor)
  • HTTP_PROXY: Defina a URL do proxy HTTP
  • HTTPS_PROXY: Defina 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 na 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)

​
Implementação de referência de contêiner de desenvolvimento

O Claude Code fornece uma configuração de contêiner de desenvolvimento para equipes que precisam de ambientes consistentes e seguros. Esta configuração de devcontainer pré-configurada funciona perfeitamente com a extensão Remote - Containers do VS Code e ferramentas similares. As medidas de segurança aprimoradas do contêiner (isolamento e regras de firewall) permitem que você execute claude --dangerously-skip-permissions para ignorar prompts de permissão para operação não assistida. Incluímos uma implementação de referência que você pode personalizar para suas necessidades.
Embora o devcontainer forneça proteções substanciais, nenhum sistema é completamente imune a todos os ataques. Sempre mantenha boas práticas de segurança e monitore as atividades do Claude.

​
Principais recursos

  • Node.js pronto para produção: Construído sobre o Node.js 20 com dependências de desenvolvimento essenciais
  • Segurança por design: Firewall personalizado restringindo o acesso à rede apenas aos serviços necessários
  • Ferramentas amigáveis ao desenvolvedor: Inclui git, ZSH com melhorias de produtividade, fzf e mais
  • Integração perfeita com VS Code: Extensões pré-configuradas e configurações otimizadas
  • Persistência de sessão: Preserva histórico de comandos e configurações entre reinicializações de contêiner
  • Funciona em qualquer lugar: Compatível com ambientes de desenvolvimento macOS, Windows e Linux

​
Começando em 4 passos

  1. Instale o VS Code e a extensão Remote - Containers
  2. Clone o repositório de implementação de referência do Claude Code
  3. Abra o repositório no VS Code
  4. Quando solicitado, clique em “Reabrir no Container” (ou use a Paleta de Comandos: Cmd+Shift+P → “Remote-Containers: Reopen in Container”)

​
Detalhamento da configuração

A configuração do devcontainer consiste em três componentes principais:
  • devcontainer.json: Controla configurações de contêiner, extensões e montagens de volume
  • Dockerfile: Define a imagem do contêiner e ferramentas instaladas
  • init-firewall.sh: Estabelece regras de segurança de rede

​
Recursos de segurança

O contêiner implementa uma abordagem de segurança em várias camadas com sua configuração de firewall:
  • Controle de acesso preciso: Restringe conexões de saída apenas para domínios na lista de permissões (registro npm, GitHub, API Anthropic, etc.)
  • Política de negação por padrão: Bloqueia todo outro acesso de rede externo
  • Verificação de inicialização: Valida regras de firewall quando o contêiner inicializa
  • Isolamento: Cria um ambiente de desenvolvimento seguro separado do seu sistema principal

​
Opções de personalização

A configuração do devcontainer foi projetada para ser adaptável às suas necessidades:
  • Adicione ou remova extensões do VS Code com base no seu fluxo de trabalho
  • Modifique alocações de recursos para diferentes ambientes de hardware
  • Ajuste permissões de acesso à rede
  • Personalize configurações de shell e ferramentas de desenvolvedor

​
Próximos passos

Tutoriais do Claude Code

Guias passo a passo para tarefas comuns

Solução de problemas

Soluções para problemas comuns com o Claude Code

Implementação de referência

Clone nossa implementação de referência de contêiner de desenvolvimento.

​
Licença e uso de dados

O Claude Code é fornecido como uma prévia de pesquisa Beta sob os Termos de Serviço Comerciais da Anthropic.

​
Como usamos seus dados

Nosso objetivo é ser totalmente transparentes sobre como usamos seus dados. Podemos usar feedback para melhorar nossos produtos e serviços, mas não treinaremos modelos generativos usando seu feedback do Claude Code. Dada sua natureza potencialmente sensível, armazenamos transcrições de feedback do usuário por apenas 30 dias.

​
Transcrições de feedback

Se você optar por nos enviar feedback sobre o Claude Code, como transcrições de seu uso, a Anthropic pode usar esse feedback para depurar problemas relacionados e melhorar a funcionalidade do Claude Code (por exemplo, para reduzir o risco de bugs similares ocorrerem no futuro). Não treinaremos modelos generativos usando este feedback.

​
Salvaguardas de privacidade

Implementamos várias salvaguardas para proteger seus dados, incluindo períodos de retenção limitados para informações sensíveis, acesso restrito a dados de sessão do usuário e políticas claras contra o uso de feedback para treinamento de modelos. Para detalhes completos, por favor revise nossos Termos de Serviço Comerciais e Política de Privacidade.

​
Licença

© Anthropic PBC. Todos os direitos reservados. O uso está sujeito aos Termos de Serviço Comerciais da Anthropic.