# App AI Game Dev e CLI gamedev — AI Game Developer Wiki

O que são o app desktop AI Game Dev e a CLI gamedev, como funcionam com os plugins de Unity, Unreal e Godot e por onde começar.

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

O AI Game Dev é o app de desenvolvimento de jogos com IA do AI Game Developer: um agente de IA que entende o seu projeto de jogo, edita os arquivos dele e comanda o editor da sua engine por meio de linguagem natural. Ele vem em duas formas que compartilham uma conta, um serviço em segundo plano e um histórico de chat: o **app desktop** e a **CLI `gamedev`** para o terminal. Esta seção da wiki explica como instalá-los, fazer login, abrir um projeto, escolher modelos, estender o app com pacotes e resolver problemas comuns.

## App desktop ou CLI

Os dois frontends executam o mesmo agente, alimentado pelo Claude Agent SDK, e ambos se autenticam na sua conta do AI Game Developer.

|  | App desktop | CLI `gamedev` |
| --- | --- | --- |
| Onde roda | Windows, macOS, Linux | Terminais do Windows, macOS e Linux |
| Instalação | Instalador assinado da [página de download](https://ai-game.dev/pt-br/download) | `npm install -g @baizor/gamedev` |
| Ideal para | O trabalho do dia a dia: painéis, pré-visualizações, Source Control, janela Packages | Fluxos de trabalho no terminal, scripts (`--print`), clientes ACP como T3 Code ou Zed |
| Pacotes | Janela Packages mais `/packages` | `gamedev pkg` e `/packages` |
| Atualizações | Baixa atualizações e oferece **Restart to update** | `gamedev update` |

Você pode usar os dois no mesmo computador. Um chat iniciado em um deles fica no histórico compartilhado, e os pacotes instalados no nível do usuário valem para ambos.

## Como isso se encaixa com os plugins das engines e o MCP

O app não substitui os plugins das engines; ele os usa. Cada engine tem seu próprio plugin MCP que expõe ferramentas do editor (criar objetos, editar cenas, executar testes, tirar capturas de tela e muito mais):

- [Unity MCP](https://ai-game.dev/pt-br/docs/wiki/unity) para Unity, gerenciado pelo `unity-mcp-cli`.
- [Unreal MCP](https://ai-game.dev/pt-br/docs/wiki/unreal) para Unreal Engine, gerenciado pelo `unreal-mcp-cli`.
- [Godot MCP](https://ai-game.dev/pt-br/docs/wiki/godot) para Godot, gerenciado pelo `godot-cli`.

Quando você abre um projeto de Unity, Unreal ou Godot, o app detecta a engine, oferece instalar ou atualizar o plugin correspondente, abre o editor quando o agente precisa dele e conecta as ferramentas do editor ao seu chat por meio do ai-game.dev com a sua sessão autenticada. Os instaladores vêm dentro do app, então você não precisa de Node.js nem npm para o app desktop.

Os plugins também funcionam sem o app: qualquer cliente MCP (Claude Code, Cursor, VS Code, Codex e outros) pode se conectar ao [endpoint MCP](https://ai-game.dev/pt-br/mcp-endpoint-info). A [visão geral do ecossistema](https://ai-game.dev/pt-br/docs/ecosystem) mostra como o app, os plugins e o servidor MCP se encaixam, e o [catálogo de ferramentas](https://ai-game.dev/docs/tools) lista o que os plugins oferecem ao agente.

## O que o app acrescenta aos plugins

- Um agente de chat que lê e edita os arquivos do seu projeto, executa comandos e chama ferramentas da engine, com aprovações que você controla.
- Uma escolha de modelos de IA de vários provedores, atribuídos conforme o seu plano e a sua região. Veja [Agentes e modelos](https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models).
- Um espaço de trabalho desktop com uma janela por projeto, sessões em painéis, pré-visualizações de arquivos (texturas, modelos 3D, áudio, vídeo) e Git. Veja [Workspace](https://ai-game.dev/pt-br/docs/wiki/app/workspace).
- **Pacotes** que acrescentam capacidades inteiras: Blender, música com SuperCollider, uma Base de Conhecimento do projeto, Tripo 3D, geração local de imagens e vídeos na sua GPU, e modelos de vídeo e áudio na nuvem. Veja [Pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages).
- Ferramentas de sessão: cada chat escolhe quais ferramentas carrega, então o contexto do agente fica pequeno.

## Mapa da página

Comece por aqui se você é novo:

1. [Instalação](https://ai-game.dev/pt-br/docs/wiki/app/installation): instale o app desktop no Windows, macOS ou Linux, ou a CLI `gamedev`, e mantenha-os atualizados.
2. [Login e conta](https://ai-game.dev/pt-br/docs/wiki/app/sign-in-and-account): login, planos, uso exibido em porcentagens, troca de contas.
3. [Projetos e engines](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines): abra ou crie um projeto e deixe o app configurar o plugin de Unity, Unreal ou Godot.
4. [Agentes e modelos](https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models): escolha um modelo, o esforço de raciocínio e o agente, aprovações, modelos locais.

Depois aprofunde-se:

- [Workspace](https://ai-game.dev/pt-br/docs/wiki/app/workspace): painéis, pré-visualizações, Explorer, Search e Source Control no app desktop.
- [Pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages): o que é um pacote, a janela Packages, `gamedev pkg`, níveis, atualizações.
- [Catálogo de pacotes](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog): todos os pacotes disponíveis hoje e o que cada um faz.
- [Criando pacotes](https://ai-game.dev/pt-br/docs/wiki/app/creating-packages): escreva, teste e compartilhe o seu próprio pacote.
- [Referência da CLI](https://ai-game.dev/pt-br/docs/wiki/app/cli): todos os comandos `gamedev` e os comandos de barra no terminal.
- [Solução de problemas](https://ai-game.dev/pt-br/docs/wiki/app/troubleshooting): login, conexão com a engine, pacotes e modelos.
- [FAQ](https://ai-game.dev/pt-br/docs/wiki/app/faq): respostas curtas para perguntas comuns.

## Início rápido

1. Baixe o aplicativo na [página de download](https://ai-game.dev/pt-br/download) ou execute `npm install -g @baizor/gamedev`.
2. Faça login com sua conta do AI Game Developer.
3. Abra a pasta do seu projeto de jogo.
4. Descreva o que você quer, por exemplo "Liste tudo na cena ativa."

O [Quickstart](https://ai-game.dev/pt-br/docs/quickstart) em quatro etapas percorre o mesmo fluxo com capturas de tela, e [o guia do App](https://ai-game.dev/docs/app) traz uma visão geral em uma página. Para dicas de prompting, leia as [boas práticas](https://ai-game.dev/docs/best-practices).

- [**Instalação** Instale o app desktop do AI Game Dev no Windows, macOS ou Linux, ou a CLI gamedev com npm, e mantenha ambos atualizados.](https://ai-game.dev/pt-br/docs/wiki/app/installation)
- [**Login e conta** Entre no app AI Game Dev e na CLI gamedev, troque de conta, entenda planos e percentuais de uso e gerencie seus outros dispositivos.](https://ai-game.dev/pt-br/docs/wiki/app/sign-in-and-account)
- [**Projetos e engines** Abra ou crie um projeto Unity, Unreal ou Godot no app AI Game Dev, instale o plugin da engine e deixe o agente abrir o editor quando precisar.](https://ai-game.dev/pt-br/docs/wiki/app/projects-and-engines)
- [**Agentes e modelos** Escolha modelos de IA, esforço de raciocínio e agentes no app e na CLI do AI Game Dev, controle aprovações de ferramentas e use modelos locais na sua GPU.](https://ai-game.dev/pt-br/docs/wiki/app/agents-and-models)
- [**Espaço de trabalho** O espaço de trabalho desktop do AI Game Dev: janelas de projeto, sessões em painéis, previews de texturas, modelos 3D e áudio, Explorer, Search e Git.](https://ai-game.dev/pt-br/docs/wiki/app/workspace)
- [**Pacotes** Quais pacotes o app AI Game Dev tem, como instalar, atualizar, excluir e remover na janela Packages ou com gamedev pkg, e como funcionam os níveis.](https://ai-game.dev/pt-br/docs/wiki/app/packages)
- [**Catálogo de pacotes** Todos os pacotes oficiais do AI Game Dev: Blender, música com SuperCollider, Knowledge Base, Tripo 3D, modelos locais e na nuvem.](https://ai-game.dev/pt-br/docs/wiki/app/packages-catalog)
- [**Criando pacotes** Crie seu próprio pacote do AI Game Dev: manifesto aigd-package.json, comandos, ferramentas MCP, desenvolvimento local e compartilhamento.](https://ai-game.dev/pt-br/docs/wiki/app/creating-packages)
- [**Referência do CLI gamedev** Todos os comandos e opções do CLI gamedev: modos interativo e headless, pkg, remote, daemon, acp, image-runtime, update e slash commands.](https://ai-game.dev/pt-br/docs/wiki/app/cli)
- [**Solução de problemas** Resolva problemas comuns do AI Game Dev e da CLI gamedev: login, modelos, plugin da engine e conexão com o editor, pacotes, geração local e em nuvem.](https://ai-game.dev/pt-br/docs/wiki/app/troubleshooting)
- [**FAQ** 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.](https://ai-game.dev/pt-br/docs/wiki/app/faq)

---

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

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