# 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.

### 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 inicial para detectar tu framework, crear un `gt.config.json` y generar credenciales.

```bash
npx gt init
```

El asistente establece tu configuración regional predeterminada y tus configuraciones regionales de destino, elige dónde se almacenan las traducciones y escribe 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.

### 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"
GT_API_KEY=your-api-key
GT_PROJECT_ID=your-project-id
```

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

### 4. Traduce tu proyecto

Ejecuta el comando `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.
## Next steps

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