Você já sabe como escrever um procedimento e entregá-lo a um modelo. O que muda aqui é que a execução não acontece no seu laptop: ela ocorre na nuvem, usando as contas reais da sua equipe, por um gatilho, diante dos seus colegas.
Então, pode pular o tour. Quase tudo o que você já construiu tem lugar aqui — só muda de nome.
| O que você tem hoje | No que se torna no Okou |
|---|---|
CLAUDE.md / AGENTS.md | As Instruções de um agente — suas diretrizes permanentes |
Uma habilidade / SKILL.md | Um fluxo de trabalho pertencente a esse agente |
| Um servidor MCP que você executa | Um conector personalizado, onde seu workspace tem MCP habilitado |
| Chaves de API e variáveis de ambiente no seu shell | Conectores — o segredo fica fora do modelo |
cron mais um script no seu laptop | Uma automação no fluxo de trabalho |
| Mais abas no terminal | Mais execuções simultâneas, compradas por workspace |
| Sua assinatura Claude ou Codex | Continua sendo sua — conecte em Configurações → Modelos |
Comece removendo os dois itens que fariam você pagar pela inferência duas vezes e reescreva o que já possui.
1. Execute na assinatura que você já paga
O Okou pode direcionar chamadas de modelo pela sua própria conta Claude ou Codex nos planos Free e pagos, se sua conta do provedor permitir.
São duas etapas, feitas por pessoas diferentes.
Um administrador escolhe a rota
Em Configurações → Modelos, um administrador do workspace decide como cada modelo será servido. Duas das opções são:
- Assinatura Claude — cada membro conecta seu próprio plano Pro, Max ou Team.
- Assinatura Codex — cada membro conecta seu próprio plano Pro ou Team.
A política define a rota, não o seletor de modelo — então, se um modelo não estiver configurado para uma dessas opções, sua conexão pessoal não será usada para servi-lo.
Você conecta sua própria conta
Em Configurações → Modelos, na seção Pessoal — usada apenas nas suas execuções, com suas próprias credenciais:
- Claude Code OAuth — conecte usando o login do Claude Code para rotas de modelo baseadas no Claude. O Okou abre uma página de aprovação do Claude; aprove o Okou lá, copie o código de autorização exibido e cole de volta no diálogo.
- ChatGPT (Codex) — conecte usando o login por dispositivo do Codex. O Okou copia um código de dispositivo e abre a página de aprovação; cole o código no OpenAI, aprove o acesso e mantenha o diálogo aberto enquanto o Okou finaliza a conexão.
Você pode conectar mais de uma conta por provedor e marcar uma como ativa. Depois de conectar, o menu da sua conta mostra quanto resta de cada janela de assinatura — a janela de 5 horas e a semanal — assim, você vê o limite antes de uma execução longa atingi-lo.
Três pontos importantes antes de começar:
- Você pode usar seu próprio provedor nos planos Free e pagos; sua conta do provedor deve suportar a rota escolhida.
- Um plano gratuito do ChatGPT não pode usar Codex via Okou. É necessário Plus ou Pro.
- Independentemente da rota do modelo, chamadas de ferramentas, geração e armazenamento continuam sendo descontados dos créditos Okou. A assinatura cobre o raciocínio, não a execução.
O seletor de modelo ao lado do compositor de chat escolhe um modelo; ele não substitui a rota definida pela política para aquele modelo. O modelo também fica na conversa, não no agente nem no fluxo de trabalho — veja Modelos.
2. Leve suas habilidades como fluxos de trabalho
O que você chama de habilidade, o Okou chama de fluxo de trabalho: um procedimento nomeado com uma descrição de quando se aplica, uma instrução de como executar e arquivos opcionais anexados. Um SKILL.md que você já escreveu é, quase linha por linha, uma instrução de fluxo de trabalho.
A forma mais rápida de migrar é entregar pelo chat. Não precisa reescrever nem executar nada:
- Solte o arquivo. Arraste seu
SKILL.mddireto para o chat — junto com checklists, modelos ou arquivos de referência que estavam ao lado. - Ou envie o link para o Okou. Cole a URL do GitHub da pasta da habilidade e deixe o Okou ler tudo sozinho.
Depois, diga o que deseja fazer com ela:
"Aqui está a habilidade que uso no Claude Code. Crie um fluxo de trabalho a partir dela neste agente. Mantenha o procedimento, mas substitua os caminhos de arquivos locais e comandos de shell por conectores, e me diga o que ainda não é possível acessar."

O Okou lê o arquivo, sugere nome, descrição e instrução, e mostra o resultado antes de salvar.
Quatro diferenças que vale a pena ajustar ao migrar
- Um fluxo de trabalho pertence a exatamente um agente, e só pode acessar os conectores autorizados para esse agente. Uma habilidade local herda tudo o que seu shell acessa; aqui não. Se um fluxo migrado não enxergar o Gmail, verifique a autorização do agente, não a instrução.
- O nome é um slug minúsculo —
triage-bug-report, de 2 a 64 caracteres. Invoque explicitamente com/triage-bug-reportno chat do agente proprietário, ou apenas descreva o trabalho e deixe o Okou combinar pela descrição. Uma descrição precisa faz o fluxo disparar sozinho. - Novos fluxos de trabalho são privados por padrão. Tornar um público para o workspace é uma ação deliberada, não um efeito colateral ao salvar. Dois agentes podem ter o mesmo procedimento e gerar resultados diferentes, pois cada um tem sua voz e permissões.
- Credenciais não viajam. Qualquer variável de ambiente ou chave em uma habilidade local vira um conector, mantendo o segredo na plataforma e fora do modelo. Se não houver conector nativo, crie um conector personalizado em vez de colar uma chave na instrução.
O que permanece igual: arquivos suplementares. Modelos, checklists, guias de marca e dados de referência são anexados ao fluxo de trabalho da mesma forma que ficavam ao lado do seu SKILL.md.
Seu CLAUDE.md é o agente, não um fluxo de trabalho
Habilidades viram fluxos de trabalho. As regras permanentes que você mantém em CLAUDE.md ou AGENTS.md — tom, estilo, o que nunca fazer, quando parar e perguntar — pertencem ao agente, em Instruções. É isso que todo fluxo de trabalho desse agente herda.

Cole o arquivo e peça ao Okou para incorporar nas instruções do agente. Separe conforme o produto: tudo sobre como trabalhamos vai no agente; tudo sobre como executar uma tarefa específica vira fluxo de trabalho.
3. Use o que um CLI local não oferece
Com a rota do modelo e seus procedimentos prontos, o restante do Okou é o que seu laptop não faz:
- Conectores — serviços autorizados que seu agente pode ler e escrever, com a credencial protegida na borda da rede e cada chamada registrada no log de execução. Isso substitui o monte de tokens pessoais no seu shell.
- Conectores personalizados — para APIs internas sem conector nativo. Um admin registra os prefixos HTTPS e a autenticação uma vez. Onde seu workspace permite, um endpoint HTTP MCP pode ser registrado do mesmo modo, tornando acessível aqui um servidor já exposto ao Claude Code.
- Execuções simultâneas — uma dimensão do workspace que você pode aumentar, em vez de abrir outra aba no terminal e esquecer. Um trabalho longo não bloqueia um curto.
- Automações — um gatilho ligado ao fluxo de trabalho: agenda, novo e-mail, pull request mesclado, evento de calendário, webhook. Isso transforma um procedimento em colega, não só em comando para lembrar de rodar.
- Agentes — identidade persistente com instrução, tom e permissões próprias, garantindo comportamento previsível entre execuções e pessoas.
- Integrações — o mesmo agente acessível pelo Slack, Telegram ou web, não só por um terminal em uma máquina.

4. Compartilhe, em vez de guardar em um dotfile
A grande diferença para um setup local é que outras pessoas podem usar o que você construiu — inclusive quem nunca abrirá um terminal.
- Torne o agente Público e publique o fluxo de trabalho que deseja que a equipe use primeiro.
- Remova credenciais e dados pontuais das instruções e arquivos antes de publicar.
- Convide colegas em Configurações → Pessoas → Adicionar membro, com Member como papel padrão. Veja Convidar colegas.
- Cada membro conecta suas próprias contas e assinatura Claude ou Codex. Ninguém compartilha login.
Os passos 3 a 6 de Para novos usuários detalham como criar um agente, publicar um fluxo de trabalho e agendar. A mecânica é igual; só o ponto de partida muda.
Para onde ir depois
- Modelos — roteamento, sua assinatura e o custo de cada modelo.
- Fluxos de trabalho — anatomia, propriedade, visibilidade e como o Okou escolhe.
- Automações — agendas, e-mail, GitHub, calendário e webhooks.
- Permissões — o que um agente pode acessar e como restringir.
- Conectores personalizados — para APIs internas sem conector nativo.

