void0.dev
Todas las versiones completas de los artefactos son con suscripción

Pool común de cuentas de suscripción mediante CLIProxyAPI

12 de septiembre de 2026
Estructura del material

Para qué sirve

Un servicio proxy sobre suscripciones resuelve dos problemas.

Problema 1: una cuenta para varias personas sin bloqueo. El proveedor bloquea la cuenta que funciona desde varios dispositivos e IP. A través del proxy, todas las solicitudes salen de un mismo servidor con una sola autorización: para el proveedor es un único cliente, pero detrás de él puede haber tantas personas como se quiera, cada una con su propia clave de API.

Problema 2: varias cuentas como una sola. Los límites de las suscripciones se agotan rápidamente. El pool se ofrece a los clientes como una única entrada, y el servicio redirige las solicitudes a una cuenta nueva cuando la actual se queda sin cuota.

El servicio acumula autorizaciones OAuth de suscripciones (Claude, OpenAI, Gemini, Kimi, Grok) y claves de API de proveedores como OpenRouter, acepta solicitudes mediante una API compatible con OpenAI y mediante los protocolos nativos de Anthropic y Gemini, y ofrece una lista unificada de modelos. La instalación está en el README; encontrará más detalles en help.router-for.me.

diagram…

Lo que hay que saber antes de empezar

No es posible usar modelos de Anthropic desde Codex ni modelos de OpenAI desde Claude Code, porque los protocolos de OpenAI y Anthropic son diferentes: el proxy traduce los formatos, pero el tool-calling, el thinking y el almacenamiento en caché funcionan de forma distinta, y el uso cruzado es inestable. La combinación recomendada es: Claude Code con modelos de Claude, Codex con modelos de OpenAI y el resto del pool desde arneses con selección libre de proveedor.

Hay que cambiar la configuración de los clientes. De forma predeterminada, Claude Code y Codex se conectan al proveedor con su inicio de sesión. Para que las solicitudes pasen por el pool, hay que cambiar el cliente a la dirección del proxy; encontrará las tres configuraciones más abajo.

Se pierden algunas funciones de la cuenta. Todo lo que está vinculado a la cuenta del proveedor deja de estar disponible a través del pool: compartir materiales, sesiones y tareas en la nube y sincronizar el historial entre dispositivos. La autorización vive en el servidor proxy; el cliente solo necesita la dirección y la clave.

Dónde montarlo

OpciónPara quiénQué ofrece
Localmente en el equipo de trabajouna persona, varias suscripcionesbalanceo entre sus propias cuentas, host: 127.0.0.1; nada queda expuesto al exterior
Equipo independiente con dominio públicoequipo, pool comúnuna clave para cada participante desde el panel; las cuentas se autorizan una sola vez; cuotas y registros en un mismo lugar

El panel Management Center se abre en https://<dominio>/management.html. En él encontrará:

  • Auth Files: añadir cuentas e iniciar sesión mediante OAuth directamente desde el navegador;
  • AI Providers: proveedores basados en claves de API (OpenRouter y otros);
  • Config → api-keys: claves para los participantes, una por persona o equipo, para poder revocar el acceso fácilmente.

El servicio no incluye estadísticas de uso; para ello se instala un panel independiente, por ejemplo cpa-usage-keeper.

Cambiar la configuración de los clientes

Hay tres tipos de configuración: Claude Code, Codex y todo lo que admita una API compatible con OpenAI.

Claude Code · CLI y aplicación de escritorio

Variables de entorno en ~/.claude/settings.json (archivo compartido por la CLI y la aplicación de escritorio):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<домен>",
    "ANTHROPIC_AUTH_TOKEN": "<ваш-ключ>",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "API_TIMEOUT_MS": "600000"
  }
}
  • ANTHROPIC_AUTH_TOKEN: clave del panel que sustituye el inicio de sesión en Anthropic en este equipo.
  • CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: la lista de modelos se obtiene del proxy.
  • Para una sola sesión, use las mismas variables mediante export antes de ejecutar claude.

Si ya ha iniciado sesión en Anthropic, ejecute /logout; de lo contrario, el cliente podría conectarse directamente. Elija modelos de Claude (/model).

Para revertirlo, elimine el bloque env y ejecute /login.

Codex · CLI y aplicación de escritorio

Proveedor en ~/.codex/config.toml:

model = "gpt-5.6-sol"
model_provider = "cliproxyapi"

[model_providers.cliproxyapi]
name = "OpenAI"
base_url = "https://<домен>/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "<ваш-ключ>"
  • experimental_bearer_token: clave del panel; no se necesitan el inicio de sesión en ChatGPT ni auth.json.
  • El nombre del modelo se obtiene de la lista del proxy; elija modelos de OpenAI.

Para revertirlo, elimine model_provider y ejecute codex login.

Arneses compatibles con OpenAI · OpenCode, Pi, Hermes, OpenClaw y otros

Cualquier agente con la configuración «custom OpenAI endpoint»:

AgenteQué es
OpenCodeagente de coding de terminal de código abierto; los proveedores se configuran mediante opencode.json
Piagente de coding minimalista con herramientas ampliables
Hermes Agentagente universal de Nous Research con memoria y habilidades
OpenClawasistente personal con canales (Telegram, WhatsApp, etc.)
Cline, Aider, Goose y similaresagentes para IDE y terminal con el campo «OpenAI-compatible base URL»

La conexión requiere dos parámetros:

export OPENAI_BASE_URL="https://<домен>/v1"
export OPENAI_API_KEY="<ваш-ключ>"

El arnés solicitará automáticamente la lista de modelos y mostrará todo el pool con sus alias. Aquí es donde resulta más cómodo usar un pool mixto: este tipo de arnés no está vinculado al protocolo de un solo proveedor.

Ejemplo para OpenCode: opencode.json en la raíz del proyecto o en ~/.config/opencode/:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "pool": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Team pool",
      "options": {
        "baseURL": "https://<домен>/v1",
        "apiKey": "{env:POOL_API_KEY}"
      },
      "models": {
        "claude-opus-5": { "name": "Claude Opus 5" },
        "gpt-5.6-sol": { "name": "GPT 5.6" }
      }
    }
  }
}

El modelo se selecciona como pool/<nombre> mediante /models; la clave se guarda en una variable de entorno, no en un archivo del repositorio.

Para las herramientas con un campo independiente «Anthropic endpoint», use https://<домен> y la misma clave.