> 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 publicar scenes. O Creator Hub é a ferramenta recomendada para a maioria dos criadores; a CLI é adequada para fluxos de trabalho avançados e automatizados.

{% hint style="info" %}
**💡 Dica**: Se estiver a trabalhar com um assistente de programação com IA (como Claude Code, Cursor ou Copilot), instale as competências oficiais do SDK da Decentraland antes de este escrever código, para que conheça os padrões verificados do SDK7:

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

Consulte [Programação Vibe com IA](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) para ver o fluxo de trabalho completo com assistência de IA.
{% endhint %}

Para criar Scenes para a Decentraland, pode usar:

* O [Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md)
* A interface de linha de comandos (CLI)

Ambas as ferramentas permitem compilar e pré-visualizar a sua Scene num ambiente de desenvolvimento «off-chain». Depois de testar a sua Scene localmente, pode carregar o conteúdo para o servidor de conteúdo, associando-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 utilizada em processos automatizados.

{% hint style="warning" %}
**📔 Nota**: O Scene Editor executa as mesmas operações de linha de comandos em segundo plano.
{% endhint %}

{% hint style="info" %}
**💡 Dica**: Consulte o [guia de instalação](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md) para obter instruções sobre como instalar o Creator Hub.
{% endhint %}

## Antes de começar

Para trabalhar com a Scene através da linha de comandos, instale as seguintes dependências antes de executar comandos da CLI na 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 a preencher com os ficheiros predefinidos de uma [Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md) da Decentraland. Também pode criar uma nova Scene com o botão **Nova Scene** no Creator Hub, que gera a mesma estrutura de projeto.

Para começar com outro tipo de projeto, use a opção `--project` Por exemplo, para criar um projeto de [Wearable inteligente](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md) :

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

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

## Atualizar a versão do SDK de uma Scene

Execute o seguinte comando na pasta da Scene:

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

Pode confirmar se funcionou verificando o ficheiro `package.json` ficheiro da cena e procurando a `@dcl/sdk` versão correspondente.

## Executar uma pré-visualização

Executar `npm run start` no nível raiz de um projeto de cena, workspace ou wearable inteligente para abrir uma pré-visualização no cliente Decentraland Desktop.

```bash
npm run start
```

Para pré-visualizar a sua cena na [aplicação móvel Decentraland](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/cliente-movel/overview.md) em vez disso, execute `npm run start -- --mobile` (atalho `-- -m`). A CLI apresenta um código QR que abre a cena num telemóvel ligado à mesma rede Wi-Fi que o seu computador. Consulte [Pré-visualizar em dispositivos móveis](https://docs.decentraland.org/creator/content-creator-pt/criar-para-mobile/desenvolver/preview-on-mobile.md) para obter o guia completo.

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

O Desktop Explorer converte os seus modelos 3D em pacotes de recursos otimizados enquanto os pré-visualiza, para que tenham exatamente o mesmo aspeto que terão depois de publicados. Para carregar os modelos em bruto, em vez disso, passe `--lsd-raw-gltf` depois de um comando `--`. Consulte [Pré-visualizar com recursos otimizados](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md#preview-with-optimized-assets).

```bash
npx sdk-commands start -- --lsd-raw-gltf
```

Consulte [pré-visualizar cenas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md) para obter detalhes e opções especiais ao executar uma pré-visualização.

## Compilar

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

O comando de compilação é opcional, pois também é executado em segundo plano antes da implementação (embora possa adicionar uma flag para o ignorar).

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

## Implementar uma cena

Execute `npm run deploy` para publicar a sua cena na Decentraland. Este comando abre uma janela do browser onde pode assinar com a sua wallet para autorizar a implementação.

Consulte [publicar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para obter detalhes e opções especiais ao publicar uma cena.

## Resolução de problemas

Se tiver algum problema, consulte a secção de [resolução de problemas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/troubleshooting.md) .


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
