教程 1：安装、认证与首次对话
预计用时：10 分钟 | 目标：让 PI 跑起来并完成第一次对话
1. 安装
bash
npm install -g @mariozechner/pi-coding-agent安装完成后，终端中输入 pi 即可启动。
2. 认证（二选一）
方式 A：API Key（推荐开发者）
bash
export ANTHROPIC_API_KEY=sk-ant-xxx
pi支持的 API Key 供应商：Anthropic、OpenAI、Google Gemini、Mistral、Groq、xAI、OpenRouter 等。
方式 B：订阅登录（OAuth）
bash
pi
# 在编辑器中输入：
/login支持的订阅：
- Anthropic Claude Pro/Max
- OpenAI ChatGPT Plus/Pro
- GitHub Copilot
- Google Gemini CLI
- Google Antigravity
3. 界面速览
启动后，界面从上到下分为：
┌─────────────────────────────────────┐
│ 启动头：快捷键提示、加载的配置信息 │
├─────────────────────────────────────┤
│ │
│ 消息区域：对话历史、工具调用结果 │
│ │
├─────────────────────────────────────┤
│ > 编辑器：在这里输入你的问题 │ ← 边框颜色表示思考级别
├─────────────────────────────────────┤
│ 底部状态栏：目录、模型、Token 用量 │
└─────────────────────────────────────┘4. 第一次对话
启动 pi 后，直接在编辑器中输入：
列出当前目录下的所有 .ts 文件按 Enter 发送，PI 会使用内置的 bash 工具执行命令并返回结果。
再试试：
创建一个简单的 TypeScript 函数，实现斐波那契数列PI 会使用 write 工具创建文件。
5. 四个核心工具
PI 默认给模型提供 4 个工具：
| 工具 | 作用 | 示例 |
|---|---|---|
read | 读取文件内容 | PI 自动调用，无需手动 |
write | 创建/覆盖文件 | 生成新代码文件 |
edit | 精确编辑文件 | 修改现有代码 |
bash | 执行 shell 命令 | 运行测试、安装依赖 |
你不需要手动调用这些工具 — 直接告诉 PI 你想做什么，模型会自动选择合适的工具。
6. 快捷命令
在编辑器中输入 / 触发命令：
| 命令 | 说明 |
|---|---|
/model | 切换模型 |
/settings | 设置（主题、思考级别等） |
/new | 新会话 |
/resume | 恢复之前的会话 |
/session | 查看当前会话信息 |
/tree | 浏览会话历史树 |
/compact | 手动压缩上下文 |
/export | 导出会话为 HTML |
/quit | 退出 |
7. 常用快捷键
| 快捷键 | 操作 |
|---|---|
Enter | 发送消息 |
Ctrl+C | 清空编辑器 |
Ctrl+C (两次) | 退出 |
Escape | 取消/中止 |
Ctrl+L | 打开模型选择器 |
Ctrl+P | 在限定模型间循环 |
Shift+Tab | 切换思考级别 |
Ctrl+O | 折叠/展开工具输出 |
8. 文件引用与 Bash 快捷
引用文件（@ 语法）
在编辑器中输入 @ 可以模糊搜索并引用项目文件：
@README.md 请总结这个文件的内容直接执行 Bash 命令
!ls -la # 执行命令并将输出发送给 LLM
!!ls -la # 执行命令但不发送输出（仅让你看到结果）9. 消息队列（高级技巧）
当 PI 正在工作时，你仍然可以输入消息：
- Enter → 发送「引导消息」（steering），在当前工具调用完成后送达
- Alt+Enter → 发送「后续消息」（follow-up），在 PI 完全结束后送达
这在你想中途调整方向时非常有用。
10. CLI 快速参考
bash
pi # 启动交互式模式
pi "帮我重构这个文件" # 带初始消息启动
pi -p "总结代码" # 非交互模式，输出后退出
pi -c # 继续最近的会话
pi -r # 浏览历史会话
pi --model openai/gpt-4o # 指定模型
pi --thinking high # 高思考级别
pi @file1.ts @file2.ts "审查这两个文件" # 引用文件
cat README.md | pi -p "总结" # 管道输入本章小结
✅ 已安装 PI
✅ 已完成认证
✅ 已进行首次对话
✅ 了解了界面布局和核心工具
✅ 掌握了常用命令和快捷键
下一步 → 教程 2：日常工作流