# gt: General Translation CLI tool: Descargar
URL: https://generaltranslation.com/es/docs/cli/download.mdx
---
title: Descargar
description: Cómo descargar traducciones puestas previamente en cola o preparadas
---

## Uso

```bash
npx gt download
```

<Callout type="info">
  **Nota:** Este comando requiere una clave API de producción. Obtén una en la
  [plataforma](https://generaltranslation.com/dashboard).
</Callout>


## Resumen

El comando `gt download` descarga las traducciones completadas que se enviaron previamente para su traducción mediante [`gt enqueue`](/docs/cli/enqueue) o [`gt stage`](/docs/cli/stage).

El flujo de trabajo típico es:

1. [`gt upload`](/docs/cli/upload) — cargar los archivos fuente a la plataforma de General Translation
2. [`gt enqueue`](/docs/cli/enqueue) — poner en cola los archivos cargados para su traducción
3. **`gt download`** — descargar las traducciones completadas

Esta separación es útil en las canalizaciones de CI/CD donde cada paso ocurre en una etapa o trabajo diferente.

<Callout type="warn">
  **¡Solo para uso en producción!**

  Este comando está pensado para compilaciones de producción y **no debe usarse en desarrollo**.
  Recuerda especificar tu clave API de producción (`GT_API_KEY`) y el ID del proyecto (`GT_PROJECT_ID`) en tus variables de entorno.
</Callout>

## Cómo funciona

1. Lee tu `gt.config.json` para determinar la configuración de los archivos
2. Si `stageTranslations` está habilitado, lee los datos de la versión preparada; de lo contrario, recopila los archivos y calcula sus hashes para determinar qué descargar
3. Consulta la API de General Translation para obtener las traducciones completadas
4. Descarga y guarda los archivos de traducción en las rutas de salida especificadas en tu configuración

## Opciones

El comando `download` acepta las mismas opciones que [`translate`](/docs/cli/translate#flags).

| Parámetro                       | Descripción                                                                    | Tipo       | Opcional | Predeterminado     |
| ------------------------------- | ------------------------------------------------------------------------------ | ---------- | -------- | ------------------ |
| `--api-key`                     | Especifica una clave API de producción                                         | `string`   | `true`   |                    |
| `--project-id`                  | Especifica el ID del proyecto                                                  | `string`   | `true`   |                    |
| `--version-id`                  | Especifica un ID de versión (por defecto, un hash del contenido)               | `string`   | `true`   |                    |
| `--config <path>`               | Especifica la ruta del archivo de configuración de GT                          | `string`   | `true`   | `"gt.config.json"` |
| `--tsconfig, --jsconfig <path>` | Especifica la ruta del archivo de configuración de TS o JS                     | `string`   | `true`   |                    |
| `--src <paths>`                 | Lista de patrones glob, separados por espacios, para archivos fuente           | `[string]` | `true`   |                    |
| `--dictionary <path>`           | Especifica la ruta del archivo de diccionario                                  | `string`   | `true`   |                    |
| `--inline`                      | Incluye etiquetas `<T>` en línea, además del diccionario                       | `boolean`  | `true`   | `true`             |
| `--timeout`                     | El tiempo de espera de la solicitud, en segundos                               | `number`   | `true`   | `600`              |
| `--new, --locales <locales>`    | locales a los que traducir tu proyecto                                         | `[string]` | `true`   |                    |
| `--default-locale <locale>`     | La configuración regional de origen del proyecto                               | `string`   | `true`   | `en`               |
| `--ignore-errors`               | Ignora los errores y fuerza la traducción del contenido válido                 | `flag`     | `true`   | `false`            |
| `--dry-run`                     | Ejecuta el comando en modo de prueba                                           | `flag`     | `true`   | `false`            |
| `--force`                       | Fuerza la descarga de todas las traducciones y sobrescribe los cambios locales | `flag`     | `true`   | `false`            |
| `--force-download`              | Fuerza la descarga de todas las traducciones y sobrescribe los cambios locales | `flag`     | `true`   | `false`            |

## Ejemplo: pipeline de CI separado

```bash
# Etapa 1: Cargar archivos fuente
npx gt upload

# Etapa 2: Poner en cola las traducciones
npx gt enqueue

# Etapa 3: Descargar cuando esté listo
npx gt download
```