如何在Windows、macOS和Linux上安装Pane:新手一步步搭建第一个AI Agent工作台
如何在Windows、macOS和Linux上安装Pane:新手一步步搭建第一个AI Agent工作台
Pane 是一款开源、跨平台的 AI Agent 管理工具,支持 Windows、macOS 和 Linux 三大系统,让你并行管理 Claude Code、Codex、Cursor Agent 等任意 CLI 编程 Agent。本教程带你一步步完成三平台的最快安装方法,10 分钟搭好你的第一个 AI Agent 工作台。
一、Pane 是什么:终端优先的 AI Agent 管理器
Pane 用一句话概括:"Vim for agent management"——它不是 IDE,也不是终端模拟器,而是一个 Agent 调度工作台。它的核心理念是 Terminal-first, no abstractions:只要一个工具能在终端里运行,就能直接在 Pane 中运行,无需插件、无需 SDK、无需等待适配。
Pane 的核心模型只有三个词,非常好记:
| 概念 | 含义 | 一句话理解 |
|---|---|---|
| Repository | 保存的基础 git 仓库 | 你的项目根目录 |
| Pane | 一个 worktree + 一个分支 | 1 个功能 = 1 个隔离工作区 |
| Panels | Pane 内共享 worktree 的多个终端 | Agent、diff 查看器、文件浏览器都以 tab 打开 |
更妙的是,Pane 会自动创建和清理 git worktree,你永远不用手动敲 git worktree 命令,五个 Agent 并行跑也不会互相踩脚。
二、安装前的准备:先装好这两样东西 📦
Pane 本身不捆绑任何 Agent,它只负责"给 Agent 一个地方跑"。所以安装前请确认:
| 前置条件 | 说明 |
|---|---|
| Git | 已安装并在系统 PATH 中可用 |
| 至少一个 CLI Agent | 已安装并登录,如 Claude Code、Codex、Cursor Agent、OpenCode、Aider、Goose 等 |
以 Claude Code 为例,macOS/Linux 执行安装脚本后运行 claude auth login 登录;Windows 可用 npm install -g @anthropic-ai/claude-code 安装。更多支持的工具见 docs/ADDING_NEW_CLI_TOOLS.md。
三、macOS 安装 Pane:一行命令搞定 🍎
打开"终端"App,推荐用官方一键脚本:
curl -fsSL https://runpane.com/install.sh | sh
💡 该脚本会直接安装桌面应用,并绕过 macOS Gatekeeper 的安全提示,比手动下载 DMG 更省事。
不想用脚本的话,直接下载 Pane-x.x.x-macOS-arm64.dmg(Apple 芯片)或 Pane-x.x.x-macOS-x64.dmg(Intel 芯片),把图标拖入"应用程序"文件夹即可。
四、Windows 安装 Pane:PowerShell 一行命令 🪟
打开 PowerShell,执行:
irm https://runpane.com/install.ps1 | iex
💡 该方式会绕过 Windows SmartScreen 拦截提示。
也可以直接下载 Pane-x.x.x-Windows-x64.exe(普通 PC)或 -arm64.exe(ARM 笔记本),双击按向导安装。Windows 用户的环境细节可以参考 docs/BUILDING_ON_WINDOWS.md。
五、Linux 安装 Pane:AppImage 或 deb 双格式 🐧
Linux 下推荐直接用一键脚本(同 macOS):
curl -fsSL https://runpane.com/install.sh | sh
或者手动下载两种格式任选其一:
- AppImage(推荐,免 root):下载
Pane-x.x.x-linux-x86_64.AppImage,赋予可执行权限后直接双击运行,x64 / ARM64 都有; - deb 包(Debian/Ubuntu):
sudo dpkg -i Pane-x.x.x-linux-x86_64.deb安装。
六、替代方案:npx runpane 引导式安装 🚀
如果本机已装 Node.js,可以直接在终端运行官方引导向导,它会交互式询问你:安装桌面应用、配置远程主机、更新还是运行诊断:
npx --yes runpane@latest
等价的 pnpm / Python 方式:
pnpm dlx runpane@latest
pipx run runpane
runpane CLI 是 Pane 的"Agent 可操作"命令行,源码位于 packages/runpane/,契约文档见 docs/RUNPANE_CLI_CONTRACT.md。
七、搭建第一个 AI Agent 工作台:3 步上手 ✅
安装完成后,按顺序做三件事:
- 添加项目:在 Pane 中创建或选择一个项目(任意 git 仓库);
- 创建 Pane:输入一句任务提示词,选择 Agent(如 Claude Code),点击创建——Pane 自动建好隔离的 worktree 和分支;
- 添加 tabs:在 Pane 里打开更多终端、diff 查看器、文件浏览器或内置浏览器,开始并行干活。
多个任务同时进行时,把多个 Pane 平铺在一起,每个 Agent 的进度一目了然:
每个 Pane 还能自带一个内置浏览器 tab,Agent 起到的本地 dev server 可以直接在旁边预览,无需来回切换窗口:
八、进阶玩法:Remote Pane,用手机管理电脑上的 Agent 📱
想让家里的 PC 或服务器跑 Agent、手机上看进度?只需:
- 在主机上打开
Settings > Remote Access,设置为远程主机并复制生成的pane-remote://...连接码; - 在另一台电脑或手机浏览器中粘贴连接码,即可接管远程 Agent。
完整的自托管流程、SSH 隧道模式和端口转发说明,见 docs/SELF_HOSTED_REMOTE_DAEMON.md:
九、常见问题排查:安装不顺利怎么办 🔧
| 问题 | 解决办法 |
|---|---|
| pnpm 权限报错 | 永远不要用 sudo 运行 pnpm,可执行 npm config set prefix ~/.npm-global 修复 |
| macOS 编译相关组件缺失 | 运行 xcode-select --install 安装 Xcode Command Line Tools |
| 下载应用被系统拦截 | 优先使用本文的一键脚本,它们会绕过 Gatekeeper / SmartScreen 提示 |
更完整的排错清单请查阅 docs/troubleshooting/SETUP_TROUBLESHOOTING.md。
十、从源码构建(可选)
如果你想参与开发 Pane,需要 patch 过的 Node 22/24/26 与 pnpm 10:
git clone https://gitcode.com/gh_mirrors/pane2/Pane
cd Pane
pnpm run setup
PANE_DIR=~/.pane_test pnpm dev
💡
PANE_DIR用于把开发版数据与正式安装(默认~/.pane)隔离开。
写在最后
回顾一下最快的路径:一行命令装好 Pane → 登录任意一个 CLI Agent → 添加 git 仓库 → 创建 Pane 开跑。Pane 的"终端优先、Agent 无关"设计意味着:明天新出的任何 CLI Agent,今天就能在 Pane 里直接用。去搭好你的第一个 AI Agent 工作台吧!🎉





