> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tu primer día con SoloEnt

> De la descarga a instalar tu primer plugin, en el orden en que realmente lo hace un usuario nuevo

Esta guía sigue el orden en que un usuario nuevo trabaja en la práctica. Calcula unos 15 minutos.

## Paso 1: Descarga

Entra en [soloent.ai](https://soloent.ai/), haz clic en **Download** en la esquina superior derecha y elige la versión correspondiente a tu equipo.

<img src="https://mintcdn.com/soloent/F2cM5uE7Kc9CGeRN/assets/images/guide_01_download-entry.png?fit=max&auto=format&n=F2cM5uE7Kc9CGeRN&q=85&s=5d669edaa2dc27a3f285c0779a992645" alt="Acceso a la descarga en la esquina superior derecha del sitio" style={{ width: '100%' }} width="2638" height="1476" data-path="assets/images/guide_01_download-entry.png" />

En Windows, comprueba la arquitectura de tu procesador. En Mac, comprueba si necesitas la versión para Apple Silicon o para Intel.

<img src="https://mintcdn.com/soloent/F2cM5uE7Kc9CGeRN/assets/images/guide_02_version-pick.png?fit=max&auto=format&n=F2cM5uE7Kc9CGeRN&q=85&s=1bca595ee4c91412871f489f93e69551" alt="Selección de versión para Windows y Mac en la página de descarga" style={{ width: '80%' }} width="1810" height="712" data-path="assets/images/guide_02_version-pick.png" />

## Paso 2: Instalación

### Windows

Es posible que aparezca una advertencia de seguridad durante la instalación. Se debe a que SoloEnt no se distribuye a través de Microsoft Store: el instalador es seguro. Elige **Trust**, **Accept**, **Keep** o **Run** para continuar.

<Warning>
  Antes de instalar, asegúrate de que no siga abierta ninguna ventana de una versión anterior de SoloEnt, o la instalación fallará.
</Warning>

<img src="https://mintcdn.com/soloent/F2cM5uE7Kc9CGeRN/assets/images/guide_03_win-warn-1.png?fit=max&auto=format&n=F2cM5uE7Kc9CGeRN&q=85&s=66ce219cb59f189ededa2116e80bc74e" alt="Advertencia de seguridad de Windows durante la instalación" style={{ width: '70%' }} width="847" height="501" data-path="assets/images/guide_03_win-warn-1.png" />

### Mac

Haz doble clic en el instalador y arrastra la aplicación a la carpeta Aplicaciones.

<img src="https://mintcdn.com/soloent/F2cM5uE7Kc9CGeRN/assets/images/guide_05_mac-install.png?fit=max&auto=format&n=F2cM5uE7Kc9CGeRN&q=85&s=78ebd04fb085e9174d2742567cb78800" alt="Arrastrar la aplicación a la carpeta Aplicaciones en Mac" style={{ width: '70%' }} width="650" height="398" data-path="assets/images/guide_05_mac-install.png" />

## Paso 3: Configura el idioma

La primera vez que abres SoloEnt, la página de bienvenida tiene un selector de idioma en la esquina superior derecha.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/welcomepage.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=934c29fed70cf39b3665eb273d0d09dc" alt="Opciones de Language y Theme en la esquina superior derecha de la página de bienvenida" style={{ width: '80%' }} width="2242" height="1574" data-path="assets/images/welcomepage.png" />

Una vez dentro de la aplicación, el icono de ajustes en la parte superior derecha del panel del Agent te da dos opciones independientes:

* **Preferred Language**: el idioma en el que responde la IA
* **Interface Language**: el idioma de la interfaz del propio panel del Agent

<img src="https://mintcdn.com/soloent/gLKaJkPIieoK6KUB/assets/images/language.png?fit=max&auto=format&n=gLKaJkPIieoK6KUB&q=85&s=72b709d5c77a46c6da35842c3fe7d646" alt="Opciones Preferred Language e Interface Language en el panel de ajustes del Agent" style={{ width: '70%' }} width="602" height="910" data-path="assets/images/language.png" />

Son independientes, así que una interfaz en inglés con respuestas en español es una combinación válida.

## Paso 4: Elige un tema de color

Si escribes durante sesiones largas, empieza por un tema cómodo para la vista.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/welcometheme.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=668839b0750ecad6dbe5d146efb8d727" alt="Opción Theme en la esquina superior derecha de la página de bienvenida" style={{ width: '80%' }} width="2242" height="1574" data-path="assets/images/welcometheme.png" />

En el selector de temas, usa **las flechas del teclado para previsualizar en vivo** y pulsa **Enter** para confirmar.

<img src="https://mintcdn.com/soloent/cLH-buynGK5Y9DZl/assets/images/themesetting.png?fit=max&auto=format&n=cLH-buynGK5Y9DZl&q=85&s=8c78882b2841793bfde2ad958afab053" alt="Menú de configuración de temas" style={{ width: '70%' }} width="1316" height="590" data-path="assets/images/themesetting.png" />

## Paso 5: Abre o crea un proyecto

**En SoloEnt, una obra equivale a una carpeta** guardada en tu equipo. Lo primero que debes hacer al abrir la aplicación es abrir una carpeta.

### Abrir un proyecto existente

Selecciona la carpeta del proyecto y haz clic en **Open**.

<Warning>
  Abre la **carpeta**, no un archivo suelto. Abrir un solo archivo deja al Agent sin el contexto del proyecto.
</Warning>

### Crear un proyecto nuevo

En el selector de archivos, ve hasta donde quieras guardar la obra, haz clic en **New Folder** abajo a la izquierda y ábrela.

<img src="https://mintcdn.com/soloent/z84uIEd0DPSDa74l/assets/images/zh/guide_11_new-folder.png?fit=max&auto=format&n=z84uIEd0DPSDa74l&q=85&s=79235c21c9025f07169e062f74da7838" alt="Botón New Folder en el cuadro de diálogo de selección de archivos" style={{ width: '70%' }} width="1670" height="970" data-path="assets/images/zh/guide_11_new-folder.png" />

Una vez abierta, el Agent buscará y creará archivos dentro de esa carpeta según lo que requiera tu escritura: mundo, personajes, escaleta, capítulos, etc.

## Paso 6: Conoce la interfaz

La interfaz tiene tres paneles, de izquierda a derecha. Todos los divisores se pueden arrastrar y los cuatro iconos de la esquina superior derecha cambian entre disposiciones predefinidas.

<img src="https://mintcdn.com/soloent/cLH-buynGK5Y9DZl/assets/images/interface-overview.png?fit=max&auto=format&n=cLH-buynGK5Y9DZl&q=85&s=cd32760f779353ad7bc55518a059aa6e" alt="Interfaz de tres paneles: gestor de archivos, editor y panel del Agent" style={{ width: '100%' }} width="2880" height="1802" data-path="assets/images/interface-overview.png" />

| Panel                          | Para qué sirve                                                                                                                                                                                       |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Izquierda — gestor de archivos | Gestiona tu obra: mundo, personajes, escaleta, capítulos y todo lo demás que generes tú o la IA                                                                                                      |
| Centro — editor                | Lee y edita documentos, sobre todo en Markdown. Admite vista dividida, varios paneles y previsualización con formato                                                                                 |
| Derecha — Agent                | Habla con el Agent para ejecutar tareas de escritura, alterna entre los modos Plan y Act, arrastra archivos desde la izquierda, cita texto seleccionado en el editor y usa subagentes o búsqueda web |

<Tip>
  Dos hábitos que conviene adquirir pronto: **arrastrar archivos al cuadro de chat** y **seleccionar texto en el editor para citarlo en el chat**. Ambos gastan menos tokens y son más precisos que copiar y pegar.
</Tip>

## Paso 7: Inicia sesión

Necesitas iniciar sesión para usar los modelos oficiales y tu crédito gratuito.

<Steps>
  <Step title="Haz clic en tu avatar">
    Haz clic en el avatar de la esquina superior derecha del panel del Agent e inicia sesión.

    <img src="https://mintcdn.com/soloent/z84uIEd0DPSDa74l/assets/images/zh/guide_13_login.png?fit=max&auto=format&n=z84uIEd0DPSDa74l&q=85&s=1c74203be1b5369b83c14408926fe8f8" alt="Acceso a la cuenta mediante el avatar en la esquina superior derecha del panel del Agent" style={{ width: '100%' }} width="2160" height="1392" data-path="assets/images/zh/guide_13_login.png" />
  </Step>

  <Step title="Inicia sesión en el navegador">
    La página de inicio de sesión se abre automáticamente en tu navegador. Entra con Google o Microsoft.
  </Step>

  <Step title="Vuelve a la aplicación">
    Tras iniciar sesión, la página pregunta si quieres abrir SoloEnt. Haz clic en **Open**.

    <img src="https://mintcdn.com/soloent/9DGUXoGK5aE9uwcb/assets/images/login_1.png?fit=max&auto=format&n=9DGUXoGK5aE9uwcb&q=85&s=3179e044022b5450574d352472e67303" alt="Página de autorización correcta con el aviso del navegador para abrir SoloEnt y el botón manual de respaldo" style={{ width: '70%' }} width="1180" height="1970" data-path="assets/images/login_1.png" />
  </Step>

  <Step title="Aprueba la solicitud">
    De vuelta en la aplicación aparece una solicitud de autorización. Haz clic en **Open** para terminar.

    <img src="https://mintcdn.com/soloent/z84uIEd0DPSDa74l/assets/images/zh/guide_15_authorize.png?fit=max&auto=format&n=z84uIEd0DPSDa74l&q=85&s=95ad5a7edb1a1040198929cd6c115522" alt="Cuadro de solicitud de autorización dentro de la aplicación" style={{ width: '70%' }} width="1920" height="1008" data-path="assets/images/zh/guide_15_authorize.png" />
  </Step>

  <Step title="Configura correo y contraseña (opcional)">
    Después de tu primer inicio de sesión con una cuenta externa, puedes configurar un correo y una contraseña en el panel de control y usarlos a partir de entonces.
  </Step>
</Steps>

## Paso 8: Configura la API

Aquí es donde más se atascan los usuarios nuevos, pero en realidad **la mayoría no necesita configurar nada**: inicia sesión y los modelos oficiales gratuitos ya están listos.

### Dos formas de entrar

* **Rápida**: haz clic en el nombre del modelo, en la parte inferior del cuadro de chat del Agent, para abrir directamente los ajustes de modelo
* **Completa**: haz clic en el icono de ajustes del panel del Agent y ve a API Configuration

La página de configuración tiene dos columnas: **Official** (sin configuración, solo elige un modelo) y **BYOK** (usa tu propia clave de API o un modelo local).

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_1.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=a380930952d0ba22b51d93be0f9a74f3" alt="Configuración rápida de la API desde el nombre del modelo en el cuadro de chat" style={{ width: '70%' }} width="686" height="272" data-path="assets/images/apikey_1.png" />

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_3.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=261ac83f5e7036db95d25d509c2cc432" alt="Configuración de la API desde el panel de ajustes" style={{ width: '70%' }} width="812" height="1072" data-path="assets/images/apikey_3.png" />

### Opción A: Usa la API oficial (recomendado para empezar)

**No hace falta configurar nada. Inicia sesión y listo.**

* Se ofrecen modelos gratuitos y cada usuario registrado recibe **US\$0,5** de crédito de prueba
* Puedes conseguir más crédito gratuito participando en las actividades de la plataforma
* La lista de modelos gratuitos y los descuentos cambian según las promociones vigentes
* Los suscriptores de Lite, Pro y Max acceden a todos los modelos de la lista VIP, siempre las versiones oficiales más recientes. Al suscribirte se cambia automáticamente a la lista VIP
* El precio de la API oficial coincide con el precio oficial de cada proveedor de modelos, **sin recargo**

Puedes buscar en la lista de modelos por nombre o proveedor. Cada modelo muestra su longitud de contexto y el precio de entrada y salida.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_4.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=da746ca341868270d88d79da60e4fd00" alt="Panel de configuración de la API con el proveedor oficial y la pestaña Free con los modelos disponibles" style={{ width: '70%' }} width="720" height="948" data-path="assets/images/apikey_4.png" />

### Opción B: Usa tu propia clave de API de terceros (BYOK)

Antes que nada, algo que conviene tener claro: **una clave de API no es lo mismo que una suscripción en la web del proveedor del modelo.**

Mucha gente da por hecho que un plan de US\$20 al mes en la web de un proveedor incluye acceso a la API. No es así: se facturan por separado. Una clave de API es:

* Tu credencial para invocar el modelo
* Aquello contra lo que se factura tu uso
* Un secreto que conviene proteger. Tiene la forma `sk-abc123xyz456...`; nunca la compartas ni la subas a un repositorio público

Para configurarla:

<Steps>
  <Step title="Selecciona BYOK">Elige BYOK en la página de configuración.</Step>
  <Step title="Elige tu proveedor de API">Selecciónalo en el desplegable.</Step>
  <Step title="Introduce tus credenciales">Rellena los valores que te haya dado tu proveedor.</Step>
</Steps>

<Warning>
  Solo las claves compradas directamente al proveedor del modelo, y unos pocos agregadores, se pueden configurar eligiendo un proveedor. **La mayoría de proveedores de terceros requieren la opción OpenAI Compatible, que necesita Base URL, API Key y Model ID: los tres.** Confirma esos tres valores con tu proveedor antes de comprar.
</Warning>

<img src="https://mintcdn.com/soloent/z84uIEd0DPSDa74l/assets/images/zh/guide_19_openai-compatible.png?fit=max&auto=format&n=z84uIEd0DPSDa74l&q=85&s=e4014bbc0454c6fb5a72f8b727b1b2f9" alt="BYOK con OpenAI Compatible seleccionado, mostrando los campos Base URL, API Key y Model ID" style={{ width: '70%' }} width="540" height="748" data-path="assets/images/zh/guide_19_openai-compatible.png" />

**Compra solo por canales oficiales y ten cuidado con tus datos de pago.**

### Opción C: Reutiliza una suscripción de Codex o Claude Code

Si ya pagas alguna de las dos, puedes consumir esa suscripción dentro de SoloEnt y seguir disfrutando de las Skills de escritura de SoloEnt.

**Codex**: elige BYOK, selecciona **OpenAI Codex** como proveedor, haz clic en Sign in to OpenAI Codex y luego elige un modelo de Codex en la lista.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/codex.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=0ec7f282fa0033e736f5ea351ab60a93" alt="Configuración BYOK con OpenAI Codex como proveedor y el botón Sign in to OpenAI Codex" style={{ width: '70%' }} width="642" height="1046" data-path="assets/images/codex.png" />

**Claude Code**: instala primero la CLI de Claude Code en tu equipo e inicia sesión con tu suscripción. Después elige BYOK, selecciona **Claude Code** como proveedor y escoge el modelo de Claude que quieras. No hace falta nada más.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/claudecode.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=cb4ad3d2c3c24fb07806b165fe8997c1" alt="Configuración BYOK con Claude Code como proveedor, mostrando la ruta de la CLI y la selección de modelo" style={{ width: '70%' }} width="632" height="980" data-path="assets/images/claudecode.png" />

### Avanzado: modelos distintos para Plan y Act

Los modelos oficiales se pueden asignar por separado a la planificación y a la ejecución:

* En planificación importan la estructura y las buenas preguntas de aclaración: Sonnet y GLM funcionan bien aquí
* En ejecución importan la velocidad, la concisión o el coste: Gemini y Doubao funcionan bien aquí

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/apikey_6.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=4e960b96ed3097597d4768eaacc570ef" alt="Panel de configuración de la API con las pestañas Plan Mode y Act Mode y la opción de usar modelos distintos en cada una" style={{ width: '70%' }} width="724" height="1506" data-path="assets/images/apikey_6.png" />

<Info>
  Es opcional. Está pensado para quien conoce bien el carácter de cada modelo; si empiezas, deja los valores por defecto.
</Info>

## Paso 9: Instala tu primer plugin

Los plugins son la forma en que se distribuyen las capacidades de escritura de SoloEnt. Un plugin puede contener una Rule, un Workflow, una Skill o cualquier combinación, orientada a un escenario de escritura concreto. **Nunca tienes que crear archivos de configuración a mano: instálalo y sigue sus instrucciones.**

Puedes ver todo lo publicado en [soloent.ai/es/plugins](https://soloent.ai/es/plugins).

### Abre un proyecto primero (esto importa)

<Warning>
  Los plugins se instalan en **el proyecto activo**, no en un directorio global. Abre el proyecto de escritura en el que quieras usarlo (paso 5) antes de instalarlo. Si instalas sin ningún proyecto abierto, los archivos acaban en el sitio equivocado.
</Warning>

### Abre el Marketplace

Haz clic en el icono del Marketplace (el cubo) en la parte superior del panel del Agent.

<img src="https://mintcdn.com/soloent/F2cM5uE7Kc9CGeRN/assets/images/guide_23_marketplace1.png?fit=max&auto=format&n=F2cM5uE7Kc9CGeRN&q=85&s=30eb3722a85bf1df5c71167e6bbfa98e" alt="Página del Marketplace de plugins con el icono del cubo como acceso, las pestañas Marketplace e Installed y la barra de búsqueda" style={{ width: '70%' }} width="420" height="833" data-path="assets/images/guide_23_marketplace1.png" />

Dos formas de explorar:

* Escribe una palabra clave en la barra de búsqueda
* Usa el filtro de idioma de la esquina superior derecha (English, 中文, 日本語, 한국어, Español)

### Lee la página de detalle

Abre un plugin para ver su página de detalle. Lo que conviene mirar:

* **Nombre y resumen**: una o dos frases sobre el problema que resuelve
* **Número de instalaciones**: una señal aproximada de lo bien que funciona
* **Uso**: cómo invocarlo o activarlo
* **Contenido**: cuáles de Rule / Workflow / Skill incluye
* **Reglas principales**: la lógica que hay detrás, de un vistazo
* **Versión**: la versión disponible actualmente

### Instala y verifica

Haz clic en **Install** en la página de detalle. Los plugins instalados aparecen en la pestaña **Installed**.

Según lo que contenga el plugin, comprueba que los archivos se hayan creado:

| Contenido | Dónde comprobarlo                  |
| --------- | ---------------------------------- |
| Rule      | Panel del Agent → pestaña Rules    |
| Workflow  | Panel del Agent → pestaña Workflow |
| Skill     | Panel del Agent → pestaña Skills   |

Un plugin combinado aparecerá en más de un sitio.

### Empieza a usarlo

Los tres tipos de contenido se activan de forma distinta:

* **Rule**: activa en cuanto se instala, no hay que invocarla
* **Workflow**: se activa con su comando
* **Skill**: se activa automáticamente cuando la situación lo requiere

La página de detalle de cada plugin documenta su activación, sus requisitos previos (por ejemplo, tener abierto un archivo de capítulo) y lo que produce. **Léela entera antes de empezar.**

## Después de esto: tres cosas que conviene hacer ya

### 1. Entiende el modo Plan frente al modo Act

Se alternan en la esquina inferior izquierda del cuadro de chat del Agent.

<img src="https://mintcdn.com/soloent/4RpSHkUFmW5kEqcF/assets/images/plan.png?fit=max&auto=format&n=4RpSHkUFmW5kEqcF&q=85&s=374a14acbf1cd63e5fb58f4079f18051" alt="Selector de modo Plan y Act en el cuadro de chat del Agent" style={{ width: '70%' }} width="676" height="252" data-path="assets/images/plan.png" />

* **Plan**: produce una propuesta sin tocar archivos. Úsalo al empezar un libro, cuando te atascas o cuando reestructuras. Analiza, divide el trabajo en pasos y pide confirmación, y termina con un plan que tú has aprobado.
* **Act**: hace el trabajo: crea archivos, edita texto, ejecuta comandos. La escritura del día a día se queda en Act.

<Tip>
  Si el Agent solo da opiniones y nunca genera archivos, comprueba si sigues en modo Plan.
</Tip>

Un buen ritmo: empieza cada proyecto nuevo en Plan, cambia a Act cuando el plan esté acordado y vuelve a Plan cuando te atasques o hagas un cambio grande.

### 2. Inicializa SOLOENT.md

Escribe `/init` en el chat y SoloEnt generará un `SOLOENT.md` para el proyecto actual. Es el panel de control del proyecto y la memoria a largo plazo de la IA, con ocho secciones: ADN del proyecto, sistema del mundo, personajes, trama y estructura, guía de estilo, restricciones y tabúes, estado de escritura en vivo y hoja de ruta.

Existe para resolver la consistencia en obras largas. **Los proyectos cortos y la no ficción no lo necesitan.**

Mientras escribes, el Agent mantiene por su cuenta las secciones de estado de escritura y hoja de ruta. Las dos que deberías editar a mano son la guía de estilo y las restricciones.

### 3. Dónde conseguir ayuda

<CardGroup cols={2}>
  <Card title="Preguntas frecuentes" icon="circle-question" href="/es/faq">
    Respuestas a las dudas más habituales
  </Card>

  <Card title="Solución de problemas" icon="wrench" href="/es/troubleshooting/login">
    Inicio de sesión, API, formatos de archivo y entorno
  </Card>

  <Card title="Soporte por correo" icon="envelope" href="mailto:support@soloent.cn">
    [support@soloent.cn](mailto:support@soloent.cn)
  </Card>

  <Card title="Suscripción y pago" icon="credit-card" href="/es/subscription/choose-your-plan">
    Planes, pago y gestión de la suscripción
  </Card>
</CardGroup>
