---
title: "安装 Vibe Prospecting 插件"
summary: "从 explorium-ai/vibeprospecting-plugin 安装 vpai@vibeprospecting。使用 vpai login 和 --poll 完成认证。"
category: skills
level: starter
surfaces: [cli, app, ide]
tags: ["插件", "Vibe Prospecting", "Explorium", "MCP"]
canonical: /tips/vpai-codex-plugin/
---

# 安装 Vibe Prospecting 插件

从 explorium-ai/vibeprospecting-plugin 安装 vpai@vibeprospecting。使用 vpai login 和 --poll 完成认证。

Vibe Prospecting 插件用 marketplace 加 explorium-ai/vibeprospecting-plugin，再 vpai login。Explorium 给 Codex 单独写了安装页：先加 GitHub marketplace，再装插件。插件带 `vibe-prospecting` 技能；真正拉数走本机 `vpai` CLI，凭证在 `~/.config/vpai`，**不是** `codex mcp login`。

在**普通终端**装，不要在 Codex TUI 里跑：

```bash
codex plugin marketplace add explorium-ai/vibeprospecting-plugin
codex plugin add vpai@vibeprospecting
```

清单 `.agents/plugins/marketplace.json` 的 name 是 `vibeprospecting`，插件 name 是 `vpai`，所以是 `vpai@vibeprospecting`。`codex plugin list` 应看到 installed, enabled。0.154 起可先检查当前会话；未显示插件时再新开会话。技能或工具没出现就重启 Codex。marketplace 过期时：

```bash
codex plugin marketplace upgrade vibeprospecting
codex plugin add vpai@vibeprospecting
```

upgrade 用清单名 `vibeprospecting`，不是仓库路径。装上却是灰的，在 `~/.codex/config.toml` 打开：

```toml
[plugins."vpai@vibeprospecting"]
enabled = true
```

认证按平台指南：每次工作流开头先装 CLI，再登录、轮询：

```bash
npm install -g @vibeprospecting/vpai@latest
vpai login
vpai login --poll
vpai whoami
```

`whoami` 退出码 0 才继续。不要直接读 `~/.config/vpai/config.json`。全局装不上（沙箱、权限）再退回 `npx @vibeprospecting/vpai@latest login`。已经能跑 `vpai` 时，**不要**每个工具调用再套一层 `npx`。无头环境才 `vpai config --api-key YOUR_TENANT_API_KEY`，不要把密钥写进提示或导出的 CSV。登出是 `vpai logout`。

会话里调用 `/vpai:vibe-prospecting`，这是他们的斜杠，不是 Claude 的 `/plugin`。默认先对 **5 条**实体跑完整链路再放大；本轮要跳过样本写 `/vpai:skip_sample` 或明确说不要样本。链式调用用上一步 JSON 里的 `session_id` 和 `csv_path`，不要自己编。同一 `session_id` 不要并行两个 agent。大批量导出保留操作审批。

只要远程 MCP、不装这套技能时，才去独立仓 vibeprospecting-mcp：

```bash
codex mcp add vibe-prospecting --url https://vibeprospecting.explorium.ai/mcp
codex mcp login vibe-prospecting
```

```toml
[mcp_servers.vibe-prospecting]
url = "https://vibeprospecting.explorium.ai/mcp"
enabled = true
```

用户配置中的服务名是 `vibe-prospecting`。URL **带** `/mcp` 后缀。这是 Streamable HTTP + OAuth，不要写 `command`。已经装了 `vpai@vibeprospecting` 就**不要**再叠同一家远程，除非你清楚要两套入口。

网页 Cloud 不读取 `~/.codex/config.toml`。配置后重新打开会话。

## 来源

- [Vibe Prospecting · Install in Codex](https://github.com/explorium-ai/vibeprospecting-plugin/blob/main/docs/install-codex.md)
- [Vibe Prospecting · Codex platform guide](https://github.com/explorium-ai/vibeprospecting-plugin/blob/main/skills/vibe-prospecting/platforms/codex.md)
- [explorium-ai/vibeprospecting-plugin](https://github.com/explorium-ai/vibeprospecting-plugin)