# 首胜 · 10 分钟拿到第一次成功 · Warp · 一台终端形状的元工具

**作者** Aklman · **章节** 02 / 12 · **首发** 2026.08 · **语言** 中文为主, 中英双语
**原文** https://library.aklman.com/books/warp/02-first-win
**全书 markdown** https://library.aklman.com/books/warp/llms.md
**上一章** https://library.aklman.com/books/warp/01-intro/llms.md
**下一章** https://library.aklman.com/books/warp/03-blocks/llms.md

> 本章来自 Aklman · Library, 完整免费阅读。允许 AI 摘读、引用、问答; 转载请保留作者署名与原文链接 (CC BY-NC-ND 4.0, https://library.aklman.com/license)。

---

> 安装、登录、三个必要设置,然后把第一件真实的活交办出去 —— 让 agent 只读地分析你机器上最占地方的东西,跑通、看懂、存下来。10 分钟后你不再是装过 Warp 的人,是用它做成过一件事的人。每一步精确到按什么键;说不准的地方标「待核」,不编。

这一章没有概念,只有动作。目标:10 分钟后,你的机器上多一个装好的 Warp,和一个你亲手交办成功的任务。跟着做,别跳步。

### I · 装上它(约 2 分钟)

按你的系统选一条路。装完打开,你会看到一个可以直接输入的终端 —— 到这里为止不需要账号,终端的全部基本功(Blocks、补全、历史)开箱即用。[^1]

#### macOS

```text

```bash
# 有 Homebrew:
brew install --cask warp

# 没有的话:从 warp.dev 下载,把 Warp 拖进 Applications
```

```

#### Windows

```text

```powershell
# 有 WinGet:
winget install Warp.Warp

# 没有的话:从 warp.dev 下载 .exe 安装包运行
```

```

#### Linux

```text

```bash
# Debian / Ubuntu:从 warp.dev 下载 .deb 后
sudo apt install ./warp-terminal.deb

# 其他发行版:下载页还有 .rpm / .tar.zst / AppImage
```

```

打开后先做一件 10 秒钟的事,确认底座活着:敲 ls 回车。输出会收进一个独立的 block —— 命令和它的结果包在一起,可以单独复制、单独回看。这就是 Warp 与传统终端的第一眼差别,也是后面一切的地基。

---

### II · 登录,和 agent 的三条路(约 2 分钟)

终端不用登录,但 **agent 是账户功能**:每一次交办都走 Warp 的云端 harness,credits 记在你的账号上,所以用 agent 之前先点右上角登录(首次会开浏览器走授权,回来就登上)。[^1][^2]登录之后,让 agent 跑起来有三条路,按你的现状选:

|| 你的现状 | 走哪条 | 怎么做 |
| :-- | :-- | :-- |
| 手里有 OpenAI / Anthropic / Google 的 API key | BYOK(最顺) | 打开 Settings(⌘,),搜 API keys,把 key 贴进去;模型选择器里带钥匙图标的模型就会走你的 key,provider 直接计费,不耗 Warp credits |
| 没有 key,想先零门槛试 | 按量充值(PAYG) | Free 档支持按 pay-as-you-go 价格买 credits;在 Settings > Billing and usage 里充一小笔,够你跑完这本书的前几章 |
| 确定会常用 | Build 档(正经答案) | 月付 $20 / 年付折算 $18,含 1500 credits/月;同一个 Billing and usage 页点 Upgrade(价格截至 2026-08-06,选型章细讲) |

> 一个常见的误会先掐掉:**你订阅了 ChatGPT 或 Claude,不等于你有能接进 Warp 的东西**。官方明示:OpenAI 和 Anthropic 的消费级订阅不允许接进第三方客户端,要用自己的账号只能走 API key(BYOK);唯一的消费订阅通道是 xAI 的 SuperGrok。[^3]两条补充:pricing 页 Free 档那行「Bring your own AI inference*」的星号脚注在页面上不展开,个别边界(如组织规模)以 BYOK 文档页为准并标「待核」;按量充值的实际入口文案以你账号里看到的为准。

---

### III · 三个必要设置(约 2 分钟)

设置项很多,只有三个和「第一次就交办成功」直接相关。其余的 —— 尤其是主题 —— 跑通之后再回来玩。

- **确认 auto-detection 开着,认识 (autodetected) 标记**:
 Settings > Agents > Warp Agent > Input 里,`Autodetect agent prompts in terminal input` 新用户默认开。它的作用:你在普通输入框打一句人话,提交前 Warp 用 magenta 色标 `(autodetected)` 告诉你这句会发给 agent;打的是 shell 语法就直接当命令跑。认错了就按 `⌘I`(Windows / Linux:`Ctrl+I`)手动改判,或加 `!` 前缀强制当命令跑。[^5]

- **把命令面板和 Drive 的键位按进手指**:
 只记四个:`⌘P` 命令面板(搜一切功能、workflow、设置)、`⌘\` 开关 Warp Drive、`⌃R` 命令搜索(历史 / workflow / agent 对话统一搜)、`⌘,` 设置。Windows / Linux 上对应 `Ctrl+Shift+P` 系,完整表在 Settings > Keyboard shortcuts。[^4]

- **主题:选一个暗色或亮色,然后关掉设置页**:
 认真的 —— 主题不改变你做事的速度。挑一个顺眼的(`⌃⌘T` 打开主题选择器),然后回来继续。这本书后面不会再提外观。

---

### IV · 第一次交办(约 3 分钟)

现在把一件真实的活交出去。选一件只读、低风险、人人都有的:让 agent 看看你磁盘上最占地方的是什么。这个任务故意只读 —— 第一次建立信任的方式,是看它干活,而不是让它改东西。

- **按 ⌘↩ 开一个 agent 会话**:
 在终端输入框直接按 `⌘↩`(Windows / Linux:`Ctrl+Shift+Enter`)。输入框会展开成一个带模型选择器的对话视图 —— 这就是 Agent Mode。[^1]

- **把这句话贴进去,回车**:
 用下面这个 PromptBox 的示例 tab 里那句(复制按钮直接拷)。它要求 agent 只读、给命令先给你看 —— 第一次交办的两个好纪律,从第一天就养成。

- **看它跑:每条命令你都有机会说不**:
 agent 会拆步骤:先跑 du / df 这类只读命令,读输出,再决定下一步。每条命令跑前都会摆出来等你确认 —— 看一眼,认得就放行,不认得就拒绝并问它「这条是干什么的」。这个过程本身就是教学。

- **验收:你得到了一张清单,和一个判断**:
 成功的样子:它给你一张按大小排的清单,标出哪些大概率能清(缓存、旧下载、安装包),哪些别碰 —— 并且没有删任何东西。你 3 分钟前还不知道答案的问题,现在有答案了。

**提示词 · 第一次交办:只读、给命令先看**

```text
只读分析,不要改任何文件:
1. 列出 <目录> 下最占空间的 10 个文件/目录,按大小排序;
2. 每条打算跑的命令先给我看,我确认再跑;
3. 标出哪些大概率可以清理(缓存/旧下载/安装包),哪些别碰;
4. 最后给我一段 100 字以内的结论。
```

**示例**

```text
只读分析,不要改任何文件:
1. 列出 ~ 下最占空间的 10 个文件/目录,按大小排序;
2. 每条打算跑的命令先给我看,我确认再跑;
3. 标出哪些大概率可以清理(缓存/旧下载/安装包),哪些别碰;
4. 最后给我一段 100 字以内的结论。
```

#### 没有 Warp 的这 3 分钟

打开访达或资源管理器,按大小排序,逐层点进去看;或者打开搜索引擎查「du 按大小排序」「mac 查看大文件」,拼出一条命令,跑,发现输出不对,再查。

#### 刚才这 3 分钟

你用一句话换来了:一张排好序的清单、每条命令的解释权、和一个没被改动过的文件系统。这就是「交办」的最小完整形态 —— 后面十一章都在给它加宽加深。

---

### V · 存下来(约 1 分钟)

跑通了别让它过去 —— 让它变成资产。在 agent 给出的那段结果上,用 Block Actions(块右键菜单)或对话里的 `Save as Workflow` 把它存成一个带参数的 Workflow;按 `⌘\` 打开 Warp Drive,确认它躺在里面。下个月磁盘再满,你不用再写那句话 —— 从命令面板调出这个 workflow 就行。这个「跑通 → 存下 → 复用」的动作是第六章的主题,今天先完成第一次。[^1]

> 如果 agent 给出的命令你不认识:别放行,直接在同一个对话里问「逐行解释这条命令,特别是 `-` 开头的参数」。它读着自己写的命令解释给你听,这是 Agent Mode 最便宜也最常被人忽略的用法。

到这里,验收这一章 —— 逐条都能勾上,你才算拿到了首胜:

- Warp 装好了,ls 的 output 收进了一个独立的 block。

- 我登录了账号,并且知道我的 agent 走哪条路:BYOK、按量充值,还是 Build。

- 我认得 (autodetected) 标记,会用 ⌘I 改判、会用 ! 前缀强制当命令跑。

- 我用 ⌘↩ 开了第一个 agent 会话,交办了一个只读任务,逐条审了它要跑的命令。

- 我拿到了那张「最占空间」的清单,并且文件系统没被改动。

- 这次交办存进了 Warp Drive,我能用 ⌘\ 再看到它。

> 10 分钟前你装的是一个终端,
> 现在你有一个能交办的搭档

## 引用与参考

01 · Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。  (Warp Docs · Quickstart)
02 · Warp Docs · Credits —— 截至 2026-08-06:Free 档不含 Warp Agent 自带用量,要用 agent 需 BYOK / custom endpoint / SuperGrok / X Premium,或升付费档;credits 分 AI / compute / platform 三桶,同一额度池;普通 shell 命令不消耗 credits;余额与用量在 Settings > Billing and usage。  (Warp Docs · Credits)
03 · Warp Docs · Bring Your Own API Key —— BYOK 支持 OpenAI / Anthropic / Google,Free 与符合条件的付费档可用(个人及 10 人以内组织);key 只存本机;官方明示:ChatGPT / Claude 的消费级订阅不能像 SuperGrok 那样接入 Warp,要用自己的 OpenAI / Anthropic 账号需走 API key 的 BYOK。  (Warp Docs · BYOK)
04 · Warp Docs · Keyboard Shortcuts —— 截至 2026-08-06:⌘P 命令面板、⌘\ Warp Drive、⌃R Command Search、⌃⇧R Workflows、⌃` Generate(自然语言生成命令);自定义键位在 Settings > Keyboard shortcuts,或按 keysets 仓库的文件方式批量导入。  (Warp Docs · Keyboard Shortcuts)
05 · Warp Docs · Terminal and Agent modes —— auto-detection 对新用户默认开启(老用户默认关闭),提交前以 magenta 的 (autodetected) 标注分流方向;两个开关在 Settings > Agents > Warp Agent > Input;⌘↩ 起新 agent 会话,⌘Y 继续上一段。  (Warp Docs · Terminal and Agent modes)

---

*首胜 · 10 分钟拿到第一次成功 · Warp · 一台终端形状的元工具 · Aklman 著 · CC BY-NC-ND 4.0 · https://library.aklman.com/books/warp/02-first-win*