# gt: General Translation CLI tool: Inicio rápido
URL: https://generaltranslation.com/es/docs/cli/quickstart.mdx
---
title: Inicio rápido
description: Aprende qué hace el CLI de General Translation, cuándo usarlo y cómo traducir tu primer proyecto.
related:
  links:
    - /docs/cli/guides/generating-translations
    - /docs/cli/guides/configuring
    - /docs/cli/guides/managing-translations
    - /docs/cli/guides/using-auto-jsx

---

El CLI de General Translation (`gt`) configura la internacionalización y traduce tu proyecto desde la línea de comandos.

Funciona con [`gt-react`, `gt-next` y `gt-react-native`](/docs/react/overview), con bibliotecas de i18n de terceros como `next-intl` e `i18next`, y con archivos independientes como JSON, YAML, Markdown y MDX.

## Qué hace la CLI [#what-it-does]

La CLI te da acceso directo a:

* **Configuración** para instalar dependencias, integrar tu framework y crear un `gt.config.json`.
* **Traducción** para enviar tu contenido de origen a la API de General Translation y guardar los resultados en tu base de código o en la CDN.
* **Componentes de CI** para subir, poner en cola y descargar traducciones en distintas etapas del flujo.
* **Validación** para comprobar si hay errores de traducción en tu proyecto sin llamar a la API.

## Cuándo usar la CLI [#when-to-use]

Usa la CLI cuando quieras:

* Configurar un proyecto nuevo para traducir con un asistente guiado.
* Traducir tu proyecto como parte de una compilación o de un flujo de CI.
* Traducir archivos de contenido independientes sin añadir una biblioteca de framework.
* Mantener las traducciones en el control de versiones junto con tu contenido de origen.

## Inicio rápido [#quickstart]

Instala `gt`, configura tu proyecto y ejecuta tu primera traducción. Necesitas un proyecto existente con un archivo `package.json` y Node.js instalado.

### 1. Instala `gt`

Instala la CLI como dependencia de desarrollo.

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt --save-dev
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add --dev gt
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add --dev gt
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add --save-dev gt
    ```
  </Tab>
</Tabs>

### 2. Configura tu proyecto

Ejecuta el asistente de configuración para detectar tu framework, crear un `gt.config.json` y generar credenciales cuando la configuración seleccionada las necesite.

```bash
npx gt init
```

En un monorepo, ejecuta el comando desde la aplicación que quieras localizar. El asistente se detiene sin modificar archivos cuando lo ejecutas desde la raíz del workspace.

<Callout type="warn">
  [`gt init`](/docs/cli/reference/commands/init) es un asistente interactivo y necesita una terminal. En CI o en otro shell no interactivo puede quedarse esperando entrada, fallar la validación o salir antes de tiempo sin crear `gt.config.json` ni escribir las credenciales. Para esos entornos, usa [Configuración no interactiva para CI](#ci-setup).
</Callout>

El asistente establece tu configuración regional predeterminada y tus configuraciones regionales de destino, y elige dónde se almacenan las traducciones. Cuando la configuración seleccionada necesita credenciales, puede escribir tu clave API y tu Project ID en `.env.local`. Consulta [Configurar la CLI](/docs/cli/guides/configuring) para ver cómo hacerlo en detalle, o [`gt init`](/docs/cli/reference/commands/init) para ver el comando completo.

*Nota: Ahora deberías tener un `gt.config.json` en la raíz de tu proyecto. Si el asistente generó credenciales, `.env.local` contiene `GT_API_KEY` y `GT_PROJECT_ID`. La configuración local incluida de Vite omite las credenciales, así que agrégalas en el siguiente paso antes de traducir.*

### 3. Añade tu clave API de producción

El comando [`translate`](/docs/cli/reference/commands/translate) requiere una clave API de producción y un Project ID. El asistente puede generarlos por ti, o puedes crearlos en la [página de API Keys](https://generaltranslation.com/dashboard). Defínelos como variables de entorno para que el CLI pueda leerlos.

```bash title=".env.local"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

*Nota: Define tu clave API como una variable de entorno; nunca la añadas a `gt.config.json`.*

### 4. Traduce tu proyecto

Ejecuta el comando [`translate`](/docs/cli/reference/commands/translate) para traducir todos los archivos configurados en `gt.config.json`, junto con cualquier componente inline [`<T>`](/docs/react/reference/components/t) y las entradas del diccionario en tu código fuente.

```bash
npx gt translate
```

Las traducciones se guardan en tu base de código, listas para hacer commit. Ejecuta esto en tu flujo de CI antes de compilar para producción. Consulta [Generating translations](/docs/cli/guides/generating-translations) para ver el flujo de trabajo completo.

## Configuración no interactiva para CI [#ci-setup]

El asistente de configuración necesita una terminal interactiva, por lo que no puede ejecutarse en CI ni en otros entornos no interactivos. Haz esta configuración manualmente: haz commit de un `gt.config.json`, proporciona tus credenciales como variables de entorno y ejecuta [`translate`](/docs/cli/reference/commands/translate) con esa configuración.

### 1. Añade un `gt.config.json`

Crea el archivo tú mismo y haz commit para que la CLI sepa qué traducir. Una configuración mínima define las configuraciones regionales de origen y de destino, además de una entrada `files` para que [`translate`](/docs/cli/reference/commands/translate) tenga algo con lo que trabajar. La entrada `gt` de abajo almacena localmente, en la ruta indicada, las traducciones del framework (de `gt-next`, `gt-react` o `gt-react-native`).

```json title="gt.config.json"
{
  "$schema": "https://assets.gtx.dev/config-schema.json",
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "gt": {
      "output": "public/_gt/[locale].json"
    }
  }
}
```

Si en su lugar quieres traducir archivos independientes, agrega un tipo de archivo como `json` o `mdx` con un glob `include` en lugar de (o junto con) la entrada `gt`. Consulta [Configurar la CLI](/docs/cli/guides/configuring) para ver las opciones de archivo y almacenamiento, y la [referencia de configuración](/docs/cli/reference/config) para conocer todos los campos.

### 2. Define tus credenciales

Define tu clave API de producción y tu Project ID como variables de entorno en la configuración de secretos de tu proveedor de CI, no en un archivo versionado. Créalos en la [página de API Keys](https://generaltranslation.com/dashboard).

```bash
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

### 3. Ejecuta el comando `translate`

Ejecuta [`translate`](/docs/cli/reference/commands/translate) antes de compilar para producción. Usa `--config` para indicar tu archivo de configuración.

```bash
npx gt translate --config gt.config.json
```
## Next steps

- /docs/cli/guides/generating-translations
- /docs/cli/guides/configuring
- /docs/cli/guides/managing-translations
- /docs/cli/guides/using-auto-jsx