Como usar Claude Code do zero: guia para iniciantes sem experiência técnica

Passo 1: instale o Node.js. Acesse nodejs.org, baixe a versão LTS (recomendada) e instale. Isso leva 3 minutos.

Passo 2: abra o terminal. No Mac, pressione Cmd+Espaço, digite 'Terminal' e aperte Enter. No Windows, instale o WSL (Windows Subsystem for Linux) primeiro. No Linux, você já sabe onde fica.

Passo 3: instale o Claude Code rodando este comando no terminal: `npm install -g @anthropic-ai/claude-code`

Passo 4: inicie o Claude Code: `claude`

Passo 5: na primeira vez, ele vai pedir para autenticar com sua conta Anthropic. Siga as instruções na tela (abre o browser automaticamente).

Fim. O Claude Code está rodando e pronto para uso.

Primeiro teste: navegue até uma pasta com arquivos que você usa no trabalho. No terminal: `cd ~/Documents/seu-projeto`. Depois inicie o Claude Code com `claude`.

Agora peça algo simples: 'Liste os arquivos desta pasta e me diga quais são os mais recentes.' Ele lê a pasta e responde. Você não precisou copiar nada.

Segundo teste: crie um arquivo novo. 'Crie um arquivo chamado rascunho.md com um modelo de email de boas-vindas para novos clientes da [sua empresa].' Ele cria o arquivo. Abra no editor de texto para ver.

Terceiro teste: peça uma tarefa de análise. 'Leia o arquivo rascunho.md e me diga o que melhoraria na comunicação.' Ele lê o arquivo sem você precisar copiar e colar.

Esses três testes mostram o diferencial central: o Claude Code acessa seu sistema de arquivos. Isso muda tudo.

Iniciar o Claude Code: `claude`

Iniciar em uma pasta específica: `cd /caminho/da/pasta && claude`

Ver os agentes disponíveis: dentro do Claude Code, digitar `/agents`

Ver os comandos disponíveis: digitar `/help`

Sair do Claude Code: digitar `exit` ou pressionar Ctrl+C

Limpar o contexto da conversa: digitar `/clear`

Além dos comandos, você interage em linguagem natural. 'Leia todos os arquivos .txt desta pasta e me dê um resumo de cada um.' 'Crie uma estrutura de pasta para um projeto de blog com seções de rascunhos, publicados e arquivados.' 'Analise este arquivo CSV e me diga quais são os 5 produtos mais vendidos.'

Quanto mais contexto você dá, melhor o resultado. Seja específico sobre o formato que quer receber, o tom, a extensão e qualquer restrição importante.

Agentes são os arquivos de instrução que transformam o Claude Code de uma conversa em um sistema de trabalho.

Crie uma pasta para seus agentes: `mkdir -p ~/.claude/agents`

Crie seu primeiro agente com qualquer editor de texto. Salve em `~/.claude/agents/nome-do-agente.md`.

Escreva as instruções em linguagem natural. Exemplo de agente de revisão de emails:

``` Você é um revisor de comunicação profissional.

Quando receber um email para revisar: 1. Corrija erros gramaticais sem mudar o significado 2. Identifique pontos onde o tom está muito formal ou muito informal para o contexto 3. Sugira uma versão de assunto mais eficaz se o atual for genérico 4. Indique se o CTA (chamada para ação) está claro

Formato: texto revisado + lista de comentários em tópicos. ```

Para usar: no Claude Code, chame `/agents`, selecione o agente e envie o email para revisão. O resultado é consistente toda vez.

Erro 1: pedir coisas muito vagas. 'Melhore este texto' gera resultado genérico. 'Revise este texto reduzindo parágrafos com mais de 4 linhas e eliminando adjetivos redundantes' gera resultado preciso.

Erro 2: não especificar o formato de saída. Se você quer uma tabela, diga que quer uma tabela. Se quer tópicos, diga que quer tópicos. O Claude Code segue sua especificação.

Erro 3: esquecer de informar o contexto. 'Escreva um email' é vago. 'Escreva um email para um cliente que atrasou o pagamento 15 dias, tom profissional mas direto, sem ameaças, com prazo de 5 dias úteis para regularizar' é específico.

Erro 4: tentar fazer tudo em uma instrução só. Divida tarefas complexas em etapas. O Claude Code mantém o contexto da conversa, então você pode construir sobre o que já foi feito.

Erro 5: não revisar o output. O Claude Code é uma ferramenta, não um substituto para julgamento. Revise o resultado antes de usar, especialmente em comunicações importantes.

O Claude Code travou ou ficou sem resposta: pressione Ctrl+C para interromper e tente novamente.

O resultado não está no formato esperado: seja mais específico na próxima instrução. 'Agora refaça em formato de tabela com duas colunas: categoria e descrição.'

O Claude Code não está encontrando os arquivos: verifique se você está na pasta certa com o comando `pwd` (mostra a pasta atual) e `ls` (lista os arquivos).

Esqueceu como usar um comando: `/help` dentro do Claude Code lista as opções disponíveis.

O processo de uso fica natural em poucos dias. O terminal parece intimidador no início, mas depois de uma semana de uso é só mais uma janela aberta.