Visão geral do 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 rapidamente 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

​

Recursos e fluxos de trabalho principais

O Claude Code opera diretamente em seu terminal, entendendo o contexto do seu projeto e tomando ações reais. Não há necessidade de adicionar arquivos manualmente ao contexto - 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 direta com API: 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 editar arquivos e criar 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"

​

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

​

Instale e autentique

​

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 há necessidade de adicionar arquivos manualmente ao contexto - 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

​

Controle o Claude Code com comandos

​

Comandos CLI

Flags CLI:

• --print: Imprimir resposta sem modo interativo
• --verbose: Ativar registro 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:

​

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

​

Proteção 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ões: 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

​

Configurar acesso à rede

O Claude Code requer acesso a:

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

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

​

Otimize sua configuração de terminal e configure seu ambiente

O Claude Code funciona melhor quando seu terminal está configurado adequadamente. Siga estas diretrizes para otimizar sua experiência.

Shells suportados:

• Bash
• Zsh (Shell Fish não é atualmente suportado)

​

Temas e aparência

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 Claude completa uma tarefa com a configuração adequada de notificações:

​

Notificações de campainha do terminal

Ative alertas sonoros quando tarefas são completadas:

claude config set --global preferredNotifChannel terminal_bell

Para usuários macOS: Não esqueça de ativar 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. Ative “Silenciar campainha” e “Enviar notificação quando ocioso”
4. Defina seu atraso de notificação preferido

Note que estas 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 estas 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 varreduras desnecessárias
• Divida tarefas complexas: Divida grandes tarefas em interações focadas
• Limpe o histórico entre tarefas: Use /clear para resetar 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 conversa
• Frequência de compactação de conversas

​

Use com APIs de terceiros

​

Conecte ao Amazon Bedrock

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

Se você não tiver o cache de prompt ativado, 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). 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=seu-id-do-projeto

Requer credenciais GCP padrão configuradas através da google-auth-library. 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 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.

​

Recursos principais

• Node.js pronto para produção: Construído no 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 pré-configuradas e configurações 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 no Contêiner” (ou use a Paleta de Comandos: Cmd+Shift+P → “Remote-Containers: Reabrir no Contêiner”)

​

Detalhamento da configuração

A configuração do 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 do devcontainer é projetada para ser adaptável às suas necessidades:

• Adicione ou remova extensões do 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 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. Dado 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.