Descripción
El Cuaderno de Agentes es un proxy local que se sitúa entre un agente de codificación, Claude Code o Codex, y el modelo subyacente. Añade una llamada a la herramienta adicional a cada solicitud: un lugar para que el modelo piense en voz alta antes de responder, anotando la decisión que está tomando, las alternativas que consideró y lo que habría costado cada opción. El objetivo declarado del proyecto es permitir a un desarrollador verificar si el plan declarado por un agente coincide con lo que realmente hace.
Leer más
El proxy se ejecuta localmente a través de Docker Compose y expone un panel en 127.0.0.1:8080, donde cada nota se transmite a medida que el modelo la escribe, con sesiones CLI separadas mantenidas en filas distintas. Claude Code apunta al proxy configurando ANTHROPIC_BASE_URL a la dirección local; Codex se configura a través de un proveedor de modelo personalizado. Un modo de continuidad opcional mantiene las notas anteriores disponibles a través de llamadas a herramientas dentro del mismo turno (activado por defecto para Codex, y habilitado para Claude Code con una bandera de entorno explícita una vez que se ha verificado contra la versión instalada de Claude Code), con límites configurables en el número de sesiones, memoria y tiempo de espera inactivo.
El proyecto documenta sus propios costos de manera clara. Debido a que realiza una llamada adicional al modelo por cada turno, y hasta cuatro cuando el modelo sigue escribiendo notas, aproximadamente duplica el uso de tokens de entrada y añade cientos a miles de tokens de salida por turno, y una respuesta no comienza a transmitirse hasta que finaliza la llamada de nota oculta, hasta 60 segundos. También advierte que una nota del cuaderno es una salida de modelo ordinaria, por lo que una clave API o secreto pegado podría aparecer en una.
El Cuaderno de Agentes no lee ni expone el razonamiento interno protegido de un modelo; las notas se producen a través de una llamada a la herramienta ordinaria, la misma que cualquier otro argumento de herramienta que un modelo puede escribir. Nada se escribe en el disco a menos que el operador establezca una ruta de archivo, y la documentación del proyecto pide explícitamente a los usuarios que no lo utilicen para recopilar o entrenar sobre trazas de razonamiento de los modelos de Anthropic u OpenAI. Se publica bajo la licencia Apache 2.0 y declara que no está afiliado a ninguna de las dos empresas.
Es un pequeño proyecto de código abierto, desarrollado por una sola persona, dirigido a desarrolladores que utilizan Claude Code o Codex y desean visibilidad sobre el razonamiento de un agente durante una sesión de codificación, en lugar de ser un producto para usuarios no técnicos.
- CategoríaCreadores de agentes de IA
- Modelo de preciosCódigo abierto
- ImplementaciónAutoalojado
- PlataformasWeb
Características principales de Cuaderno de Agentes
El proxy local añade una llamada a la herramienta "pensar en voz alta" a cada solicitud de Claude Code / Codex
Panel en vivo (127.0.0.1:8080) transmitiendo cada nota a medida que se escribe
Filas separadas por sesión CLI en el panel
Continuidad opcional entre solicitudes que mantiene notas anteriores disponibles dentro de un turno
Límites de continuidad configurables (número de sesiones, tamaño de memoria, tiempo de espera inactivo)
Funciona tanto con Claude Code (a través de ANTHROPIC_BASE_URL) como con Codex (a través de configuración de proveedor personalizado)
Se ejecuta completamente de forma local a través de Docker Compose; nada se escribe en el disco a menos que se configure
Licencia de código abierto Apache 2.0
Primeros pasos con Cuaderno de Agentes
Clona el repositorio: Obtén el proyecto de GitHub (softcane/agents-workbook).
Inicia el proxy: Ejecuta docker compose up -d --build.
Abre el panel: Visita 127.0.0.1:8080 y deja la pestaña abierta.
Apunta tu CLI al proxy: Establece ANTHROPIC_BASE_URL para Claude Code, o configura los ajustes del proveedor de modelo de Codex.
Trabaja como de costumbre: Utiliza Claude Code o Codex, y observa cómo su razonamiento se transmite al panel.
Habilita la continuidad (opcional): Establece WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true para mantener las notas disponibles a través de llamadas a herramientas para Claude Code.
Casos de uso de Cuaderno de Agentes
- Auditoría de plan vs acción
- Revisión de sesión de codificación
- Depuración local
