Cowork Connector – Automazione per Claude
Progetto open source MIT che accoda task in linguaggio naturale per Claude Cowork, eseguiti dentro l'abbonamento durante sessioni programmate, senza chiamare le API di Claude a consumo.
---
🎯 La Sfida: Non Pagare Claude Due Volte
Claude Cowork funziona benissimo finché resti dentro il suo ecosistema. Il problema arriva quando devi far reagire il sistema a qualcosa che succede fuori dalla sessione — un evento sul tuo sito, un servizio online, un file nuovo, un task ricorrente da eseguire in autonomia.
La strada standard, in quel caso, è passare dalle API di Claude: si pagano a consumo, token dopo token, in aggiunta all'abbonamento Cowork. È qui che nasce il paradosso: paghi lo stesso vendor due volte, per lo stesso lavoro. Un abbonamento mensile che già copre Claude, più una seconda fattura a consumo per farlo reagire dall'esterno.
- Costi crescenti: ogni chiamata alle API consuma token, oltre all'abbonamento che stai già pagando.
- Complessità inutile: gestione di chiavi API, retry, rate limit, per un lavoro che Claude Cowork potrebbe già svolgere da solo con gli strumenti che ha a disposizione nella sessione.
Il pubblico che sente più forte questo problema è chi ha un sito o un servizio online che oggi chiama le API di Claude e vorrebbe invece sfruttare l'abbonamento Cowork che paga già.
La domanda chiave: se Claude Cowork ha già accesso a strumenti e sessioni programmate tramite la skillschedule, perché pagare di nuovo le API dello stesso Claude per fargli eseguire compiti che potrebbe già fare in sessione, semplicemente sapendo cosa fare e quando?
---
💡 La Soluzione: Una Coda di Task in Linguaggio Naturale
Cowork Connector risponde a questa domanda con un'architettura minimale: un sistema di coda dove si accodano istruzioni in linguaggio naturale, che Claude preleva ed esegue durante le sessioni programmate, usando esclusivamente gli strumenti già disponibili nel progetto Cowork. I task girano così dentro l'abbonamento, tramite la coda, invece che tramite API a consumo.
Come funziona, in sintesi:- Si scrive un'istruzione in linguaggio naturale (es. "controlla la cartella X e genera un riepilogo").
- Il task viene accodato — in locale via SQLite o su un server remoto tramite
core/tasks.php. - Alla sessione schedulata successiva, Claude preleva il task, lo esegue con gli strumenti disponibili e ne registra l'esito.
- Stato, log e tentativi restano tracciati per ogni singolo task.
---
🚀 Funzionalità Chiave
Due Backend, Secondo l'Esigenza
Backend locale — Python 3 (solo libreria standard) + SQLite, tutto dentro la cartella del progetto Cowork. Zero deploy: la scelta più rapida per flussi interni, senza esporre nulla verso l'esterno. Backend remoto — PHP 7.4+ + SQLite su un server esterno proprio, concore/tasks.php caricato via FTP/SFTP e protetto da un token lungo e casuale (32+ caratteri) generato durante il setup. Necessario quando sistemi esterni (un sito, un webhook, un altro processo) devono accodare task per Claude Cowork da fuori il progetto locale.
Installazione Guidata da un Wizard Conversazionale
Non serve seguire una procedura manuale: l'installazione è conversazionale. Apri un progetto Claude con una cartella dedicata e scrivi il prompt "installa il connettore Claude che trovi su questo link: github.com/StChannelIT/cowork-connector e inizia la configurazione". Il file CLAUDE.md del repo istruisce Claude a fare da wizard e a guidarti in 5 fasi: connessione al progetto, scelta di dove vive la coda (locale o remota), definizione dei task (action_type), configurazione del task pianificato con la skill schedule e chiusura. L'installazione manuale (git clone + CLI) resta disponibile come nota per utenti avanzati.
Coda Atomica e Tracciamento Completo
Ogni task viene prelevato in modo esclusivo da un solo ciclo di esecuzione: se più cicli schedulati si sovrappongono, nessun task viene eseguito due volte. Ogni esecuzione mantiene stato (in coda, in esecuzione, completata, fallita), log testuale, timestamp e un numero di tentativi configurabile in caso di errore.
Protocollo action_type Personalizzabile
Non esiste un elenco fisso di categorie di task: si definisce liberamente il protocollo action_type più adatto al proprio flusso di lavoro — report, notifiche, sincronizzazioni, pubblicazioni — e si istruisce Claude su come comportarsi per ciascun tipo, tramite il file CLAUDE.md del progetto.
Integrazione con la Skill schedule
Cowork Connector non sostituisce lo scheduling di Claude Cowork: si integra con la skill schedule già disponibile, che fa partire i cicli ricorrenti durante i quali la coda viene letta ed eseguita.
---
🛠️ Stack Tecnologico
- Python 3 (libreria standard) — client e coda del backend locale
- PHP 7.4+ — API
core/tasks.phpdel backend remoto - SQLite — persistenza della coda, sia locale sia remota
- Claude Cowork — motore di esecuzione dei task, tramite la skill
schedule
---
📦 Open Source, Licenza MIT
Cowork Connector non è un prodotto in vendita: è uno strumento che uso ogni giorno, reso pubblico perché il problema che risolve — smettere di pagare Claude due volte, l'abbonamento e poi le sue API a consumo — è comune a chiunque usi Cowork per lavoro reale.
La licenza MIT permette di usare, modificare e integrare il codice anche in progetti commerciali, mantenendo l'avviso di copyright originale. Contributi, issue e pull request sono benvenuti.
Codice pubblico · Licenza MIT · Contributi benvenuti
---
📞 Vuoi Automatizzare Claude Cowork Nel Tuo Progetto?
Se usi Claude Cowork per il lavoro quotidiano — o hai un sito che oggi chiama le API di Claude a consumo — e vuoi far girare quei task dentro l'abbonamento che già paghi, Cowork Connector è pronto: basta aprire un progetto Claude e chiedergli di installare il connettore dal repo, poi il wizard fa il resto. Ho scritto anche una guida pratica passo-passo e un articolo che racconta il ragionamento dietro il progetto: