Primeros pasos

Lo que necesitas

• Node 24 o posterior para el terminal.
• npm viene incluido con Node.

Nada local queda nunca detrás de un pago. La aplicación de escritorio y el terminal muestran barras sin cuenta. Una cuenta solo añade sincronización.

Terminal

Ejecuta la herramienta sin argumentos y seguirá los mismos tres pasos en todas partes: iniciar sesión, conectar y elegir dónde mostrar las barras.

npx openlimiter

Al iniciar sesión aparecen un código corto y un enlace a openlimiter.com/app/cli, así que el terminal nunca ve una contraseña. Pulsa Intro para omitirlo y dejar el dispositivo sin sesión. Conectar comprueba cada CLI de agente instalada e indica use current login, sign in o install en cada fila. También ofrece iniciar la sesión propia de Codex al momento. Después enumera los terminales compatibles y configura los que elijas.

Ejecuta openlimiter terminal para volver al último paso. Usa openlimiter terminal show y openlimiter terminal hide para elegir qué proveedores conectados muestran barras, y openlimiter terminal status para ver la configuración. Consulta contexto del agente para conocer los terminales, el formato y las marcas de actualidad.

La instalación permanente funciona igual: npm install -g openlimiter y después openlimiter.

Aplicación de escritorio

El primer inicio de la aplicación de escritorio muestra los mismos tres pasos en su ventana: crear una cuenta u omitirla, conectar los proveedores accesibles directamente y mostrar barras en la bandeja. La bandeja y sus barras nunca requieren una cuenta.

Centro web

openlimiter.com/app empieza por la cuenta: inicia sesión con GitHub, Google, Microsoft o un enlace por correo, conecta y consulta las barras. Ábrelo tras iniciar sesión en un terminal o en la aplicación de escritorio y mostrará las mismas barras sincronizadas desde allí.

Gratis y Pro

Las barras son gratuitas para siempre y no necesitan ninguna cuenta.

• Una cuenta añade sincronización: el porcentaje actual de cada ventana se mantiene actualizado entre todos los dispositivos donde inicias sesión.
• Pro añade historial, alertas, el teléfono, varias cuentas por proveedor y medición en la nube para claves de gasto de API.
• Cada función Pro ofrece una prueba gratuita de 30 días, sin tarjeta.

Phone

Abre el centro, elige tu teléfono y escanea el código QR que aparece. No hay que escribir nada para vincularlo. Añádelo a la pantalla de inicio: Android ofrece instalarlo; en iOS, usa Compartir y después Añadir a pantalla de inicio.

Conecta Claude Code manualmente

openlimiter terminal lo hace por ti. Para ver exactamente qué escribe, o para conectar un equipo sin ejecutarlo de forma interactiva, añade esto a settings.json de Claude Code.

{
  "statusLine": {
    "type": "command",
    "command": "openlimiter statusline --host claude"
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "openlimiter hook"
          }
        ]
      }
    ]
  }
}

Contribuye desde el código fuente

Usa las herramientas del repositorio cuando quieras contribuir.

git clone https://github.com/lucaswebsystems/openlimiter
cd openlimiter
pnpm install
pnpm build
pnpm typecheck
pnpm test
node packages/cli/dist/bin.js demo

La compilación debe ejecutarse antes de la comprobación de tipos, porque cada paquete resuelve sus dependencias mediante las declaraciones que produce la compilación.

Qué sigue

Un orden de lectura razonable

1. 1Por qué OpenLimiter para conocer el problema que resuelve.
2. 2Proveedores compatibles para saber cómo se conecta cada uno y qué nunca hace OpenLimiter.
3. 3Contexto del agente para los terminales, el formato de las barras y lo que llega a tu agente de programación.
4. 4Referencia de la CLI para cada comando y código de salida.