Visão geral do Claude Code

Instale o NodeJS 18+ e, em seguida, execute:

npm install -g @anthropic-ai/claude-code

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

​

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

​

Instalar e autenticar

​

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.

​

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

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:

​

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:

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:

​

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:

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

​

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:

​

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

​

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

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:
  • Verifique o uso histórico no Console Anthropic (requer função de Administrador ou Faturamento)
  • Defina limites de gastos do workspace para o workspace do Claude Code (requer função de Administrador)
• 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

​

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"}'

​

Use com APIs de terceiros

​

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.

​

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

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.

​

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

​

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.