Você já sabe como escrever um procedimento e entregá-lo a um modelo. O que há de novo aqui é que a execução não fica no seu laptop: ela acontece na nuvem, nas contas reais da sua equipe, acionada por um gatilho, diante dos seus colegas.
Então pule o tour. Quase tudo o que você já construiu tem um lugar aqui — só recebe outro nome.
| O que você tem agora | Em que isso se torna no Okou |
|---|---|
CLAUDE.md / AGENTS.md | Instruções pessoais no My Okou; as instruções do Agent selecionado em Legacy Agents |
Uma skill / SKILL.md | Um fluxo de trabalho para o método reutilizável |
| Um servidor MCP que você executa | Um conector personalizado, quando seu workspace tiver 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 do terminal | Mais execuções concorrentes, compradas por workspace |
| Sua assinatura do Claude ou Codex | Continua sendo sua — conecte-a em Settings → Models |
Comece removendo as duas coisas que, de outro modo, fariam você pagar duas vezes pela inferência e reescrever o que você já tem.
Qual experiência você está usando?
Esta documentação cobre as duas experiências. Se Settings → Personal → My Okou estiver disponível, siga as etapas de My Okou. Se você usa uma página de Agents com New agent, siga as etapas de Legacy Agents. A disponibilidade pode variar entre membros; esta documentação não altera a sua experiência.
Em qualquer uma das experiências, você pode executar vários chats ou tarefas ao mesmo tempo, reutilizar fluxos de trabalho e compartilhar com sua equipe o trabalho revisado. Um subagente de runtime é uma ferramenta de execução, não um perfil de produto separado que você precise criar.
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 a conta do seu provedor oferecer suporte a isso.
Há duas metades nisso, e pessoas diferentes fazem cada uma delas.
Um admin escolhe a rota
Em Settings → Models, um admin do workspace decide como cada modelo é 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 decide a rota, não o seletor de modelo — então, se um modelo não estiver definido para uma dessas opções, sua conexão pessoal não será a que o servirá.
Você conecta sua própria conta
Em Settings → Models, na seção Personal — usada somente nas suas execuções, com suas próprias credenciais:
- Claude Code OAuth — conecte com o login do Claude Code para rotas de modelo com 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-o de volta no diálogo.
- ChatGPT (Codex) — conecte com o login de 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 deixe o diálogo aberto enquanto o Okou conclui a conexão.
Você pode conectar mais de uma conta por provedor e marcar uma como ativa. Depois de conectado, o menu da sua conta mostra quanto de cada janela de assinatura ainda resta — a janela de 5 horas e a semanal — para que você veja um limite se aproximando antes que uma execução longa esbarre nele.
Três coisas para saber antes de começar:
- Você pode usar seu próprio provedor nos planos Free e pagos; a conta do seu provedor precisa oferecer suporte à rota selecionada.
- Um plano ChatGPT gratuito não pode usar o Codex pelo Okou. É necessário Plus ou Pro.
- Seja qual for a rota que um modelo tomar, chamadas de ferramenta, geração e armazenamento ainda são cobrados nos créditos do Okou. A assinatura cobre o pensamento, não a execução.
O seletor de modelo ao lado do compositor do chat escolhe um modelo; ele não substitui a rota que a política atribuiu a esse modelo. O modelo também fica na conversa do chat, não no agent e não no fluxo de trabalho — veja Modelos.
2. Leve suas habilidades para workflows
O que você chama de skill, o Okou chama de fluxo de trabalho: um procedimento nomeado com uma descrição que diz quando ele se aplica, uma instrução que diz como fazer o trabalho e arquivos opcionais empacotados junto. Uma SKILL.md que você já escreveu é, quase linha por linha, uma instrução de fluxo de trabalho.
A maneira mais rápida de mover uma delas é entregá-la no chat. Você não precisa reescrevê-la, e não precisa executar nada:
- Solte o arquivo aqui. Arraste sua
SKILL.mddiretamente para o chat — junto com quaisquer checklists, templates ou arquivos de referência que estavam ao lado dela. - Ou passe o link para o Okou. Cole a URL do GitHub da pasta da skill e deixe o Okou ler tudo por conta própria.
Depois diga o que você quer que seja feito com ela:
"Aqui está a skill que eu uso no Claude Code. Crie um Workflow privado a partir dela neste workspace. Mantenha o procedimento, mas substitua os caminhos de arquivos locais e as etapas de shell por connectors, e me diga o que ela ainda não consegue alcançar."
O Okou lê o arquivo, elabora o nome, a descrição e a instrução, e mostra o resultado antes de salvar.
Quatro diferenças que vale corrigir ao portar
- Os fluxos de trabalho do My Okou vivem no workspace. Os fluxos de trabalho privados pertencem a você; os fluxos de trabalho públicos são compartilhados dentro do workspace. Os fluxos de trabalho legados continuam vinculados a um único Agent. A execução usa suas próprias contas conectadas e permissões; o acesso de um shell local não é transferido. Verifique a conexão real e as permissões nomeadas quando uma ferramenta não estiver disponível.
- O nome é um slug em minúsculas —
triage-bug-report, entre 2 e 64 caracteres. Chame-o explicitamente com/triage-bug-reportem um chat onde o fluxo de trabalho esteja disponível, ou apenas descreva o trabalho e deixe o Okou combiná-lo pela descrição. Uma descrição precisa é o que faz um fluxo de trabalho ser acionado sozinho. - Novos fluxos de trabalho são privados por padrão. Torná-los públicos para o workspace é uma etapa deliberada, não um efeito colateral de salvar. No My Okou, seu fluxo de trabalho privado com o mesmo nome tem precedência sobre a versão pública. Em Legacy Agents, verifique também a visibilidade do Agent proprietário.
- Credenciais não viajam. Tudo o que era uma variável de ambiente ou uma chave em uma skill local vira um conector em vez disso, para que o segredo fique na plataforma e fora do alcance do modelo. Se nenhum conector de primeira parte servir, crie um conector personalizado em vez de colar uma chave em uma instrução.
Uma coisa que é transferida sem alteração: arquivos suplementares. Templates, checklists, guias de marca e dados de referência são anexados ao fluxo de trabalho da mesma forma que ficavam ao lado da sua SKILL.md.
Separe Instructions pessoais de métodos de tarefa
Skills viram fluxos de trabalho. Com o My Okou, suas preferências pessoais ficam em Settings → Personal → My Okou → Instructions e se aplicam somente a você neste workspace. Regras reutilizáveis da equipe e métodos de tarefa pertencem aos fluxos de trabalho do workspace. Salvar instruções pessoais afeta o próximo trabalho que o Okou iniciar, não o trabalho já em andamento. Com Legacy Agents, edite as Instructions do Agent selecionado em vez disso.
Somente Legacy Agents:
Peça ao Okou para separar as preferências pessoais dos procedimentos reutilizáveis antes de salvar qualquer coisa. As Instructions pessoais não viram política do workspace e não podem alterar permissões de conta.
3. Depois use as partes que uma CLI local não tem
Com a rota do modelo e seus procedimentos no lugar, o restante do Okou é a parte que seu laptop não consegue fazer:
- Conectores — serviços autorizados que seu agent pode ler e escrever, com a credencial mantida na borda da rede e cada chamada visível no log de execução. Isso substitui a pilha de tokens de acesso pessoais no seu perfil de shell.
- Conectores personalizados — para a API interna que não tem conector de primeira parte. Um admin registra os prefixos HTTPS e a autenticação uma vez. Onde seu workspace tiver isso habilitado, um endpoint MCP de HTTP streamable pode ser registrado da mesma forma, para que um servidor que você já expõe ao Claude Code também fique acessível aqui.
- Execuções concorrentes — uma dimensão do workspace que você pode aumentar, em vez de uma segunda aba do terminal que você precisa lembrar que deixou aberta. Um trabalho longo deixa de bloquear um curto.
- Automações — um gatilho anexado a um fluxo de trabalho: um agendamento, um e-mail novo, um pull request mesclado, um evento de calendário, um webhook. Esta é a parte que transforma um procedimento em um colega de equipe, em vez de um comando que você precisa lembrar de executar.
- Instructions and experience modes — preferências pessoais para My Okou, com a orientação separada do perfil legado de Agent preservada.
- Integrações — o mesmo agent acessível pelo Slack, Telegram ou web, em vez de apenas um terminal em uma máquina.
4. Compartilhe, em vez de mantê-lo em um dotfile
A diferença real em relação a uma configuração local é que outras pessoas podem usar o que você construiu — inclusive pessoas que nunca abrirão um terminal.
- My Okou: compartilhe um fluxo de trabalho público revisado. Legacy Agents: torne também público o Agent que o possui.
- Remova credenciais e dados pontuais da instrução e dos arquivos antes de fazer isso.
- Convide colegas de equipe em Settings → People → Add member, com Member como função padrão. Veja Convidar colegas de equipe.
- Cada membro conecta suas próprias contas e sua própria assinatura Claude ou Codex. Ninguém compartilha um login.
As etapas 3 a 6 de Para novos usuários cobrem instruções pessoais (ou a configuração legada do Agent), o compartilhamento de um fluxo de trabalho e o agendamento dele com mais detalhes. A mecânica é a mesma; só o ponto de partida era diferente.
Para onde ir em seguida
- Modelos — roteamento, sua própria assinatura e o custo de cada modelo.
- Fluxos de trabalho — anatomia, propriedade, visibilidade e como o Okou escolhe um.
- Automações — agendamentos, e-mail, GitHub, calendário e gatilhos de webhook.
- Permissões — o que um agent está autorizado a acessar e como restringir isso.
- Conectores personalizados — para a API interna que não tem conector de primeira parte.
