Pi Agent 支持在 Windows、macOS、Linux 和 AndroidTermux上运行。本章介绍各平台的配置要点。macOS 配置macOS 是 Pi Agent 的一等支持平台大部分功能开箱即用。推荐终端终端安装方式推荐理由iTerm2brew install --cask iterm2原生 True Color 支持图片显示效果好功能丰富Kittybrew install --cask kittyGPU 加速渲染速度快Warpbrew install --cask warp现代化终端AI 功能集成验证 True Color 支持$ echo $COLORTERM truecolorShell 别名在 ~/.zshrc 中添加常用别名实例# Pi Agent 别名alias picpi -c # 继续上次会话alias pirpi -r # 恢复历史会话alias piqpi -p # 快速问答Windows 配置推荐安装方式在 Windows 上推荐使用 Windows Terminal 配合 WSL2 或直接使用 Node.js。安装 Node.js从 nodejs.org 下载安装包或使用 winget winget install OpenJS.NodeJS.LTS安装 Pi Agent在 Windows Terminal 的 PowerShell 或 CMD 中执行 npm install -g --ignore-scripts earendil-works/pi-coding-agentWindows 特有快捷键功能Windows 快捷键macOS/Linux 快捷键粘贴图片AltVCtrlV多行输入CtrlEnterShiftEnter发送跟进消息需重映射AltEnter在 Windows Terminal 中AltEnter 默认是全屏快捷键。如果想让 Pi Agent 接收到这个快捷键需要在 Windows Terminal 设置中移除或重映射全屏快捷键。在设置中搜索 toggleFullscreen将其快捷键改为其他组合。挂起行为Windows 原生终端不支持 Unix 的作业控制。app.suspend默认 CtrlZ在 Windows 上没有默认绑定。如果手动配置了绑定Pi Agent 会显示状态信息而不是真正挂起。在 WSL 中运行时Linux 的 CtrlZ/fg 行为正常可用。TermuxAndroid配置Pi Agent 可以在 Android 设备上通过 Termux 运行。安装步骤实例# 1. 安装 Termux从 F-Droid 获取最新版# 2. 更新包并安装 Node.jspkg update pkg upgradepkg install nodejs# 3. 安装 Pi Agentnpm install -g --ignore-scripts earendil-works/pi-coding-agent# 4. 验证安装pi --version注意事项Termux 的存储访问路径与常规 Linux 不同使用 ~/storage/shared/ 访问共享存储部分终端的图片显示功能可能受限建议使用蓝牙键盘或 OTG 键盘以获得更好的编辑体验tmux 集成Pi Agent 可以在 tmux 会话中正常工作。优势会话持久化即使 SSH 断开Pi Agent 仍在后台运行多窗口布局一个窗口运行 Pi Agent另一个窗口查看代码远程开发SSH 到服务器后使用 Pi Agent推荐配置在 ~/.tmux.conf 中添加实例# 确保 True Color 支持set -g default-terminal tmux-256colorset -ag terminal-overrides ,*:Tc# 增大回滚缓冲区查看大量 AI 输出时有用set -g history-limit 50000终端设置优化设置项建议值说明True Color启用确保终端支持 24 位色彩字体等宽字体如 JetBrains Mono、Fira Code确保代码对齐和特殊字符显示回滚缓冲区至少 10000 行查看大量 AI 输出和历史消息VS Code 终端设置 minimumContrastRatio 为 1确保主题颜色准确渲染VS Code 集成终端配置在 VS Code 的 settings.json 中实例{terminal.integrated.minimumContrastRatio: 1,terminal.integrated.fontFamily: JetBrains Mono,terminal.integrated.fontSize: 13}Shell 别名建议以下是一套完整的 Pi Agent 别名可添加到 shell 配置文件中实例# Pi Agent 常用别名alias pipi # 基础启动alias pinpi --name # 命名会话启动alias picpi -c # 继续最近会话alias pirpi -r # 恢复历史会话alias piqpi -p # 快速一次性问答alias pippi --print # Print 模式同 -palias pifpi --fork # 分叉会话alias piipi --no-session # 临时模式不保存alias piropi --tools read,grep,find,ls # 只读模式alias pirevpi -p 审查暂存的代码变更git diff --cached如果你使用 fish shell将 alias 改为 abbr 或使用 fish 的 alias 语法。