Saltearse al contenido

Claude Agent

Claude Agent pone en tu flujo a el agente de programación de Anthropic (el motor de Claude Code). Trabaja sobre un repositorio de Git o una carpeta vacía, en un espacio aislado solo para tu conversación: lee el código, lo cambia, ejecuta comandos y pruebas, y te devuelve su respuesta y la lista de ficheros que ha cambiado.

Funciona como un nodo normal (entra una instrucción, sale la respuesta) y como herramienta de un Agent o de un Voice Agent: así puedes pedir cambios en tu código hablando o por chat.

Cuándo usarlo

  • Quieres que un agente arregle un error, añada una función pequeña, escriba pruebas o revise un cambio en un repositorio.
  • Quieres programar por voz: el agente de voz le pasa lo que dices y te cuenta lo que ha hecho.
  • Quieres automatizar tareas de código desde un flujo: por ejemplo, que cada incidencia nueva genere una rama con una propuesta de arreglo.

Cómo funciona

  • Cada conversación (un chat del playground, una llamada, una sesión de la API) tiene su propio contenedor aislado con sus ficheros. Nadie más lo ve.
  • Los mensajes siguientes de la misma conversación continúan el trabajo: el agente recuerda lo que hizo y los ficheros siguen ahí.
  • El espacio de Run Instruction se apaga solo tras 15 minutos sin uso y se conserva 7 días; el siguiente mensaje lo vuelve a arrancar tal como estaba. Las operaciones List Sessions, Delete Session y Get Changes se ejecutan al vuelo (contenedor efímero destruido al instante, sin consumir límite de contenedores simultáneos).
  • En el nodo colapsado solo aparece visible Instruction (a la izquierda) y Tools (abajo); el resto de campos se configuran desde el panel lateral o activando su visibilidad si necesitas cablearlos.
  • La API key llega solo al proceso del agente y el token de Git solo a los comandos de Git que ejecuta la plataforma: el agente nunca ve el token.

Suscripción de Claude (solo cuentas internas y de prueba)

En las cuentas internas (las de nuestros dominios) y en las cuentas de prueba que se habiliten una a una, el nodo muestra el bloque Suscripción de Claude con el botón Iniciar sesión en Claude: abre la página de Anthropic, pegas el código que te muestra y el nodo, sin API key, usa esa suscripción. Es para pruebas internas, no una función comercial; para el resto de cuentas el bloque no aparece.

Configuración

CampoQué hace
Credencial «Claude»Tu API key de Anthropic; el trabajo se factura a esa cuenta.
Operation (tool)Qué hacer en el espacio de trabajo: Run Instruction (por defecto), List Sessions (devuelve las sesiones guardadas con su session_name, conversation_id, fecha y resumen), Delete Session (borra una sesión guardada sin tocar los archivos) o Get Changes (muestra los cambios pendientes sin consumir tokens).
Sign-in CodeCon Claude subscription: el código que te da Anthropic al iniciar sesión. Sirve una vez y caduca en minutos.
InstructionLo que tiene que hacer, en palabras normales. Como herramienta, lo escribe el agente que la llama.
Agent InstructionsReglas fijas para todas las instrucciones: convenciones del proyecto, qué evitar, cómo contestar.
Modelclaude-sonnet-5-5 (por defecto), claude-opus-5-5 para el trabajo más difícil, claude-haiku-5-5 para tareas rápidas.
PermissionsQué puede hacer dentro de su espacio: Read only (leer y explicar), Edit files (cambiar ficheros) o Edit files and run commands (por defecto; necesario para lanzar pruebas). Lo que pase de ese nivel se rechaza y aparece en el resultado.
Repository URLEl repositorio que se clona la primera vez. Vacío, empieza en una carpeta vacía.
Workspace NameNombre único para persistir la carpeta de trabajo en tu Storage (claude_data/<nombre>). Vacío, no persiste (cada conversación empieza de cero). Con el mismo nombre en varios nodos o flujos de Claude Agent comparten archivos y sesiones.
SkillsSkills de tu cuenta de la plataforma (las tuyas y las instaladas del marketplace) que el agente puede usar. Pulsa refrescar para cargar la lista; se copian al agente antes de cada instrucción.
When DoneCommit and push a new branch sube los cambios de cada instrucción a una rama nueva nappai/claude-<fecha>.
ToolsHerramientas del flujo que el agente puede usar mientras trabaja, por ejemplo para leer un ticket o un documento antes de cambiar el código.

Opciones avanzadas

CampoQué hace
BranchLa rama que se clona. Vacío, la rama principal del repositorio.
Git Access TokenToken para un repositorio privado y para subir la rama. Solo lo usan los comandos de Git de la plataforma.
Keep WorkspaceDuring the conversation (por defecto) conserva ficheros y memoria entre mensajes; Only for this run lo borra todo al acabar.
Session Name (tool)Nombre lógico o conversation_id de la sesión a continuar o retomar. Vacío usa la sesión por defecto; pon nombres distintos por tarea para no mezclar contextos en un mismo espacio persistente.
New Session (tool)Activado (true), arranca una conversación limpia desde cero en vez de reanudar la sesión actual.
Reasoning EffortCuánto piensa el modelo antes de actuar. Más es más lento y más caro.
Output SchemaUn esquema JSON opcional: el agente termina con una respuesta con esa forma, en structured del resultado.
Time Limit (s)Si una instrucción tarda más, se detiene. Por defecto, 600.
API Base URLSolo para una pasarela compatible propia. Vacío, la dirección oficial del proveedor.
Max Cost per Instruction (USD)El agente se detiene si una instrucción fuera a costar más. 0, sin límite.
Max StepsMáximo de idas y vueltas con el modelo por instrucción. 0, sin límite.

Resultado

  • Response: en Run Instruction, la respuesta final del agente; en List Sessions, Delete Session y Get Changes, un JSON válido listo para automatizaciones ({"sessions": [...], "count": N}, {"changed_files": [...], "diff_summary": "...", "count": N} o {"deleted": true, "session_name": "..."}).
  • Result: objeto Data estructurado. En Run Instruction incluye changed_files, diff_summary, branch, denied_actions, steps, conversation_id, session_name, structured, usage y cost_usd; en List Sessions, Delete Session y Get Changes incluye los mismos datos estructurados en structured y en el nivel raíz (sessions, changed_files, deleted, count). Es lo que recibe un agente cuando lo usa como herramienta.

Ejemplo

Programar por voz sobre un repositorio:

  1. Añade un Voice Agent y un Claude Agent con tu credencial Claude.
  2. En Repository URL pon tu repositorio y, si es privado, el Git Access Token.
  3. Activa el modo herramienta del nodo y conéctalo a Tools del Voice Agent.
  4. Llama y di «arregla el test que falla en el módulo de facturas»: el agente de voz se lo pasa y te cuenta qué ha cambiado.

Seguridad

  • Usa tu API key; nunca pegues tokens de sesión en un campo.
  • El agente trabaja aislado: sin acceso a la red interna de NappAI ni a los espacios de otras personas.
  • No escribas claves ni tokens en la instrucción: usa la credencial y el campo Git Access Token.

Componentes relacionados

Codex Agent, Antigravity Agent, OpenCode Agent.