# Skill da NexTags no Claude Code

> Instale a skill da NexTags no Claude Code e monte o seu agente de IA com uma entrevista guiada. Ela entrega os 3 textos para colar no AI Hub.

Endereço: https://docs.nextags.com.br/ia/skill-claude-code/
Tipo: Guia

Atualizado em: 26/10/2026

Uma skill é um pacote de instruções que ensina o Claude a fazer uma tarefa do jeito certo. A skill da NexTags, `criar-agente-ia`, faz o Claude Code trabalhar como um consultor de agentes: ele entrevista você sobre o negócio, coleta os produtos ou serviços (do site, de um cardápio em PDF, de uma planilha ou de uma lista colada), com as fotos, e entrega 3 textos prontos para colar no AI Hub. Serve para qualquer segmento, como delivery, loja, clínica, salão, imobiliária e serviços. A skill vem no plugin `nextags`, do catálogo público [guiipego/nextags](https://github.com/guiipego/nextags), no GitHub.

**Antes de começar**

- Uma conta do Claude com acesso ao Claude Code: planos Pro, Max, Team ou Enterprise, ou uma conta do Console. O plano gratuito do Claude não inclui o Claude Code.
- Python 3, para os scripts da skill, que montam o catálogo e conferem os textos. Confira com `python3 --version` (no Windows, `python --version`). Se não tiver, instale pelo site do Python e, no Windows, marque **Add python.exe to PATH** na instalação.
- No Windows, o Git for Windows: o Claude Code usa o Git para baixar o catálogo de plugins.
- Um agente de IA criado no **AI Hub**, com um provedor de IA conectado. Veja [Criar um agente de IA](https://help.nextags.com.br/tutoriais/ia/criar-agente/).

## Passo a passo

### Passo 1: Instale o Claude Code

Se você já usa o Claude Code, pule para o próximo passo. Abra o Terminal (no macOS ou no Linux) ou o PowerShell (no Windows) e cole:

**Instalar o Claude Code**

```bash
# macOS, Linux e WSL
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
```

Depois, abra um terminal novo e rode `claude --version`: aparece o número da versão. Digite `claude` e entre com a sua conta do Claude. Fonte: [Advanced setup](https://code.claude.com/docs/en/setup), da Anthropic.

### Passo 2: Adicione o catálogo da NexTags

No terminal, cole:

```bash
claude plugin marketplace add guiipego/nextags
```

A resposta começa com `Successfully added marketplace: nextags`. O catálogo fica registrado no seu computador; não é preciso repetir.

### Passo 3: Instale o plugin

```bash
claude plugin install nextags@nextags
```

A resposta começa com `Successfully installed plugin: nextags@nextags`. Instalado pelo terminal, o plugin vale para você em todos os projetos do computador. Para conferir, rode `claude plugin list`: o plugin `nextags@nextags` aparece com `Status: ✔ enabled`.

Prefere fazer dentro do Claude Code? Numa sessão aberta, digite `/plugin marketplace add guiipego/nextags` e depois `/plugin install nextags@nextags`. O painel abre com os detalhes do plugin: escolha **Install for you (user scope)**. Os comandos estão em [Install and manage plugins](https://code.claude.com/docs/en/discover-plugins), da Anthropic.

### Passo 4: Abra o Claude Code numa pasta só para o agente

Os 3 textos são salvos como arquivos, então crie uma pasta para eles, como "Agente NexTags", em Documentos, e abra o Claude Code nela:

**Criar a pasta e abrir o Claude Code**

```bash
# macOS e Linux
mkdir -p ~/Documents/"Agente NexTags" && cd ~/Documents/"Agente NexTags" && claude
```
```powershell
# Windows (PowerShell)
mkdir "$env:USERPROFILE\Documents\Agente NexTags"; cd "$env:USERPROFILE\Documents\Agente NexTags"; claude
```

No app do Claude para computador, abra a aba **Code** e escolha essa pasta. O plugin instalado pelo terminal também aparece no app.

### Passo 5: Comece a montar o agente

Na sessão do Claude Code, digite:

```text
/nextags:criar-agente-ia
```

Ou peça do seu jeito, como "quero criar meu agente de atendimento na NexTags para a minha confeitaria". A partir daí, a skill conduz o trabalho:

1. Pede o nome do negócio e onde estão os produtos ou serviços: site, cardápio, planilha ou lista.
2. Faz poucas perguntas por vez. O que você não souber fica marcado `[A DEFINIR]`, e o agente aprende a dizer que a equipe confirma.
3. Coleta o catálogo e confere as fotos.
4. Escreve os 3 textos, revisa e salva na pasta.

Quando o Claude for ler o seu site ou rodar um script da skill, o Claude Code pede permissão. Escolha **Yes**; para não ser perguntado de novo pelo mesmo comando, escolha **Yes, and don't ask again**, quando a opção aparecer.

### Passo 6: Cole os 3 textos no AI Hub

No fim, a pasta tem os 3 textos, além dos arquivos de trabalho da skill, como o catálogo:

```text
Agente NexTags/
  1_mensagem_do_sistema.md
  2_prompt_da_acao.md
  3_acoes_de_ia.md
```

| Arquivo | Onde colar na NexTags |
|---|---|
| `1_mensagem_do_sistema.md` | **AI Hub** › aba **Agentes de IA** › o seu agente › **Mensagem do sistema** |
| `3_acoes_de_ia.md` | No mesmo editor, cartão **Ações de IA** › **+ Adicionar regra**: uma regra para cada regra do arquivo, com o texto do **Quando** e as ações em **O que a IA deve fazer?**, na ordem |
| `2_prompt_da_acao.md` | Cartão **Ações de IA** › ícone de ajustes › **Prompt da ação**. O ícone aparece quando o agente tem pelo menos uma regra: cole este texto depois das regras. |

Antes de colar as regras, crie o que a skill listar no checklist da entrega: as etiquetas, os campos personalizados (com os nomes exatos do arquivo) e quem recebe as conversas transferidas.

A skill também recomenda a configuração do agente: os formatos em **Tipo de resposta da IA**, o modelo e os ajustes **Max tokens**, **Reasoning effort** e **Verbosity**. Use o modelo que a skill recomendar, se ele estiver na lista do seu provedor. Onde fica cada ajuste: [Modelo, temperatura e limite de tokens](https://help.nextags.com.br/tutoriais/ia/modelo-e-parametros/). Depois, clique em **Salvar**, no topo da tela.

### Passo 7: Teste antes de ligar para os clientes

Converse com o agente usando um número seu e passe pelos casos que mais dão erro:

```text
Peça o cardápio ou a lista de serviços.
Faça um pedido ou um agendamento completo.
Mude o pedido no meio da conversa.
Pergunte por um produto que não existe.
Peça para falar com uma pessoa.
```

Confira se as transferências, as etiquetas e os campos funcionam. Veja [Testar e ajustar o agente](https://help.nextags.com.br/tutoriais/ia/testar-agente/) e [Agente padrão e resposta automática por IA](https://help.nextags.com.br/tutoriais/ia/agente-padrao/).

## Atualizar a skill

Para buscar a versão mais nova do catálogo e atualizar o plugin:

```bash
claude plugin marketplace update nextags
claude plugin update nextags@nextags
```

A versão nova entra na próxima sessão, ou na hora, com `/reload-plugins` numa sessão aberta. Para atualizar sozinho, digite `/plugin` dentro do Claude Code, abra a aba **Marketplaces**, escolha **nextags** e clique em **Enable auto-update**: num catálogo de fora da Anthropic, a atualização automática começa desligada.

## Pronto: como conferir

- `claude plugin list` mostra `nextags@nextags` com `Status: ✔ enabled`.
- Ao digitar `/` numa sessão, aparece `/nextags:criar-agente-ia`.
- A pasta do agente tem os 3 arquivos, e o agente no AI Hub está salvo com a mensagem do sistema, as regras e o prompt da ação.

## Se não funcionou

### O terminal não reconhece o comando claude

Abra um terminal novo depois da instalação. Se continuar, a pasta do Claude Code não está no PATH: siga [Troubleshoot installation and login](https://code.claude.com/docs/en/troubleshoot-install), da Anthropic.

### O comando claude plugin não existe

O Claude Code está numa versão antiga. Rode `claude update` e tente de novo.

### A instalação diz que não achou o plugin ou o catálogo

No terminal, a mensagem é `Plugin "nextags" not found in marketplace "nextags"`; numa sessão, `Marketplace "nextags" not found`. O catálogo ainda não foi adicionado: rode `claude plugin marketplace add guiipego/nextags`, escrito exatamente assim, e instale o plugin de novo.

### No Windows, apareceu "Command 'git' not found"

Instale o Git for Windows, abra um terminal novo e adicione o catálogo de novo.

### A skill não aparece na sessão

Digite `/reload-plugins` ou abra uma sessão nova com `claude`. Para ver o que está instalado, digite `/plugin` e abra a aba **Installed**.

### Apareceu "python3: command not found" ou "python não é reconhecido"

Instale o Python 3 e abra um terminal novo. No Windows, marque **Add python.exe to PATH** na instalação.

### As fotos dos produtos não chegam como imagem no WhatsApp

O WhatsApp aceita imagens em PNG ou JPEG de até 5 MB. Se as fotos do seu site forem WebP, a skill avisa e oferece a conversão para JPG. Veja [Tipos de arquivo e limites por canal](https://help.nextags.com.br/tutoriais/canais/tipos-de-arquivo-e-limites/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Vou montar o meu agente de IA da NexTags com a skill do Claude Code. Leia este guia: https://docs.nextags.com.br/ia/skill-claude-code.md

Meu sistema: [macOS / Windows / Linux]. Meu negócio: [descreva em uma frase]. Me diga, na ordem, os comandos para instalar o Claude Code e o plugin da NexTags, e o que separar antes de começar a entrevista: o material dos produtos, as fotos e quem recebe as conversas transferidas.
```