> 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 você estiver trabalhando com um assistente de programação com IA (como Claude Code, Cursor ou Copilot), instale as Decentraland SDK Skills oficiais antes que ele escreva qualquer código, para que ele conheça padrões verificados do SDK7:

```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 cenas para Decentraland, você pode usar:

* O [Creator Hub](/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md)
* A Interface de Linha de Comando (CLI)

Ambas as ferramentas permitem que você compile e faça preview da sua cena em um ambiente de desenvolvimento "off-chain". Depois de testar sua cena localmente, você pode enviar seu conteúdo para o servidor de conteúdo, vinculando-o ao seu LAND ou WORLD.

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

{% hint style="warning" %}
**📔 Observação**: 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/primeiros-passos/editor-installation.md) para instruções sobre como instalar o Creator Hub.
{% endhint %}

## Antes de começar

Para lidar com a cena pela linha de comando, instale as seguintes dependências antes de executar comandos da CLI com a cena:

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

## Iniciar um novo projeto

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

Para começar a partir de um tipo diferente de projeto, use a `--project` flag. Por exemplo, para criar um projeto de [smart wearable](/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` (o padrão), `px-template`, `smart-wearable`, e `library`.

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

Execute o seguinte comando na pasta da cena:

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

Você pode confirmar que funcionou verificando o `arquivo package.json` da cena e procurando pela `@dcl/sdk` versão lá.

## Executar uma pré-visualização

Execute `npm run start` na raiz de um projeto de cena, workspace ou smart wearable para abrir um preview no cliente de desktop do Decentraland.

```bash
npm run start
```

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

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

Para fazer o preview rodar de forma mais suave e renderizar modelos 3D exatamente como ficarão quando publicados, adicione a `--local-ab` flag. Veja [Preview 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 cenas](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md) para detalhes e opções especiais ao executar um preview.

## Compilar

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

O comando build é opcional, pois ele também é executado em segundo plano antes do deploy (embora você possa adicionar uma flag para ignorá-lo).

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

## Fazer o deploy de uma cena

Execute `npm run deploy` para publicar sua cena no Decentraland. Este comando abre uma janela do navegador onde você pode assinar com 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 cena.

## Solução de problemas

Se você encontrar problemas, veja a seção de [solução de problemas](/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.