如何在Windows、macOS和Linux上安装Pane:新手一步步搭建第一个AI Agent工作台

原创2026-11-14 17:19:021,414 阅读

如何在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 管理工作台:桌面应用与 Remote Pane 手机视图

一、Pane 是什么:终端优先的 AI Agent 管理器

Pane 用一句话概括:"Vim for agent management"——它不是 IDE,也不是终端模拟器,而是一个 Agent 调度工作台。它的核心理念是 Terminal-first, no abstractions:只要一个工具能在终端里运行,就能直接在 Pane 中运行,无需插件、无需 SDK、无需等待适配。

Pane 核心概念图解:Repository → Pane → Panels

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 步上手 ✅

安装完成后,按顺序做三件事:

  1. 添加项目:在 Pane 中创建或选择一个项目(任意 git 仓库);
  2. 创建 Pane:输入一句任务提示词,选择 Agent(如 Claude Code),点击创建——Pane 自动建好隔离的 worktree 和分支;
  3. 添加 tabs:在 Pane 里打开更多终端、diff 查看器、文件浏览器或内置浏览器,开始并行干活。

Pane 第一个工作台:终端里运行的 AI 编程 Agent 与 Diff 面板

多个任务同时进行时,把多个 Pane 平铺在一起,每个 Agent 的进度一目了然:

Pane 平铺布局:多个 AI Agent 会话并行运行

每个 Pane 还能自带一个内置浏览器 tab,Agent 起到的本地 dev server 可以直接在旁边预览,无需来回切换窗口:

Pane 内置浏览器标签:本地开发服务器预览

八、进阶玩法:Remote Pane,用手机管理电脑上的 Agent 📱

想让家里的 PC 或服务器跑 Agent、手机上看进度?只需:

  1. 在主机上打开 Settings > Remote Access,设置为远程主机并复制生成的 pane-remote://... 连接码;
  2. 在另一台电脑或手机浏览器中粘贴连接码,即可接管远程 Agent。

完整的自托管流程、SSH 隧道模式和端口转发说明,见 docs/SELF_HOSTED_REMOTE_DAEMON.md:

Pane 设置界面:Remote Access 远程访问配置

九、常见问题排查:安装不顺利怎么办 🔧

问题 解决办法
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 工作台吧!🎉

登录后查看全文
Pane