Per utenti di Claude Code e Codex

Sai già come scrivere una procedura e passarla a un modello. La novità qui è che l’esecuzione non vive sul tuo laptop: avviene nel cloud, sui veri account del tuo team, su un trigger, davanti ai tuoi colleghi.

Quindi salta il tour. Quasi tutto quello che hai già costruito ha qui una casa — solo che ha un nome diverso.

Inizia eliminando le due cose che altrimenti ti farebbero pagare due volte l’inferenza e riscriverebbero ciò che hai già.

Quale esperienza stai usando?

Questa documentazione copre entrambe le esperienze. Se Settings → Personal → My Okou è disponibile, segui i passaggi di My Okou. Se usi una pagina Agents con New agent, segui i passaggi di Legacy Agents. La disponibilità può differire tra membri; questa documentazione non cambia la tua esperienza.

In entrambe le esperienze, puoi eseguire più chat o attività contemporaneamente, riutilizzare i flussi di lavoro e condividere il lavoro revisionato con il tuo team. Un subagent di runtime è uno strumento di esecuzione, non un profilo prodotto separato che devi creare.

1. Esegui sull’abbonamento che già paghi

Okou può instradare le chiamate al modello tramite il tuo account Claude o Codex su piani Free e a pagamento, se il tuo account del provider lo supporta.

Ci sono due metà in questo, e le fanno persone diverse.

Un admin sceglie il percorso

In Settings → Models, un amministratore dello spazio di lavoro decide come viene servito ogni modello. Due delle opzioni sono:

• Claude subscription — ogni membro collega il proprio piano Pro, Max o Team.
• Codex subscription — 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 una di queste opzioni, la tua connessione personale non sarà quella che lo serve.

Colleghi il tuo account

In Settings → Models, nella sezione Personal — usata solo nelle tue esecuzioni, con le tue credenziali:

• Claude Code OAuth — connettiti con il login di Claude Code per i percorsi dei modelli basati su Claude. Okou apre una pagina di approvazione di Claude; approva Okou lì, copia il codice di autorizzazione che ti mostra e incollalo di nuovo nella finestra di dialogo.
• ChatGPT (Codex) — connettiti con il login del dispositivo di Codex. Okou copia un codice dispositivo e apre la pagina di approvazione; incolla il codice in OpenAI, approva l’accesso e lascia aperta la finestra di dialogo mentre Okou completa la connessione.

Puoi collegare più di un account per provider e marcarne uno attivo. Una volta collegato, il menu del tuo account mostra quanta parte di ciascuna finestra di abbonamento è rimasta — la finestra di 5 ore e quella settimanale — così puoi vedere arrivare un limite prima che una lunga esecuzione ci vada a sbattere contro.

Tre cose da sapere prima di iniziare:

• Puoi usare il tuo provider nei piani Free e a pagamento; il tuo account del provider deve supportare il percorso selezionato.
• Un piano ChatGPT gratuito non può usare Codex tramite Okou. È richiesto Plus o Pro.
• Qualunque percorso usi un modello, le chiamate agli strumenti, la generazione e l’archiviazione vengono comunque addebitate sui crediti di Okou. L’abbonamento copre il pensare, non il fare.

Il selettore del modello accanto al compositore della chat sceglie un modello; non sostituisce il percorso assegnato a quel modello dalla policy. Il modello vive anche sul thread della chat, non sull’agente e non sul workflow — vedi Modelli.

2. Porta le tue competenze nei workflow

Quello che tu chiami skill, Okou lo chiama workflow: una procedura con nome e una descrizione che dice quando si applica, un’istruzione che dice come svolgere il lavoro e file opzionali allegati insieme. Una SKILL.md che hai già scritto è, quasi riga per riga, un’istruzione del workflow.

Il modo più veloce per spostarne una è passarla in chat. Non devi riscriverla e non devi eseguire nulla:

• Trascina dentro il file. Trascina la tua SKILL.md direttamente nella chat — insieme a eventuali checklist, template o file di riferimento che le stavano accanto.
• Oppure dai a Okou il link. Incolla l’URL GitHub della cartella della skill e lascia che Okou legga tutto da solo.

Poi di’ cosa vuoi che ne faccia:

"Ecco la skill che uso in Claude Code. Creane un workflow privato in questo spazio di lavoro. Mantieni la procedura, ma sostituisci i percorsi dei file locali e i passaggi shell con i connector, e dimmi a cosa non può ancora accedere."

Okou legge il file, abbozza nome, descrizione e istruzione e ti mostra il risultato prima di salvarlo.

Quattro differenze da sistemare mentre fai il porting

• I workflow di My Okou vivono nello spazio di lavoro. I workflow privati appartengono a te; i workflow pubblici sono condivisi all’interno dello spazio di lavoro. I workflow legacy restano collegati a un solo agente. L’esecuzione usa i tuoi account collegati e le tue autorizzazioni; l’accesso di una shell locale non viene trasferito. Controlla la connessione effettiva e le autorizzazioni nominate quando uno strumento non è disponibile.
• Il nome è uno slug in minuscolo — triage-bug-report, 2 a 64 caratteri. Richiamalo esplicitamente con /triage-bug-report in una chat in cui il workflow è disponibile, oppure descrivi semplicemente il lavoro e lascia che Okou lo abbini alla descrizione. Una descrizione precisa è ciò che fa scattare un workflow da solo.
• I nuovi workflow sono privati per impostazione predefinita. Renderne uno pubblico per lo spazio di lavoro è un passaggio intenzionale, non un effetto collaterale del salvataggio. In My Okou, il tuo workflow privato con lo stesso nome ha precedenza sulla versione pubblica. Nei Legacy Agents, controlla anche la visibilità dell’agente proprietario.
• Le credenziali non si spostano. Tutto ciò che era una variabile d’ambiente o una chiave in una skill locale diventa invece un connector, così il segreto resta sulla piattaforma e fuori dalla portata del modello. Se nessun connector di prima parte è adatto, crea un custom connector invece di incollare una chiave in un’istruzione.

Una cosa che invece si trasferisce invariata: i file supplementari. Template, checklist, linee guida di branding e dati di riferimento si allegano al workflow nello stesso modo in cui stavano accanto alla tua SKILL.md.

Separa le Instructions personali dai metodi delle attività

Le skill diventano workflow. Con My Okou, le tue preferenze personali appartengono a Settings → Personal → My Okou → Instructions e si applicano solo a te in questo spazio di lavoro. Le regole di team riutilizzabili e i metodi delle attività appartengono ai workflow dello spazio di lavoro. Salvare le Instructions personali influisce sul lavoro successivo che Okou avvia, non sul lavoro già in corso. Con Legacy Agents, modifica invece le Instructions dell’agente selezionato.

Solo Legacy Agents:

Chiedi a Okou di separare le preferenze personali dalle procedure riutilizzabili prima di salvare qualsiasi cosa. Le Instructions personali non diventano policy dello spazio di lavoro e non possono cambiare le autorizzazioni degli account.

3. Poi usa le parti che un CLI locale non ha

Con il percorso del modello e le tue procedure al loro posto, il resto di Okou è la parte che il tuo laptop non può fare:

• Connettori — servizi autorizzati che il tuo agente può leggere e scrivere, con la credenziale tenuta al confine di rete e ogni chiamata visibile nel run log. Questo sostituisce la pila di token di accesso personali nel profilo della tua shell.
• Connettori personalizzati — per l’API interna che non ha un connector di prima parte. Un admin registra una volta i prefissi HTTPS e l’autenticazione. Dove il tuo spazio di lavoro lo ha abilitato, un endpoint MCP Streamable HTTP può essere registrato nello stesso modo, così anche un server che esponi già a Claude Code è raggiungibile qui.
• Esecuzioni concorrenti — una dimensione dello spazio di lavoro che puoi aumentare, invece di una seconda scheda del terminale che devi ricordarti di aver lasciato aperta. Un lavoro lungo smette di bloccarne uno breve.
• Automazioni — un trigger allegato a un workflow: una pianificazione, una nuova email, una pull request unita, un evento del calendario, un webhook. Questa è la parte che trasforma una procedura in un collega, invece che in un comando che devi ricordarti di eseguire.
• Instructions and experience modes — preferenze personali per My Okou, con la guida separata del profilo legacy dell’agente mantenuta.
• 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 — comprese persone che non apriranno mai un terminale.

• My Okou: condividi un workflow pubblico revisionato. Legacy Agents: rendi pubblico anche il suo agente proprietario.
• Rimuovi credenziali e dati una tantum dall’istruzione e dai file prima di farlo.
• Invita i colleghi da Settings → People → Add member, con Member come ruolo predefinito. Vedi Invita i membri del team.
• Ogni membro collega i propri account e il proprio abbonamento Claude o Codex. Nessuno condivide un login.

I passaggi 3 a 6 di Per i nuovi utenti coprono in modo più dettagliato le Instructions personali (o la configurazione legacy dell’agente), la condivisione di un workflow e la sua pianificazione. La meccanica è la stessa; era diverso solo il punto di partenza.

Dove andare dopo

• Modelli — routing, il tuo abbonamento personale e quanto ti costa ogni modello.
• Flussi di lavoro — anatomia, proprietà, visibilità e come Okou ne sceglie uno.
• Automazioni — pianificazioni, email, GitHub, calendario e trigger webhook.
• Autorizzazioni — a cosa è autorizzato ad accedere un agente e come limitarlo.
• Connettori personalizzati — per l’API interna che non ha un connector di prima parte.