主题
语言

使用 GetVibe 模型的 Paseo

使用 GetVibe 分步设置 Paseo：安装 CLI，放入现成的 config.json，避免 OAuth 重新绑定并验证支出。

现成配置

Download config.json

根据请求从我们的目录构建：API 地址、每个已发布模型及其上下文和输出限制，以及推荐设置。其中不包含密钥。Paseo 会将环境值原样传递给代理，因此文件中包含三个 PASTE-YOUR-GETVIBE-API-KEY-HERE 占位符 — 请将它们替换为你的密钥（步骤如下）。

# 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"
  • 主模型 — gpt-6.1-sol：具备强大代理能力的编码模型，拥有较大的上下文窗口，价格适中；使用不带限定的 id 可保持跨渠道故障转移。
  • 小型任务 — deepseek-v4.1-flash：最便宜且能力足够、支持 1M 上下文的模型，用于标题、摘要、提交消息和压缩。
  • 启用流式传输，请求超时时间为 600 秒，推理力度为 medium：较长的推理回答需要几分钟，而不使用流式传输会达到等待时限。
  • 所有地方都使用不带 :suffix 的纯模型 ID，这样可以保持自动故障转移到健康通道的功能。
目录会发生变化：出现新模型时，请再次下载该文件。若只保留部分模型，请在 URL 中添加带逗号分隔 ID 的 ?models=。

Paseo 是一款适用于 Windows 和 macOS 的图形化程序。安装应用后，连接预先制作好的三个 GetVibe 提供商：Codex、Claude Code 和 OpenCode。只有安装这三个 CLI 工具时才需要使用命令行，安装或运行 Paseo 本身无需命令行。

1. 下载并安装 Paseo Desktop

打开官方 paseo.sh/download 页面，并下载适用于你系统的构建版本：

参数类型描述
Windowsinstaller通常为 Intel / x64。运行下载的 Paseo-Setup-…-x64.exe，并按照安装程序的指引操作。
macOSDMGApple Silicon：适用于搭载 M1/M2/M3/M4 芯片或更新芯片的 Mac；Intel：适用于较旧的 Mac。打开 DMG，然后将 Paseo 拖入 Applications。

在 Windows 上从“开始”菜单启动 Paseo，或在 Mac 上从“应用程序”中启动。首次启动时，应用会启动自己的本地守护进程，无需通过 npm 单独安装 Paseo，也无需输入 paseo 命令。

下载页面还会显示 npm 选项，但该选项用于服务器和无头环境。本指南请选择 Desktop 区块。

2. 安装所需提供商的 CLI

Paseo Desktop 用于管理代理，但 Codex、Claude Code 和 OpenCode 本身必须安装在你的系统中。首先从 nodejs.org 安装当前 LTS 版本的 Node.js，然后重新打开终端。

如何打开终端

终端是一个可以以文本形式输入命令的窗口。打开方法：

参数类型描述
WindowsPowerShell按 Win + X → “Terminal”（或“Windows PowerShell”）。或者：按 Win + R，输入 powershell，然后按 Enter。
macOS终端按下 Cmd + Space，输入 Terminal，然后按 Enter。

随后会打开一个带有闪烁光标的窗口。将下面的命令逐条粘贴进去，每条命令后按 Enter。粘贴方式：Windows 上右键或 Ctrl + V，macOS 上按 Cmd + V。安装需要 1–3 分钟；运行期间请保持窗口打开。

如果你只需要一个提供商，可以只安装其 CLI。以下命令需要 Node.js，但已安装 Paseo Desktop 的情况下不需要。

安装全部三个 CLI：

npm install -g @openai/codex @anthropic-ai/claude-code opencode-ai

检查命令是否可用：

codex --version
claude --version
opencode --version

3. 连接准备好的 config.json

下载 paseo-getvibe-config.json。将其重命名为 config.json 并放置在：

参数类型描述
macOS / Linuxpath~/.paseo/config.json
Windowspath%USERPROFILE%\.paseo\config.json

.paseo 文件夹名称以点开头，因此默认处于隐藏状态。如果看不到它，不要新建文件夹，而是显示隐藏文件：

参数类型描述
Windows文件浏览器将 %USERPROFILE%\.paseo 粘贴到 Explorer 地址栏中，然后按 Enter，即使文件夹处于隐藏状态也会打开。
macOSFinder在 Finder 中按下 Cmd + Shift + G，输入 ~/.paseo，然后按 Enter。显示隐藏文件：Cmd + Shift + .（句点）。
如果 .paseo 文件夹尚不存在 — 启动一次 Paseo，然后退出：它会自动创建该文件夹。这比手动创建更可靠。
当前的 Paseo Desktop 没有专用的“导入配置”按钮。将文件以确切名称 config.json 放在此文件夹中，是加载现成自定义提供商的标准方式。
Windows 可能会将文件保存为 config.json.txt，因为扩展名处于隐藏状态。在资源管理器中启用“查看 → 显示 → 文件扩展名”，并确认名称完全是 config.json。这是 Paseo“看不到”配置的最常见原因。
下载的文件是一个完整的最小配置。如果 Paseo 已经完成设置，请先保存备份，然后仅将 agents.providers 中的三个对象移入现有文件。不要覆盖您自己的设置和提供商。

4. 粘贴 API 密钥

使用纯文本编辑器打开文件：Windows 上使用“记事本”（右键单击文件 →“打开方式”→“记事本”），macOS 上使用“TextEdit”（右键单击 →“打开方式”→ TextEdit）。不要在 Word 或 Pages 中打开，否则它们会添加格式，导致文件无法继续读取。

将 all three 个 PASTE-YOUR-GETVIBE-API-KEY-HERE 替换为 GetVibe 控制面板中的密钥，然后保存（Windows 使用 Ctrl + S，macOS 使用 Cmd + S）。将密钥粘贴在引号之间，并保留引号。不要发布完成后的文件，也不要将其添加到 Git。

在 macOS 的 TextEdit 中，如果可用，请在编辑前选择“格式 → 制作纯文本”。否则文件会保存为 RTF，Paseo 将无法读取。

5. 删除过期登录信息

Codex 可能会复用已保存的“使用 ChatGPT 登录”登录状态。这样，请求可能会静默地直接发送到 OpenAI。使用 GetVibe token 的 Claude Code 会优先使用该 token，而退出登录也会同时移除任何旧的 Apps Gateway 会话。请各执行一次以下两个命令：

codex logout
claude auth logout
OpenCode 无需注销：身份验证按提供商 id 分别存储，配置文件会明确选择 getvibe、其地址和密钥。不要使用 GetVibe 密钥运行 codex login --with-api-key。

6. 重启 Paseo 并验证所有内容

在更新 Codex CLI 之前，不要为 Codex (GetVibe) 选择 Auto-review。使用不兼容的版本时，代理甚至还未启动就会失败，并显示错误 unknown variant auto_review, expected user or guardian_subagent。主要修复方法：在终端中运行 npm install -g @openai/codex@latest，然后完全退出 Paseo Desktop 并重新打开。仅执行一次 Restart daemon 可能不足以更新已经运行的应用。
  1. 重新打开 Paseo Desktop。
  2. 打开 Settings → Host → Overview，然后按 Restart daemon。
  3. 打开 Settings → Host → Providers。现在列表中应显示 Codex (GetVibe)、Claude Code (GetVibe) 和 OpenCode (GetVibe)。
  4. 返回工作区并创建一个代理。在新代理表单底部的模式/权限下拉菜单中选择Default Permissions。对于初学者，这是一个安全的临时选择。不要选择Auto-review。Full Access选项允许代理在没有常规确认提示的情况下执行操作，此修复不需要该选项。
  5. 发送一条简短测试消息：Reply with a single word: ready。
供应商卡片上的 Refresh 按钮会刷新模型列表，但在手动替换整个 config.json 后，不能替代 Restart daemon。

7. 验证请求的去向

  1. 测试前，请在 GetVibe 控制台中打开 Usage and requests。
  2. 从 Paseo 发送一条测试消息，然后等待回复。
  3. 刷新页面：此时应显示一个包含所选模型和费用的新行。
仅凭 Paseo 中的回复无法证明已完成路由。如果 usage 中没有新增行，请停止并修复配置，不要继续执行付费任务。

故障排除

“Command not found”

关闭并重新打开终端。如果只有一个 CLI 缺失，请重新执行第 2 步中的安装命令。无需重新安装 Paseo Desktop。

自动审核：未知变体 auto_review

将 Codex 更新为 npm install -g @openai/codex@latest，完全退出 Paseo Desktop 后重新打开。在兼容性问题修复之前，请在底部模式下拉菜单中选择 Default Permissions。如果已失败的会话没有应用新模式，请创建新的 agent 或标签页，并在发送前选择该模式。

401，或文件中仍保留占位符

查找并替换全部三个占位符，检查逗号和引号，然后在 Paseo 中打开 设置 → 主机 → 概览 → 重启守护进程。

Codex 回复了，但没有显示 GetVibe 消费记录

再次运行codex logout，检查codex login status，通过 Settings 重启守护进程，并且只选择Codex (GetVibe)。

Claude 要求登录或显示 Gateway

运行claude auth logout，检查你的密钥，然后重启claude-getvibe提供商。

OpenCode：“Provider not found: getvibe”

请确认供应商环境中包含 OPENCODE_CONFIG_CONTENT，文件已保存为真正的 JSON，并通过“设置”重启守护进程。

Qwen3.8 缺失或以旧错误开头

  1. 重新下载当前的 paseo-getvibe-config.json：之前保存的副本不会自行更新。
  2. 完全退出 Paseo Desktop。将 .paseo 文件夹中的旧 config.json 替换为新文件，并再次将你的密钥粘贴到全部三个占位符中。请勿将此文件发送给支持团队。
  3. 打开 Paseo，运行 Settings → Host → Overview → Restart daemon，然后创建一个新代理：旧标签页可能仍在使用之前的模型。
  4. 准确选择 OpenCode (GetVibe)，然后选择 Qwen3.8 Max Preview。Qwen 不属于 Codex (GetVibe) 提供商。

如果错误重复出现，请仅截取包含提供商名称、模型和完整错误文本的区域。请遮盖或裁剪掉密钥以及 config.json 的内容。你也可以从智能体窗口中复制单独的一行错误信息，但不要包含任务消息、密钥或环境变量。

官方来源

← 上一页概览下一页 →Pi Agent
Paseo + GetVibe API — Codex、Claude Code 和 OpenCode 的就绪配置 | GetVibe API