https://github.com/servomorph/autoclaude
Outil Python qui clique automatiquement sur le bouton de confirmation de Claude Code (VS Code). Interface graphique sombre, compteur de clics, analyses graphiques et protection de projet intégrée.
https://github.com/servomorph/autoclaude
autoclick automation claude-code customtkinter dark-theme gui opencv pyinstaller python template-matching vscode windows
Last synced: 2 months ago
JSON representation
Outil Python qui clique automatiquement sur le bouton de confirmation de Claude Code (VS Code). Interface graphique sombre, compteur de clics, analyses graphiques et protection de projet intégrée.
- Host: GitHub
- URL: https://github.com/servomorph/autoclaude
- Owner: ServOMorph
- License: mit
- Created: 2026-04-23T08:01:20.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-25T06:50:59.000Z (2 months ago)
- Last Synced: 2026-04-25T08:37:42.947Z (2 months ago)
- Topics: autoclick, automation, claude-code, customtkinter, dark-theme, gui, opencv, pyinstaller, python, template-matching, vscode, windows
- Language: Python
- Homepage: https://serenia-tech.fr/
- Size: 783 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Audit: audit_after.json
- Security: DOCS/SECURITY.md
- Roadmap: DOCS/ROADMAP.md
Awesome Lists containing this project
README
# AutoClaude
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/)
[](https://github.com/ServOMorph/AutoClaude/actions/workflows/tests.yml)
[](https://github.com/ServOMorph/AutoClaude/releases)
> **Conçu pour [Claude Code](https://claude.ai/code) dans VS Code** — donne plus d'autonomie à Claude Code en cliquant automatiquement sur les boutons de confirmation récurrents, sans interrompre le flux de travail de l'IA.
Outil Python qui détecte et clique automatiquement sur un bouton récurrent à l'écran — avec une interface graphique CustomTkinter en mode sombre.
Quand Claude Code travaille dans VS Code, il demande régulièrement une confirmation utilisateur (bouton "Continuer", "Approuver", etc.). AutoClaude surveille l'écran en arrière-plan et clique à ta place, permettant à Claude Code de tourner en continu sans surveillance constante.
> Développé par [SéréniaTech](https://serenia-tech.fr) · [GitHub](https://github.com/ServOMorph)
---
## Fonctionnalités
- Détection d'image par template matching (OpenCV + mss)
- Support multi-moniteur
- Dégradation progressive : si une dépendance optionnelle manque, l'outil continue de fonctionner
- Arrêt via Esc, fermeture fenêtre ou mouvement souris (mode auto-stop)
- Protection de projet Claude Code via injection dans `.claude/CLAUDE.md`
- **Compteur de clics** avec historique persisté
- **Analyses graphiques** : navigation temporelle (Récent / Tout), bandeau de statistiques (total, moyenne, record, jours actifs), graphes par Aujourd'hui/7j/30j/12m/Tout
- **Indicateur flottant** : overlay always-on-top en bas à gauche de l'écran, cliquable pour activer/désactiver l'autoclick depuis n'importe quelle application
- Logs rotatifs (`~/.autoclaude/logs/`) et watchdog de stabilité pour une utilisation longue durée
- Interface sombre SéréniaTech (CustomTkinter)
- Paramètres persistés localement (`~/.autoclaude/settings.json`)
---
## Installation
### Option 1 : Télécharger l'exécutable (Windows)
Télécharge `AutoClaude_v2.3.0.exe` depuis les [releases](https://github.com/ServOMorph/AutoClaude/releases) et double-clique pour lancer. Aucune dépendance Python requise.
### Option 2 : Installation depuis le code source
```bash
# Cloner le dépôt
git clone https://github.com/ServOMorph/AutoClaude.git
cd AutoClaude
# Installer les dépendances
pip install -r requirements.txt
# Lancer l'application
python run.py
```
### Dépendances (installation depuis source)
**Obligatoires**
| Package | Rôle |
|---------|------|
| `pyautogui` | Détection et clic d'image (fallback) |
| `pynput` | Écoute clavier/souris |
| `customtkinter` | Interface graphique |
| `Pillow` | Affichage des images |
| `matplotlib` | Graphes d'analyse |
| `psutil` | Monitoring mémoire/stabilité |
**Optionnelles** (meilleures performances)
| Package | Rôle |
|---------|------|
| `opencv-python` | Template matching haute précision |
| `mss` | Capture multi-moniteur rapide |
| `numpy` | Traitement d'image (requis par OpenCV) |
| `screeninfo` | Énumération des moniteurs |
---
## Interface
---
## Utilisation
```bash
# Lancer l'interface graphique
python run.py
```
L'interface permet de :
1. **Activer / désactiver** l'autoclick via le bouton bleu/rouge
2. **Sélectionner un dossier de projet** à protéger
3. **Appliquer ou retirer** la protection Claude Code sur ce dossier
4. **Compter les clics** — affichage en temps réel du nombre total, avec reset possible
5. **Visualiser les analyses** — navigation par période, mode Récent/Tout, stats chiffrées
6. **Afficher/masquer l'indicateur flottant** — overlay visible par-dessus toutes les applications
### Indicateur flottant
Un petit indicateur apparaît en bas à gauche de l'écran, par-dessus toutes les fenêtres :
- 🟢 **Vert — CL OFF** : autoclick inactif
- 🔴 **Rouge — CL ON** : autoclick actif
Un clic sur l'indicateur active ou désactive l'autoclick directement, sans revenir à la fenêtre principale. L'affichage se contrôle via le switch **"Afficher l'indicateur flottant"** dans l'UI.
### Analyses
La fenêtre d'analyses offre :
- **5 périodes** : Aujourd'hui, 7 jours, 30 jours, 12 mois, Tout
- **Mode Récent** (défaut) : fenêtre glissante — dernières 24h / 7 derniers jours / 30 derniers jours / 12 derniers mois
- **Mode Tout** : historique complet avec navigation Précédent / Suivant (paginé par jour, mois ou année selon la période)
- **Bandeau de stats** : total, moyenne par jour actif, record journalier, jours actifs
### Arrêt
- Touche **Esc** — arrête l'autoclick
- **Fermeture de la fenêtre** — arrête proprement le thread
- **Mouvement souris** — si le mode auto-stop est actif
---
## Image cible
Par défaut, AutoClaude cherche `assets/yes.png`. Remplace ce fichier par un screenshot du bouton que tu veux automatiser (PNG, JPG ou BMP recommandé).
---
## Protection Claude Code
Le bouton **Protéger** injecte un bloc de restrictions dans `.claude/CLAUDE.md` du projet sélectionné. Ce bloc est lu par Claude Code au démarrage de chaque session et contraint le comportement de l'IA au périmètre du projet.
Voir [DOCS/SECURITY.md](DOCS/SECURITY.md) pour le détail du bloc injecté et de l'API.
---
## Logs & stabilité
AutoClaude est conçu pour tourner en continu. Les logs sont disponibles dans `~/.autoclaude/logs/autoclaude.log` (rotation automatique, 5 Mo × 3 fichiers). En cas de crash ou de comportement anormal, ce fichier est le premier endroit à consulter.
---
## Configuration fine-tuning
Le fichier `config.py` à la racine du projet permet d'ajuster le comportement sans modifier le code :
| Variable | Valeur | Description |
|----------|--------|-------------|
| `DEBUG_COMPTEUR` | `True/False` | Affiche les cercles rouges de debug à chaque clic |
| `COOLDOWN_DURATION` | `3.0-5.0` (sec) | Attente après chaque clic avant nouvelle détection (élevez si re-clics fantômes) |
| `CONFIDENCE_THRESHOLD` | `0.85-0.95` | Sévérité de la détection d'image (élevez pour moins de faux positifs) |
| `PRE_CLICK_DELAY` | `0.5-2.0` (sec) | Délai après détection avant de cliquer (élevez si bouton anime) |
**Exemple :**
```python
# Pour éviter les faux positifs sur boutons bleus
CONFIDENCE_THRESHOLD = 0.95
# Pour boutons qui tardent à disparaître
COOLDOWN_DURATION = 5.0
# Pour debug visuel des clics
DEBUG_COMPTEUR = True
```
---
## Problèmes connus
### Comptage des clics imprécis
- **Symptôme** : Le compteur enregistre parfois plus ou moins de clics que prévu
- **Cause potentielle** : Timing critique entre détection, clic et disparition du bouton
- **Solution** : Ajustez dans `config.py` :
- Augmentez `COOLDOWN_DURATION` si clics doublés
- Augmentez `CONFIDENCE_THRESHOLD` pour strictitude accrue
- Augmentez `PRE_CLICK_DELAY` pour laisser le bouton stable avant clic
- **Debug** : Activez `DEBUG_COMPTEUR = True` pour visualiser chaque clic via un cercle rouge
### Faux positifs de détection (image)
- **Symptôme** : Clics sur des éléments qui ne sont pas le bouton visé
- **Cause** : Couleurs proches (bleu, gris) ou éléments UI similaires
- **Solution** : Augmentez `CONFIDENCE_THRESHOLD` à 0.90-0.95 dans `config.py`
### Le bouton n'est pas détecté
- **Cause** : Confiance trop stricte, ou image cible différente sur l'écran
- **Solution** : Baissez `CONFIDENCE_THRESHOLD` à 0.80-0.85, ou mettez à jour `assets/yes.png`
---
## Architecture
```
src/core/ détection, clic, listener, service autoclick, logger, health monitor
src/ui/ interface CustomTkinter + composants + dialogs + overlays
src/security/ ClaudeMdProtector
src/config/ constantes et persistance JSON
assets/ yes.png, Icone AutoClaude.png, Icone AutoClaude.ico, ui-screenshot.png
```
Voir [DOCS/ARCHITECTURE.md](DOCS/ARCHITECTURE.md) pour le détail des décisions techniques.
---
## Mises à jour
Pour rester informé des dernières versions et améliorations d'AutoClaude, n'hésitez pas à suivre le dépôt GitHub officiel :
[https://github.com/ServOMorph/AutoClaude](https://github.com/ServOMorph/AutoClaude)
Vous y trouverez les notes de version, les nouvelles fonctionnalités et les correctifs de bugs.
---
## Licence
MIT — voir [LICENSE](LICENSE)
---
Projet réalisé par ServOMorph avec ClaudeCode pour SérénIA Tech :
https://serenia-tech.fr/
Date : 26 avril 2026 (v2.4.3)
---
## Contribuer
Les contributions sont les bienvenues ! Consulter [CONTRIBUTING.md](CONTRIBUTING.md) pour démarrer.