CLI zctl.
Gestiona tu cuenta de ZRouter.

¿Quién debería usar zctl?

zctl es para titulares de cuentas de ZRouter, desarrolladores, equipos de operaciones y responsables de CI/CD que necesitan acceso a su cuenta desde el terminal.

¿Cuándo deberías usar la CLI?

Usa zctl mientras programas, desde terminales remotos o en scripts repetibles para crear y actualizar routers virtuales, rotar claves, consultar el uso y gestionar límites. Usa el panel para gráficos y el entorno de pruebas. Los permisos de cuenta son los mismos en ambas interfaces.

Necesitas una cuenta de ZRouter y la URL de tu espacio de trabajo. Los clientes instalados necesitan acceso a la red, pero no requieren Go, Node.js ni una copia del repositorio.

Lee la guía completa de instalación y uso →

Instalar con npm

Con Node.js 20 o posterior, instala el paquete en macOS, Linux o Windows. Incluye los binarios nativos de la CLI; no requiere compilador de Go ni descarga adicional.

npm install -g zrouterctl
zctl login

O ejecuta npx --package=zrouterctl@latest zctl login. Actualiza con npm install -g zrouterctl@latest.

Instalación directa en macOS o Linux

Descarga el instalador desde este gateway y ejecútalo. Verifica la suma de comprobación del binario y lo instala en tu directorio personal ~/.local/bin .

curl -fsS 'https://zrouter.si/cli/install.sh' -o install-zctl.sh
sh install-zctl.sh --url 'https://zrouter.si'
export PATH="$HOME/.local/bin:$PATH"
zctl login

Inicia sesión con tu contraseña, Google o GitHub en el navegador, verifica el código del terminal y aprueba el acceso. Las credenciales caducan después de 30 días y pueden revocarse en Acceso CLI.

Windows y descargas directas

Descarga el ejecutable y compara su hash SHA-256 con SHA256SUMS. En Windows, renómbralo a zctl.exe, colócalo en una carpeta incluida en PATH y usa PowerShell Get-FileHash -Algorithm SHA256 para verificarlo.

• Linux: x64 · ARM64
• macOS: Apple Silicon · Intel
• Windows: x64 · ARM64

Crea y edita tus routers

zctl models list
zctl routers create my-router --target openai/gpt-4.1 --strategy round_robin
zctl routers update my-router --description "My default route"
zctl routers edit my-router
zctl routers list
zctl routers export my-router > router.json
zctl routers apply --file router.json

Sustituye el destino del ejemplo por un proveedor/modelo disponible en tu cuenta. La lista de routers incluye las estrategias de enrutamiento habilitadas en este despliegue. La edición usa tu ajuste VISUAL o EDITOR. El JSON exportado admite destinos con pesos, horarios, plugins, alternativas y afinidad de sesión. Usa el valor devuelto de source, por ejemplo accounts/ACCOUNT_ID/my-router, como modelo de tu API.

Gestiona el resto de tu cuenta

zctl account
zctl keys create --name production
zctl byok set openai
zctl credits add --amount 25 --open
zctl credits history
zctl usage summary
zctl logs requests --query 'limit=20'
zctl budgets list
zctl rate-limits list
zctl sessions list
zctl logout
zctl help

Las claves de proveedores y contraseñas se ocultan al introducirlas. Al crear una clave de API, su secreto se muestra una sola vez. Las compras de crédito abren el pago de Stripe, desde $5. Los comandos devuelven JSON para scripts. Configura ZROUTER_URL y ZROUTER_TOKEN en CI con una credencial de gestión de la CLI y mantén los secretos fuera del historial del shell.

¿Prefieres trabajar con un asistente de IA?

Usa el servidor MCP de la cuenta para preguntar a un asistente sobre el uso o gestionar routers, claves y límites habilitados. Elige zctl para comandos explícitos y scripts repetibles, MCP para tareas conversacionales de la cuenta y el panel para gráficos y pruebas.

Guía completa de la CLI y solución de problemas · Documentación de la plataforma · Gestionar terminales autorizados