Como criar um agente de IA sem programar: guia prático com Claude Code

Um agente não é um robô autônomo que age sozinho. É uma versão especializada do Claude com instruções específicas para um contexto. Pense assim: o Claude padrão é um generalista. Um agente é um especialista com persona, regras e foco definidos.

Exemplo concreto: o Claude padrão vai revisar um texto de forma genérica. Um agente de revisão de copy que você criou com as regras do seu tom de voz, lista de palavras proibidas e estrutura preferida vai devolver um texto alinhado com o seu padrão. A diferença entre um output genérico e um output que parece feito por alguém do seu time.

No Claude Code, um agente é salvo como um arquivo .md em uma pasta específica. Quando você chama aquele agente, o Claude carrega as instruções antes de executar qualquer tarefa. O resultado é consistente toda vez.

Passo 1: abra o terminal com o Claude Code rodando. Digite `claude` para iniciar.

Passo 2: crie a pasta de agentes se ainda não existir. No terminal: `mkdir -p ~/.claude/agents`

Passo 3: crie um arquivo para o agente. Exemplo para um revisor de textos: `~/.claude/agents/revisor-textos.md`

Passo 4: dentro do arquivo, escreva as instruções em linguagem natural:

``` Você é um revisor de textos profissional especializado em comunicação direta e clara.

Seu papel: revisar qualquer texto que eu enviar seguindo estas regras: - Eliminar advérbios desnecessários (realmente, literalmente, basicamente) - Substituir voz passiva por voz ativa quando possível - Reduzir frases com mais de 25 palavras em frases menores - Manter o tom do autor original

Formato de saída: texto revisado + lista das principais mudanças. ```

Passo 5: para usar o agente, no Claude Code chame com `/agents` e selecione o agente criado, ou referencie diretamente no prompt.

Em 20 minutos você tem um revisor que funciona do jeito que você trabalha, não do jeito genérico da IA padrão.

Revisor de textos: lê qualquer rascunho e devolve com tom de voz consistente, eliminando clichês e ajustando ritmo. Economiza 20 minutos por texto.

Assistente de SEO: recebe um tema e retorna um briefing completo com keyword principal, keywords secundárias, estrutura de H2s, perguntas do FAQ e meta description. Substitui 1 hora de pesquisa manual.

Organizador de tarefas: lê meu bloco de notas caótico do dia e devolve uma lista priorizada com estimativa de tempo para cada item.

Analisador de dados: recebe uma planilha ou arquivo CSV e responde perguntas em linguagem natural. 'Qual foi o produto com mais vendas no Q3?' Sem fórmulas, sem pivot table.

Gerador de posts: dado um artigo longo, cria 5 variações de post para LinkedIn com diferentes ângulos (educativo, opinião, dado curioso, história, pergunta).

Cada um desses é um arquivo de texto com 10 a 30 linhas de instrução. Nada de código.

Agentes salvos em `~/.claude/agents/` ficam disponíveis em qualquer projeto que você abrir no Claude Code. São globais.

Agentes salvos em `.claude/agents/` dentro de uma pasta específica ficam disponíveis apenas naquele projeto. São locais.

Boas práticas para organização: use nomes descritivos no arquivo (revisor-linkedin.md, analisador-metricas.md, gerador-pautas.md), adicione uma linha de comentário no início do arquivo explicando o propósito do agente e quando usá-lo, agrupe agentes relacionados com prefixos comuns (copy-, dados-, gestao-).

Para atualizar um agente, edite o arquivo de texto. A próxima vez que você chamar, as novas instruções já estão ativas. Sem recompilação, sem deploy, sem nada.

Um agente resolve uma tarefa. Um time de agentes resolve um fluxo de trabalho inteiro.

Exemplo de fluxo: você tem um processo de criação de conteúdo. O agente de pesquisa levanta dados e fontes. O agente de briefing estrutura o artigo. O agente de escrita gera o rascunho. O agente de revisão apara as arestas. O agente de adaptação cria as versões para cada canal.

Cada um é um arquivo de texto. Você aciona em sequência ou o Claude Code orquestra automaticamente se você configurar um fluxo.

A diferença entre usar IA como ferramenta pontual e ter um sistema de trabalho com IA está exatamente nessa camada de agentes. A ferramenta resolve problemas isolados. O sistema resolve o processo inteiro.