Sai già come scrivere una procedura e affidarla a un modello. La novità qui è che l'esecuzione non avviene sul tuo laptop: succede nel cloud, sugli account reali del tuo team, su un trigger, davanti ai tuoi colleghi.
Quindi salta la panoramica. Quasi tutto ciò che hai già costruito trova posto qui — ha solo un nome diverso.
| Cosa hai ora | Cosa diventa in Okou |
|---|---|
CLAUDE.md / AGENTS.md | Le Istruzioni di un agente — le sue direttive permanenti |
Una skill / SKILL.md | Un workflow di proprietà di quell'agente |
| Un server MCP che esegui | Un connettore personalizzato, dove il tuo workspace ha MCP abilitato |
| API key e variabili d'ambiente nella tua shell | Connettori — il segreto resta fuori dal modello |
cron più uno script sul tuo laptop | Un'automazione sul workflow |
| Più tab del terminale | Più esecuzioni concorrenti, acquistate per workspace |
| Il tuo abbonamento Claude o Codex | Rimane tuo — collegalo in Impostazioni → Modelli |
Inizia rimuovendo le due cose che altrimenti ti farebbero pagare due volte per l'inferenza e riscrivi ciò che hai già.
1. Esegui sull'abbonamento che già paghi
Okou può instradare le chiamate ai modelli tramite il tuo account Claude o Codex, sia su piani Free che a pagamento, se il tuo account provider lo supporta.
Ci sono due parti in questo processo, e persone diverse se ne occupano.
Un admin sceglie il percorso
In Impostazioni → Modelli, un admin del workspace decide come viene servito ciascun modello. Due delle opzioni sono:
- Abbonamento Claude — ogni membro collega il proprio piano Pro, Max o Team.
- Abbonamento Codex — ogni membro collega il proprio piano Pro o Team.
La policy decide il percorso, non il selettore del modello — quindi se un modello non è impostato su uno di questi, la tua connessione personale non lo servirà.
Colleghi il tuo account personale
In Impostazioni → Modelli, nella sezione Personale — usata solo nelle tue esecuzioni, con le tue credenziali:
- Claude Code OAuth — collega tramite login Claude Code per i percorsi modello basati su Claude. Okou apre una pagina di approvazione Claude; approva Okou lì, copia il codice di autorizzazione che ti viene mostrato e incollalo nella finestra di dialogo.
- ChatGPT (Codex) — collega tramite login dispositivo Codex. Okou copia un codice dispositivo e apre la pagina di approvazione; incolla il codice su OpenAI, approva l'accesso e lascia la finestra di dialogo aperta mentre Okou completa la connessione.
Puoi collegare più di un account per provider e impostarne uno come attivo. Una volta collegato, il menu del tuo account mostra quanto resta di ciascuna finestra di abbonamento — la finestra di 5 ore e la finestra settimanale — così puoi vedere un limite in arrivo prima che una lunga esecuzione lo raggiunga.
Tre cose da sapere prima di iniziare:
- Puoi portare il tuo provider su piani Free e a pagamento; il tuo account provider deve supportare il percorso selezionato.
- Un piano ChatGPT gratuito non può usare Codex tramite Okou. È richiesto Plus o Pro.
- Qualunque sia il percorso scelto, le chiamate agli strumenti, la generazione e l'archiviazione vengono comunque scalate dai crediti Okou. L'abbonamento copre il ragionamento, non l'esecuzione.
Il selettore modello accanto al compositore chat sceglie un modello; non sovrascrive il percorso assegnato dalla policy a quel modello. Il modello vive anche sul thread della chat, non sull'agente né sul workflow — vedi Modelli.
2. Porta le tue competenze come workflow
Quello che chiami skill, Okou lo chiama workflow: una procedura nominata con una descrizione che indica quando si applica, un'istruzione che spiega come svolgere il lavoro e file opzionali allegati. Un SKILL.md che hai già scritto è, quasi riga per riga, un'istruzione di workflow.
Il modo più veloce per trasferirne uno è consegnarlo in chat. Non devi riscriverlo né eseguire nulla:
- Trascina il file. Trascina il tuo
SKILL.mddirettamente nella chat — insieme a checklist, template o file di riferimento che lo accompagnavano. - Oppure fornisci il link a Okou. Incolla l'URL GitHub della cartella della skill e lascia che Okou legga tutto da solo.
Poi indica cosa vuoi che venga fatto:
"Ecco la skill che uso in Claude Code. Creane un workflow su questo agente. Mantieni la procedura, ma sostituisci i percorsi file locali e i passaggi shell con connettori, e dimmi cosa non può ancora raggiungere."

Okou legge il file, propone nome, descrizione e istruzione, e ti mostra il risultato prima di salvare.
Quattro differenze da sistemare durante la migrazione
- Un workflow appartiene a un solo agente, e può accedere solo ai connettori autorizzati per quell'agente. Una skill locale eredita ciò che la tua shell può raggiungere; qui non è così. Se un workflow migrato non vede Gmail, controlla l'autorizzazione dell'agente, non l'istruzione.
- Il nome è uno slug minuscolo —
triage-bug-report, da 2 a 64 caratteri. Invocalo esplicitamente con/triage-bug-reportnella chat dell'agente proprietario, oppure descrivi il lavoro e lascia che Okou lo abbini alla descrizione. Una descrizione precisa fa sì che il workflow si attivi da solo. - I nuovi workflow sono privati per impostazione predefinita. Renderlo pubblico nel workspace è una scelta consapevole, non una conseguenza del salvataggio. Due agenti possono avere la stessa procedura e produrre risultati diversi, perché ciascuno ha la propria voce e i propri permessi.
- Le credenziali non viaggiano. Qualsiasi variabile d'ambiente o chiave in una skill locale diventa invece un connettore, così il segreto resta sulla piattaforma e fuori dalla portata del modello. Se nessun connettore nativo è adatto, crea un connettore personalizzato invece di incollare una chiave in un'istruzione.
Una cosa che resta invariata: i file supplementari. Template, checklist, linee guida di brand e dati di riferimento si allegano al workflow come stavano accanto al tuo SKILL.md.
Il tuo CLAUDE.md è l'agente, non un workflow
Le skill diventano workflow. Le regole permanenti che tieni in CLAUDE.md o AGENTS.md — tono, stile della casa, cosa non fare mai, quando fermarsi e chiedere — appartengono invece all'agente, sotto Istruzioni. È ciò che ogni workflow di quell'agente eredita.

Incolla il file e chiedi a Okou di integrarlo nelle istruzioni dell'agente. Suddividilo come è suddiviso il prodotto: tutto ciò che riguarda come lavoriamo va sull'agente; tutto ciò che riguarda come svolgere un compito specifico diventa un workflow.
3. Usa le parti che una CLI locale non ha
Con il percorso del modello e le tue procedure pronte, il resto di Okou è ciò che il tuo laptop non può fare:
- Connettori — servizi autorizzati che il tuo agente può leggere e scrivere, con la credenziale custodita al confine di rete e ogni chiamata visibile nel log delle esecuzioni. Questo sostituisce la pila di token personali nel profilo della tua shell.
- Connettori personalizzati — per l'API interna senza connettore nativo. Un admin registra i prefissi HTTPS e l'autenticazione una sola volta. Dove il workspace lo consente, un endpoint HTTP MCP Streamable può essere registrato allo stesso modo, così un server che già esponi a Claude Code è raggiungibile anche qui.
- Esecuzioni concorrenti — una dimensione del workspace che puoi aumentare, invece di una seconda tab del terminale che devi ricordarti di aver lasciato aperta. Un lavoro lungo non blocca più uno breve.
- Automazioni — un trigger collegato a un workflow: una pianificazione, una nuova email, una pull request unita, un evento in calendario, un webhook. Questa è la parte che trasforma una procedura in un collega, invece che in un comando da ricordare.
- Agenti — un'identità persistente con proprie istruzioni, tono e permessi sui connettori, così il comportamento resta prevedibile tra esecuzioni e tra persone.
- Integrazioni — lo stesso agente raggiungibile da Slack, Telegram o dal web, invece che da un solo terminale su una sola macchina.

4. Condividilo, invece di tenerlo in un dotfile
La vera differenza rispetto a una configurazione locale è che altre persone possono usare ciò che hai costruito — anche chi non aprirà mai un terminale.
- Rendi l'agente Pubblico e pubblica il workflow che vuoi che il team esegua per primo.
- Rimuovi credenziali e dati temporanei da istruzioni e file prima di pubblicare.
- Invita i colleghi da Impostazioni → Persone → Aggiungi membro, con Member come ruolo predefinito. Vedi Invita colleghi.
- Ogni membro collega i propri account e il proprio abbonamento Claude o Codex. Nessuno condivide un login.
I passaggi da 3 a 6 di Per i nuovi utenti spiegano in dettaglio come costruire un agente, pubblicare un workflow e pianificarlo. La meccanica è la stessa; solo il punto di partenza era diverso.
Dove andare dopo
- Modelli — instradamento, il tuo abbonamento e quanto costa ogni modello.
- Workflow — anatomia, proprietà, visibilità e come Okou ne seleziona uno.
- Automazioni — pianificazioni, email, GitHub, calendario e trigger webhook.
- Permessi — cosa può toccare un agente e come restringerlo.
- Connettori personalizzati — per l'API interna senza connettore nativo.

