官网 · 代码 · 代理 · 终端 · 云盘 · 文档 · Warp 工作原理

关于

这是一个仅用于提交问题的仓库，专为 Warp 设计，您可以在此处提交问题、Bug 和功能请求。

我们构建 Warp 是为了解决团队在软件开发过程中反复遇到的两个问题：传统的终端工具未能跟上现代开发者的工作方式，而基于代理的开发工具又难以扩展到单机之外。

Warp 是一款专为与代理协作编码而打造的现代化终端。 Warp 通过现代化的用户界面和代码编辑功能，将终端带入了 21 世纪。您可以使用 Warp 内置的前沿代理 Oz，也可以运行 Claude Code、Codex 或 Gemini CLI 等命令行编码代理。

Oz 是一个面向云端代理的编排平台。 您可以启动无限数量的并行编码代理，这些代理可编程、可审计且完全可控。自动化重复性任务，基于现有代理构建新功能，并在云端并行运行它们。创建代理 →

安装

您可以通过 下载 Warp 并阅读我们的 文档 获取针对不同平台的具体安装说明。

变更日志与发布

我们通常每周四发布一次更新。请查看我们的 变更日志（发布说明）。

问题、Bug 与功能请求

请先在现有问题中搜索您的 Bug（包括临时解决方案）或功能需求：https://github.com/warpdotdev/warp/issues?q=is%3Aissue+is%3Aopen+a+sort%3Areactions-%2B1-desc。

如果仍未找到相关解决方案，请在此仓库中提交新问题：https://github.com/warpdotdev/warp/issues/new/choose。我们恳请您使用问题模板，以便团队更高效地跟踪和处理这些问题。

开源与贡献

我们计划首先开源我们的 Rust UI 框架，随后逐步开放部分甚至全部客户端代码库。目前，Warp 的服务器端仍将保持闭源状态。

有关我们对开源的思考，请参阅：https://github.com/warpdotdev/Warp/discussions/400。

值得一提的是，我们在推进过程中会逐步开放扩展点。社区已经积极参与贡献新的主题：https://github.com/warpdotdev/themes，同时我们的 Workflows 仓库 也欢迎大家分享和协作编写实用的命令模式。

如果您有兴趣加入我们团队，请查看我们的 招聘职位，或发送邮件至 hello@warpdotdev。

支持与疑问

1. 请参阅我们的 文档 以获取关于 Warp 功能的全面指南。
2. 加入我们的 Slack 社区 或 Discord 与其他用户交流，并获得 Warp 团队的支持。
3. 尝试我们的 预览版，体验 Warp 最新且仍在实验中的功能。

如有其他问题，请随时通过 email 联系我们：hello@warpdotdev。

社区准则

总体而言，我们希望大家能够互相尊重、富有同理心。我们遵循 GitHub 社区准则：

• 热情友好、开放包容
• 彼此尊重
• 富有同理心地沟通
• 表达清晰、紧扣主题

开源依赖

在此特别感谢以下帮助 Warp 起步的 开源依赖：

• Tokio
• NuShell
• Fig 自动补全规范
• Warp 服务器框架
• Alacritty
• Hyper HTTP 库
• FontKit
• Core-foundation
• Smol

Warp 快速上手指南

Warp 是一款面向 21 世纪的现代化终端，专为结合 AI 智能体（Agents）进行代码开发而设计。它拥有现代 UI、代码编辑功能，并内置了先进的 AI 助手 Oz，同时支持运行 Claude Code、Codex 等 CLI 编程智能体。

环境准备

• 操作系统：
  • macOS (Intel 或 Apple Silicon)
  • Linux (主要支持 Ubuntu/Debian 及基于其发行的版本)
  • 注：Windows 版本目前正在开发中，暂不支持原生安装。
• 前置依赖：
  • 无需复杂的系统依赖，Warp 为独立安装包。
  • 建议拥有稳定的网络连接以使用 AI 功能（国内用户可能需要配置网络代理以访问云端智能体服务）。
• 账号要求：
  • 首次启动需登录 Warp 账号（支持 GitHub、Google 或邮箱注册），以便同步配置和使用云端智能体功能。

安装步骤

目前官方未提供专门的中国镜像源，请直接通过官网下载对应平台的安装包。

macOS 用户

方式一：使用 Homebrew（推荐）

brew install --cask warp

方式二：直接下载 访问 Warp 下载页，下载 .dmg 文件并拖入应用程序文件夹。

Linux 用户

方式一：使用官方安装脚本（适用于 Debian/Ubuntu）

curl -sSf https://releases.warp.dev/linux/inst.sh | sh

方式二：手动下载.deb 包 访问 Warp 下载页，选择 Linux 版本下载 .deb 包，然后执行：

sudo dpkg -i warp_<version>_amd64.deb

(请将 <version> 替换为实际下载的文件版本号)

基本使用

安装完成后，在应用菜单中启动 Warp。

1. 初始化与登录

首次启动时，跟随引导完成登录。登录后，Warp 会自动加载你的配置文件（兼容 .zshrc 或 .bashrc）。

2. 使用内置 AI 智能体 (Oz)

Warp 的核心特性是自然语言交互。在输入框中直接输入自然语言指令即可。

示例：创建一个 Python 项目结构 直接在命令行输入以下中文或英文指令并回车：

Create a basic Python project structure with src, tests, and a README file

Warp 的内置智能体 Oz 会自动解析意图，生成相应的命令序列（如 mkdir, touch 等），并在执行前向你展示预览。确认无误后按下 Enter 执行，或按 Esc 修改。

3. 运行外部 CLI 智能体

Warp 完美支持现有的 CLI 编程智能体。如果你安装了 Claude Code 或其他工具，可以直接在 Warp 中运行：

claude-code "Refactor the main function to improve performance"

4. 使用工作流 (Workflows)

Warp 允许将常用命令组合保存为“工作流”。

• 输入 # 符号即可唤起已保存的工作流列表。
• 你可以访问官方的 Workflows 仓库 查找社区分享的命令模式。

5. 块编辑模式 (Block Editing)

不同于传统终端，Warp 将每个命令的输出视为一个独立的“块”。

• 鼠标操作：直接点击任意输出块即可选中，支持像编辑器一样复制、搜索或分享该块内容。
• 重试命令：将鼠标悬停在失败命令的块上，点击 "Rerun" 即可重新执行，无需向上翻阅历史记录。