
Usando o Base Code
Antes de começar:
- Seu projeto precisa ser um projeto web ou full-stack em um repositório do GitHub. Em um monorepo, o projeto na raiz do repositório precisa se qualificar, e um app mobile em uma subpasta não é problema.
- Se você constrói seu app na Base44, continue construindo-o no editor do app e sincronize-o com um repositório usando a integração com o GitHub.
- Você precisa conectar uma conta do GitHub durante a configuração.
Configurando o Base Code
Conecte um repositório do GitHub para fazer alterações com o chat de IA no Base Code. Se sua conta do GitHub já estiver conectada, continue para como escolher um repositório.Conectando sua conta do GitHub
O Base Code trabalha diretamente nos seus repositórios do GitHub, por isso precisa de acesso aos repositórios em que você quer trabalhar. Sua conta também precisa de acesso de escrita a cada repositório. Sem ele, o projeto mostra um selo Somente leitura. Você pode discutir o projeto no chat de IA e alternar branches, mas não pode fazer alterações nem criar uma branch. Para conectar sua conta:- Acesse o Base Code.
- Clique em Conectar GitHub.
- Entre no GitHub se for solicitado e autorize o Base44 Builder.
- Selecione a conta ou organização do GitHub e siga as instruções para instalar ou configurar o Base44 Builder e dar a ele acesso ao repositório. Se você não for proprietário da organização do GitHub, o GitHub envia sua solicitação aos proprietários da organização e você vê Aguardando aprovação…. Depois que um proprietário aprovar, clique em Conectar GitHub de novo.
Corrigir um projeto somente leitura
Corrigir um projeto somente leitura
Para conectar sua conta do GitHub a partir de um projeto:
- Abra o projeto.
- Clique em Conectar conta no banner Conecte sua conta do GitHub.
- Autorize o Base44 Builder no GitHub.
Escolhendo um repositório
Escolha o código em que você quer trabalhar, entre seus próprios repositórios ou uma cópia de um repositório em que você não pode fazer push.- Da sua conta
- Colar um link
Para escolher um repositório da sua conta:
- Clique em Ver mais no Base Code.
- Selecione um repositório.
- Mantenha a Branch selecionada ou escolha outra.
- Clique em Conectar.
Encontrar um repositório que não aparece
Encontrar um repositório que não aparece
Se seu repositório não aparece em Conecte seu repositório, dê à Base44 acesso a ele no GitHub.Para atualizar o acesso ao repositório:
- Dê ao Base44 Builder acesso ao repositório no GitHub.
- Abra Conecte seu repositório de novo no Base Code.
Conectar um repositório de uma organização não aprovada
Conectar um repositório de uma organização não aprovada
Se você vir “Your workspace’s GitHub policy doesn’t allow this import”, ou se a Base44 disser que seu repositório não está em uma organização do GitHub aprovada, seu workspace não permite repositórios dessa organização. Peça a alguém que gerencia as organizações do GitHub do seu workspace para conectar a organização e marcá-la como Permitido. Depois, tente de novo.Se você só tem acesso de leitura, conecte um fork ou uma cópia privada. Quando seu workspace limita os repositórios a organizações aprovadas, você precisa de acesso de escrita a um repositório em uma delas.
Trabalhando no seu projeto
Use o chat de IA para fazer alterações no repositório conectado e testá-las em uma prévia de desenvolvimento. Conforme você conversa, o Base Code faz commit e push das suas alterações para a sua branch de trabalho no GitHub.Como seu projeto roda no Base Code:
- O Base Code oferece uma prévia de desenvolvimento, não hospedagem de produção. Para lançar suas alterações ou conectar um domínio personalizado, use o processo de implantação e o provedor de hospedagem que seu projeto já usa.
- Seu projeto mantém o próprio banco de dados, autenticação e roteamento. Conectar um repositório não adiciona entidades, login nem o SDK da Base44. Para adicionar um banco de dados, autenticação ou CI/CD, peça ao chat de IA para adicioná-los com a stack do seu próprio projeto e adicione as strings de conexão ou chaves de API como segredos.
- Quando você volta ao Base Code, o ambiente do seu projeto é reiniciado. Se ele precisar ser reconstruído, o Base Code usa o commit mais recente da sua branch no GitHub. Por isso, peça ao chat de IA para confirmar que suas últimas alterações estão nessa branch antes de sair.
Fazendo sua primeira alteração
Quando você conecta um repositório pela primeira vez, o chat de IA coloca seu projeto para rodar antes de você iniciar uma branch e mostra cada etapa da configuração. O Base Code inicia uma nova branch a partir do seu primeiro pedido e dá um nome a ela. Assim, sua alteração fica separada até você abrir um pull request.Seu primeiro pedido em um repositório recém-conectado é gratuito, incluindo a configuração que ele inicia.
- Acesse o Base Code.
- (Opcional) Selecione a branch de partida no menu suspenso ao lado de Criar nova branch a partir de.
-
Descreva a alteração que você quer fazer na caixa de prompt. Por exemplo:
-
Clique em Criar branch. Se alguma destas situações aparecer, faça o seguinte e clique em Criar branch de novo:
- Conectar ao GitHub: Autorize o app Base44 Builder no GitHub.
- “Your GitHub account can’t push to this repo”: Peça a um admin do repositório para dar acesso de escrita à sua conta do GitHub.

Criando sua primeira branch
- Revise a alteração em Pré-visualização quando ela aparecer e peça ao chat de IA os ajustes que quiser. No desktop, uma nova branch abre com o chat de IA ocupando o editor, e a prévia aparece quando há uma alteração para mostrar.
Se uma etapa da configuração falhar, clique em Corrigir configuração para que a IA encontre a causa e a corrija.
Revisando suas alterações
Confira exatamente o que mudou antes de pedir a alguém para revisar. Para revisar suas alterações:- Abra as alterações que você quer conferir:
- Alterações de uma resposta: Use a lista de arquivos abaixo dessa resposta no chat de IA.
- Todas as alterações da branch: Clique em Criar PR no editor do app, ou clique no número do PR se ele já existir.
- Clique no nome de um arquivo para ver o diff dele, com as linhas adicionadas e removidas.
Revertendo um arquivo
Desfaça as alterações que você não quer em um arquivo. A reversão é salva como um novo commit na sua branch. Para reverter um arquivo:- Abra sua branch no Base Code.
- Encontre o arquivo abaixo da resposta do chat de IA, ou na lista de arquivos da branch em Criar PR ou no número do PR.
- Clique no arquivo para expandi-lo e depois em Reverter arquivo.
- Confira se o arquivo certo aparece em Reverter alterações da branch? e clique em Reverter.
Adicionando arquivos do Google Drive
Dê ao chat de IA um briefing, uma especificação ou um design do seu Google Drive quando você iniciar uma branch. Para iniciar uma branch a partir de um arquivo do Google Drive:- Acesse o Base Code.
- Clique no ícone Adicionar na caixa de prompt.
- Clique em Enviar do Google Drive.
- Se for solicitado, clique em Connect Google Drive e permita o acesso no Google.
- Selecione um ou mais arquivos do Meu Drive ou de um drive compartilhado. Você pode escolher arquivos do Google Docs, Sheets e Slides, arquivos do Word, Excel e PowerPoint, PDFs, imagens e arquivos de texto, CSV, HTML, XML e JSON.
- (Opcional) Descreva a alteração que você quer fazer na caixa de prompt.
- Clique em Criar branch.
Parando a IA
Pare o chat de IA enquanto ele trabalha e envie uma nova mensagem para mudar de direção. Para parar a IA:- Clique no ícone Parar geração na caixa de prompt.
- (Opcional) Envie uma nova mensagem com o que você quer.
O que acontece quando você para:
- As alterações que já têm commit na sua branch permanecem.
- As edições que a IA ainda não tinha enviado em commit são descartadas.
- Se você parar a criação de uma branch na tela inicial, o Base Code restaura seu prompt na caixa de prompt e remove a nova branch do Base Code.
Escolhendo o modelo de IA
Por padrão, o Base Code usa Auto para escolher um modelo de IA para cada pedido. Você pode escolher um modelo você mesmo quando quiser mais controle. Para escolher um modelo de IA:- Abra sua branch no Base Code.
- Clique no modelo na parte inferior do chat de IA.
- Selecione o modelo com o qual você quer trabalhar.
Usando skills do repositório
Ensine ao chat de IA os fluxos de trabalho da sua equipe com skills armazenadas no seu repositório. Cada skill tem um nome, uma descrição e instruções. O chat de IA lê uma skill quando ela se encaixa no seu pedido. As skills valem para todos que trabalham no projeto, em todas as branches. O Base Code encontra skills nestes lugares, na raiz do seu repositório ou em uma subpasta:- Pastas de skills: Um arquivo
SKILL.mdem uma pasta dentro de.agents/skills,.claude/skillsou.codex/skills. - Comandos do Claude Code: Arquivos Markdown em
.claude/commands. - Plugins locais: Skills de plugins do Claude Code ou do Codex armazenados no seu repositório.
- Clique em Painel no editor do app.
- Clique em Habilidades do repositório.
- Escolha o que você quer fazer:
- Ler uma skill: Clique na skill para ver as instruções dela.
- Ativar ou desativar uma skill: Clique no botão ao lado da skill. As skills ficam ativadas por padrão, e só o dono do app pode ativá-las ou desativá-las.
- Mostrar uma nova skill: Depois de adicionar um arquivo
SKILL.mdao seu repositório, clique em Atualizar.
Visualizando apps de monorepo
Quando seu repositório tem vários apps, como um site e uma API, cada app em execução ganha sua própria aba acima da prévia. Escolha quais apps rodam em cada branch. Para escolher os apps que rodam em uma branch:- Abra sua branch no Base Code.
- Clique no ícone Apps na barra de ferramentas acima da prévia, ou clique em Adicionar app no fim da fileira de abas.
- Selecione cada app que você quer rodando em Apps para executar nesta branch.
- Clique em Concluído.
- Abra sua branch no Base Code.
- Clique em Visualização dividida no fim da fileira de abas.
- Clique em Mostrar ou Start ao lado do app para o lado vazio.
Expandindo o chat
Oculte a prévia para que o chat de IA ocupe o editor e traga a prévia de volta quando quiser conferir seu trabalho. O chat volta à largura normal quando você alterna entre Preview, Dashboard e Code, ou abre outro arquivo. Para expandir ou reduzir o chat:- Abra sua branch no Base Code.
- Clique no ícone Expandir o chat na barra de ferramentas acima do chat de IA.
- Clique no ícone Reduzir o chat para mostrar a prévia de novo.

O chat de IA expandido
Gerenciando branches
Cada branch tem seu próprio ambiente de desenvolvimento no Base Code. Você pode abrir um pull request com as alterações dela.Criando branches
Inicie cada nova alteração em sua própria branch, a partir da sua branch padrão ou de outra branch em que você está trabalhando. O Base Code dá nome à branch para você. Para criar uma branch pela barra lateral:- Clique em Nova branch na barra lateral.
- Selecione a branch de partida no menu suspenso ao lado de Criar novo branch.
- Descreva sua alteração no chat de IA e clique em Criar.

Iniciando uma branch pela barra lateral
Trabalhando pela barra lateral
Veja a situação de cada uma das suas branches e vá direto para a que precisa de você. Suas branches na barra lateral lista as branches que você criou. As branches com merge feito vão para Mesclado no fim da lista, para que você ainda possa ler os chats delas. Cada branch tem um ícone de status. Passe o cursor sobre ele para ver o rótulo, com o número do pull request quando houver um.
Na fila significa que seu pull request está aguardando na fila de merge do seu repositório no GitHub.
Enquanto a IA está construindo, o ícone é substituído por Em andamento, e por Mesclando enquanto um merge roda. Um ponto à direita de uma branch significa que a IA terminou ali e você ainda não a abriu desde então.
Para abrir uma branch:
- Clique na branch em Suas branches.
Organizando suas branches
Mantenha ao alcance as branches em que você está focado e traga para o topo as que precisam de você.
Branches fixadas e agrupadas
- Passe o cursor sobre a branch na barra lateral e clique no ícone de opções dela.
- Clique em Fixar.
- Clique no ícone Novo grupo ao lado de Suas branches.
- Digite um Nome do grupo e clique em Criar grupo.
- Arraste uma branch para o grupo, ou clique no ícone de opções da branch, clique em Mover para um grupo e selecione o grupo.
- Tirar uma branch de um grupo: Arraste-a para Suas branches, ou clique no ícone de opções dela, clique em Mover para um grupo e depois em Sem grupo.
- Renomear ou excluir um grupo: Clique no ícone de opções do grupo e depois em Renomear grupo ou Excluir grupo. Ao excluir um grupo, você pode arquivar as branches dele junto.
- Reordenar seus grupos: Arraste um grupo para cima ou para baixo na lista.
- Clique no ícone Ordenar branches ao lado de Suas branches.
- Selecione Status, Última atividade ou Nenhum em Agrupar por.
- Selecione Data de criação ou Nome em Ordenar por.
Arquivando uma branch
Arquive as branches em que você não está trabalhando para manter sua lista curta. Uma branch arquivada vai para Archived no fim de Suas branches, fora da fixação ou do grupo dela. Arquivar só altera a sua própria barra lateral. A branch, o chat dela e a branch no GitHub continuam como estão. Para arquivar uma branch:- Passe o cursor sobre a branch na barra lateral e clique no ícone de opções dela.
- Clique em Arquivar.
Removendo uma branch
Remova as branches com as quais você já terminou. Para manter uma branch sem que ela ocupe sua lista, arquive-a. Para remover uma branch:- Passe o cursor sobre a branch na barra lateral e clique no ícone de opções dela.
- Clique em Remover branch.
- Confirme na caixa de diálogo:
- Remover: Aparece para uma branch com merge feito, ou para uma branch em que seus colegas também estão. A branch sai da sua lista, e nada é excluído. Seus colegas mantêm a branch e o chat dela, e você pode trazer de volta uma branch sem merge enviando um prompt nela de novo.
- Excluir branch: Aparece para uma branch sem merge em que mais ninguém está. A branch e o chat dela são excluídos do Base Code para sempre. A branch e os commits dela continuam no GitHub.
Trabalhando com pull requests
Faça a revisão e o merge das suas alterações por meio de pull requests no GitHub. O Base Code sempre usa sua própria conexão com o GitHub, independentemente do que o seu workspace define para os outros apps. Sua conta do GitHub precisa estar conectada e ter acesso de escrita ao repositório. A Base44 abre pull requests pela sua conta. Cada commit do chat de IA lista você como autor ebase44-builder[bot] como coautor.
Abrindo um pull request
Depois de testar suas alterações, abra um pull request para revisão. Seu pull request tem como destino a branch a partir da qual sua branch de trabalho foi criada. O chat de IA escreve o título e a descrição com base na sua conversa e nas alterações com commit. Depois que você o abre, as novas alterações na sua branch de trabalho são adicionadas a ele, e o GitHub executa as verificações configuradas no seu repositório. Faça o merge no GitHub ou peça ao chat de IA para fazer o merge. Criar pull request lista os arquivos que sua branch alterou. Ele mostra apenas alterações com commit e push. Para deixar um arquivo fora do pull request, reverta o arquivo antes de continuar.
Conferindo o diff de um arquivo
- Abra sua branch no Base Code.
- Clique em Criar PR no editor do app.
- Clique em cada arquivo alterado em Criar pull request para conferir o diff.
- Clique em Continuar no construtor.
- Revise e envie a mensagem preenchida no chat de IA.
Acompanhando seu trabalho
Veja a situação de cada uma das suas tarefas, das alterações que o Base Code ainda está fazendo aos pull requests que estão indo ao ar. Seu trabalho, na tela inicial do Base Code, organiza suas tarefas em colunas:- O Base Code está trabalhando: A IA ainda está fazendo alterações.
- Precisa de você: O Base Code tem uma pergunta, ou o pull request tem conflitos, verificações com falha ou alterações solicitadas.
- Pronto para revisão: O trabalho terminou e nada o bloqueia.
- Concluído: Tarefas com merge feito, respondidas e arquivadas.
- Acesse o Base Code.
- Em Seu trabalho, escolha o que você quer fazer:
- Abrir uma tarefa: Clique nela para abrir a branch dela.
- Dar o próximo passo: Clique na ação de uma tarefa, como Corrigir conflitos ou Mesclar.
- Encontrar uma tarefa: Pesquise pelo título dela em Buscar no seu trabalho.
- Filtrar suas tarefas: Use os filtros de tipo, status e tempo. Por exemplo, filtre por Tem uma pergunta ou Verificações com falha.
- Ordenar suas tarefas: Selecione Última atualização ou Data de criação.
- Ver todos os pull requests: Clique em Ver todos os pull requests para abrir os pull requests do seu repositório no GitHub.
Resolvendo conflitos de branch
Se o seu pull request tiver conflitos, o chat de IA pode resolvê-los para você. Resolver conflitos faz o merge da branch base do pull request na sua branch de trabalho. Para resolver conflitos:- Abra sua branch no Base Code.
- Clique em Resolver conflitos acima da caixa de prompt.
- Revise e teste as alterações que a IA fizer, principalmente onde as duas branches alteraram a mesma funcionalidade.
Respondendo a comentários de revisão
Peça ao chat de IA para tratar as conversas de revisão não resolvidas no seu pull request. Ele responde a cada conversa com o que alterou. Depois de fazer push das alterações, ele resolve as conversas que corrigiu. Para responder a comentários de revisão:- Abra sua branch no Base Code.
-
Peça ao chat de IA para corrigir os comentários no seu pull request. Por exemplo:
- Revise as alterações e as respostas que o chat de IA informar.
Colaborando com colegas
Sua equipe pode contribuir com o mesmo projeto e revisar as alterações uns dos outros por meio de pull requests.Quem pode participar sem convite:
- Membros do workspace: Se um projeto do Base Code permite que membros do workspace colaborem, qualquer pessoa do seu workspace pode abri-lo no editor do app e participar sem um convite separado.
- Convidados do workspace: Os convidados ainda precisam de um convite.
- Pessoas de fora do seu workspace: Para convidá-las, adicione-as como colaboradoras pelo editor do app.
Adicionando segredos
Dê ao seu projeto as chaves de API e outras credenciais de que ele precisa sem colocá-las no seu repositório. O chat de IA avisa quando um segredo é necessário. Os segredos são criptografados, compartilhados entre branches e mantidos quando seu ambiente é reconstruído. Alterações e remoções se aplicam automaticamente às branches em execução. As branches inativas as recebem quando você as abrir de novo. Para adicionar um segredo:- Clique em Painel no editor do app.
- Clique em Segredos.
- Clique em Adicionar segredo.
- Digite o Nome do segredo e o Valor do segredo e clique em Adicionar segredo.
Gerenciando organizações do GitHub
As organizações conectadas pertencem ao seu workspace, então os apps continuam sincronizando mesmo que a pessoa que conectou uma delas saia. Qualquer pessoa no workspace pode usar uma organização que já está conectada. A configuração Escolha como sua equipe escreve no GitHub desta página não se aplica a apps do Base Code, que sempre usam conexões por usuário. Para adicionar uma organização do GitHub:- Acesse as configurações do seu workspace.
- Clique em GitHub em Ferramentas de desenvolvimento.
- Clique em Adicionar organização em Organizações conectadas.
- Entre no GitHub se for solicitado e autorize o Base44 Builder.
- Escolha a conta ou organização e instale o Base44 Builder. Se você não for proprietário da organização do GitHub, o GitHub envia sua solicitação aos proprietários da organização. Depois que um proprietário aprovar, clique em Adicionar organização de novo.
- Acesse as configurações do seu workspace.
- Clique em GitHub em Ferramentas de desenvolvimento.
- Escolha o que você quer fazer:
- Filtrar organizações: Use o filtro em Organizações conectadas para mostrar organizações Todas, Ativo ou Desconectado.
- Disponibilizar uma organização para novos apps: Proprietários e admins podem usar Permitido para controlar quais organizações ficam disponíveis. Alterar Permitido não afeta os apps que já usam essa organização.
- Desconectar uma organização: Clique no ícone Ações ao lado da organização, clique em Desconectar organização e depois em Desconectar. Os apps ligados à conexão do workspace dessa organização param de sincronizar com o GitHub, e a confirmação lista esses apps. O Base44 Builder continua instalado no GitHub, para que você possa reconectar a organização depois.
Perguntas frequentes
Onde posso saber mais sobre privacidade e uso de dados?
Onde posso saber mais sobre privacidade e uso de dados?
A Política de Privacidade da Base44 explica como as informações pessoais são coletadas e usadas. Privacidade e segurança aborda o treinamento de modelos de IA e seus controles de dados.
Como aplico um código de cupom?
Como aplico um código de cupom?
Você pode aplicar um cupom antes ou depois de conectar um repositório.Cada código de cupom vale para até 10 pessoas no seu workspace.Para aplicar um cupom:
- Acesse o Base Code.
- Digite seu código de cupom:
- Antes de conectar um repositório: Clique em Tem um cupom? no canto superior direito e digite seu código na caixa de diálogo.
- Depois de conectar um repositório: Digite seu código no campo abaixo de Tem um cupom?.
- Clique em Aplicar.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.