> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# base44 scaffold

> Cria a estrutura de um projeto local para um aplicativo Base44 existente. Use isto quando você já tem um aplicativo Base44 (você conhece seu ID) e quer configurar os arquivos do projeto local para trabalhar com ele. Roda totalmente de forma não interativa...

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# base44 scaffold

Cria a estrutura de um projeto local para um aplicativo Base44 **existente**. Use isto quando você já tem um aplicativo Base44 (você conhece seu ID) e quer configurar os arquivos do projeto local para trabalhar com ele. Roda totalmente de forma não interativa, então é seguro para agentes e CI.

## Crítico: Quando usar Scaffold vs Create vs Link

| Cenário                                                                    | Comando               |
| -------------------------------------------------------------------------- | --------------------- |
| Começando do zero, quer um NOVO aplicativo Base44 + projeto de um modelo   | `npx base44 create`   |
| Você já tem um aplicativo Base44 (pelo ID) e quer arquivos locais para ele | `npx base44 scaffold` |
| Tem um `base44/config.jsonc` local mas nenhum `.app.jsonc`                 | `npx base44 link`     |

## Sintaxe

```bash theme={null}
npx base44 scaffold [name] [options]
```

Cria a estrutura no **diretório atual**.

## Argumentos e opções

| Argumento/Opção | Descrição                                                                                | Obrigatório |
| --------------- | ---------------------------------------------------------------------------------------- | ----------- |
| `name`          | Nome do projeto (posicional). Padrão para o nome do diretório atual.                     | Não         |
| `--app-id <id>` | ID de aplicativo Base44 existente. Recorre à variável de ambiente `BASE44_APP_ID`.       | Sim\*       |
| `--no-skills`   | Pula a instalação de habilidades de agente de IA (habilidades são instaladas por padrão) | Não         |

\*O ID do aplicativo é obrigatório: forneça via `--app-id` ou a variável de ambiente `BASE44_APP_ID`. Se nenhum for definido, o comando falha.

## Exemplos

```bash theme={null}
# Cria estrutura no diretório atual para um aplicativo existente
npx base44 scaffold --app-id app_123

# Cria estrutura no diretório atual com um nome de projeto explícito
npx base44 scaffold my-app --app-id app_123

# Fornece o ID do aplicativo via variável de ambiente em vez da flag
BASE44_APP_ID=app_123 npx base44 scaffold

# Cria estrutura sem instalar habilidades de agente de IA
npx base44 scaffold --app-id app_123 --no-skills
```

## O que faz

1. Resolve o ID do aplicativo a partir de `--app-id` ou da variável de ambiente `BASE44_APP_ID`
2. Aplica o modelo `backend-only` ao diretório atual
3. Registra os arquivos do projeto contra o aplicativo existente e grava `base44/.app.jsonc` com o ID do aplicativo
4. Instala habilidades de agente de IA (a menos que `--no-skills` seja passado)

## Transferência de provisionamento (Stripe Projects / projects.dev)

`scaffold` é o comando para executar depois que um aplicativo Base44 é provisionado por meio de um fluxo Stripe Projects / projects.dev. **Use `scaffold`, não `create`** — o aplicativo já existe, então `create` criaria uma duplicata.

Quando a Base44 é provisionada dessa forma, as credenciais são injetadas no ambiente sob o prefixo `BASE44_PROJECTS_` (por exemplo, `BASE44_PROJECTS_BASE44_APP_ID`, `BASE44_PROJECTS_BASE44_ACCESS_TOKEN`, `BASE44_PROJECTS_BASE44_REFRESH_TOKEN`). A CLI normaliza automaticamente esses para os nomes simples que ela usa (`BASE44_APP_ID`, `BASE44_ACCESS_TOKEN`, …). Como resultado:

* **ID do aplicativo** é resolvido de `BASE44_APP_ID` automaticamente — sem necessidade de flag `--app-id`.
* **Autenticação** é semeada de `BASE44_ACCESS_TOKEN` / `BASE44_REFRESH_TOKEN` — sem necessidade de `npx base44 login` interativo.

Portanto, toda a etapa pós-provisionamento é apenas:

```bash theme={null}
npx base44 scaffold
```

Execute-o do diretório onde você quer os arquivos do projeto. Depois de criar a estrutura, envie recursos com `npx base44 deploy`.

## Notas

* **Modelo:** Sempre usa o modelo `backend-only` (apenas configuração Base44 — nenhum frontend é gerado).
* **Não interativo:** Nunca solicita. Ele **não** envia entidades ou implanta o site. Use `npx base44 deploy` depois para enviar recursos.
* **Apenas aplicativo existente:** Ao contrário de `create`, isto não cria um novo aplicativo Base44 — ele vincula arquivos locais ao ID de aplicativo que você fornece.
* **Autenticação:** Requer que você esteja autenticado (execute `npx base44 login` primeiro).
* O arquivo `.app.jsonc` deve ser ignorado pelo git (contém seu ID de aplicativo).

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>