--- title: "Agentes de programação e skills em um app do Chatfuel wizard" description: "O Chatfuel wizard instala uma skill por módulo para o Claude Code ou o Codex, escreve CLAUDE.md ou AGENTS.md e entrega o app ao seu agente com um checklist." canonical_url: https://chatfuel.com/pt/docs/wizard/coding-agents markdown_url: https://chatfuel.com/pt/docs/wizard/coding-agents.md last_updated: 2026-10-27 lang: pt site: https://chatfuel.com/docs llms_txt: https://chatfuel.com/docs/llms.txt --- # Agentes de programação e skills em um app do Chatfuel wizard O Chatfuel wizard instala uma skill por módulo para o Claude Code ou o Codex, escreve CLAUDE.md ou AGENTS.md e entrega o app ao seu agente com um checklist. O [Chatfuel wizard](https://chatfuel.com/pt/docs/wizard/quickstart) termina entregando o novo app a um agente de programação. Ele instala uma skill para cada módulo que você escolheu, escreve o arquivo de instruções que o agente lê no início de cada sessão e oferece iniciar o agente no projeto com um checklist de configuração. O Claude Code e o Codex CLI são suportados. As skills trazem o que o agente precisa para alterar o app com segurança: as operações GraphQL do módulo, como essa parte da Public API se comporta e as regras que o proxy do app impõe. ## Quais agentes de programação o wizard suporta [#quais-agentes-de-programação-o-wizard-suporta] O wizard procura o Claude Code (`claude`) e o Codex CLI (`codex`) no seu `PATH`: * **Um agente encontrado:** o wizard usa esse agente. * **Os dois encontrados:** o wizard pergunta qual deles continua o trabalho. `--agent claude` ou `--agent codex` responde a essa pergunta com antecedência. * **Nenhum encontrado:** o wizard oferece instalar um deles com `npm i -g @anthropic-ai/claude-code` ou `npm i -g @openai/codex`. Só uma estrutura é escrita, para o agente que você escolheu: * **Claude Code:** skills em `.claude/skills/`, instruções em `CLAUDE.md`. * **Codex CLI:** skills em `.agents/skills/`, instruções em `AGENTS.md`, que indica o caminho completo de cada skill. ## O que as skills contêm [#o-que-as-skills-contêm] Cada módulo instala uma skill chamada `chatfuel-`, como `chatfuel-contacts` ou `chatfuel-bookings`. Uma skill reúne a estrutura desse módulo, as operações GraphQL que ele usa, referências sobre as partes da Public API por trás dele e playbooks para alterações comuns. Duas skills vêm com todo app, não importa o que você escolheu: * **`chatfuel-core`:** autenticação, as regras do proxy, transporte HTTP e WebSocket, paginação, o schema GraphQL do Chatfuel e um validador para novas operações. * **`chatfuel-update`:** como ler o que `npx @chatfuel/wizard update` informa e resolver os arquivos que você alterou e que a atualização também altera. O wizard pergunta onde instalar as skills: no projeto ou no seu diretório pessoal, para que uma única cópia sirva a todos os apps que você criar. [Módulos do wizard](https://chatfuel.com/pt/docs/wizard/modules) lista os módulos aos quais cada skill pertence. ## O que dizem o arquivo de instruções e o checklist de configuração [#o-que-dizem-o-arquivo-de-instruções-e-o-checklist-de-configuração] O wizard escreve dois arquivos para o agente, com funções diferentes: * **O arquivo de instruções** (`CLAUDE.md` ou `AGENTS.md`) é lido em toda sessão e continua curto: as rotas dos módulos do app, as skills que o agente deve ler antes de mexer na API, quais chaves do `.env` são segredos, com a regra "NEVER print or commit" (nunca exibir nem fazer commit), e como retomar a configuração. * **O checklist de configuração** é lido uma vez, na entrega: o que dizer a você na primeira mensagem, um tour pelos módulos instalados com links para o app, as permissões do Chatfuel de que cada módulo precisa e as primeiras tarefas de cada módulo. Para o Claude Code, é o comando `/chatfuel:finish-setup`; para o Codex, é a skill `chatfuel-finish-setup`. Quando você aceita a oferta de iniciar o agente no fim da execução, o wizard inicia o agente no novo projeto com o checklist. O próprio agente inicia o servidor de desenvolvimento e cumprimenta você com um resumo do que foi construído. Para retomar depois, execute `claude /chatfuel:finish-setup` no diretório do app ou peça ao Codex para usar a skill `chatfuel-finish-setup`. Com `--embed`, o seu arquivo de instruções existente não é substituído. O wizard escreve a parte dele entre os marcadores `` e ``, e uma nova execução reescreve só essa parte. ## Prompts que funcionam com um app do wizard [#prompts-que-funcionam-com-um-app-do-wizard] Diga o módulo e o resultado que você quer; o agente encontra a skill correspondente. Estes prompts vêm das primeiras tarefas nas notas de entrega dos módulos: * *"Adicione uma busca à lista do chat ao vivo e faça a consulta da lista de conversas e a assinatura ao vivo dela usarem o mesmo filtro."* Atendido por `chatfuel-livechat`. * *"Adicione uma legenda de cores de status à barra de ferramentas do calendário de agendamentos."* Atendido por `chatfuel-bookings`. * *"Adicione um módulo chamado notes com uma tela de lista e uma tela de arquivados."* Atendido por `chatfuel-core`, que descreve onde um módulo fica e o que ele pode importar. * *"Mude as cores de destaque do app e nada mais."* Atendido por `chatfuel-core`: as cores ficam em um único arquivo de design tokens. * *"Adicione anexos de arquivo ao campo de mensagem do chat ao vivo."* Atendido por `chatfuel-livechat`, com `chatfuel-core` para a rota de upload. ## Como o agente adiciona uma nova operação da API [#como-o-agente-adiciona-uma-nova-operação-da-api] O proxy do app encaminha apenas os documentos GraphQL com os quais o app foi gerado e recusa qualquer outro, então uma operação nova ou alterada exige três etapas. Mencione-as no seu prompt e o agente faz as três: 1. Comece pelas operações do módulo na skill dele e escreva o novo documento. 2. Valide-o com o schema do Chatfuel usando o validador da `chatfuel-core`. 3. Adicione-o ao arquivo de operações do módulo no app e execute `npm run codegen`, que gera os tipos dele e o registra no proxy. A introspecção em produção está desativada, então o schema dentro da `chatfuel-core` é aquele com que o agente trabalha. A [visão geral da Public API](https://chatfuel.com/pt/docs/public-api/overview) e as páginas de referência desta seção descrevem as mesmas operações. ## Como deixar o agente trabalhar também com os seus bots [#como-deixar-o-agente-trabalhar-também-com-os-seus-bots] As skills ensinam o código ao agente. Para que o mesmo agente leia e altere os seus bots do Chatfuel enquanto constrói o app, por exemplo para conferir um contato ou uma configuração, conecte o servidor MCP do Chatfuel: [Claude Code](https://chatfuel.com/pt/docs/mcp/connect-claude-code-to-chatfuel) ou [Codex](https://chatfuel.com/pt/docs/mcp/connect-codex-to-chatfuel).