Visão geral do Claude Code

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

Claude Code é uma ferramenta de codificação agêntica que vive em seu terminal, entende sua base de código e ajuda você a codificar mais rápido através 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 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 através do histórico do git, resolver conflitos de merge 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 RAM
• Software:
  • Node.js 18+
  • git 2.23+ (opcional)
  • GitHub ou GitLab CLI para fluxos de trabalho de PR (opcional)
  • ripgrep (rg) para busca aprimorada 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 principais e fluxos de trabalho

O Claude Code opera diretamente em seu terminal, entendendo o contexto do seu projeto e tomando ações reais. Não é necessário adicionar arquivos manualmente ao contexto - o Claude explorará sua base de código conforme necessário. O Claude Code usa claude-3-7-sonnet-20250219 por padrão.

​

Segurança e privacidade por design

A segurança do seu código é primordial. A arquitetura do Claude Code garante:

• Conexão API direta: Suas consultas vão direto para a API da Anthropic sem servidores intermediários
• Funciona onde você trabalha: Opera diretamente em 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 iniciantes, recomendamos:

1. Inicie o Claude Code com claude
2. Tente um comando simples como resuma este projeto
3. Gere um guia CLAUDE.md do projeto com /init
4. Peça ao Claude para fazer commit do arquivo CLAUDE.md gerado em seu repositório

​

Use o Claude Code para tarefas comuns

O Claude Code opera diretamente em seu terminal, entendendo o contexto do seu projeto e tomando 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 não familiar

> 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?
> faça rebase na main e resolva quaisquer conflitos de merge

​

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 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 (3.7 Sonnet) estiver usando pensamento estendido. 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. Então, 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 headless. 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 API personalizada.

O modo não interativo é especialmente útil quando você pré-configura o conjunto de comandos que o Claude tem permissão para usar:

export ANTHROPIC_API_KEY=sk_...
claude -p "atualize o README com as últimas alterações" --allowedTools "Bash(git diff:*)" "Bash(git log:*)" Edit

​

Controle o Claude Code com comandos

​

Comandos CLI

Flags CLI:

• --print: Imprimir resposta sem modo interativo
• --verbose: Habilitar logging detalhado
• --dangerously-skip-permissions: Pular prompts de permissão (apenas em contêineres Docker sem internet)

​

Comandos com barra

Controle o comportamento do Claude dentro de uma sessão:

​

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:

​

Proteja contra injeção de prompt

Injeção de prompt é uma técnica onde um atacante tenta sobrescrever ou manipular as instruções de um assistente de IA inserindo texto malicioso. O Claude Code inclui várias proteções 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 comando 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 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. Reporte comportamento suspeito com /bug

​

Configure acesso à rede

O Claude Code requer acesso a:

• api.anthropic.com
• statsig.anthropic.com
• sentry.io

Liste na lista de permissões essas URLs ao usar o Claude Code em ambientes containerizados.

​

Configure o Claude Code

Configure o Claude Code executando claude config em 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 auto-atualizador

Quando o Claude Code detecta que não tem permissões suficientes para escrever em seu diretório npm prefix 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 auto-atualizador, veja o guia de solução de problemas.

​

Recomendado: Criar um novo npm prefix 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 do 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 em ~/npm-global-packages.txt e instale os pacotes que você quer 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.

​

Desabilitando o auto-atualizador

Se você preferir desabilitar o auto-atualizador 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 execute sem aprovação
claude config add allowedTools "Bash(npm test)"

# Permitir que npm test e qualquer um de seus sub-comandos executem 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/**"

​

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 é controlado pelo seu aplicativo de terminal. Você pode combinar o tema do Claude Code com seu terminal durante a integração ou a qualquer momento via 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 em 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 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

Habilite alertas sonoros quando tarefas são completadas:

claude config set --global preferredNotifChannel terminal_bell

Para usuários macOS: Não esqueça de habilitar permissões de notificação em Configurações do Sistema → Notificações → [Seu App de Terminal].

Notificações do sistema iTerm 2

Para alertas do iTerm 2 quando tarefas são completadas:

1. Abra Preferências do iTerm 2
2. Navegue até Perfis → Terminal
3. Habilite “Silenciar campainha” e “Enviar not

ificação quando ocioso” 4. Defina seu atraso de notificação preferido

Note 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 colagem direta: O Claude Code pode ter dificuldades com conteúdo colado muito longo
• Use fluxos de trabalho baseados em arquivo: 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

Ao configurar essas definições, você criará um fluxo de trabalho mais suave e eficiente com o Claude Code.

​

Gerencie custos efetivamente

O Claude Code consome tokens para cada interação. O uso típico custa entre $5-10 por desenvolvedor por dia, mas pode exceder $100 por hora durante uso intensivo.

​

Acompanhe seus custos

• Use /cost para ver o uso da sessão atual
• Revise o resumo de custos exibido ao sair
• Verifique o uso histórico no Console Anthropic
• Defina Limites de Gastos

​

Reduza o uso de tokens

• Compacte conversas: Use /compact quando o contexto ficar grande
• Escreva consultas específicas: Evite solicitações vagas que disparam varredura desnecessária
• Divida tarefas complexas: Divida grandes tarefas em interações focadas
• Limpe histórico entre tarefas: Use /clear para resetar 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 conversa
• Frequência de compactação de conversas

​

Use com APIs de terceiros

​

Conecte ao Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Se você quiser sobrescrever o modelo padrão, você pode passar a variável de ambiente ANTHROPIC_MODEL (Claude 3.7 Sonnet é usado por padrão):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

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://your-proxy-url'

Se você não tiver cache de prompt habilitado, também defina:

DISABLE_PROMPT_CACHING=1

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 credenciais AWS, execute:

aws configure

Contate o Amazon Bedrock para cache de prompt para custos reduzidos e limites de taxa mais altos.

​

Conecte ao Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Se você quiser sobrescrever o modelo padrão, você pode passar a variável de ambiente ANTHROPIC_MODEL (Claude 3.7 Sonnet é usado por padrão):

ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'

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://your-proxy-url'

Se você não tiver cache de prompt habilitado, também defina:

DISABLE_PROMPT_CACHING=1

Requer credenciais GCP padrão configuradas através do google-auth-library. Para configurar credenciais GCP, execute:

gcloud auth application-default login

Para a melhor experiência, contate o Google para limites de taxa elevados.

​

Implementação de referência do 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 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.

​

Recursos principais

• Node.js pronto para produção: Construído sobre Node.js 20 com dependências de desenvolvimento essenciais
• Segurança por design: Firewall personalizado restringindo acesso de rede apenas a 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 e configurações pré-configuradas e otimizadas
• Persistência de sessão: Preserva histórico de comandos e configurações entre reinicializações do 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 em Contêiner” (ou use a Paleta de Comandos: Cmd+Shift+P → “Remote-Containers: Reabrir em Contêiner”)

​

Detalhamento da configuração

A configuração devcontainer consiste em três componentes principais:

• devcontainer.json: Controla configurações do 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 múltiplas 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 devcontainer é projetada para ser adaptável às suas necessidades:

• Adicione ou remova extensões VS Code baseado em 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 desenvolvimento

​

Próximos passos

​

Licença e uso de dados

O Claude Code é fornecido como uma prévia Beta de pesquisa 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ê escolher 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 limitados de retenção 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 modelo.

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.