CBTeams
Uso interno ClickBalance. Consola para operar equipos de Claude Code (agent teams) sin salir de VS Code, con soporte transparente para Remote-SSH.
CBTeams es la herramienta interna de ClickBalance para lanzar, observar y conversar con equipos de agentes de Claude Code. Se instala como extensión de VS Code y vive en la barra de actividad. Cuando abres un workspace remoto vía Remote-SSH, la extensión corre en el host remoto: claude se spawnea allá, la base de datos vive allá, y tu máquina local solo renderiza la UI.
Qué hace
Equipos multi-agente
- Launcher con templates (frontend / backend / pruebas / seguridad / arquitecto / leader-solo / scout-auto) o configuración manual.
- Modo
agent_teams (experimental nativo de Claude Code) con TeamCreate + teammates peer-to-peer, o modo subagents clásico (Task-tool, leader-as-hub).
- Buzón estilo WhatsApp para chatear con el líder y observar conversaciones entre teammates.
- Agentes en vivo con cards Kanban (Trabajando · En espera · Apagado) + status dots de colores.
- Tareas en columna lateral, sincronizadas con el
TodoWrite del líder.
Hilos laterales (consultas independientes)
- Drawer dedicado a la derecha del buzón.
- Multi-turno, conserva el contexto del team principal SIN ensuciar su historia.
- Cierra con ESC o el botón ×.
Control fino del líder
- Stop button en el composer — interrumpe el turno actual sin matar el team.
- Soft-correct firewall para
agent_teams: el primer tool fuera de protocolo recibe un recordatorio inyectado; la segunda violación aborta.
- Aviso de worktrees cuando hay teams en paralelo (sugiere
git worktree add para evitar choques).
- Auto-resume al compactar — la extensión re-envía el mensaje al líder después de
/compact.
Administración (Configuración → Permisos)
- Gestión de usuarios + roles.
- Presets de permisos.
- Bitácora de auditoría.
- Defaults por módulo para usuarios nuevos.
Integraciones ClickBalance
- CBTasks — fetch del inbox de la plataforma interna, claim/complete por team, link de teams a issues, marcado automático al cerrar.
- Playwright Runner — corre suites unit + e2e + visual regression dentro de la extensión, con baselines aprobables desde la UI.
- Asistente de contexto —
CLAUDE.md, reglas, system-extra, configurables por workspace y persistidos.
Instalación
Desde el Marketplace (preferido para producción)
- Abre VS Code.
- Extensions → busca "CBTeams" (publisher
clickbalance).
- Install. La extensión registra el panel
CBTeams en la barra de actividad.
Desde un .vsix (preview / staging)
code --install-extension cbteams-<version>.vsix
O en la UI de VS Code: Extensions → menú ⋯ → Install from VSIX…
Setup inicial
- La extensión te pide login con tu cuenta de Google de ClickBalance la primera vez.
- Si vas a usar
agent_teams mode, asegúrate de tener CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 exportado en tu shell o ~/.claude/settings.json.
- Para Remote-SSH: instala la extensión también en el host remoto (VS Code lo hace automáticamente la primera vez que abres ese host).
Requisitos
- VS Code 1.85+
- Claude Code CLI instalado y autenticado (
claude --version debe funcionar).
- node 18+ (para los hooks y el spawner interno).
- Para
agent_teams: Claude Code 2.1.32+.
- Para Remote-SSH: extensión
ms-vscode-remote.remote-ssh.
Slugs de teammates (war-room ClickBalance)
Los nombres canónicos que la app reconoce y rutea automáticamente:
| Slug ES |
Rol |
Alias EN |
arquitecto |
Diseño de servicios + DB + tipos |
architect |
frontend |
React / Tailwind / stores |
frontend-engineer |
pruebas |
Playwright + visual diffs |
tests-engineer |
seguridad |
IPC validation + hooks + paths |
security-engineer |
Cuando el líder hace Task, los aliases en inglés resuelven al slug en español automáticamente. Nunca uses general-purpose como slug — es el subagent_type del tool de Claude Code, no un rol; la app lo intenta resolver pero si no encuentra match el card del buzón queda confuso.
Soporte
- Bugs / requests: abre un ticket en CBTasks (proyecto CBTEAMS).
- Slack:
#cbteams-internal.
- Logs: Output panel → "CBTeams" channel. Los logs vienen estructurados (pino) — copia y pega completo cuando reportes.
Privacidad
Las conversaciones de los teams se persisten localmente en SQLite dentro de globalStorage de la extensión (o en el host remoto cuando trabajas vía SSH). La extensión NO sube transcripciones a ningún servidor externo de ClickBalance — la única red saliente es la API de Anthropic (vía la CLI claude) y, opcionalmente, CBTasks cuando enlazas un team a un issue.
ClickBalance · uso interno · no distribuir fuera de la organización.
