如何使用 Pi Agent：从安装配置到自动化工作流的保姆级教程
如果你正在搜索如何使用 Pi Agent，那么你来对地方了。Pi Agent 是一款采用“极简底座”设计的通用 AI Agent。与臃肿的软件不同，它将选择权交给你：你需要什么功能，就安装什么 Skill（技能）。
无论是搜资料、读 PDF、整理表格，还是做 PPT，Pi 都能完美胜任。本文将通过图文并茂的方式，带你 5 分钟掌握 Pi Agent 的核心用法。
# 📑 本文目录
- 一、 前置准备
- 二、 什么是 Pi Agent？
- 三、 核心教程：如何使用 Pi Agent
- 四、 实战演练：一句话生成 PPT
- 五、 Pi 的设计哲学：按需扩展
- 六、 常用快捷键与高频命令
- 七、 常见问题解答（FAQ）
# 一、 前置准备
在正式开始探索如何使用 Pi Agent 之前，请确保你的电脑环境满足以下基础条件：
- Node.js 20+：强烈推荐使用最新的 LTS 版本。
- AI 模型服务：准备一个可用的 API Key（如 DeepSeek、Claude、OpenAI），或者拥有平台订阅账号（如 Claude Pro、ChatGPT Plus）。
- 项目目录：建议在你的项目根目录下启动 Pi，它会自动读取并管理本地文件。
# 二、 什么是 Pi Agent？
在 OpenRouter 的最新 token 消耗量排行榜上，Pi 稳居第五，紧随 OpenClaw。
让 Pi 脱颖而出的秘诀是“低消耗，高频率”。完成同等规模的任务，Pi 的 token 消耗量往往不到 Claude Code 的三分之一。这表明大量用户正高频使用它来自动化繁琐的日常工作。
# Pi Agent 与 Claude Code 的核心对比
| 对比维度 | Pi Agent | Claude Code |
|---|---|---|
| 核心定位 | 完成日常办公与工作任务 | 编写代码、交付软件项目 |
| 预装能力 | 极简：读文件、写文件、改文件、跑命令 | 复杂：代码索引、测试、Git 操作等开发工具 |
| 扩展方式 | 通过 Skill 按需安装 | 通过 MCP / Hook 扩展 |
| 目标用户 | 任何有日常办公或自动化需求的人 | 专业程序员、开发者 |
| 典型场景 | 搜资料、读文档、处理表格、制作 PPT | 写功能、修 Bug、Code Review |
核心结论： 如果你想提升编程效率，选 Claude Code；但如果你想解决日常工作流的效率问题，Pi Agent 绝对是最佳选择。
# 三、 核心教程：如何使用 Pi Agent
接下来，我们将分步讲解如何使用 Pi Agent，只需 5 分钟即可完成环境搭建。
# 第 1 步：一键安装
打开你的终端（Terminal），直接运行以下安装命令：
curl -fsSL https://pi.dev/install.sh | sh
温馨提示： 安装完成后，所有的配置文件、会话记录和下载的 Skill 都会被统一安全地存放在你电脑的
~/.pi/agent/目录下。
# 第 2 步：启动与登录
使用 cd 命令进入你想要工作的目录，然后输入以下命令启动：
pi
在启动后的界面输入 /login，系统会提供两种登录模式：
- 方式 1：订阅登录 —— 如果你已经是 Claude Pro 或 ChatGPT Plus 的付费用户，选择对应的 provider，按提示在浏览器中授权即可。
- 方式 2：API Key（推荐） —— 适合拥有独立 API 密钥的用户，这种方式对 Secrets 管理更安全高效。
# 第 3 步：配置大语言模型
成功登录后，输入 /model（或者使用快捷键 Ctrl+P）呼出模型选择面板。
- 你可以使用
Shift+Tab快速切换模型的“思考强度（Thinking Level）”。 - 以 DeepSeek 为例：在列表中选择 DeepSeek，填入你申请好的 DeepSeek API 密钥。
# 第 4 步：开启你的首次对话
一切就绪！现在你可以像使用微信一样，在终端里直接给 Pi 下达指令了。
# 四、 实战演练：一句话生成 PPT
不知道如何使用 Pi Agent 赋能具体工作？我们来看看这个生成演示文稿的经典案例。
# 1. 安装 PPT 专属 Skill
在对话框中输入安装指令：
pi install git:github.com/op7418/guizang-ppt-skill
# 2. 下达自然语言指令
无需编写复杂的代码，直接用人类语言告诉 Pi 你想要什么：
“帮我制作一张介绍南京风景的 PPT”
Pi Agent 会智能分析你的需求，为你梳理大纲。当你确认了设计风格和主题色后，它将自动进入生成环节。
# 3. 查看最终效果
下图为 Pi 基于指令自动生成的纯文字版 PPT 效果（进阶用户可以通过微调 Prompt 进一步提升视觉表现力）。
# 五、 Pi 的设计哲学：按需扩展
市面上的大多数 Agent 都在拼命做加法，而 Pi Agent 选择了做减法。
它的底层仅提供最不可或缺的四项能力：读文件、写文件、改文件、跑命令。除此以外，完全空白。因为 Pi 的愿景是让你打造一个完全契合自己工作习惯的专属 Agent：
- 科研学术党：安装 PDF 解析与全网搜索 Skill。
- 行政运营党：安装 Excel 与数据处理 Skill。
- 自媒体创作者：安装 Hyper Frames 处理视频，或 Edge TTS 实现语音合成。
- 设计师：安装 GPT Image 2 等图像生成 Skill。
正如 Pi 官方所述：
“Adapt Pi to your workflows, not the other way around.（让 Pi 适应你的工作流，而不是让你去适应它。）”
# 六、 常用快捷键与高频命令
掌握以下快捷键和斜杠命令，能让你的操作效率翻倍。
# 高效操作快捷键
| 功能用途 | 对应操作方式 |
|---|---|
| 精准文件引用 | 输入 @ 快速模糊搜索项目内文件 |
| 自动路径补全 | 按 Tab 键快速补全当前路径 |
| 安全多行输入 | Shift + Enter（在 Windows Terminal 中请使用 Ctrl + Enter） |
| 一键粘贴图片 | Ctrl + V（Windows 下为 Alt + V），或直接拖拽图片至终端窗口 |
| 执行系统命令 | !command（执行后，输出结果会同步发送给 AI 模型分析） |
| 静默系统命令 | !!command（执行后，输出结果不发送给 AI 模型） |
| 调用外部编辑 | Ctrl + G 快速唤起系统默认的 $VISUAL 或 $EDITOR |
# 核心斜杠 (/) 命令
在输入框键入 / 即可唤出命令菜单：
| 命令代码 | 具体功能说明 |
|---|---|
/model | 快速切换当前对话所使用的 AI 模型 |
/settings | 深入配置思考层级、UI 主题及数据传输协议 |
/resume | 查找并恢复之前的历史工作会话 |
/new | 立即清空上下文，开启一轮全新会话 |
/session | 查看当前会话状态、Token 消耗及预估费用 |
/compact [prompt] | 手动压缩冗长的上下文（可附加自定义保留指令） |
/export [file] | 将当前精彩的对话导出为精美的 HTML 文件 |
/reload | 重载配置文件，解决刚安装的 Skill 未生效的问题 |
/quit | 安全退出 Pi Agent |
# 七、 常见问题解答（FAQ）
# 1. Pi Agent 完全免费吗？
是的。 Pi Agent 客户端本身是开源且完全免费的工具。但是，大语言模型（如 DeepSeek、GPT-4）的推理 API 并非免费。你需要绑定自己的 API Key 或订阅账号，产生的 Token 费用由相应的模型服务商收取。
# 2. 安装了新 Skill 却发现不生效，怎么解决？
如果你发现新安装的技能无法触发，请优先在对话框中输入 /reload 命令重新加载环境。如果仍然失效，请前往 ~/.pi/agent/ 目录检查文件是否成功下载。
# 3. 如何在不同场景下切换模型？
非常简单。只要在聊天框输入 /model，即可呼出模型菜单随意切换。遇到简单的文案润色可以用基础模型节省成本，遇到复杂的逻辑分析再切换到旗舰级推理模型。