Pi-code-agent 安装与使用指南

一、前置环境准备

1. Node.js 安装（推荐：使用 fnm）

参考文档: Node.js 安装指南

# 更新软件源并安装依赖sudo apt updatesudo apt install -y unzip# 安装 fnm (Node Version Manager)curl -fsSL https://fnm.vercel.app/install | bashsource ~/.bashrc# 安装 Node.js v24（推荐版本）fnm install 24fnm default 24

2. pnpm 包管理工具安装

# 全局安装 pnpmnpm install -g pnpmpnpm setupsource ~/.bashrc# 配置 pnpm 存储和目录路径pnpm config set store-dir /root/.pnpm-storepnpm config set global-dir /root/.pnpm-globalpnpm config set global-bin-dir /usr/local/bin# 设置镜像源（国内推荐 npmmirror）pnpm config set --global registry https://registry.npmmirror.com

二、PI-code-agent 安装

安装命令（Linux/macOS）

curl -fsSL https://pi.dev/install.sh | sh

安装完成后验证：

# 测试 PI 是否正常工作pi -p "回复一个字:好"# 预期输出："好"

三、PI 核心配置

3.1 模型配置文件 (/home/xi/.pi/agent/models.json)

{"providers": {"local-openai-text": {"baseUrl": "http://127.0.0.1:9999/v1","api": "openai-completions","apiKey": "sk-123456","authHeader": true,"models": [{ "id": "qwen38-27b-text" }]},"local-openai": {"baseUrl": "http://127.0.0.1:9999/v1","api": "openai-completions","apiKey": "sk-123456","authHeader": true,"models": [{ "id": "qwen38-27b" }]}},"lastChangelogVersion": "0.84.4","theme": "light","defaultProvider": "local-openai-text","defaultModel": "qwen38-27b-text","defaultThinkingLevel": "medium","packages": ["npm:pi-web-access"]}

注意: 手动修改的部分包括 providers、lastChangelogVersion、theme、defaultProvider、defaultModel、defaultThinkingLevel 和 packages。

四、搜索功能配置

4.1 安装 pi-web-access 包

pi install npm:pi-web-access# 输出示例：added 134 packages, and audited 135 packages in 48s

4.2 使用场景

通过搜索功能可以研究 2026 年最赚钱的个人 AI 项目，包括：

• Solo developer AI project revenue 2026 MRR
• Indie hacker AI SaaS revenue 2026 open startup
• One person AI company revenue 2025 case study

4.3 已知成功案例（截至 2026 年）

重要说明:

• 除 Marc Lou 外，多为创始人自述、未经审计数据
• Photo AI 的 105�/月是2026年本人披露的最新数字（此前报道的132K 为峰值）
• 需要深入某个方向可以进一步提供具体的 wedge 方案

五、Pi Web 编程代理配置与使用

5.1 参考文档

Pi Web 本地 Web 界面介绍

5.2 安装与运行

要求: Node.js 22.19.0 或更高版本

# 方式一：免安装直接运行（推荐）npx @agegr/pi-web@latest# 方式二：全局安装后运行npm install -g @agegr/pi-webpi-web

服务特性:

• 自动打开浏览器访问 http://127.0.0.1:30141
• 默认绑定 127.0.0.1，仅本机可访问
• 支持多机器编程协作

5.3 常用运行选项

# 自定义端口pi-web --port 8080# 或: PORT=8080 pi-web# 暴露到可信网络（需配合防火墙）pi-web --hostname 0.0.0.0# 或: PI_WEB_HOSTNAME=0.0.0.0 pi-web# 不自动打开浏览器pi-web --no-open# 或: PI_WEB_NO_OPEN=1 pi-web

六、使用统计与 Token 消耗参考

示例搜索任务的 Token 消耗情况：

20.51.138.280 I slot print_timing: id  3 | task 3599 | prompt eval time =    6088.72 ms /  1188 tokens (    5.13 ms per token,   195.11 tokens per second)20.51.138.285 I slot print_timing: id  3 | task 3599 |        eval time =   79383.77 ms /  1953 tokens (   40.67 ms per token,    24.59 tokens per second)20.51.138.286 I slot print_timing: id  3 | task 3599 |       total time =   85472.49 ms /  3141 tokens

七、注意事项

1. API Key: 搜索功能无需配置 API-key 即可使用
2. 数据可靠性: 大部分收入数据来自创始人自述，未经第三方审计
3. 版本要求: Pi Web 需要较新版本的 Node.js（推荐 22.19.0+）
4. 安全提示: 暴露到网络时请确保防火墙配置正确

本文档记录于 2026-08-31，基于实际使用经验整理。