Claude Code

En el Radar compartido: Adopt (valoración de la edición aportada).

Cómo funciona

Combina un modelo con acceso a archivos y comandos. Instrucciones del repositorio y skills orientan la ejecución de tareas de varios pasos.

Ejemplo de uso

Solicitar una validación de campos con casos de borde explícitos. El agente inspecciona convenciones, modifica el código y ejecuta verificaciones; el desarrollador revisa comportamiento y dependencias.

Superficies de uso

Claude Code funciona en la terminal (CLI), en IDE (VS Code, JetBrains), en la aplicación de escritorio, en la web y como acción de GitHub o mediante el Agent SDK para automatizaciones. La configuración del proyecto es la misma en todas.

Piezas de configuración

Pieza	Ubicación típica	Para qué sirve
CLAUDE.md	Raíz del repo, subcarpetas, usuario	Convenciones, comandos de build y test, decisiones no obvias
settings.json	.claude/settings.json	Permisos (allow/deny), variables de entorno, modelo, hooks
Skills	.claude/skills/<nombre>/SKILL.md	Procedimientos reutilizables que se cargan bajo demanda (Agent Skills)
Subagentes	.claude/agents/*.md	Agentes especializados con herramientas y contexto propios
Hooks	En settings.json	Comandos que se ejecutan en eventos (antes o después de usar una herramienta, al terminar)
Servidores MCP	.mcp.json	Herramientas externas: bases de datos, tickets, documentación (MCP)
Plugins	Marketplaces	Paquetes de skills, agentes, hooks y comandos (marketplace)

Permisos y seguridad

{
  "permissions": {
    "allow": ["Bash(npm run test:*)", "Bash(git diff:*)"],
    "deny": ["Read(./.env)", "Bash(git push:*)"]
  }
}

Los modos de permiso van desde pedir confirmación en cada acción hasta un modo automático con clasificador de riesgo. En entornos sin supervisión, ejecútalo dentro de un contenedor o sandbox (sandboxed execution) y con credenciales de alcance mínimo.

Hooks como sensores

Un hook PostToolUse puede ejecutar el formateador o el linter tras cada edición, y uno Stop puede lanzar las pruebas antes de que el agente dé la tarea por terminada. Es una forma práctica de aplicar feedback sensors for coding agents.

Flujo de trabajo recomendado

1. Explorar: pedir que lea el código relevante y explique el enfoque sin modificar nada (modo plan).
2. Planificar: revisar el plan y corregir supuestos antes de escribir código.
3. Implementar: cambios pequeños con pruebas ejecutadas por el agente.
4. Verificar y revisar: diff, pruebas y revisión humana; usar /code-review o un segundo agente como revisor.
5. Registrar: actualizar CLAUDE.md cuando se descubre una convención no documentada.

Antipatrones frecuentes

• CLAUDE.md enorme que repite lo que el código ya muestra: consume contexto y diluye lo importante.
• Aceptar cambios de cientos de líneas sin leerlos.
• Dar acceso a credenciales de producción en la máquina donde corre el agente.

Criterios de implementación

Usar sandbox, credenciales limitadas y cambios pequeños. Revisar acciones con efectos externos y medir defectos y retrabajo junto con velocidad de implementación.