Cómo usar los agentes de Claude Code: configuración, herramientas, permisos y flujo de trabajo con sandbox

Para usar bien los agentes de Claude Code, tratalo a Claude Code como un bucle de agente en lugar de una ventana de chat: inicialo dentro del repositorio que deseas modificar, dale instrucciones claras del proyecto, conectar solo las herramientas que realmente necesita, mantener los permisos ajustados y ejecutar la ejecución dentro de un entorno de ejecución aislado cuando el flujo de trabajo vaya más allá de ediciones locales de bajo riesgo. Esa es la diferencia entre una sesión de codificación útil y una costosa y desordenada.

Si tu pregunta principal es más amplia que la de Claude Code, empieza con ¿Qué son los agentes de codificación? para ver la arquitectura. Si primero estás decidiendo entre herramientas, compara Claude Code vs Cursor. Esta guía es más específica: cómo usar los agentes de Claude Code en la práctica.

Qué suele entenderse por “agentes de Claude Code”

La mayoría de los desarrolladores que buscan “agentes de Claude Code” se refieren a una de dos cosas:

1. El mismo Claude Code actuando como un agente autónomo de codificación.
2. Varios agentes especializados, herramientas o subagentes trabajando dentro de un flujo de trabajo de Claude Code.

Ambas son válidas. Claude Code ya se comporta como una herramienta de codificación agentica: puede inspeccionar un repositorio, editar archivos, ejecutar comandos y reaccionar a los resultados. Anthropic también documenta bloquees de construsión relacionados, como integraciones de herramientas MCP, hooks y subagentes, por lo que el término suele aparecer en plural.

El modelo prático es simple:

• Claude Code es el flujo de trabajo anfritión.
• El modelo se encarga de la planificación y las decisions del siguente paso.
• Herramientas proporcionan acceso a archivos, comandos, navegadores, APIs y sistemas externos.
• Permisos deciden qué está permitido que Claude haga sin preguntar.
• Un sandox te da un lugar seguro para ejecutar código y la ejecución de herramientas.

Si mantienes esas cinco capas separadas, Claude Code se vuelve mucho más fácil de operar de manera fiable.

Paso 1: Instalar Claude Code y comenzar en el directorio correcto

Anthropic documenta Claude Code como una CLI instalable. La ruta de instalación estándar es:

npm install -g @anthropic-ai/claude-code
claude

El detalle importante no es solo la instalación. Inicia Claude Code desde el repositorio en el que quieras trabajar. Claude Code lee el directorio actual, las instrucciones del proyecto local y cualquier configración de herramienta a escala del proyecto desde allí.

Si el repo es nuevo, ejecuta:

/init

Eso genera un archivo CLAUDE.md inicial con instrucciones específicas del proyecto. Úsalo para cosas que Claude debería recordar en cada sesión: comandos de prueba preferidos, estándares de codificación, límites de arquitectura, expectativas de revisión y archivos que debe tratar con cuidado.

Esto importa más de lo que la mayoría de los usuaros esperan. Un agente de Claude Code sin instrucciones específicas del repositorio normalmente no está infravalorado. Está subespecificado.

Paso 2: Dar al agente una tarea que pueda ejecutar realmente

Claude Code funciona mejor cuando la tarea incluye un resultado concreto y un paso de verificación.

Buenos ejemplos:

• “Agregar limitación de tasa a /login, actualizar las pruebas y ejecutar el archivo de prueba afectado.”
• “Refactorizar el servicio de facturación para usar el nuevo cliente, luego ejecutar pruebas unitarias para ese paquete.”
• “Revizar este diff de PR por problemas de segurid y corrección.”

Los promptes débiles suelen ser vagos exactamente de la manera incorrecta:

• “Mejorar este código.”
• “Hacer la app mejor.”
• “Revisar el proyecto.”

Las herramientas de codificación agenticas rinden mejor cuando la línea de meta es explícita. Si quieres autónomía, define el éxito. Si quieres exploración, define el alcance.

Paso 3: Configurar solo las herramientas que necesitas

Claude Code usa el Model Contex Protoco para herramientas externas. En la práctica, eso significa que los servidores MCP son la superficie de extensión para navegadores, bases de dados, rastreadores de incidencias, GitHub, ejecutores de código y servicios internos.

El comando de configración más común es:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Eso le da a Claude herramientas de automatización de navegadores. La documentación de MCP de Anthropic y la guía rápida cubren el mismo patrón para otros servidores.

La rega operatva clave es la restricción: no adjuntes todas las herramientas que quizás algún día quieras. Adjunta el conjunto de herramientas más pequeñ que coincida con el trabajo. Demasiadas herramientas aumentan el ruido de inicio, amplían la superficie de acción y hacen que la selección de herramientas sea menos predecible.

Para la mayoría de los trabajos en repositorios, un conjunto inicial sensato es:

• acceso local a archivos y shell
• una herramienta de navegador si se requiere control de calidad web
• una herramienta de incidencias o documentos si la tarea dependde de un sistema externo

Todo lo demás debe ganarse su lugar.

Paso 4: Usar los permisos deliberadamente, no como una ocurrencia tardía

Una de las grandes diferencia entre un flujo de trabajo seguro con Claude Code y uno imprudente es la disiplina de permisos.

Claude Code expone controles de permisos porque la ejecución de herramientas es el verdadero límite de riesgo. Leer un archivo es una cosa. Ejecutar scripts de instalación, eliminar directorios o acceder a servicios externos es otra.

Usa /permissions al principio de un proyecto, especalmente si la sesión puede:

• escriber en muchos archivos
• ejecutar comandos de shell
• instalir paquetes
• acceder a secretos o sistemas internos
• llamar a herramientas MCP con efectos secundarios

La configración correcta depend del trabajo:

• Para depuración exploratoria, preguntar antes de ejecutar suele ser el valor predeterminado más segur.
• Para trabajo repetitivo y bien delimitado en el repo, las reglas de permiso pueden reducir las interrupciones.
• Para comandos de alto riesgo o rutas sensibles, las regas de denegación debern permanecer explícitas.

Aquí es también donde muchos equipos cometen la optimización equivocada. Eliminan fricción abriendo demasiado los permisos y luego intentan recuperar el control solo con palabras en el prompt. Eso está al revés. Los prompts son guía. Los permisos son aplicación.

Paso 5: Entender el bucle real del agente

Claude Code se siente poderoro cuando entiendes lo que está sucediendo bajo el capó.

El bucle generalmente se ve así:

1. Claude lee la tarea y el contexto del proyecto.
2. Planifica el siguente paso útil.
3. Lee archivos o llama a herramientas.
4. Edita código o ejecuta un comando.
5. Comprueba la salida.
6. Reviza el plan basándose en lo que sucedió.
7. Se dentiene cuando el resultado solicitado está completdo.

Ese bucle explica por qué los flujos de trabajo agenticos son diferente del uso normal de chatbots. El modelo no solo genera código. Está coorenando el estado a traves de herramientas, archivos, salidas de comandos y fallos intermedios.

Para el trabajo real en repositorios, las partes más importantes normalmente no son la primera respuesta. Son los pasos de recuperción después del primer fracas de prueba, error de lint o desajuste de entorno.

Paso 6: Usar subagentes cuando la especialización ayuda

Claude Code ahora incluye soporte para subagentes porque un agente de propósito general no siempre es la mejor opción para cada tarea.

Los subagentes tienen sentido cuando el flujo de trabajo se beneficia de la especialización, por ejamplo:

• un agente para la implementción
• un agente para la revisión de código
• un agente para la documentción
• un agente para la investiación de pruebas

Esto no significa que cada proyecto necesite un enjambre. En repositorios pequeñ, múltiples subagentes pueden agregar más sobrecarga que valor. Pero para equipos con traspasos repetitivos, los subagentes son útiles porque permiten codificar instrucciones y responsabilidades más estrechas.

El principio operativo es el mismo que los buenos equipos de ingeniería ya usan: separar roles cuando los límitos son lo suficientemente claros para ser útiles.

Si no puedes explicar por qué existe un segundo agente, probablemente no lo necesitas.

Paso 7: Usar hooks para control y auditabilidad

Los hooks son la respuesta correcta cuando quieres que las sesiones de Claude Code detenen verificaciones predecibles en puntos específicos del flujo de trabajo.

Ejemplos:

• ejecutar formato después de ediciones de archivos
• regirtar cambios de archivos después de operaciones de escritura
• bloquear comandos que toquen rutas protgidas
• envir eventos a un rastro de audtoría local

Los hooks importan porque hacen que el flujo de trabajo dependa menos de que el modelo recuerde cada política cada vez. Si un paso siempre debe ocurrir después de una catería de acción, automatiza ese límite en lugar de esperar que el prompt de la sesión sea suficiente.

Esto es especalmente importante una vez que Claude Code se convierte en parte de un proceso de equipo repetitivo en lugar de una herramineta individual única.

Dónde encaja Novita en una pila de agentes de Claude Code

Claude Code es la interface del agente. No es toda la pila.

Una vez que un equipo usa Claude Code en serio, aparecen dos preguntas de infraestructura separadas:

1. ¿Qué backend de modelo debe manejar el razonamiento?
2. ¿Dónde debería ejecutarse realmente la ejecución de herramientas?

Esas son exactamente las partes donde Novita encaja de forma natural.

Usar la API de LLM de Novita para flexibilidad de backend

Novita documenta un endpoin compatible con Anthropic para flujos de trabajo al estilo de Claude Code. Esu significa que puedes mantener el patrón de interacción de Claude Code mientras dirijes el tráfico del modelo hacia modelos alojados en Novita en lugar de solo una ruta prederterminada.

El patrón de entorno estándar es:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<tu-clave-api-novita>"
export ANTHROPIC_MODEL="qwen/qwen3-coder-480b-a35b-instruct"

Esa configración es útil cuando quieres evaluar diferentes modelos de codificación sin reconstuir tu capa de herramientas.

También crea una ruta más natural para equipos que quieren la ergonomía de Claude Code pero no una suposición operativa de un solo modelo. La interface sigue siendo familiar; el backend se vuelve provablo.

Usar el Agent Sandbox de Novita para el aislamiento de ejecución

La segunda mitad del problema es la ejecución.

Un agente de Claude Code que solo lee y escriibe pequeñ archivos locales es una cosa. Un agente de Claude Code que ejecuta comandos, instala paquetes, lanza navegadores, descarga dependencias o toca sistemas similares a producción es otra.

Ahí es donde un tiempo de ejecución aislado deja de ser opcional y comienza a ser parte del diseño.

El Agent Sandbox de Novita está posicionado exactamente para esta capa: entornos aislados para la ejecución de código, trabajo con sistem de archivos, automatización de navegadores y flujos de trabajo de agentes de larga duración. En otras palabras, cubre la parte de la pila donde ocurren los efctos secundarios.

El modelo mental limpio es:

• usar Claude Code para el flujo de trabajo del agente.
• usar la API de LLM de Novita para el enrutamiento de modelos y experimentción.
• usar el Agente Sandbox de Novita para límites de ejecución seguros.

Mantener el razonamiento y la ejecución separados suele ser la mejor arquitectura a largo plazo.

Una opción práctica de modelo abierto dentro del mismo flujo de trabajo

Una vez que tengas Claude Code funcionando bien, la siguente pregunta suele no ser “¿Puede esto usar agentes?” Sino “¿Qué backend merece la peana pagar cada da?”

Aquí es donde los modelos de codificación de pesos abiertos se volven interesantes de una manera muy práctica. Si a tu equipo le gusta la interface de Claude Code pero quire una experimentación más barata o más flexibilidad de proveedor, un modelo abierto puede ser el siguente punto de referencia adecuado.

Un candidato creíble es Qwen3-Coder-480B-A35B-Instruct a través de la ruta compatible con Anthropic de Novita. No necesitas tratarlo como un reemplazo garantizado de Claude en cada tarea. Debes tratarlo como una opción seria de modelo de codificación que pertenece al mismo conjunto de evluación que las alternativas cerradas.

Ese es el cambio natural que muchos equipos hacen:

• mantner el flujo de trabajo del agente.
• mantner las herramientas.
• mantner el modelo de permisos.
• cambiar el backend y comparar resultados de tareas reales.

Si el trabajo está dominado por la navegación del repositorio, la implementación sencilla y la llamada a herramientas en lugar de razonamiento de nivel vanguardia, un modelo abierto puede ser lo suficientemente competitivo como para justificar la prueba.

Esta es una de las cosas más útiles de la configración de Nvita: te permite comparar esa pregunta dentro de un flujo de trabajo familiar de Claude Code en lugar de convertir el punto de referencia en un proyecto de migración.

Errores comunes al usar agentes de Claude Code

La mayoría de los fracasos provienen del diseño del flujo de trabajo, no de la idea del código agentico en sí.

Dar al agente objetivos amplios sin una línea de meta

Si quieres resultados fiables, especifica el entregable y cómo verificarlo.

Adjuntar demasiadas herramientas

Más herramientas no automatticamente hacen a Claude más listo. Suelen hacer que el enrutamiento sea más ruidoso.

Tratar los permisos como una molestia de UX

Los permisos son el plano de control para los efectos secundarios. Deben ajustarse, no eludirse.

Ejecutar acciones arriesgadas directamente en una máquina de desarrollo

Si el agente está haciendo automatización de navegador, instalación de paquetes o ejecución repetida de comandos, usa un tiempo de ejecución aislado.

Confundir una demostración útil con un flujo de trabajo de producción

Una demostración de Claude Code puede verse bien en cinco minutos. Un flujo de trabajo de producción necesita política, auditoría, aislamiento del tiempo de ejecución y disciplina en la elección del modelo.

Flujo de trabajo recomendado para la mayoría de los equipos

Si quieres un valor predeterminado pragmático, usa este orden:

1. Inicia Claude Code en el repositorio de destino.
2. Ejecuta /init y haz que CLAUDE.md sea útil.
3. Adjunta solo las herramientas MCP necesarias para la tarea.
4. Configura /permissions antes de la ejecución amplia.
5. Usa un sandox cuando el flujo de trabajo ejecute código real o pasos de navegador.
6. Evaúa al menos un backend alternativo a traves de Novita antes de estandarizar las suposiciones de coste.

Esa secuencia mantiene el sistema comprensible. Tambien evita que mezcés la ergonomía del producto, la calid del modelo, la propagación de herramientas y la segurid del tiempo de ejecución en una decición borrsa.

Preguntas frecuentes

¿Es Claude Code mismo un agente?

Sí. Claude Code es un flujo de trabajo de codificación agentico en lugar de una herramineta simple de completión de código. Puede inspeccionar archivos, editar código, ejecutar comandos y reaccionar a los resultados de las herramientas.

¿Necesito MCP para usar agentes de Claude Code?

No. Claude Code es útil solo con acceso local al repositorio. MCP se vuelve importante cuando quieres herramientas externas como navegadores, bases de datos, APIs o sistemas de incidencias.

¿Cuándo debería usar un sandbox con Claude Code?

Úsalo cuando el flujo de trabajo ejecute código, instale paquetes, lance navegadores o realice acciones repetitivas con efectos secundarios que no quieras ejecutar directmente en el anfitrión.

¿Puede Claude Code usar modelos a través de Novita?

Novita documenta una configración compatible con Anthropic para flujos de trabajo al estilo de Claude Code, por lo que puedes mantener la interface de Claude Code mientras dirijes las solicitudes del modelo a través de modelos alojados en Novita.

¿Debería usar varioss subagentes de inmediato?

Por lo general, no. Empieza con un agente y agrega subagentes solo cuando la especialización sea lo suficientemente clara para reduir la confusión en lugar de crearla.

Artículos recompendados

• Claude Code Plugins: Cómo las herramientas MCP extienden Claude Code con capacidades externas
• Modelos compaibles con Claude Code en 2026: ¿Cuál deberías usar?
• ¿Qué son los agentes de codificación? Cómo funconan y cómo construsir uno

Fuentes verificadas el 24 de agosito de 2026: Visión general de Claude Code de Anthropic, Configración y permisos de Claude Code de Anthropic, Hooks de Claude Code de Anthropic, Subagentes de Claude Code de Anthropic, MCP de Claude Code de Anthropic, Guía de Claude Code de Novita, y Visión general de Sandbox de Novita.