Description
Carnet des Agents est un proxy local qui se situe entre un agent de codage, Claude Code ou Codex, et le modèle sous-jacent. Il ajoute un appel d'outil supplémentaire à chaque requête : un espace pour que le modèle réfléchisse à voix haute avant de répondre, notant la décision qu'il prend, les alternatives qu'il a envisagées et ce que chaque option aurait coûté. L'objectif déclaré du projet est de permettre à un développeur de vérifier si le plan déclaré d'un agent correspond à ce qu'il fait réellement.
Lire la suite
Le proxy fonctionne localement via Docker Compose et expose un tableau de bord à 127.0.0.1:8080, où chaque note est diffusée au fur et à mesure que le modèle l'écrit, avec des sessions CLI séparées maintenues dans des lignes distinctes. Claude Code pointe vers le proxy en définissant ANTHROPIC_BASE_URL à l'adresse locale ; Codex est configuré via un fournisseur de modèle personnalisé. Un mode de continuité optionnel garde les notes précédentes disponibles à travers les appels d'outils au sein du même tour (activé par défaut pour Codex, et activé pour Claude Code avec un drapeau d'environnement explicite une fois qu'il a été vérifié par rapport à la version de Claude Code installée), avec des limites configurables sur le nombre de sessions, la mémoire et le délai d'inactivité.
Le projet documente ses propres coûts de manière claire. Parce qu'il effectue un appel supplémentaire au modèle pour chaque tour, et jusqu'à quatre lorsque le modèle continue d'écrire des notes, il double à peu près l'utilisation des tokens d'entrée et ajoute des centaines à des milliers de tokens de sortie par tour, et une réponse ne commence pas à être diffusée tant que l'appel de note cachée n'est pas terminé, jusqu'à 60 secondes. Il avertit également qu'une note de carnet est une sortie ordinaire du modèle, donc une clé API ou un secret collé pourrait apparaître dans l'une d'elles.
Carnet des Agents ne lit ni n'expose le raisonnement interne protégé d'un modèle ; les notes sont produites par un appel d'outil ordinaire, le même que tout autre argument d'outil qu'un modèle peut écrire. Rien n'est écrit sur le disque à moins que l'opérateur ne définisse un chemin d'archive, et la documentation du projet demande explicitement aux utilisateurs de ne pas l'utiliser pour collecter ou s'entraîner sur des traces de raisonnement provenant des modèles d'Anthropic ou d'OpenAI. Il est publié sous la licence Apache 2.0 et déclare qu'il n'est affilié à aucune des deux entreprises.
C'est un petit projet open-source, développé par un seul développeur, destiné aux développeurs qui utilisent Claude Code ou Codex et souhaitent avoir une visibilité sur le raisonnement d'un agent pendant une session de codage, plutôt qu'un produit pour des utilisateurs non techniques.
- CatégorieCréateurs d'agents IA
- Modèle tarifaireOpen source
- DéploiementAuto-hébergé
- PlateformesWeb
Fonctionnalités principales de Carnet des Agents
Proxy local ajoutant un appel d'outil "penser à voix haute" à chaque requête Claude Code / Codex
Tableau de bord en direct (127.0.0.1:8080) diffusant chaque note au fur et à mesure qu'elle est écrite
Lignes séparées par session CLI sur le tableau de bord
Continuité inter-appels optionnelle qui garde les notes précédentes disponibles au sein d'un tour
Limites de continuité configurables (nombre de sessions, taille de la mémoire, délai d'inactivité)
Fonctionne avec Claude Code (via ANTHROPIC_BASE_URL) et Codex (via configuration de fournisseur personnalisé)
Fonctionne entièrement localement via Docker Compose ; rien n'est écrit sur le disque à moins d'être configuré
Licence open-source Apache 2.0
Premiers pas avec Carnet des Agents
Cloner le dépôt : Obtenez le projet depuis GitHub (softcane/agents-workbook).
Démarrer le proxy : Exécutez docker compose up -d --build.
Ouvrir le tableau de bord : Visitez 127.0.0.1:8080 et laissez l'onglet ouvert.
Pointer votre CLI vers le proxy : Définissez ANTHROPIC_BASE_URL pour Claude Code, ou configurez les paramètres du fournisseur de modèle de Codex.
Travailler normalement : Utilisez Claude Code ou Codex, et regardez son raisonnement se diffuser vers le tableau de bord.
Activer la continuité (optionnel) : Définissez WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true pour garder les notes disponibles à travers les appels d'outils pour Claude Code.
Cas d'utilisation de Carnet des Agents
- Audit plan-vs-action
- Revue de session de codage
- Débogage local





