Paseo com modelos do GetVibe
Configuração passo a passo do Paseo com o GetVibe: instale as CLIs, insira o config.json pronto, evite a reassociação de OAuth e verifique os gastos.
Configuração pronta
Gerado sob demanda a partir do nosso catálogo: o endereço da API, todos os modelos publicados com seus limites de contexto e saída e as configurações recomendadas. Ele não contém uma chave. O Paseo passa os valores de ambiente aos agentes literalmente, portanto o arquivo contém três placeholders PASTE-YOUR-GETVIBE-API-KEY-HERE — substitua-os pela sua chave (etapas abaixo).
# macOS / Linux
mkdir -p ~/.paseo
curl -fsSL https://getvibeapi.com/api/integrations/paseo.json -o ~/.paseo/config.json# Windows PowerShell
New-Item -ItemType Directory -Force "$HOME\.paseo" | Out-Null
Invoke-WebRequest https://getvibeapi.com/api/integrations/paseo.json -OutFile "$HOME\.paseo\config.json"- Modelo principal —
gpt-6.1-sol: excelente para programação agêntica, com um contexto amplo e preço moderado; o id simples mantém o failover entre canais ativado. - Tarefas pequenas —
deepseek-v4.1-flash: modelo capaz mais barato com um contexto de 1M, para títulos, resumos, mensagens de commit e compactação. - Streaming ativado, tempo limite de solicitação de 600 segundos e esforço de raciocínio médio: uma resposta com raciocínio longo leva minutos e, sem streaming, atinge o limite de espera.
- IDs de modelo sem sufixo em todos os lugares — isso mantém o failover automático para um canal saudável ativado.
?models= com IDs separados por vírgulas à URL.Paseo é um programa gráfico para Windows e macOS. Instale o aplicativo e depois configure o conjunto pronto com os três provedores do GetVibe: Codex, Claude Code e OpenCode. Uma linha de comando só é necessária para instalar essas três ferramentas CLI — não para instalar ou executar o Paseo.
1. Baixar e instalar o Paseo Desktop
Abra a página oficial paseo.sh/download e baixe a versão para o seu sistema:
| Parâmetro | Tipo | Descrição |
|---|---|---|
Windows | installer | Geralmente Intel / x64. Execute o Paseo-Setup-…-x64.exe baixado e siga o instalador. |
macOS | DMG | Apple Silicon — para Macs com chip M1/M2/M3/M4 ou mais recente; Intel — para Macs mais antigos. Abra o DMG e arraste o Paseo para Applications. |
Abra o Paseo pelo menu Iniciar no Windows ou pela pasta Aplicativos em um Mac. Na primeira inicialização, o app inicia seu próprio daemon local — não é necessário instalar o Paseo separadamente via npm nem digitar o comando paseo.
2. Instalar as CLIs dos provedores de que você precisa
O Paseo Desktop gerencia agentes, mas o Codex, o Claude Code e o OpenCode precisam estar instalados no seu sistema. Primeiro, instale a versão LTS atual do Node.js em nodejs.org e reabra o terminal depois.
Como abrir um terminal
Um terminal é uma janela na qual você digita comandos como texto. Para abrir um:
| Parâmetro | Tipo | Descrição |
|---|---|---|
Windows | PowerShell | Pressione Win + X → “Terminal” (ou “Windows PowerShell”). Ou: Win + R, digite powershell e pressione Enter. |
macOS | Terminal | Pressione Cmd + Space, digite Terminal e pressione Enter. |
Uma janela com um cursor piscando é aberta. Cole os comandos abaixo um de cada vez e pressione Enter após cada um. Para colar: clique com o botão direito ou pressione Ctrl + V no Windows, Cmd + V no macOS. A instalação leva de 1–3 minutos; mantenha a janela aberta enquanto ela é executada.
Instale as três CLIs:
npm install -g @openai/codex @anthropic-ai/claude-code opencode-aiVerifique se os comandos estão disponíveis:
codex --version
claude --version
opencode --version3. Conectar o config.json pronto
Baixe paseo-getvibe-config.json. Renomeie-o para config.json e coloque-o em:
| Parâmetro | Tipo | Descrição |
|---|---|---|
macOS / Linux | path | ~/.paseo/config.json |
Windows | path | %USERPROFILE%\.paseo\config.json |
A pasta .paseo começa com um ponto, portanto fica oculta por padrão. Se você não a vir, não crie uma nova: mostre os arquivos ocultos em vez disso:
| Parâmetro | Tipo | Descrição |
|---|---|---|
Windows | Explorador de arquivos | Cole %USERPROFILE%\.paseo na barra de endereços do Explorer e pressione Enter — a pasta será aberta mesmo quando estiver oculta. |
macOS | Finder | No Finder, pressione Cmd + Shift + G, digite ~/.paseo e pressione Enter. Mostre os arquivos ocultos: Cmd + Shift + . (ponto). |
.paseo ainda não existir — inicie o Paseo uma vez e encerre-o: ele criará a pasta sozinho. Isso é mais confiável do que criá-la manualmente.config.json nesta pasta é a maneira padrão de carregar provedores personalizados prontos.config.json.txt — a extensão fica oculta. No Explorer, ative “Exibir → Mostrar → Extensões de nomes de arquivo” e verifique se o nome é exatamente config.json. Esse é o motivo mais comum para o Paseo “não ver” a configuração.agents.providerspara o arquivo existente. Não substitua suas próprias configurações e provedores.4. Colar sua chave de API
Abra o arquivo em um editor de texto simples: no Windows, use o “Notepad” (clique com o botão direito no arquivo → “Open with” → “Notepad”); no macOS, use o “TextEdit” (clique com o botão direito → “Open With” → TextEdit). Não o abra no Word ou no Pages — eles adicionam formatação e o arquivo deixa de ser legível.
Substitua as três ocorrências de PASTE-YOUR-GETVIBE-API-KEY-HERE pela sua chave no painel do GetVibe e salve (Ctrl + S no Windows, Cmd + S no macOS). Cole a chave entre as aspas e mantenha as aspas. Não publique o arquivo finalizado nem o adicione ao Git.
5. Remover logins obsoletos
O Codex pode reutilizar um login salvo de “Sign in with ChatGPT”. Nesse caso, uma solicitação poderia ir silenciosamente direto para a OpenAI. O Claude Code com um token do GetVibe dá prioridade a ele em relação a uma assinatura salva, mas sair da conta também encerra qualquer sessão antiga do Apps Gateway. Execute os dois comandos uma vez:
codex logout
claude auth logoutgetvibe, seu endereço e sua chave. Não execute codex login --with-api-key com uma chave do GetVibe.6. Reiniciar e verificar tudo no Paseo
unknown variant auto_review, expected user or guardian_subagent. A correção principal: execute npm install -g @openai/codex@latest em um terminal, depois feche completamente o Paseo Desktop e abra-o novamente. Um único Restart daemon pode não ser suficiente para atualizar um aplicativo que já esteja em execução.- Reabra o Paseo Desktop.
- Abra Settings → Host → Overview e pressione Restart daemon.
- Abra Settings → Host → Providers. A lista agora deve exibir
Codex (GetVibe),Claude Code (GetVibe)eOpenCode (GetVibe). - Retorne ao workspace e crie um agente. No menu suspenso de modo/permissões na parte inferior do formulário do novo agente, escolha Permissões padrão. É uma opção temporária segura para iniciantes. Não escolha Revisão automática. A opção Acesso total permite que o agente execute ações sem as solicitações normais de confirmação e não é necessária para esta correção.
- Envie um teste curto:
Reply with a single word: ready.
config.json inteiro.7. Verificar para onde a solicitação foi
- Antes do teste, abra Uso e solicitações no painel do GetVibe.
- Envie um teste pelo Paseo e aguarde a resposta.
- Atualize a página: uma nova linha com o modelo escolhido e a cobrança deverá aparecer.
Solução de problemas
“Command not found”
Feche e reabra seu terminal. Se apenas uma CLI estiver ausente, execute novamente o comando de instalação dela na etapa 2. Você não precisa reinstalar o Paseo Desktop.
Revisão automática: variante desconhecida auto_review
Atualize o Codex com npm install -g @openai/codex@latest, encerre completamente o Paseo Desktop e abra-o novamente. Até que o problema de compatibilidade seja corrigido, selecione Default Permissions no menu suspenso de modo na parte inferior. Se uma sessão que já falhou não aplicar o novo modo, crie um novo agente ou guia e selecione-o antes de enviar.
401 ou um placeholder deixado no arquivo
Encontre e substitua as três ocorrências de placeholder, verifique as vírgulas e aspas e, em seguida, no Paseo, abra Configurações → Host → Visão geral → Reiniciar daemon.
Codex responde, mas nenhum gasto do GetVibe é exibido
Execute codex logout novamente, verifique codex login status, reinicie o daemon pelas Configurações e selecione apenas Codex (GetVibe).
Claude pede para fazer login ou mostra Gateway
Execute claude auth logout, verifique sua chave e reinicie o provedor claude-getvibe.
OpenCode: “Provider not found: getvibe”
Verifique se o ambiente do provedor contém OPENCODE_CONFIG_CONTENT, se o arquivo foi salvo como JSON válido e reinicie o daemon pelas Configurações.
Qwen3.8 ausente ou iniciado com um erro antigo
- Baixe novamente o paseo-getvibe-config.json atual: uma cópia salva anteriormente não se atualiza sozinha.
- Feche completamente o Paseo Desktop. Substitua o
config.jsonantigo na pasta.paseopelo novo arquivo e cole sua chave novamente nos três placeholders. Não envie este arquivo ao suporte. - Abra o Paseo, execute Settings → Host → Overview → Restart daemon e crie um novo agente: uma aba antiga pode continuar usando o modelo anterior.
- Escolha exatamente OpenCode (GetVibe) e, em seguida, Qwen3.8 Max Preview. O Qwen não pertence ao provedor Codex (GetVibe).
Se o erro se repetir, faça uma captura de tela somente da área com o nome do provedor, o modelo e o texto completo do erro. Cubra ou recorte sua chave e o conteúdo de config.json. Você também pode copiar uma única linha de erro da janela do agente — sem mensagens de tarefas, chaves ou variáveis de ambiente.