# Su primer proyecto

<TLDR>
Cree un proyecto con **Nuevo proyecto**, inicie su Studio, pídale a la IA que construya o cambie algo y revise el resultado en **Vista previa**. Conecte GitHub para que su código quede guardado en su propio repositorio.
</TLDR>

## Qué va a construir [#qué-va-a-construir]

Un <Term id="project">proyecto</Term> con un <Term id="studio">Studio</Term> en ejecución y un primer cambio hecho por la IA, visible en la vista previa en vivo. Agentes, despliegues y aplicaciones viven en un proyecto.

## Antes de empezar [#antes-de-empezar]

- Un <Term id="workspace">espacio de trabajo</Term> de Klarety en la prueba gratis o en Pro. Vea el [Inicio rápido](/docs/es/get-started/quickstart).
- <Term id="credits">Créditos</Term>: un Studio en ejecución se cobra por minuto. Su saldo está en <AppLink to="settings.usage" />.
- Opcional: GitHub conectado, para guardar su código en un repositorio suyo. Vea [GitHub](/docs/es/connectors/github).

<Callout type="info" title="Un Studio en ejecución usa créditos">
Un Studio se cobra por minuto mientras se ejecuta. Deténgalo al terminar; sus archivos se conservan.
</Callout>

## Pasos [#pasos]

<Steps>
<Step>
### Cree el proyecto [#cree-el-proyecto]
Abra <AppLink to="projects.new" />, o seleccione **Nuevo proyecto** en <AppLink to="home" />. Escriba un nombre para el proyecto. Las demás opciones tienen valores predeterminados razonables:

- **Tamaño**: cuánta máquina recibe el Studio. El inicial basta para empezar.
- **Cómo funciona**: la máquina compartida estándar es la predeterminada. Si se recupera, una nueva arranca sola y no se pierde trabajo. **Premium** nunca se interrumpe.
- **<Term id="ai-harness">AI harness</Term>**: qué herramientas de IA usa el proyecto.
- **Conectar GitHub**: enlace un repositorio ahora, o después desde la configuración del proyecto.
- **Invitar personas**: agregue compañeros de su espacio de trabajo.
- **Acceso a internet**: si el Studio puede llegar a toda la web, solo a sus conexiones y los sitios que agregue, o a nada fuera de Klarety.

El formulario muestra el costo del Studio por hora. Seleccione **Crear proyecto**. Cada opción se explica en [Crear un proyecto](/docs/es/projects/create-a-project).

<Screenshot src="/docs/_media/new-project-advance-settings.png" alt="El formulario Nuevo proyecto con Tamaño, Cómo funciona, Acceso a internet y el costo por hora" />
</Step>
<Step>
### Inicie el Studio [#inicie-el-studio]
El proyecto se abre en su resumen. Si el Studio no está en ejecución, seleccione **Iniciar Studio** y espere a que su estado diga que está en ejecución.
</Step>
<Step>
### Pídale algo a la IA [#pídale-algo-a-la-ia]
Abra la pestaña **IA** y describa lo que quiere, por ejemplo:

> Construye una página web pequeña que liste las tablas de mi espacio de trabajo y cuántas filas tiene cada una.

La IA lee su proyecto, escribe el código y lo ejecuta, mostrando cada paso.

<Screenshot src="/docs/_media/studio-ai-chat.png" alt="El chat de IA del Studio dentro de un proyecto" caption="La pestaña de IA: describa un cambio y vea a la IA hacerlo." />

Use la IA de Klarety o su propia suscripción de Claude Code, Codex o Cursor. Vea el [AI harness](/docs/es/ai-harness).
</Step>
<Step>
### Vea el resultado [#vea-el-resultado]
**Vista previa** muestra la aplicación en ejecución; **Código** le permite editar los archivos. Ponga las pestañas lado a lado para ver la vista previa mientras la IA trabaja.

<Screenshot src="/docs/_media/project-page-running-klarety-code-new-session.png" alt="El Studio con las pestañas IA y Vista previa lado a lado" />
</Step>
<Step>
### Guarde su código en GitHub [#guarde-su-código-en-github]
Si está enlazado a un repositorio, haga push desde el Studio. Si no, el resumen del proyecto le ofrece conectar GitHub; selecciónelo y elija un repositorio.
</Step>
<Step>
### Detenga el Studio al terminar [#detenga-el-studio-al-terminar]
Seleccione **Detener Studio**. Los archivos se conservan, un Studio detenido no gasta créditos por tiempo de ejecución, y puede iniciarlo de nuevo cuando quiera.
</Step>
</Steps>

## Compruebe que funcionó [#compruebe-que-funcionó]

- El proyecto aparece en <AppLink to="projects" /> con el estado de su Studio.
- **Vista previa** muestra la página que construyó la IA.
- Si enlazó GitHub, la tarjeta de código del resumen dice que el código está guardado en su repositorio.
- La **Actividad** del proyecto muestra su sesión en el Studio.

## Variaciones comunes [#variaciones-comunes]

- **Partir de un repositorio existente.** Enlace un repositorio de GitHub al crear el proyecto; la IA trabaja sobre su código real.
- **Trabajar con un compañero.** Agréguelo en **Invitar personas**, o después en **Personas** dentro de la configuración del proyecto. Cada persona usa su propia sesión de IA en el mismo Studio. Vea [Trabajar juntos](/docs/es/ai-harness/working-together).
- **Probar un cambio arriesgado con seguridad.** Pídale a la IA que trabaje en una copia, una rama separada, así su código principal queda como está. Vea [Copias](/docs/es/ai-harness/copies).

## Si algo sale mal [#si-algo-sale-mal]

<Accordions>
<Accordion title="Iniciar Studio dice que no tengo créditos">
Compre más créditos o revise sus créditos mensuales en <AppLink to="settings.usage" />.
</Accordion>
<Accordion title="Una opción dice que no está en su plan">
Algunos tamaños y opciones dependen de su plan. Deje el valor predeterminado, o vea <AppLink to="settings.billing" /> para comparar planes.
</Accordion>
<Accordion title="El Studio no llega a un sitio web">
Revise **Acceso a internet** en la configuración del proyecto. Con solo sitios permitidos, agregue el sitio. Con internet apagado, el Studio no llega a nada fuera de Klarety.
</Accordion>
<Accordion title="El Studio no arrancó">
Seleccione **Iniciar Studio** de nuevo. Si eligió una máquina estándar y se recuperó, una nueva arranca sola y su trabajo se conserva.
</Accordion>
</Accordions>

## Siguientes pasos [#siguientes-pasos]

- [Convierta una hoja de cálculo en tabla](/docs/es/guides/spreadsheet-to-table): dele datos a su proyecto.
- [Despliegue su primera aplicación](/docs/es/guides/first-deploy): ponga en línea lo que construyó.
- [El Studio](/docs/es/projects/studio): todo lo que puede hacer un Studio.
- [Klarety Buddy](/docs/es/projects/buddy): revisión de código con IA para su proyecto.