---
title: Crear un equipo – Documentación de Agent Teams
description: Define roles, asigna proveedores y modelos, redacta un briefing de equipo y configura el aislamiento por worktree y los niveles de autonomía.
lang: es-ES
---

# Crear un equipo

Un equipo es un grupo con nombre de agentes con roles, un lead, un proyecto objetivo y un prompt de coordinación.

## Primer equipo recomendado

Empieza con un equipo pequeño:

| Rol      | Propósito                                                  |
| -------- | --------------------------------------------------------- |
| Lead     | Divide el trabajo, crea tareas, coordina a los compañeros |
| Builder  | Implementa tareas acotadas                                |
| Reviewer | Revisa el resultado, detecta regresiones, pide correcciones |

Esta estructura te da suficiente coordinación para ver el valor del producto sin hacer ruidoso el primer lanzamiento.

::: tip
Puedes añadir más miembros más adelante. Empieza con poco, valida el flujo de trabajo y luego escala.
:::

## Asignar proveedores y modelos

Cada miembro del equipo se ejecuta sobre un backend de proveedor. En el editor de equipos, elige un proveedor (Claude, Codex u OpenCode) y un modelo para cada miembro. La aplicación solo muestra los proveedores con los que ya te has autenticado.

Se admite mezclar proveedores en un mismo equipo — por ejemplo, un lead de Claude con builders de OpenCode.

::: info
Gemini está disponible como ruta de proveedor compatible. Consulta [Proveedores y runtimes](/es/reference/providers-runtimes) para conocer las opciones de autenticación y el estado actual de los proveedores.
:::

## Redactar un buen briefing de equipo

El briefing de equipo debería incluir:

- el resultado que quieres
- los archivos o áreas de funcionalidad que importan
- los límites de riesgo, como "no refactorizar módulos no relacionados"
- las expectativas de revisión
- los comandos de verificación cuando los conozcas

Ejemplo:

```text
Build a focused improvement to the download flow. Keep changes inside the landing app unless a shared helper is clearly needed. Create tasks before implementation, review each task diff, and run landing lint/build checks.
```

## Aislamiento por worktree

Los miembros de OpenCode pueden usar el **aislamiento por worktree** para trabajar en un worktree de Git independiente en lugar del directorio de trabajo principal. Esto evita conflictos de archivos cuando varios agentes editan el mismo proyecto.

::: warning
El aislamiento por worktree requiere un proyecto rastreado por Git y, actualmente, está limitado a los miembros de OpenCode.
:::

Para activarlo, activa la opción **Worktree isolation** al añadir o editar un miembro de equipo de OpenCode.

## Elegir la autonomía

Agent Teams admite distintos niveles de control. Usa más autonomía para cambios rutinarios y una revisión más estricta para áreas de riesgo como la autenticación de proveedores, el IPC, la persistencia, los flujos de trabajo de Git y las herramientas de publicación.

### Nivel de esfuerzo

Cada miembro del equipo tiene un ajuste de **esfuerzo** que controla cuánto razonamiento invierte el proveedor antes de responder. Un esfuerzo mayor produce un resultado más exhaustivo a costa de tiempo y tokens.

| Nivel  | Cuándo usarlo                                                  |
| ------ | ------------------------------------------------------------- |
| Low    | Consultas rápidas, pequeños cambios de formato, ediciones rutinarias |
| Medium | Predeterminado para la mayoría de tareas de implementación    |
| High   | Refactorizaciones complejas, cambios transversales, rutas de código de riesgo |

La aplicación ofrece niveles adicionales (minimal, xhigh, max) para los proveedores que los admiten. Si un modelo no admite un esfuerzo configurable, el selector se desactiva y se usa el valor predeterminado del proveedor.

### Modo rápido

Activa el **Modo rápido** por miembro para priorizar la velocidad sobre la profundidad. Esto se corresponde con el modo rápido/de velocidad nativo del proveedor cuando está disponible. Ponlo en **On** para tareas rutinarias, en **Off** para trabajo cuidadoso, o en **Inherit** para seguir el valor predeterminado a nivel de equipo.

### Limitar el contexto

Activa **Limit context** para reducir la ventana de contexto de un miembro. Esto es útil para los modelos de Claude que admiten contexto extendido (p. ej. 1M de tokens) — limitar el contexto evita un uso innecesario de tokens y puede mejorar la latencia en tareas que no necesitan un contexto amplio.

## Añadir contexto

Adjunta archivos, capturas de pantalla o notas concretas cuando cambien la tarea de forma sustancial. Los agentes pueden usar las descripciones de las tareas, los comentarios y los archivos adjuntos como contexto duradero.

## Vigilar la calidad de las tareas

Los buenos equipos crean tareas que son:

- lo bastante específicas para revisar
- lo bastante pequeñas para terminar
- vinculadas a un resultado visible
- respaldadas por una ruta de verificación

Si el lead crea tareas imprecisas, envía un mensaje directo pidiendo tareas más pequeñas y comprobables.

## Próximos pasos

- [Configuración del runtime](/es/guide/runtime-setup) — configura la autenticación de proveedores y los modelos
- [Revisión de código](/es/guide/code-review) — acepta, rechaza o comenta los cambios de los agentes
- [Solución de problemas](/es/guide/troubleshooting) — problemas habituales y soluciones
