--- title: "Preguntas frecuentes" description: "Respuestas cortas a las preguntas que más surgen al usar verbatra, desde lo que cuesta una ejecución hasta lo que deberías confirmar en el repositorio." type: "reference" --- # Preguntas frecuentes Respuestas cortas a las preguntas que más surgen al usar verbatra, desde lo que cuesta una ejecución hasta lo que deberías confirmar en el repositorio. Respuestas cortas con un enlace a la página que tiene los detalles. Para los mensajes de error, consulta [Solución de problemas](https://verbatra.kreitz-webdev.de/es/docs/troubleshooting.md) y [Códigos de error](https://verbatra.kreitz-webdev.de/es/docs/error-codes.md). ## ¿Cómo controlo el coste? [#cómo-controlo-el-coste] Las ejecuciones son incrementales, así que solo las claves que faltan o que cambiaron llegan al proveedor, y volver a ejecutar un proyecto sin cambios no cuesta nada. `verbatra translate --estimate` dimensiona una ejecución sin llamar a un proveedor, y `--max-tokens` o `maxTokens` en la config la limitan. Consulta [Estimar el coste](https://verbatra.kreitz-webdev.de/es/docs/estimating-cost.md). ## ¿Cuánto cuesta realmente una ejecución? [#cuánto-cuesta-realmente-una-ejecución] Poco: 400 claves a 3 locales con `gemini-2.5-flash` suman unos 72.000 tokens, que valoras con la tarifa actual de tu proveedor, y las ejecuciones siguientes solo pagan por los textos que cambiaste. Cómo estimar una ejecución, dónde publica cada proveedor sus tarifas y cómo calibrar con tu propio proyecto están en [Estimar el coste](https://verbatra.kreitz-webdev.de/es/docs/estimating-cost.md). ## ¿Con qué proveedor empiezo? [#con-qué-proveedor-empiezo] Con Gemini, porque su nivel gratuito de API te deja traducir un proyecto entero sin coste, y cambiar después es editar un `id`. Mantén los textos confidenciales fuera del nivel gratuito: consulta [Tratamiento de datos y privacidad](https://verbatra.kreitz-webdev.de/es/docs/data-handling.md#retención-y-tratamiento-de-datos-del-proveedor). Todos los proveedores se comparan en [Proveedores](https://verbatra.kreitz-webdev.de/es/docs/providers.md). ## ¿Puedo usar un modelo local? [#puedo-usar-un-modelo-local] Sí: el proveedor `openai-compatible` apunta verbatra a cualquier servidor que hable la API de chat de OpenAI, como LM Studio, Ollama o vLLM, normalmente sin clave. Sin ningún modelo de lenguaje, `libretranslate` usa un servidor LibreTranslate propio. Consulta [Proveedores](https://verbatra.kreitz-webdev.de/es/docs/providers.md#libretranslate). ## ¿Qué idiomas admite verbatra? [#qué-idiomas-admite-verbatra] Cualquier idioma que admita tu proveedor, escrito como un código BCP 47 válido como `pt-BR` o `zh-Hant`. DeepL y Google Cloud Translation tienen listas fijas; los proveedores LLM no tienen ninguna. Consulta [Soporte de idiomas](https://verbatra.kreitz-webdev.de/es/docs/language-support.md). ## ¿Cómo conservan las claves su orden? [#cómo-conservan-las-claves-su-orden] Las claves existentes conservan su posición y las nuevas se añaden en el orden de la fuente, así que un archivo traducido da un diff limpio. Consulta [Formatos](https://verbatra.kreitz-webdev.de/es/docs/formats.md). ## ¿Por qué una traducción quedó marcada para revisión? [#por-qué-una-traducción-quedó-marcada-para-revisión] Una heurística de revisión encontró algo que merece una segunda mirada, como una traducción igual a su fuente, y la marcó sin retenerla. Cada código de motivo aparece en [Motivos de revisión](https://verbatra.kreitz-webdev.de/es/docs/error-codes.md#review-reason-codes). ## ¿Funciona verbatra en un monorepo? [#funciona-verbatra-en-un-monorepo] Sí. La búsqueda de la config sube desde el directorio de trabajo y se detiene en el `.git` más cercano, así que un paquete encuentra su propia config y la raíz la de la raíz; `--cwd` y `--config` apuntan a cualquier otro sitio. Consulta [Archivo de configuración](https://verbatra.kreitz-webdev.de/es/docs/config-file.md). ## ¿Qué debo confirmar? [#qué-debo-confirmar] Confirma tus archivos de locale, `verbatra.lock.json` y `verbatra.provenance.json`; nunca `.env`, `.env.local`, `.verbatra-local/` ni `verbatra.cache.json`, que `verbatra init` añade a `.gitignore`. Consulta [El archivo de bloqueo](https://verbatra.kreitz-webdev.de/es/docs/the-lock-file.md). ## ¿Cómo lo retraduzco todo? [#cómo-lo-retraduzco-todo] Borra el archivo de locale y ejecuta `verbatra translate`: entonces falta cada clave y se traduce de nuevo. Borrar el archivo de bloqueo no sirve, porque sin línea base las traducciones existentes cuentan como actuales. Para una sola clave, usa la acción de retraducir de Studio o `retranslateEntry`. ## ¿Usar la CLI implica instalar el SDK? [#usar-la-cli-implica-instalar-el-sdk] Sin paso extra: `@verbatra/cli` depende de `@verbatra/sdk`, así que viene con ella. Solo `@verbatra/studio` y `@verbatra/mcp` son instalaciones aparte y opcionales. ## ¿Dónde viven las claves de API? [#dónde-viven-las-claves-de-api] Solo en variables de entorno, que la CLI también lee de [`.env.local` y `.env`](https://verbatra.kreitz-webdev.de/es/docs/cli.md#archivos-de-entorno). La config rechaza claves desconocidas para que ningún secreto acabe en un archivo confirmado. Consulta [Proveedores](https://verbatra.kreitz-webdev.de/es/docs/providers.md). ## ¿verbatra envía mis textos a algún sitio? [#verbatra-envía-mis-textos-a-algún-sitio] Solo al proveedor que configuras, y solo cuando un comando traduce; no hay telemetría. Con `provider: { id: "none" }` nada sale de la máquina. Consulta [Tratamiento de datos y privacidad](https://verbatra.kreitz-webdev.de/es/docs/data-handling.md). ## ¿Qué comprueba realmente verbatra doctor? [#qué-comprueba-realmente-verbatra-doctor] La configuración de una sola pasada, sin una llamada de traducción y sin leer el valor de una clave salvo que pases `--live`, que la envía para obtener la lista de idiomas del proveedor: la config, el formato, el proveedor, la variable de la clave de API, la política de red, el archivo fuente y el soporte de locales, más informes informativos sobre plurales, códigos de locale y estado de locale sobrante. [`verbatra doctor`](https://verbatra.kreitz-webdev.de/es/docs/cli/doctor.md) tiene la tabla completa de comprobaciones. ## ¿Puede un agente de IA configurar o manejar verbatra por mí? [#puede-un-agente-de-ia-configurar-o-manejar-verbatra-por-mí] Sí, a través de cuatro superficies: un prompt de configuración para agentes de código ([Configurar con un agente de IA](https://verbatra.kreitz-webdev.de/es/docs/start-with-ai.md)), la salida `--json` para tus propios bucles ([Recetas para agentes y scripts](https://verbatra.kreitz-webdev.de/es/docs/agent-recipes.md)), herramientas WebMCP en una pestaña abierta de Studio ([Maneja Studio con un agente del navegador](https://verbatra.kreitz-webdev.de/es/docs/agent-tools-in-studio.md)) y un servidor MCP por stdio ([`verbatra mcp`](https://verbatra.kreitz-webdev.de/es/docs/cli/mcp.md)). Studio y el servidor MCP solo gastan en un proveedor tras un flag `--allow-spend`; en el bucle `--json`, un `translate` real gasta al instante, así que tu script o agente debe pedir antes el visto bueno de una persona. ## ¿Este sitio publica algo para agentes de IA y rastreadores? [#este-sitio-publica-algo-para-agentes-de-ia-y-rastreadores] Sí, tres archivos estáticos, generados en tiempo de build y siempre en inglés, sin importar qué locale estés viendo: - [`/llms.txt`](https://verbatra.kreitz-webdev.de/llms.txt): un índice curado con el título y la descripción de cada página de la documentación, agrupado igual que la barra lateral, como enlaces en Markdown. - [`/llms-full.txt`](https://verbatra.kreitz-webdev.de/llms-full.txt): toda la documentación en un solo archivo, el contenido renderizado de cada página concatenado en orden, para un agente que ingiere el contenido directamente en lugar de seguir enlaces. - [`/.well-known/ai.txt`](https://verbatra.kreitz-webdev.de/.well-known/ai.txt): una política de uso que les dice a los rastreadores de IA que este proyecto tiene licencia MIT y que rastrear, indexar y citar este contenido es bienvenido. Los tres están enlazados desde la columna "Para agentes de IA" del pie de página. ## ¿El contenido de este sitio está traducido por IA? [#el-contenido-de-este-sitio-está-traducido-por-ia] En su mayor parte, por dos mecanismos distintos. El texto de la interfaz (etiquetas de navegación, botones, el pie de página, el texto de la página de inicio, sus preguntas frecuentes) vive en `messages/en.json` y sus hermanos `de`, `es` y `fr`; esos se traducen automáticamente con verbatra mismo, contra el formato `next-intl-json`, a través del proveedor Gemini, ejecutando `pnpm i18n` después de que cambie la fuente en inglés. Es el propio proyecto usando su propia herramienta (dogfooding), y el workflow `docs-i18n-check` hace fallar un pull request cuyos archivos de locale se han desviado de la fuente en inglés. La prosa de la documentación que estás leyendo ahora mismo, cada guía y cada página de referencia incluida esta, es MDX con sufijo de locale (`page.mdx`, `page.de.mdx`, `page.es.mdx`, `page.fr.mdx`) y también está traducida con IA, solo que fuera de esa canalización automatizada: `pnpm i18n` solo traduce los [formatos de archivo de locale](https://verbatra.kreitz-webdev.de/es/docs/formats.md) estructurados, nunca Markdown, así que nunca toca estas páginas. En su lugar, un agente de IA traduce cada página de documentación en el mismo cambio que edita su fuente en inglés, así que los cuatro idiomas llegan juntos; por eso cada página que no está en inglés muestra el aviso de traducción automática. No todo sale tal cual de esos dos pasos: algunos textos, entre ellos partes de las páginas legales, se redactaron o corrigieron directamente en los archivos de locale. Las traducciones se revisan en la medida de lo posible, y no todos los textos traducidos los revisa una persona antes de publicarse, por lo que una traducción puede contener errores. La [política de privacidad](https://verbatra.kreitz-webdev.de/privacy) describe el mismo proceso. Si algo en alemán, español o francés suena raro, abre un issue en cualquiera de los dos casos: en el texto de la interfaz, la corrección va a la fuente en inglés y se vuelve a traducir, o directamente al archivo de locale afectado; para la prosa de la documentación, edita el archivo MDX directamente y envía un pull request.