TokenMix CLI

CLI oficial de TokenMix — conecta cualquier agente de IA a TokenMix en un solo comando

Descripción general

TokenMix CLI es la herramienta de línea de comandos oficial de TokenMix. Conecta Claude Code, Aider, OpenCode, Codex, Qwen Code, Goose, OpenHands y cuatro extensiones de VS Code (Kilo Code, Cline, Roo Code, Continue) a tu cuenta de TokenMix en segundos, sin configurar variables de entorno manualmente ni editar archivos de configuración. Una sola clave API cubre los tres protocolos: OpenAI Chat Completions, Anthropic Messages y Responses API.

Requisitos previos

Node.js 18 o superior. Verifica con node --version; si no lo tienes, instálalo desde nodejs.org.
Una cuenta de TokenMix. Regístrate en tokenmix.ai. Las cuentas nuevas reciben $1 de crédito gratuito (válido en la mayoría de los modelos no premium, incluido Qwen Flash).

Instalación

Opción A — instalación global (recomendada para uso diario):

npm install -g tokenmix

Opción B — ejecutar sin instalar (npx):

npx tokenmix <comando>

Inicio de sesión

tokenmix login

Esto abre tu navegador. Inicia sesión en tu cuenta de TokenMix y confirma el código corto que se muestra en el terminal. Entornos sin navegador / CI:

tokenmix login --paste          # solicitud interactiva para pegar la clave
tokenmix login --key sk-tm-...  # proporcionar la clave API directamente

Tus credenciales se almacenan localmente con permisos 0600 (solo lectura/escritura del propietario).

Lanzar un agente

Cada comando instala el agente automáticamente en la primera ejecución (cuando aplica) y lo apunta hacia TokenMix:

npx tokenmix opencode       # OpenCode — instalación automática
npx tokenmix claude         # Claude Code — instalación automática
npx tokenmix aider          # Aider — requiere pip install aider-chat
npx tokenmix codex          # Codex — instalación automática
npx tokenmix qwen           # Qwen Code — instalación automática
npx tokenmix goose          # Goose — instala Goose primero
npx tokenmix openhands      # OpenHands — Python 3.12+, uv tool install openhands

Configuración de extensiones de VS Code (imprime el fragmento para pegar en la configuración de la extensión):

npx tokenmix kilo           # Kilo Code
npx tokenmix cline          # Cline
npx tokenmix roo            # Roo Code
npx tokenmix continue       # Continue (VS Code / JetBrains)

Usar el crédito gratuito de $1

El crédito gratuito funciona con modelos no premium. Para una prueba sin costo, apunta a qwen-flash:

TOKENMIX_DEFAULT_MODEL=qwen-flash npx tokenmix opencode

Ejecuta tokenmix models para ver todos los modelos disponibles y sus precios.

Verificación

tokenmix balance   # muestra el saldo en tiempo real, crédito de regalo y gasto total
tokenmix doctor    # verifica la validez de la clave y el estado de instalación/configuración de cada agente

Si balance muestra tu crédito y doctor no reporta errores, estás listo para programar.

Preguntas frecuentes

El navegador no se abrió al ejecutar tokenmix login. Es lo esperado en servidores, contenedores o sesiones SSH. El terminal muestra una URL y un código corto; abre la URL en cualquier dispositivo e ingresa el código. También puedes usar tokenmix login --paste para pegar una clave, o tokenmix login --key sk-tm-... en CI.

¿Cómo cambio el modelo predeterminado? Los agentes usan claude-sonnet-4.6 por defecto. Establece TOKENMIX_DEFAULT_MODEL para cambiarlo. Ejecuta tokenmix models para listar todos los modelos disponibles. tokenmix claude y tokenmix codex requieren un modelo de la familia Claude; los otros agentes aceptan cualquier modelo de chat.

¿Cómo cierro sesión o desinstalo? tokenmix logout elimina tu clave almacenada y revierte cualquier configuración de agente que el CLI haya modificado. Si está instalado globalmente, npm uninstall -g tokenmix lo elimina por completo.