# FAQ — App e CLI do AI Game Dev · AI Game Developer Wiki

Respostas curtas sobre o AI Game Dev e a CLI gamedev: engines, plataformas, planos, uso, pacotes, modelos locais, privacidade e cliente de IA próprio.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/docs/wiki/app/faq).

Respostas rápidas às perguntas mais comuns sobre o app desktop AI Game Dev e a CLI `gamedev`. Cada resposta traz um link para a página com os detalhes.

## Geral

### O que é o app AI Game Dev?

É o app de desenvolvimento de jogos com IA do AI Game Developer: um agente de IA que edita os arquivos do seu projeto e controla seu editor Unity, Unreal ou Godot por meio do plugin MCP da engine. Ele vem como app desktop e como CLI `gamedev`. Veja a [visão geral](https://ai-game.dev/pt-br/docs/wiki/app).

### Devo usar o app desktop ou a CLI?

Use o app desktop para o trabalho do dia a dia: painéis, prévias, Source Control e a janela Packages. Use a CLI em um terminal, via SSH, em scripts (`gamedev --print`) ou dentro de clientes ACP como T3 Code ou Zed (`gamedev acp`). Ambos compartilham uma conta, o serviço em segundo plano e o histórico de chat em um computador.

### Quais engines são suportadas?

Unity 2022.3 LTS ou superior, Unreal Engine 5.5 ou superior (projetos C++) e Godot 4.3 a 4.5 (.NET). Você também pode conversar em qualquer outra pasta sem as ferramentas de engine. Veja [Projetos e engines](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines).

### Quais sistemas operacionais são suportados?

O app desktop: Windows x64, macOS (Apple silicon e Intel) e Linux x86\_64. A CLI: Windows x64, macOS arm64 e x64, Linux x64 e arm64. Veja [Instalação](https://ai-game.dev/pt-br/docs/wiki/app/installation).

### Preciso instalar o plugin da engine por conta própria?

Não. Abra seu projeto e clique em **Install Package** na barra lateral, ou execute `/install-plugin` na CLI. Um projeto criado pelo app recebe o plugin automaticamente. Os instaladores vêm dentro do app, então você não precisa de Node.js nem npm para o app desktop.

## Conta, planos e uso

### Preciso de uma conta?

Sim. Entre com sua conta AI Game Developer no app ou com `/login` na CLI. Veja [Login e conta](https://ai-game.dev/pt-br/docs/wiki/app/sign-in-and-account).

### De qual plano eu preciso?

Depende dos modelos e ferramentas que você quer. Os planos são Free, Indie, Studio e Studio Max, e há um teste gratuito. Alguns modelos e ferramentas pagas exigem Studio ou superior. Compare-os na [página de preços](https://ai-game.dev/pricing).

### Como o uso é exibido?

Como uma porcentagem da sua cota mensal, em que 100% é a cota total do seu plano. Turnos de chat e operações pagas, como Tripo ou vídeo na nuvem, consomem parte dela; modelos locais no seu computador não.

### Por que não consigo escolher um modelo?

O plano, a região do seu endereço de cobrança ou um requisito de idade o impedem; o motivo aparece abaixo do nome do modelo. A lista atual está na [página de disponibilidade de modelos](https://ai-game.dev/model-availability).

## Pacotes

### O que é um pacote?

Uma extensão do próprio app: uma pasta com um manifesto `aigd-package.json` e código opcional que adiciona ferramentas, comandos, painéis, editores ou modelos. Veja [Pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages).

### Quais pacotes vêm com o app?

Blender, SuperCollider (Music), Knowledge Base, Tripo e o runtime local de imagem e vídeo são instalados por padrão. Os modelos locais e as famílias de modelos na nuvem são pacotes separados. Veja o [catálogo de pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog).

### Todo chat carrega todos os pacotes?

Não. Cada sessão ativa ferramentas na sua linha Tools, assim o contexto do agente fica pequeno. Uma alteração vale a partir da próxima mensagem.

### Posso escrever meu próprio pacote?

Sim. Desenvolva-o em uma pasta local com `gamedev pkg link` ou `gamedev pkg dev` e depois compartilhe pelo GitHub ou npm. Veja [Criando pacotes](https://ai-game.dev/pt-br/docs/wiki/app/creating-packages).

### Como os pacotes diferem dos plugins do Claude e dos servidores MCP?

Pacotes estendem o app; plugins do Claude adicionam skills, comandos e agentes ao agente Claude; servidores MCP adicionam ferramentas de qualquer servidor MCP a um projeto. Plugins e servidores MCP são gerenciados em **Settings** ou com `/plugin` e `/mcp`.

## Modelos e geração

### Posso gerar imagens ou vídeo na minha própria GPU?

Sim, com os modelos locais de imagem e vídeo executados pelo stable-diffusion.cpp. A maioria exige uma GPU NVIDIA; o Z-Image Turbo também roda em outras GPUs, e o FLUX.2 klein 4B em Apple silicon. A geração local é gratuita. Veja a [tabela de hardware](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#local-image-models).

### Posso gerar vídeo e áudio sem uma GPU?

Sim, com a geração Cloud nos planos pagos: modelos de vídeo como Veo, Kling e Seedance, e áudio com ElevenLabs, Kokoro, Lyria e ACE-Step. Cada tarefa pergunta antes ou respeita um orçamento que você define como porcentagem da sua cota. Veja [Geração na nuvem](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#cloud-generation).

### O agente consegue modelar no Blender?

Sim. Digite `/blender` para encontrar ou instalar o Blender 4.2 ou superior e conectá-lo; depois ative **Blender** na sessão. Veja [Blender](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog#blender).

## Privacidade e controle

### O agente altera arquivos sem perguntar?

No modo padrão, o agente trabalha dentro do seu projeto sem perguntar e pergunta quando sai dele. Você pode fazer com que ele pergunte sempre, ou nunca. Veja [aprovações e permissões](https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models#permissions).

### O código do meu projeto é armazenado nos seus servidores?

Seu projeto fica no seu computador. A conexão com a engine retransmite mensagens MCP entre o agente e seu editor e não armazena payloads de chamadas de ferramentas; consulte o [FAQ](https://ai-game.dev/docs/faq) do site para saber quais dados o servidor MCP mantém. Os prompts e arquivos que o agente lê são enviados ao modelo de IA que você escolheu para que ele possa responder. Dados de uso e relatórios de erro são controlados em **Settings**, **Privacy**.

### Posso usar meu próprio cliente de IA em vez do app?

Sim. Os plugins de engine funcionam com qualquer cliente MCP, como Claude Code, Cursor, VS Code ou Codex. Aponte-o para o [endpoint MCP](https://ai-game.dev/pt-br/mcp-endpoint-info) e deixe que ele autorize; veja [Autenticação](https://ai-game.dev/docs/auth) e o guia de conexão de cada engine para [Unity](https://ai-game.dev/pt-br/docs/wiki/unity/connecting-ai-clients), [Unreal](https://ai-game.dev/pt-br/docs/wiki/unreal/connecting-ai-clients) e [Godot](https://ai-game.dev/pt-br/docs/wiki/godot/connecting-ai-clients).

## Atualizações

### Como faço para atualizar?

O app desktop se atualiza sozinho e mostra **Restart to update**. A CLI é atualizada com `gamedev update`. Os pacotes são atualizados automaticamente, a menos que você desative isso por pacote. Veja [Instalação](https://ai-game.dev/pt-br/docs/wiki/app/installation#updates).

### Onde posso ver o que mudou?

Na [página de notas de versão](https://ai-game.dev/pt-br/releases).

---

Source (HTML): https://ai-game.dev/pt-br/docs/wiki/app/faq

Machine-translated (pt-BR) from the English page: https://ai-game.dev/docs/wiki/app/faq
