Voltar para a documentaçãoPrimeiros passos

Para usuários do Claude Code e Codex

Direcione execuções pela sua assinatura Claude ou Codex e leve suas habilidades para fluxos de trabalho.

Última atualização em 29 de outubro de 2026 · 8 min read

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 hojeNo que se torna no Okou
CLAUDE.md / AGENTS.mdAs Instruções de um agente — suas diretrizes permanentes
Uma habilidade / SKILL.mdUm fluxo de trabalho pertencente a esse agente
Um servidor MCP que você executaUm conector personalizado, onde seu workspace tem MCP habilitado
Chaves de API e variáveis de ambiente no seu shellConectores — o segredo fica fora do modelo
cron mais um script no seu laptopUma automação no fluxo de trabalho
Mais abas no terminalMais execuções simultâneas, compradas por workspace
Sua assinatura Claude ou CodexContinua 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.md direto 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."

Um SKILL.md anexado no compositor de chat do Okou, com a instrução para transformá-lo em fluxo de trabalho

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

A aba Instruções de um agente, onde vivem as diretrizes permanentes

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.

Registrando um conector personalizado: nome de exibição, prefixos HTTPS permitidos e autenticação

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