> ## 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 link

> Vincula um projeto Base44 local existente a um aplicativo Base44 na nuvem. Use isto quando você tem um base44/config.jsonc mas ainda não o conectou a um aplicativo Base44.

<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 link

Vincula um projeto Base44 local existente a um aplicativo Base44 na nuvem. Use isto quando você tem um `base44/config.jsonc` mas ainda não o conectou a um aplicativo Base44.

## Crítico: Quando usar Link vs Create

| Cenário                                        | Comando                |
| ---------------------------------------------- | ---------------------- |
| Começando do zero, sem pasta `base44/`         | `npx base44 create`    |
| Tem `base44/config.jsonc` mas sem `.app.jsonc` | `npx base44 link`      |
| Projeto já vinculado (tem `.app.jsonc`)        | Já feito, use `deploy` |

## Sintaxe

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

## Opções

| Opção                             | Descrição                                                                                     | Obrigatório    |
| --------------------------------- | --------------------------------------------------------------------------------------------- | -------------- |
| `-c, --create`                    | Cria um novo projeto (pula o prompt de seleção)                                               | Não            |
| `-n, --name <name>`               | Nome do projeto (obrigatório quando `--create` é usado)                                       | Com `--create` |
| `-d, --description <description>` | Descrição do projeto                                                                          | Não            |
| `--app-id <id>`                   | ID do aplicativo para vincular a um projeto existente (flag global, pula o prompt de seleção) | Não            |

## Modo não interativo

Para uso em CI/CD ou por agentes:

**Criar um novo projeto:**

```bash theme={null}
npx base44 link --create --name my-app
```

**Vincular a um aplicativo existente:**

```bash theme={null}
npx base44 link --app-id <app-id>
```

ERRADO: `npx base44 link --create` (falta --name)
ERRADO: `npx base44 link --create --app-id <id>` (não pode usar ambos)
CERTO: `npx base44 link --create --name my-app`
CERTO: `npx base44 link --app-id <id>`

## Exemplos

```bash theme={null}
# Modo interativo - solicita detalhes do projeto
npx base44 link

# Não interativo - cria e vincula em uma única etapa
npx base44 link --create --name my-app

# Com descrição
npx base44 link --create --name my-app --description "My awesome app"

# Vincula a um projeto existente específico pelo ID
npx base44 link --app-id abc123
```

## O que faz

1. Encontra o `base44/config.jsonc` no diretório atual (ou diretórios pai)
2. Verifica se nenhum `.app.jsonc` existe (projeto ainda não vinculado)
3. Ou:
   * Cria um novo aplicativo Base44 na nuvem (com `--create`), OU
   * Vincula a um aplicativo existente (com `--app-id` ou seleção interativa)
4. Grava o ID do aplicativo em `base44/.app.jsonc`

## Requisitos

* Deve ter `base44/config.jsonc` no projeto
* NÃO deve ter `base44/.app.jsonc` (use `deploy` se já vinculado)
* Deve estar autenticado (execute `npx base44 login` primeiro)

## Notas

* Após vincular, você pode implantar recursos com `npx base44 deploy`
* 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>