Instalación

Requisitos

• Node.js 20.11+ (ESM nativo)
• Una clave de API de traducción (véase a continuación)

Instalar

npm

npm install --save-dev champollion

npx (no install)

npx champollion sync

pnpm

pnpm add -D champollion

yarn

yarn add --dev champollion

Obtener una clave de API

Champollion necesita un backend de traducción. Elija uno:

Proveedor	Variable de Entorno	Mejor para
OpenRouter (recomendado)	OPENROUTER_API_KEY	Proyectos con mucho contenido, Markdown, 200+ modelos
Gemini (nivel gratuito)	GEMINI_API_KEY	Inicio sin costo, buena calidad
OpenAI	OPENAI_API_KEY	Acceso directo a GPT-4o
Anthropic	ANTHROPIC_API_KEY	Acceso directo a Claude, texto matizado
DeepL	DEEPL_API_KEY	Idiomas europeos, formalidad integrada
Google Translate	GOOGLE_TRANSLATE_API_KEY	Pares clave-valor de alto volumen, 130+ idiomas
Microsoft Translator	MICROSOFT_TRANSLATOR_API_KEY	Azure, 100+ idiomas
LibreTranslate	LIBRETRANSLATE_API_URL	Auto-hospedado, privacidad primero

OpenRouter (recommended)

OpenRouter proporciona una API unificada para 200+ modelos LLM. Nivel gratuito disponible.

# Sign up at https://openrouter.ai, then:
export OPENROUTER_API_KEY=sk-or-v1-...

O agregue a .env.local:

OPENROUTER_API_KEY=sk-or-v1-your-key-here

Mejor para: proyectos con mucho contenido, traducción de Markdown, y proyectos que necesitan protección consciente del contenido (bloques de código, shortcodes, variables de interpolación).

Google Translate

export GOOGLE_TRANSLATE_API_KEY=...

Mejor para: pares de cadenas clave-valor de alto volumen (130+ idiomas). No recomendado para contenido Markdown — Google Translate no tiene conciencia de bloques de código, shortcodes, o variables de interpolación.

:::tip Detección inteligente Si solo GOOGLE_TRANSLATE_API_KEY está configurado (sin clave de OpenRouter), champollion cambia automáticamente a Google Translate. No se necesita cambio de configuración. :::

Verificar la instalación

npx champollion --help

Debería ver la lista de comandos disponibles. Está listo para el Inicio Rápido.