Use o Claude Code e outros apps de IA com o Crucible

Resposta rápida: abra Agente e depois Conectar no launcher do Crucible, pressione Conectar ao lado do seu app de IA e reinicie ele ou comece um chat novo nele. Para qualquer outro app que rode servidores MCP, Copiar configuração copia o bloco para colar nele. Mudanças que não dá para desfazer esperam o seu Permitir em Atividade.

A aba Agente do launcher do Crucible tem três partes:

Agente local (veja também converse com o Agente local), uma IA pequena que roda no seu próprio PC e responde perguntas sobre o Crucible, mapas de Rust e servidores locais. Ela também faz coisas simples por você, como abrir um app ou iniciar um servidor.
Atividade, a lista de tudo que uma IA fez no Crucible, com os cartões que esperam o seu OK.
Conectar, onde você liga um app de IA que já usa (Claude Code, Codex, Cursor e outros) para ele trabalhar no Crucible por você: abrir e atualizar seus apps, montar e exportar um mapa de Rust no Crucible Heightmap e rodar um servidor de teste de Rust local no Crucible Local Server.

As janelas dos apps ficam na sua tela o tempo todo, então você vê a IA trabalhando.

O Agente local

O Agente local é gratuito e roda inteiro no seu PC. Nada é instalado até você pedir.

Escolher um modelo

Abra Agente e depois Agente local. A primeira tela mostra sua placa de vídeo, a memória dela (VRAM) e a RAM do seu PC, e os três modelos que o Agente local consegue rodar, todos da equipe Qwen:

Modelo	Respostas	Download	Memória gráfica
Standard (Qwen3.5-2B)	as mais rápidas	cerca de 1,2 GB	cerca de 2,0 GB, ou roda no processador
Smarter (Qwen3.5-4B)	melhores, com menos erros	cerca de 3,8 GB	cerca de 3,6 GB, só na placa de vídeo
Best (Qwen3.5-9B)	as melhores, mais lentas ainda	cerca de 6,5 GB	cerca de 5,9 GB, só na placa de vídeo

Um modelo é marcado como Recomendado para a sua placa (uma estrela no menu Model). Deixar espaço na placa de vídeo para o Rust e a visualização no jogo (ligado no começo) decide qual:

Ligado sugere um modelo que deixa a maior parte da placa livre, para o Rust ou a visualização no jogo do Heightmap rodarem fluidos ao lado.
Desligado sugere o maior modelo que a sua placa aguenta.

Escolha qualquer modelo para o qual a sua placa tenha espaço e pressione Instalar. O Smarter e o Best vêm com o Standard, que responde quando o Rust ou a visualização no jogo não deixa espaço na placa de vídeo; os tamanhos acima incluem ele. Se o download parar, Continuar a instalação retoma de onde parou.

Depois pressione Carregar para colocar o modelo na memória e faça sua pergunta.

O que ele sabe e faz

Ele sabe como o Crucible funciona e o que cada slider e botão faz. Links para as páginas que ele usou aparecem embaixo de cada resposta.

Ele também conhece o próprio Rust, igual à referência do jogo Rust: comandos de console, variáveis do servidor, itens com os shortnames, tamanhos de pilha e receitas de fabricação, caminhos de prefabs e o básico de plugins Oxide e Carbon, mantidos em dia a cada atualização do Rust. Pergunte “qual é o comando para desligar o decay” ou “qual é o prefab de uma large wood box”.

Quando as docs não cobrem uma pergunta, como custos de raid ou o que a última atualização do Rust trouxe, ele diz que não sabe em vez de chutar e aponta para um lugar que sabe: o Discord do Crucible, o RustHelp, as notícias de atualização da Facepunch ou uma busca rápida no Google ou no YouTube.

Ele também ajuda com compra e cobrança (o checkout, códigos de desconto, troca de plano, cancelamento, faturas) e com deixar amigos entrarem no seu servidor (playit.gg, abrir portas). Ele explica esses passos e mostra o lugar; os botões que gastam dinheiro ou mudam sua assinatura ou licença são sempre seus para pressionar.

Ele faz coisas quando você pede em palavras simples, em todo app do Crucible:

O launcher: abrir, fechar, instalar, atualizar ou desinstalar o Crucible Heightmap ou o Crucible Local Server, mudar as configurações do launcher (idioma, inicialização, bandeja, atualização automática, reduzir movimento), verificar atualizações, salvar seus logs para o suporte, limpar arquivos temporários e salvar ou instalar os downloads gratuitos (ele consegue colocar um plugin gratuito direto em um servidor Carbon ou Oxide).
Crucible Heightmap: fazer um mapa novo, mudar os sliders e o tamanho do mapa, desfazer e refazer, salvar e abrir projetos e seeds, montar o worldgen, editar ilhas, ramps e cortes de canal, pintar e exportar, com qualquer um dos arquivos da exportação.
Crucible Local Server: preparar, iniciar, parar e reiniciar servidores, mudar as configurações deles, rodar comandos de console e ler o console (por exemplo para ver por que um servidor parou), ver quem está online, fazer backups, wipe e gerenciar plugins e mapas.
Ele mesmo: a voz, a leitura de respostas em voz alta, o hands-free, a memória e o modelo, perguntar antes de agir e seus chats.

Ele faz isso na hora; para ele mostrar o plano e esperar o seu Permitir antes, veja O que ele pergunta antes?.

Ele também faz algumas tarefas que levam vários passos a partir de um pedido:

Preparar um servidor: descreva (“um servidor PvE 4k para 10 jogadores com Oxide, chamado Test”) e ele cria o servidor, define o mapa (um procedural com o seu tamanho e seed, ou a sua exportação mais nova do Heightmap), aplica as configurações que você disse, baixa os arquivos do servidor e inicia. Diga “me faça admin” e a conta da Steam logada neste PC vira dona do servidor; diga “e entre quando estiver no ar” e ele espera o mundo terminar de carregar, abre o Rust e entra, e depois avisa você no chat (em voz alta também, com a voz ligada). Você pode continuar usando o launcher enquanto ele espera.
Mapa em um servidor: coloca sua exportação mais nova do Heightmap em um servidor e inicia, e entra quando estiver no ar se você pedir.
Configurações do servidor: muda jogadores, PvE, modo de jogo, nome ou descrição de um servidor.

Cada um só preenche o que você disse: um nome, tamanho ou seed que você não deu nunca é inventado. Um app de que ele precisa e está fechado abre antes. Para tarefas grandes, como montar um mapa inteiro passo a passo ou pintura detalhada, ele faz o que consegue e avisa quando um app de IA que você conecta em Conectar, como o Claude Code ou o Codex, faria melhor. Se o Crucible Heightmap ou o Crucible Local Server for mais antigo do que o Agente local consegue trabalhar, ele avisa: feche o app, pressione Atualizar nele em Apps e abra de novo.

Quando a resposta é um lugar, ele mostra enquanto explica: pergunte onde cancelar sua assinatura e o launcher troca para Conta, peça os extras e ele abre Loja > Extras, pergunte onde fica Salvar para o suporte e ele aponta a linha em Configurações. Ele mostra os painéis e visões do Heightmap e as abas do Local Server do mesmo jeito.

Voz

O Agente local pode ler as respostas em voz alta enquanto escreve, e você pode falar com ele em vez de digitar. A voz vem com o Instalar (cerca de 0,5 GB a mais).

Voz, na barra acima do chat, liga ou desliga Ler respostas em voz alta e escolhe uma de dez vozes (escolher uma toca uma amostra), o Volume, a Velocidade e o Microfone. Enviar uma mensagem, trocar de chat ou pressionar o botão de pausa corta uma leitura.
O botão de microfone ao lado de Enviar: pressione e fale, depois pressione de novo ou simplesmente pare de falar. Suas palavras caem na caixa, então você confere antes de enviar.
Hands-free, no menu Voz: o Agente local escuta “Hey” e o nome da voz que você escolheu (“Hey Luna”), depois faz o que você disser e lê a resposta em voz alta, sem botão para pressionar. Quando ele ouve o nome, toca um tom curto e o botão de microfone fica vermelho. Diga tudo de uma vez (“Hey Luna, start my server”), ou diga o nome, espere o tom e depois o resto. “Hey Luna, stop” faz ele parar de falar. Ele continua escutando com o launcher minimizado ou atrás de um jogo. Com o hands-free ligado, o botão de microfone silencia e reativa o microfone.

Se o botão de microfone não faz nada, o Windows pode estar bloqueando o microfone: ligue Acesso ao microfone e Permitir que aplicativos da área de trabalho acessem o microfone em Configurações do Windows > Privacidade e segurança > Microfone. As respostas em chinês não são lidas em voz alta.

Placa de vídeo ou processador

Quando você pressiona Carregar, o Agente local roda na sua placa de vídeo quando ela tem espaço, que é o mais rápido, e no seu processador quando não tem. O chip ao lado de Ejetar mostra qual está em uso.

A faixa embaixo dos botões mostra, ao vivo, quanta memória gráfica (VRAM) e RAM o seu PC está usando, com a parte do próprio Agente local em lima, o quanto o Contexto deste chat está cheio e a velocidade com que ele escreve (tokens por segundo).

Model: trocar depois

Model troca entre Standard, Smarter e Best a qualquer momento; seus chats continuam. Cada linha mostra quanto espaço aquele modelo ocupa no seu PC, e uma estrela marca o recomendado para a sua placa.

Um modelo que ainda não está no seu PC mostra uma marca de download. Escolher ele traz de volta a tela de preparação com uma barra de progresso até baixar, e então o chat volta.
O ícone de lixeira ao lado do Smarter ou do Best remove aquele modelo do seu PC e libera o espaço. O Standard fica, e escolher o modelo de novo baixa ele de volta.

O Smarter e o Best rodam só na placa de vídeo. Quando a placa não tem espaço para o que você escolheu, por exemplo com a visualização no jogo aberta, um modelo menor responde no lugar e o botão Model fica dourado para avisar; feche algo pesado e pressione Ejetar e Carregar.

Memória: quanto de um chat ele mantém em mente

Memória define quanto de um chat o Agente local mantém em mente de uma vez:

Configuração	Mantém em mente	Memória gráfica: Standard	Smarter	Best
Automático (padrão)	ajustado para o seu PC	cerca de 2,0 GB	3,6 GB	5,9 GB
Curto	8k tokens	cerca de 1,9 GB	3,4 GB	5,6 GB
Médio	16k tokens	cerca de 2,0 GB	3,6 GB	5,9 GB
Longo	32k tokens	cerca de 2,1 GB	4,2 GB	6,4 GB
Mais longo	64k tokens	cerca de 2,5 GB	5,2 GB	7,4 GB

Mais deixa ele acompanhar chats mais longos e trabalhos de vários passos mais longos. Quando um chat enche, as mensagens mais antigas saem da memória do modelo, nunca do chat em si.

Chats

Novo chat começa um novo. Os chats são agrupados por semana neste mês e por mês antes disso. Clique em um grupo para abrir ou fechar, e o ícone de lixeira exclui um chat ou um grupo inteiro.

O Rust e o Agente local

O Rust e o Agente local dividem sua placa de vídeo e a memória. Se o Rust estiver aberto quando você pressiona Carregar, ou se o Rust iniciar com o modelo carregado, o launcher vem para a frente e recomenda fechar o Rust enquanto você conversa. Ejetar devolve toda a memória.

Ejetar, atualizar, remover

Ejetar descarrega o modelo. Seus chats ficam.
Atualizar aparece quando um Agente local mais novo é publicado.
Remover Agente local, no pé da lista de chats, remove o Agente local do seu PC. Seus chats ficam, e a primeira tela volta para você escolher um modelo de novo.

Como conecto um app de IA?

Abra Agente e depois Conectar. O launcher lista os apps de IA que acha no seu PC:

Conectar adiciona o Crucible àquele app. Reinicie o app de IA, ou comece um chat novo nele, para ele carregar o Crucible.
Desfazer tira o Crucible de novo.
Reparar aparece quando um app aponta para uma instalação do Crucible que mudou de lugar; ele aponta para esta.
Não está neste PC significa que o app não está instalado.

A lista cobre Claude Code, Claude Desktop, Cursor, VS Code, Codex, Antigravity, Windsurf, Gemini CLI e LM Studio. São apps de IA que rodam no seu PC (em um terminal, um editor ou um app de desktop); um site de chat em um navegador não alcança apps no seu PC.

Outro app de IA funciona com qualquer app que rode servidores MCP locais, inclusive os que ainda não existem. Copiar configuração copia o bloco de configuração MCP padrão:

{
  "mcpServers": {
    "crucible": {
      "command": "<the Crucible program on your PC>",
      "args": ["--mcp"]
    }
  }
}

Cole nas configurações de MCP daquele app, ou cole para o próprio agente de IA e peça para ele adicionar o Crucible. O bloco copiado já traz o caminho certo para o seu PC.

Você não precisa abrir o launcher antes.

O que um app de IA conectado pode fazer no Crucible?

O launcher: ver o que está instalado e rodando, instalar, atualizar, abrir e desinstalar apps, conferir a memória livre do seu PC, buscar nestas docs, mostrar qualquer aba ou página, mudar as configurações do launcher (idioma, inicialização, bandeja, atualização automática, reduzir movimento), verificar atualizações, salvar seus logs para o suporte, limpar arquivos temporários, ler seu plano e a data de renovação, mudar as configurações do Agente local e salvar os plugins, prefabs, mapas e guias gratuitos (você escolhe a pasta) ou colocar um plugin gratuito direto em um servidor Carbon ou Oxide.
Crucible Heightmap (aberto, com uma licença que cobre): ler e mudar qualquer configuração pelo nome na tela, conjurar um mapa novo, trabalhar com ilhas, rodar o worldgen e mudar as configurações dele (proporções de biomas e tiers, rotação, cliffs, lagos, lava, topologia), adicionar ramps e canais, pintar, definir todo pincel, pintar o chão por altura e inclinação, mudar o que o Conjurar sorteia, as sobreposições da visão e a hora do dia e as Configurações do próprio app, transformar uma imagem da sua pasta imports em uma ilha, usar suas formas de ilha salvas, tirar uma imagem do mapa ou da visualização no jogo, salvar, abrir, renomear e excluir projetos, trabalhar com seeds salvas (favoritas, tags, importação) e exportar pelo mesmo painel Exportar que você usa, inclusive vários projetos salvos de uma vez.
Crucible Local Server (aberto): criar, renomear, copiar e excluir servidores, baixar e gerenciar os arquivos deles, mudar configurações e regras ao vivo, definir o reinício diário, iniciar, parar e reiniciar, pressionar os botões da Quick view, rodar comandos de console e ler o console, listar jogadores, cuidar de mapas e saves, buscar e gerenciar plugins e os arquivos de config deles, fazer backups e wipes, ler e escrever as anotações de um servidor, navegar pelos arquivos dele, mudar as Configurações do próprio app e abrir o Rust para entrar.

Uma posição de mapa no Heightmap é dada na imagem do mapa: da esquerda para a direita e de cima para baixo, com o norte no topo, do jeito que você vê.

O que ele pergunta antes?

Tudo que não dá para desfazer espera por você. Um cartão aparece em Agente > Atividade (ou ao lado do chat do Agente local, para os pedidos dele), o launcher vem para a frente e a IA espera até você pressionar Permitir ou Negar. Negar avisa que você disse não. Isso cobre, entre outros:

substituir um mapa do Heightmap com mudanças não salvas e excluir um projeto, uma seed salva ou uma forma salva,
limpar todo o chão pintado à mão no Heightmap,
desinstalar um app,
excluir um servidor, um mapa, um save, um mundo ou uma página de anotações e remover arquivos de servidor,
wipes, restaurar um backup e excluir um backup,
instalar um plugin de um link ou de um arquivo (é código de outra pessoa rodando no seu servidor), excluir um e mudar o arquivo de config de um plugin,
substituir o server.cfg ou os argumentos de inicialização, ou voltar um servidor ao preset dele,
limpar os arquivos guardados do Crucible Local Server,
comandos de console que mudam o servidor (comandos de leitura como status rodam na hora),
fechar um app com um servidor rodando,
o Agente local fechar o Crucible Local Server com um servidor rodando,
o Agente local desinstalar um app ou excluir chats.

O Agente local inicia, para e prepara servidores na hora. Para ele mostrar o plano em um cartão e esperar o Permitir antes, pressione O Agente local age sem perguntar em Atividade, para que diga O Agente local pergunta antes de agir. Wipes, exclusões e tudo que perderia trabalho não salvo sempre perguntam.

Permitir tudo nesta sessão deixa passar as mudanças dos apps de IA conectados sem cartão até o launcher fechar. Nunca é salvo e não muda o Agente local.

O que ele nunca pode fazer?

Comprar qualquer coisa, mudar sua assinatura ou ver sua chave de licença. Compras, trocas de plano, cancelamentos e licenças ficam nas abas Loja e Conta do launcher, onde você pressiona os botões.
Ler uma senha. As senhas de RCON dos seus servidores ficam escondidas dos apps de IA.
Começar um passo para o qual o seu PC não tem espaço. Quando o seu PC está curto de memória para um passo, o Crucible diz o que está usando, para você decidir o que fechar.

Como faço parar?

Parar, à direita da aba Agente, recusa tudo que os apps de IA e o Agente local pedem para fazer até você pressionar Retomar, e isso vale mesmo depois de reiniciar o launcher. Um download que já está rodando termina, para nenhum app ficar atualizado pela metade. Para parar o Agente local no meio de uma resposta, pressione o botão de pausa onde estava o Enviar.

Atividade lista cada pedido: qual IA fez, o que pediu e como foi.

Meus dados são compartilhados?

O Agente local roda no seu PC. Seus chats ficam no seu PC, e nada que você digita ou fala é enviado para lugar nenhum.

Um app de IA conectado recebe as respostas do Crucible no seu PC e mais nada. O que aquele app faz com elas (imagens do mapa, configurações, estado do servidor) segue a política do próprio app, igual a qualquer outra coisa que você mostra para ele. Ele nunca recebe sua chave de licença nem suas senhas.

Onde vejo o que aconteceu?

Salvar para o suporte nas Configurações inclui o que os apps de IA fizeram, para quando você precisar de ajuda. Abrir pasta na mesma aba Configurações mostra onde o Crucible fica no seu PC.