Delegar en cualquier LLM desde Claude Code
cc-fleet convierte cualquier modelo de lenguaje grande (DeepSeek, GLM, Qwen, Kimi, MiniMax y otros) en un verdadero compañero de equipo de Claude Code o en un subagente sin interfaz de un solo uso. Sustituye el backend LLM predeterminado por un modelo de proveedor que expone una API compatible con Anthropic, lo que permite una delegación de LLM rentable sin compartir tus credenciales principales.
Las claves API de los proveedores se almacenan de forma segura en el disco (~/.config/cc-fleet/secrets/, modo 0600) y se inyectan mediante un mecanismo apiKeyHelper.
Nunca aparecen en variables de entorno, argumentos de línea de comandos ni en el historial del shell.
La herramienta consta de una CLI en Go para la gestión de perfiles de proveedores y el envío de claves, además de una habilidad de Claude Code que decide cuándo y cómo delegar el trabajo.
Requisitos previos e instalación rápida
Requisitos
- Claude Code CLI en tu
PATH - tmux (el modo compañero se ejecuta dentro de paneles de tmux)
- macOS o Linux (amd64/arm64); Windows no ha sido probado
- Para el modo compañero, activa la bandera experimental agent‑teams: añade
{ "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" } }a~/.claude/settings.jsony reinicia Claude Code
El instalador de una línea recomendado configura el binario, un alias ccf y la habilidad de Claude Code en un solo paso.
Se pueden pasar banderas de personalización (p. ej., --skill plugin, --version vX.Y.Z) después de | sh -s --.
curl -fsSL https://raw.githubusercontent.com/ethanhq/cc-fleet/main/install.sh | sh
Añadir la habilidad después de una instalación solo del binario
Cuando instalas mediante npm (npm install -g @ethanhq/cc-fleet), go install o compilas desde el código fuente, solo se coloca el binario en tu sistema.
La habilidad de Claude Code debe instalarse por separado:
claude plugin marketplace add ethanhq/cc-fleet claude plugin install cc-fleet@ethanhq
El instalador de una línea y el tarball precompilado ya realizan este paso automáticamente. Si aún necesitas la habilidad después de una instalación solo del binario, ejecuta los dos comandos anteriores.
Registrar proveedores en la TUI
Ejecuta cc-fleet sin argumentos para abrir la TUI interactiva.
Proporcionas el nombre del proveedor, la URL base compatible con Anthropic, el endpoint de modelos, el modelo predeterminado y la clave API.
La clave se guarda inmediatamente en ~/.config/cc-fleet/secrets/ con permisos 0600; el directorio de configuración se crea en el primer guardado, sin necesidad de un paso de inicialización separado.
La TUI lista todos los proveedores registrados, permite la edición y gestiona múltiples claves por proveedor.
Cambia al panel de Estado de agentes (pulsa tab) para ver los compañeros activos agrupados por sesión y equipo, junto con su proveedor, modelo, panel de tmux, PID, estado de salud y estado oculto.
Desde este panel puedes ocultar o mostrar paneles (h/s) y refrescar la vista (r).
Modo compañero: un trabajador persistente
Los compañeros son miembros completos del equipo de agentes de Claude Code impulsados por un modelo de proveedor.
La habilidad llama al mecanismo nativo TeamCreate; cc-fleet genera un proceso claude específico del proveedor en un panel de tmux y se comunica mediante SendMessage.
El compañero permanece activo entre turnos y se pueden ejecutar varios compañeros en paralelo.
Para una visibilidad completa, inicia siempre dentro de una sesión de tmux (tmux new-session -s cc-fleet).
Si no estás dentro de tmux, el compañero se ejecuta en una sesión de servidor desconectada llamada cc-fleet-swarm-<team>.
Puedes adjuntarte con tmux -L cc-fleet-swarm-<team> attach.
Solo el panel del compañero factura la clave del proveedor; la autenticación de tu sesión principal permanece sin cambios.
Modo subagente: autónomo y de una sola ejecución
El modo subagente se ejecuta de forma sincrónica, sin interfaz gráfica, y no requiere paneles ni la función de equipos de agentes.
Es ideal para análisis puntuales y para distribuir subagentes de IA independientes en tareas paralelas.
El comando CLI subyacente es cc-fleet subagent <vendor>.
Claude lo invoca automáticamente, pero también puedes ejecutarlo directamente con cualquiera de estas opciones:
| Opción | Uso |
|---|---|
--background | Ejecutar en segundo plano; consulta el estado con cc-fleet subagent-status |
--resume <id> | Continuar un subagente previo (multiturno) |
--max-budget-usd | Limitar el coste monetario |
--max-turns | Limitar el número de turnos |
Se pueden mantener conversaciones de varios turnos con --resume, aunque no se describe la continuación automática del contexto.
La habilidad elige automáticamente entre el modo compañero y el modo subagente según la tarea.
Best Practices y limitaciones
- Siempre inicia una sesión de tmux antes de lanzar compañeros.
- Deja que la habilidad decida el modo de ejecución; elige entre modo compañero o subagente según el trabajo.
- Se recomienda el modo subagente para análisis rápidos y puntuales (revisiones de diferencias, resúmenes de registros).
- Para tareas paralelas independientes, distribuye subagentes en lugar de crear muchos compañeros.
- Fuera de tmux, los compañeros se ejecutan en sesiones separadas; conéctate con
tmux -L cc-fleet-swarm-<team> attach.
Limitaciones conocidas: probado solo en macOS y Linux; el modo compañero requiere tmux y la opción agent‑teams; las API de los proveedores deben ser compatibles con Anthropic; no hay renovación automática de claves; los subagentes de varios turnos necesitan reanudación manual; no se describen límites de escalado ni de recursos para trabajadores concurrentes.
