Pool común de cuentas de suscripción mediante CLIProxyAPI
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.
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ón | Para quién | Qué ofrece |
|---|---|---|
| Localmente en el equipo de trabajo | una persona, varias suscripciones | balanceo entre sus propias cuentas, host: 127.0.0.1; nada queda expuesto al exterior |
| Equipo independiente con dominio público | equipo, pool común | una 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
exportantes de ejecutarclaude.
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 niauth.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»:
| Agente | Qué es |
|---|---|
| OpenCode | agente de coding de terminal de código abierto; los proveedores se configuran mediante opencode.json |
| Pi | agente de coding minimalista con herramientas ampliables |
| Hermes Agent | agente universal de Nous Research con memoria y habilidades |
| OpenClaw | asistente personal con canales (Telegram, WhatsApp, etc.) |
| Cline, Aider, Goose y similares | agentes 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.
