# gt: General Translation CLI tool: CLI de traducción
URL: https://generaltranslation.com/es/docs/cli.mdx
---
title: CLI de traducción
description: Configura y traduce tu proyecto con la herramienta de línea de comandos de General Translation
---

## Resumen

La herramienta CLI de General Translation (`gt`) te permite configurar la internacionalización y traducir automáticamente tu proyecto a cualquiera de los [idiomas compatibles](/docs/platform/supported-locales).

Funciona con [`gt-next`](/docs/next), [`gt-react`](/docs/react), [`gt-react-native`](/docs/react-native) y bibliotecas de i18n de terceros, como `next-intl` e `i18next`. También puedes usarla para traducir archivos autónomos (JSON, MDX, HTML y más).

## Quickstart

### 1. Configura tu proyecto

```bash
npx gt@latest
```

Esto ejecuta el asistente de configuración, que:

* Instalará las dependencias necesarias (p. ej., `gt-next` o `gt-react`)
* Configurará tu framework (plugin de Next.js, provider de React, etc.)
* Creará un `gt.config.json` con tus locales y la configuración de archivos
* Generará credenciales de API


### 2. Traducir

```bash
npx gt translate
```

Este comando traduce tu proyecto mediante la API de General Translation. Ejecútalo en tu flujo de CI/CD **antes** de generar la construcción de producción.

<Callout type="info">
  **Nota:** Se requiere una clave de API de producción para el comando `translate`. El asistente de configuración puede generar una para ti, o puedes obtener una en [generaltranslation.com](https://generaltranslation.com).
</Callout>

Eso es todo: dos comandos para pasar de un proyecto en un solo idioma a uno completamente traducido.


## Comandos

| Comando                                     | Descripción                                                                                               |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| [`npx gt@latest`](/docs/cli/init)           | Ejecuta el asistente de configuración. Instala dependencias, configura tu proyecto y genera credenciales. |
| [`npx gt translate`](/docs/cli/translate)   | Traduce tu proyecto mediante la API de GT.                                                                |
| [`npx gt configure`](/docs/cli/configure)   | Actualiza la configuración de GT de tu proyecto (`gt.config.json`).                                       |
| [`npx gt auth`](/docs/cli/auth)             | Genera o renueva credenciales de la API.                                                                  |
| [`npx gt generate`](/docs/cli/generate)     | Genera un archivo JSON con datos de traducción para uso autónomo.                                         |
| [`npx gt upload`](/docs/cli/upload)         | Carga archivos de origen y traducciones en la plataforma de GT.                                           |
| [`npx gt enqueue`](/docs/cli/enqueue)       | Encola archivos para traducir sin descargar los resultados.                                               |
| [`npx gt download`](/docs/cli/download)     | Descarga traducciones encoladas o preparadas previamente.                                                 |
| [`npx gt stage`](/docs/cli/stage)           | Prepara las traducciones para su revisión humana antes de publicarlas.                                    |
| [`npx gt save-local`](/docs/cli/save-local) | Guarda las ediciones locales de traducción en la plataforma de GT.                                        |

## Guías

| Guía                                | Descripción                                                                       |
| ----------------------------------- | --------------------------------------------------------------------------------- |
| [Ramificación](/docs/cli/branching) | Haz un seguimiento independiente de las traducciones para distintas ramas de Git. |
| [FAQ](/docs/cli/faqs)               | Preguntas frecuentes sobre la herramienta CLI.                                    |

## Formatos compatibles

La CLI puede traducir archivos en varios formatos:

[GT](/docs/cli/formats/gt) · [JSON](/docs/cli/formats/json) · [MDX](/docs/cli/formats/mdx) · [TypeScript/JavaScript](/docs/cli/formats/ts) · [YAML](/docs/cli/formats/yaml) · [PO/POT](/docs/cli/formats/po) · [HTML](/docs/cli/formats/html) · [Texto sin formato](/docs/cli/formats/txt)