安装与设置

注意

平台支持： Warp 支持 macOS（Intel 和 Apple Silicon）、Windows (x86_64 和 ARM64) 以及 Linux (x86_64 和 ARM64)。

安装 Warp

注意

访问 已知问题 以获取有关安装和排查 Warp 问题的更多详细信息。

macOS

注意

最低要求： 支持 Metal 的 Intel 或 Apple Silicon Mac，运行 macOS 10.14 或更高版本。

下载 Warp 并将其拖至应用程序文件夹

下载 Warp

使用 Homebrew 安装，运行以下命令

brew install --cask warp

安装完成后，您可以在应用程序文件夹中找到 Warp。

Windows

注意

最低要求： Warp 需要 Windows 10 版本 1809 (内部版本 17763) 或更高版本，Windows Server 2019 (内部版本 17763) 和 Windows Server 2022 (内部版本 20348) 或更高版本。这是 Windows 伪控制台 (ConPTY) 的要求。

下载 Warp，然后打开并运行安装程序

下载 Warp

使用 WinGet 安装，运行以下命令

winget install Warp.Warp

安装完成后，您可以在“开始”菜单中找到 Warp。

Linux

注意

最低要求： 运行 glibc >= 2.31 (2020 年 2 月发布) 且支持 OpenGL ES 3.0+ 或 Vulkan 的 Linux 发行版。

这包括（但不限于）以下系统

• Ubuntu 20.04
• Debian 11 ("bullseye")
• Fedora 32
• Arch Linux

访问 Warp 下载页面查看完整的 Linux 安装选项列表

下载 Warp

基于 Debian 和 Ubuntu 的发行版

安装 Warp 最简单的方法是下载 x64 .deb 软件包 或 ARM64 deb 软件包。下载后，您可以使用以下命令安装

sudo apt install ./<file>.deb

安装 .deb 包将自动配置 Warp apt 存储库和签名密钥，以便自动更新 Warp 并验证下载包的完整性。

或者，您可以手动配置 Warp apt 存储库并通过运行以下命令安装 Warp

sudo apt-get install wget gpg
wget -qO- https://releases.warp.dev/linux/keys/warp.asc | gpg --dearmor > warpdotdev.gpg
sudo install -D -o root -g root -m 644 warpdotdev.gpg /etc/apt/keyrings/warpdotdev.gpg
sudo sh -c 'echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/warpdotdev.gpg] https://releases.warp.dev/linux/deb stable main" > /etc/apt/sources.list.d/warpdotdev.list'
rm warpdotdev.gpg
sudo apt update && sudo apt install warp-terminal

基于 RHEL、Fedora 和 CentOS 的发行版

安装 Warp 最简单的方法是下载 x64 .rpm 软件包 或 ARM64 .rpm 软件包。下载后，您可以使用以下命令安装

sudo dnf install ./<file>.rpm

安装 .rpm 包将自动配置 Warp yum 存储库。首次更新时，dnf 将检索验证下载包完整性所需的签名密钥。

或者，您可以手动配置 Warp yum 存储库并通过运行以下命令安装 Warp

sudo rpm --import https://releases.warp.dev/linux/keys/warp.asc
sudo sh -c 'echo -e "[warpdotdev]\nname=warpdotdev\nbaseurl=https://releases.warp.dev/linux/rpm/stable\nenabled=1\ngpgcheck=1\ngpgkey=https://releases.warp.dev/linux/keys/warp.asc" > /etc/yum.repos.d/warpdotdev.repo'
sudo dnf install warp-terminal

基于 Arch Linux 的发行版

安装 Warp 最简单的方法是下载 x64 .pkg.tar.zst 软件包 或 ARM64 pacman 软件包。下载后，您可以使用以下命令安装

sudo pacman -U ./<file>.pkg.tar.zst

首次通过应用更新 Warp 时，它将引导您完成设置 Warp pacman 存储库和签名密钥的过程。

或者，您可以手动配置 Warp pacman 存储库并通过运行以下命令安装 Warp

sudo sh -c "echo -e '\n[warpdotdev]\nServer = https://releases.warp.dev/linux/pacman/\$repo/\$arch' >> /etc/pacman.conf"
sudo pacman-key -r "linux-maintainers@warp.dev"
sudo pacman-key --lsign-key "linux-maintainers@warp.dev"
sudo pacman -Sy warp-terminal

基于 OpenSUSE 和 SLE 的发行版

Warp yum 存储库也适用于基于 OpenSUSE 和 SLE 的系统。下载 x64 .rpm 软件包 或 ARM64 .rpm 软件包。下载后，您可以使用以下命令安装

sudo zypper install ./<file>.rpm

安装 .rpm 包将自动配置 Warp yum 存储库。首次更新时，zypper 将检索验证下载包完整性所需的签名密钥。

或者，您可以手动配置 Warp yum 存储库并通过运行以下命令安装 Warp

sudo rpm --import https://releases.warp.dev/linux/keys/warp.asc
sudo sh -c 'echo -e "[warpdotdev]\nname=warpdotdev\ntype=rpm-md\nbaseurl=https://releases.warp.dev/linux/rpm/stable\nenabled=1\nautorefresh=1\ngpgcheck=1\ngpgkey=https://releases.warp.dev/linux/keys/warp.asc\nkeeppackages=0" > /etc/zypp/repos.d/warpdotdev.repo'
sudo zypper install warp-terminal

AppImage

我们还提供 AppImage，这是一种单文件的 Warp 可执行版本。建议通过包管理器安装 Warp，以确保您的系统已安装所有必要的依赖项。

您可以使用以下命令下载 Warp AppImage

# On x64 systems
curl -L "https://app.warp.dev/download?package=appimage" -o Warp-x64.AppImage
chmod +x Warp-x64.AppImage

# On ARM64 systems
curl -L "https://app.warp.dev/download?package=appimage_arm64" -o Warp-ARM64.AppImage
chmod +x Warp-ARM64.AppImage

在 Linux 上运行 Warp

如果您安装了软件包，可以在桌面管理器中找到 Warp，或者在终端中运行 warp-terminal。如果您使用的是 AppImage，可以通过导航到 AppImage 所在的目录并运行 ./Warp-*.AppImage 来启动它。

注意

想尝试我们的最新功能吗？Warp Preview 适用于所有平台和架构（macOS、Windows、Linux），可让您抢先体验实验性功能。

从源码构建

Warp 客户端在 AGPL v3 协议下开源，因此您可以从 warpdotdev/warp 自行构建。

克隆存储库，引导工具链依赖项，并启动开发构建

git clone https://github.com/warpdotdev/warp.git
cd warp
./script/bootstrap
cargo run

cargo run 会启动从您的本地签出版本构建的 warp-oss 二进制文件。有关完整的先决条件（macOS 上的 Xcode、固定的 Rust 工具链、protoc）和开发设置，请参阅存储库中的 README.md 和 CONTRIBUTING.md。

注意

日常使用请使用官方版本。自构建的 warp-oss 二进制文件使用单独的配置和数据目录，因此它们与官方 Warp 并行运行而不会冲突，但它们不会自动更新，也不具备生产环境的代码签名身份。请将其用于开发、审计或向向上游贡献。

初始设置

登录 Warp (可选)

安装完成后，您可以选择通过右上角的“Sign up”（注册）按钮，或通过导航至 Settings > Account > Sign up 来创建 Warp 账户。您可以选择跳过此步骤。如果您在登录时遇到问题，请参阅 登录排查 页面。

注意

如果您使用 Google 或 GitHub 注册，Warp 仅会访问关联的电子邮件地址。有关 Warp 隐私方法的更多详情，请访问 隐私 页面。

离线使用 Warp

您仅在首次打开 Warp 应用时需要有效的互联网连接。打开后，Warp 可以在没有互联网连接的情况下运行，但 AI 和实时协作等需要联网的功能将不可用。

导入设置

如果您正在从其他终端、编辑器或 AI 编程工具迁移到 Warp，请参阅 迁移至 Warp 文档，获取分来源指南，包括设置导入步骤和功能对等说明。

设置 Warp 默认 Shell

Warp 默认尝试加载您的登录 Shell。目前，Warp 支持 bash、fish、zsh 和 PowerShell (pwsh)。如果您的登录 Shell 设置为其他 Shell（例如 Nushell），Warp 将默认加载 zsh。

Zsh 是 macOS（从 2019 年 macOS Catalina 开始）的默认登录和交互式 Shell，取代了 bash Shell。对于大多数 Linux 发行版，默认 Shell 是 bash。

您可以通过 Settings > Features > Session 更改您的默认 Shell。在“Startup shell for new sessions”（新会话的启动 Shell）部分，您可以选择您希望 Warp 使用的 Shell。