Torna alla documentazionePer iniziare

Per utenti Claude Code e Codex

Instrada le esecuzioni tramite il tuo abbonamento Claude o Codex e trasferisci le tue competenze nei workflow.

Ultimo aggiornamento 29 ottobre 2026 · 8 min read

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 oraCosa diventa in Okou
CLAUDE.md / AGENTS.mdLe Istruzioni di un agente — le sue direttive permanenti
Una skill / SKILL.mdUn workflow di proprietà di quell'agente
Un server MCP che eseguiUn connettore personalizzato, dove il tuo workspace ha MCP abilitato
API key e variabili d'ambiente nella tua shellConnettori — il segreto resta fuori dal modello
cron più uno script sul tuo laptopUn'automazione sul workflow
Più tab del terminalePiù esecuzioni concorrenti, acquistate per workspace
Il tuo abbonamento Claude o CodexRimane 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.md direttamente 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."

Un file SKILL.md allegato nel compositore chat di Okou, con l'istruzione di trasformarlo in un workflow

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-report nella 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.

La scheda Istruzioni di un agente, dove vivono le direttive permanenti

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.

Registrazione di un connettore personalizzato: un nome visualizzato, i prefissi HTTPS che può chiamare e la sua autenticazione

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.