Claude Code

Claude Code: guia completo de A a Z

Nick Bargiela · 15 de julho de 2026 · 10 min leitura

Claude Code é uma CLI (interface de linha de comando) que executa Claude diretamente no seu terminal, com acesso aos arquivos do seu computador, ao seu editor de código e, via MCP, a qualquer sistema externo que você configure.

Isso muda a categoria da ferramenta. Claude no navegador é como ter um consultor que você liga para fazer perguntas. Claude Code é como ter esse consultor trabalhando no seu computador, com acesso às suas pastas, seus arquivos, seus sistemas, e capacidade de executar tarefas autonomamente enquanto você faz outra coisa.

Este guia cobre tudo: o que é, como instalar, como configurar, os casos de uso que funcionam para não-programadores e os recursos avançados para quem quer ir além.

O que Claude Code faz que o Claude no navegador não faz

Lê arquivos do seu computador. Você pode pedir para o Claude analisar um PDF, um Excel, um contrato, uma pasta inteira de documentos. Sem limite de tamanho de upload, sem copiar e colar.

Escreve e edita arquivos diretamente. Claude Code pode criar um arquivo, editar um documento existente, reorganizar uma pasta, sem que você precise fazer nada manualmente.

Executa comandos no terminal. Instalar pacotes, rodar scripts, processar arquivos, buscar informação na web. Tudo o que você faria no terminal, Claude pode fazer por você.

Trabalha em projetos longos com memória. Porque está rodando localmente com acesso ao contexto do projeto, Claude Code não perde o fio depois de 10 perguntas. Você define o contexto uma vez e ele persiste.

Opera de forma autônoma. Você pode dar uma tarefa grande e deixar o Claude trabalhar enquanto você faz outra coisa. Ele vai executar, encontrar problemas, ajustar e seguir em frente, reportando o progresso.

Instalação em 5 minutos

Você precisa de Node.js instalado no computador. Depois, no terminal:

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

Para verificar que funcionou:

claude --version

Para iniciar uma sessão interativa numa pasta de projeto:

cd /caminho/do/projeto
claude

O primeiro uso vai pedir autenticação com sua conta Anthropic. Depois disso, você está dentro.

Para uma orientação mais detalhada voltada para quem nunca usou terminal, Claude Code para não-programadores tem um guia passo a passo.

CLAUDE.md: o contexto que persiste entre sessões

O CLAUDE.md é o arquivo mais importante para quem usa Claude Code de forma séria. É um arquivo Markdown que fica na raiz do seu projeto e é carregado automaticamente toda vez que você inicia uma sessão naquele diretório.

O que colocar nele:

Contexto do projeto: o que é, qual o objetivo, qual o stack
Convenções: como você nomeia arquivos, qual formato você usa, o que você quer que Claude evite
Informações de acesso: onde ficam as configurações, como rodar o projeto
Regras de comportamento: o que Claude deve ou não deve fazer naquele contexto

Exemplo simples para um projeto de conteúdo:

# Meu Blog

Escrevo sobre IA aplicada a negócios. Meu público são gestores e donos de PMEs.

## Tom
Direto, sem jargão, sem entusiasmo exagerado. Exemplos concretos antes de conceitos abstratos.

## Estrutura de pastas
- rascunhos/ → artigos em andamento
- publicados/ → artigos finalizados
- pesquisa/ → fontes e notas por tema

## Regras
- Nunca inventar dados ou estatísticas
- Sempre incluir pelo menos 2 referências externas por artigo
- Não usar em-dashes (—) no texto

Com esse arquivo, você não precisa reexplicar o contexto em toda sessão. O Claude já sabe onde está e como trabalhar.

Slash commands e skills: capacidades extras

Claude Code tem um sistema de slash commands que expande as capacidades padrão. Você digita /nome-do-comando e ativa um comportamento específico.

Alguns exemplos de commands úteis:

/help: lista todos os comandos disponíveis
/clear: limpa o contexto da conversa atual
/compact: comprime o histórico para liberar contexto
/cost: mostra o custo estimado da sessão

Skills são extensões criadas pela comunidade ou por você. Cada skill tem um nome e um arquivo de instrução. Você instala colocando o arquivo em .claude/skills/ e automaticamente vira um slash command.

Exemplos de skills disponíveis:

Skills de revisão de código
Skills de escrita com voz específica
Skills de depuração
Skills de geração de testes

Para não-programadores, skills de conteúdo são as mais úteis: você configura uma vez como quer que o Claude escreva para você e reutiliza em todas as sessões.

MCP: conectar Claude a qualquer sistema externo

MCP (Model Context Protocol) é o padrão que permite ao Claude Code se comunicar com serviços externos como se fossem ferramentas nativas. É uma das funcionalidades mais poderosas da plataforma.

Com MCP, Claude Code pode:

Ler e criar páginas no Notion
Criar cards no Trello ou issues no Linear
Buscar informações na web
Enviar emails
Acessar bancos de dados
Interagir com qualquer API que tenha um servidor MCP

Para entender o conceito mais a fundo, o que é MCP e por que importa explica o protocolo sem jargão técnico.

A configuração básica fica em .mcp.json na raiz do projeto. Para servidores MCP disponíveis, o repositório awesome-claude-code no GitHub reúne uma lista atualizada.

Hooks: automação baseada em eventos

Hooks são scripts que rodam automaticamente em resposta a eventos do Claude Code. Você configura em settings.json e eles executam antes ou depois de ações específicas.

Exemplos de hooks úteis:

Antes de editar um arquivo: rodar um backup automático Depois de criar um arquivo: adicionar automaticamente ao índice do projeto Antes de fazer um commit: rodar verificação de qualidade Depois de uma sessão: salvar o log em um arquivo de contexto

Para usuários não-técnicos, hooks são o ponto onde Claude Code pode ser configurado para operar quase como um colaborador autônomo. Você define o que deve acontecer em cada situação e o Claude executa sem precisar de instrução manual.

Subagentes: trabalho paralelo

Claude Code suporta lançar subagentes: instâncias secundárias do Claude que executam tarefas específicas em paralelo com a sessão principal.

Cenário prático: você está trabalhando em um projeto e pede para o Claude verificar a consistência de 20 arquivos ao mesmo tempo que gera um relatório e busca informações na web. Sem subagentes, isso seria sequencial. Com subagentes, tudo roda ao mesmo tempo.

Para quem trabalha com automação de conteúdo, análise de dados ou qualquer tarefa que envolva múltiplas frentes simultâneas, subagentes reduzem drasticamente o tempo de execução.

Casos de uso para não-programadores

Uma das maiores barreiras de adoção do Claude Code é o nome. “Code” soa como coisa de programador. Não é. É coisa de qualquer pessoa que precisa de um assistente que opera no computador, não só no navegador.

Gestão de arquivos e documentos. Você tem 300 PDFs desorganizados. Pede para o Claude renomear, classificar em pastas por tema e criar um índice. Trabalho de horas em minutos.

Análise de planilhas grandes. Você tem um Excel com 50 mil linhas que o navegador não consegue processar. Claude Code lê, analisa e devolve os insights que você precisa.

Pesquisa e síntese. Você tem 15 artigos para ler antes de uma reunião. Claude Code lê todos, sintetiza os pontos principais e destaca as contradições entre eles.

Produção de conteúdo em escala. Você tem um banco de 200 tópicos para artigos. Claude Code gera os rascunhos em lote, seguindo o tom e a estrutura que você definiu no CLAUDE.md.

Automação de relatórios. Toda semana você compila dados de três fontes diferentes em um relatório. Com Claude Code, você configura uma vez e executa toda semana em segundos.

Para casos de uso práticos sem nenhuma linha de código, não precisa de curso pago para usar Claude Code tem exemplos concretos com passo a passo.

Modos de execução

Claude Code tem três modos principais de operação:

Modo interativo (padrão): você está presente, conversando, aprovando cada ação. Ideal para tarefas novas onde você quer acompanhar o raciocínio.

Modo autônomo (headless): você passa uma tarefa e deixa o Claude trabalhar. Você volta mais tarde para ver o resultado. Ideal para tarefas longas e repetitivas que você já testou antes.

Modo planejamento: antes de executar, o Claude apresenta o plano do que vai fazer e espera aprovação. Bom para tarefas que afetam arquivos importantes ou operações irreversíveis.

Claude Code vs Claude no navegador: quando usar cada um

Situação	Melhor opção
Perguntas rápidas, pesquisa, brainstorm	Claude.ai (navegador)
Análise de arquivos grandes do seu computador	Claude Code
Produção de conteúdo com templates e padrões definidos	Claude Code
Automação que roda toda semana ou todo dia	Claude Code
Colaboração com equipe em tempo real	Claude.ai (Projects)
Integração com sistemas da empresa	Claude Code + MCP

A regra geral: se você vai fazer a mesma coisa mais de uma vez, Claude Code. Se é uma tarefa pontual de pesquisa ou geração de texto, o navegador é suficiente.

Segurança: o que Claude Code pode e não pode fazer por padrão

Por padrão, Claude Code pede confirmação antes de executar ações irreversíveis: deletar arquivos, enviar emails, fazer push de código para repositório remoto. Você vê o que vai acontecer antes de aprovar.

Você pode ajustar os limites de permissão no settings.json. Para operações de alto risco, a recomendação é manter as confirmações ativas até ter confiança no comportamento do modelo naquele contexto específico.

O que nunca colocar no Claude Code sem cuidado: senhas, chaves de API, dados de clientes com PII. Para esses casos, use variáveis de ambiente, não texto direto nos prompts.

Por onde começar

Instale e rode a primeira sessão em um projeto simples. Uma pasta de documentos, não o projeto mais crítico da empresa.
Crie o CLAUDE.md do projeto. Escreva o contexto, as convenções e duas ou três regras de comportamento. Menos de 20 minutos.
Faça uma tarefa de organização ou análise. Peça para o Claude ler e resumir uma pasta de arquivos ou gerar um relatório de uma planilha. Veja como ele opera.
Explore um MCP. Conecte ao Notion ou ao seu gerenciador de tarefas. Peça para o Claude criar um card ou atualizar uma página diretamente da sessão.
Configure um hook simples. Algo pequeno, como salvar um log de cada sessão em um arquivo de notas.

Cada passo expande o que você consegue fazer. O aprendizado com Claude Code é incremental: você começa simples, vai entendendo o que é possível e vai expandindo conforme a necessidade.

Para entender os agentes de IA de forma mais ampla antes de ir fundo no Claude Code, vale ter o contexto do que significa delegar processos a sistemas autônomos.

Para implementar Claude Code na sua operação com um plano de adoção: veja como posso ajudar.

COMENTÁRIOS

Nenhum comentário ainda.