> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md).

# Usando a CLI

Use a CLI do Decentraland para executar e implantar scenes. O Creator Hub é a ferramenta recomendada para a maioria dos creators; a CLI é adequada para workflows avançados e automatizados.

{% hint style="info" %}
**💡 Dica**: Se estiver a trabalhar com um assistente de codificação com IA (como Claude Code, Cursor ou Copilot), instale o Decentraland SDK Skills oficial antes de ele escrever qualquer código, para que conheça padrões SDK7 verificados:

```bash
npx skills add decentraland/sdk-skills
```

Veja [Vibe Coding com IA](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) para o fluxo de trabalho completo assistido por IA.
{% endhint %}

Para criar scenes para Decentraland, pode usar:

* O [Creator Hub](/creator/content-creator-pt/scene-editor/comece/editor-installation.md)
* A Command Line Interface (CLI)

Ambas as ferramentas permitem compilar e pré-visualizar a sua scene num ambiente de desenvolvimento "off-chain". Após testar a sua scene localmente, pode carregar o seu conteúdo para o content server, ligando-o ao seu LAND ou WORLD.

Embora o Scene Editor no Creator Hub seja mais fácil de usar, a CLI oferece mais flexibilidade e pode ser facilmente usada em processos automatizados.

{% hint style="warning" %}
**📔 Nota**: O Scene Editor executa as mesmas operações de linha de comando nos bastidores.
{% endhint %}

{% hint style="info" %}
**💡 Dica**: Veja [Guia de instalação](/creator/content-creator-pt/scene-editor/comece/editor-installation.md) para instruções sobre como instalar o Creator Hub.
{% endhint %}

## Antes de começar

Para trabalhar com a scene via linha de comando, instale as seguintes dependências antes de executar comandos da CLI com a scene:

* [Node.js](https://nodejs.org) (versão 20 ou posterior)

## Iniciar um novo projeto

Execute `npx @dcl/sdk-commands init` numa pasta vazia para preenchê-la com os ficheiros predefinidos de um Decentraland [scene](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md) projeto. Também pode criar uma nova scene com o **Nova Scene** botão no Creator Hub, que produz a mesma estrutura de projeto.

Para começar com um tipo diferente de projeto, use o `--project` parâmetro. Por exemplo, para criar um [smart wearable](/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md) projeto:

```bash
npx @dcl/sdk-commands init --project smart-wearable
```

As opções disponíveis para `--project` são `scene-template` (o predefinido), `px-template`, `smart-wearable`, e `library`.

## Atualize a versão do SDK de uma scene

Execute o seguinte comando na pasta da scene:

```bash
npm i @dcl/sdk@latest
```

Pode confirmar que funcionou verificando o `package.json` ficheiro da scene e procurando o `@dcl/sdk` versão aí.

## Execute uma pré-visualização

Execute `npm run start` no nível raiz de uma scene, workspace ou projeto smart wearable para abrir uma pré-visualização no cliente de Desktop do Decentraland.

```bash
npm run start
```

Para pré-visualizar a sua scene na [aplicação móvel do Decentraland](/creator/content-creator-pt/criar-para-dispositivos-moveis/mobile-client/overview.md) em vez disso, execute `npm run start -- --mobile` (alias `-- -m`). A CLI imprime um código QR que abre a scene num telemóvel ligado à mesma rede Wi-Fi que o seu computador. Veja [Pré-visualização no telemóvel](/creator/content-creator-pt/criar-para-dispositivos-moveis/desenvolver/preview-on-mobile.md) para o guia completo.

```bash
npm run start -- --mobile
```

Para tornar a pré-visualização mais fluida e renderizar os modelos 3D exatamente como ficarão quando publicados, adicione o `--local-ab` parâmetro. Veja [Pré-visualização com assets otimizados](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md#preview-with-optimized-assets).

```bash
npm run start -- --local-ab
```

Veja [pré-visualizar scenes](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md) para detalhes e opções especiais ao executar uma pré-visualização.

## Compilar

Execute `npm run build` para compilar o seu projeto. As scenes do Decentraland são escritas em TypeScript, mas são compiladas para JavaScript minificado quando publicadas. Veja [codificar scenes](https://github.com/decentraland/docs-creator/blob/main/sdk7/getting-started/coding-scenes.md) para mais detalhes.

O comando build é opcional, uma vez que também é executado em segundo plano antes do deploy (embora possa adicionar um parâmetro para o ignorar).

O comando build executa verificações de tipos mais rigorosas do que as que são executadas com `npm run start`, executá-lo pode por vezes ser útil para depurar uma scene.

## Publicar uma scene

Execute `npm run deploy` para publicar a sua scene no Decentraland. Este comando abre uma janela do browser onde pode assinar com a sua Wallet para autorizar o deploy.

Veja [publicação](/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para detalhes e opções especiais ao publicar uma scene.

## Resolução de problemas

Se tiver problemas, veja a [resolução de problemas](/creator/content-creator-pt/scenes-sdk7/debugging/troubleshooting.md) secção.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.