> 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-es/scenes-sdk7/primeros-pasos/using-the-cli.md).

# Usando el CLI

Usa el CLI de Decentraland para ejecutar y desplegar escenas. Creator Hub es la herramienta recomendada para la mayoría de los creadores; el CLI se adapta mejor a flujos de trabajo avanzados y automatizados.

{% hint style="info" %}
**💡 Consejo**: Si estás trabajando con un asistente de programación con IA (como Claude Code, Cursor o Copilot), instala los SDK Skills oficiales de Decentraland antes de que escriba cualquier código, para que conozca los patrones verificados de SDK7:

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

Ver [Vibe Coding con IA](/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md) para el flujo de trabajo completo asistido por IA.
{% endhint %}

Para crear escenas para Decentraland, puedes usar:

* La [Creator Hub](/creator/content-creator-es/scene-editor/primeros-pasos/editor-installation.md)
* La interfaz de línea de comandos (CLI)

Ambas herramientas te permiten compilar y previsualizar tu escena en un entorno de desarrollo "off-chain". Después de probar tu escena localmente, puedes subir tu contenido al servidor de contenido, vinculándolo con tu LAND o WORLD.

Aunque el Scene Editor en el Creator Hub es más fácil de usar, la CLI te ofrece más flexibilidad y se puede usar fácilmente en procesos automatizados.

{% hint style="warning" %}
**📔 Nota**: El Scene Editor ejecuta las mismas operaciones de línea de comandos entre bastidores.
{% endhint %}

{% hint style="info" %}
**💡 Consejo**: Consulta [guía de instalación](/creator/content-creator-es/scene-editor/primeros-pasos/editor-installation.md) para obtener instrucciones sobre cómo instalar el Creator Hub.
{% endhint %}

## Antes de comenzar

Para trabajar con la escena mediante la línea de comandos, instala las siguientes dependencias antes de ejecutar comandos de CLI con la escena:

* [Node.js](https://nodejs.org) (versión 20 o posterior)

## Iniciar un nuevo proyecto

Ejecuta `npx @dcl/sdk-commands init` en una carpeta vacía para llenarla con los archivos predeterminados de un Decentraland [escena](/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/scene-metadata.md) proyecto. También puedes crear una nueva escena con el **Nueva escena** botón en el Creator Hub, que produce la misma estructura de proyecto.

Para empezar desde otro tipo de proyecto, usa el `--project` indicador. Por ejemplo, para crear un [wearable inteligente](/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/smart-wearables.md) proyecto:

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

Las opciones disponibles para `--project` son `scene-template` (el predeterminado), `px-template`, `smart-wearable`, y `library`.

## Actualizar la versión del SDK de una escena

Ejecuta el siguiente comando en la carpeta de la escena:

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

Puedes confirmar que funcionó revisando el archivo `package.json` de la escena, y buscando la versión de `@dcl/sdk` allí.

## Ejecutar una vista previa

Ejecuta `npm run start` en el nivel raíz de una escena, workspace o proyecto de wearable inteligente para abrir una vista previa en el cliente de escritorio de Decentraland.

```bash
npm run start
```

Para previsualizar tu escena en la [app móvil de Decentraland](/creator/content-creator-es/desarrollar-para-movil/cliente-movil/overview.md) en su lugar, ejecuta `npm run start -- --mobile` (alias `-- -m`). La CLI muestra un código QR que abre la escena en un teléfono conectado a la misma red Wi‑Fi que tu computadora. Consulta [Previsualizar en móvil](/creator/content-creator-es/desarrollar-para-movil/desarrollar/preview-on-mobile.md) para la guía completa.

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

Para que la vista previa se ejecute con mayor fluidez y renderice los modelos 3D tal como se verán una vez publicados, añade el `--local-ab` indicador. Consulta [Previsualización con assets optimizados](/creator/content-creator-es/scenes-sdk7/primeros-pasos/preview-scene.md#preview-with-optimized-assets).

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

Ver [previsualizar escenas](/creator/content-creator-es/scenes-sdk7/primeros-pasos/preview-scene.md) para ver detalles y opciones especiales al ejecutar una vista previa.

## Compilar

Ejecuta `npm run build` para compilar tu proyecto. Las escenas de Decentraland están escritas en TypeScript, pero se compilan a JavaScript minimizado cuando se publican. Consulta [codificación de escenas](https://github.com/decentraland/docs/blob/main/creator/sdk7/getting-started/coding-scenes.md) para más detalles.

El comando de compilación es opcional, ya que también se ejecuta en segundo plano antes de desplegar (aunque puedes añadir un indicador para omitirlo).

El comando de compilación ejecuta comprobaciones de tipo más rigurosas que las que se ejecutan con `npm run start`, ejecutarlo a veces puede ser útil para depurar una escena.

## Desplegar una escena

Ejecuta `npm run deploy` para publicar tu escena en Decentraland. Este comando abre una ventana del navegador donde puedes firmar con tu Wallet para autorizar el despliegue.

Ver [publicación](/creator/content-creator-es/scenes-sdk7/publicacion/publishing.md) para más detalles y opciones especiales al publicar una escena.

## Solución de problemas

Si tienes problemas, consulta la [solución de problemas](/creator/content-creator-es/scenes-sdk7/depuracion/troubleshooting.md) sección.


---

# 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-es/scenes-sdk7/primeros-pasos/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.