首胜 · 10 分钟拿到第一次成功First Win · Your First Success in 10 Minutes.
安装、登录、三个必要设置,然后把第一件真实的活交办出去 —— 让 agent 只读地分析你机器上最占地方的东西,跑通、看懂、存下来。10 分钟后你不再是装过 Warp 的人,是用它做成过一件事的人。每一步精确到按什么键;说不准的地方标「待核」,不编。Install, sign in, three settings, then hand over one real job — have the agent read-only analyze what's eating your disk, watch it run, understand it, save it. In 10 minutes you are no longer someone who installed Warp, but someone who finished something with it. Every step down to the keystroke; what can't be verified is marked, not invented.
这一章没有概念,只有动作。目标:10 分钟后,你的机器上多一个装好的 Warp,和一个你亲手交办成功的任务。跟着做,别跳步。This chapter has no concepts, only moves. The goal: in 10 minutes, your machine has a working Warp and one task you personally dispatched to success. Follow along; don't skip.
— I
装上它(约 2 分钟)Install It (About 2 Minutes).
按你的系统选一条路。装完打开,你会看到一个可以直接输入的终端 —— 到这里为止不需要账号,终端的全部基本功(Blocks、补全、历史)开箱即用。1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.Pick the row for your system. Open it when done, and you'll see a terminal ready for input — no account needed up to here; all the terminal's fundamentals (Blocks, completions, history) work out of the box.1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.
三条安装路径,任选其一;包管理器方式将来升级最省心Three install paths — pick one; the package-manager route upgrades easiest later
打开后先做一件 10 秒钟的事,确认底座活着:敲 ls 回车。输出会收进一个独立的 block —— 命令和它的结果包在一起,可以单独复制、单独回看。这就是 Warp 与传统终端的第一眼差别,也是后面一切的地基。Do one 10-second thing to confirm the base is alive: type ls and hit Enter. The output lands in its own block — the command and its results wrapped together, copyable and reviewable on their own. That's the first visible difference from a traditional terminal, and the foundation for everything later.
— II
登录,和 agent 的三条路(约 2 分钟)Sign In, and the Three Roads to the Agent (About 2 Minutes).
终端不用登录,但 agent 是账户功能:每一次交办都走 Warp 的云端 harness,credits 记在你的账号上,所以用 agent 之前先点右上角登录(首次会开浏览器走授权,回来就登上)。1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.2注 2Note 2Warp 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 — as of 2026-08-06: the Free plan includes no bundled Warp Agent usage — use BYOK / a custom endpoint / SuperGrok / X Premium, or upgrade; credits come in AI / compute / platform buckets drawing from one pool; plain shell commands consume no credits; balance and usage live under Settings > Billing and usage.登录之后,让 agent 跑起来有三条路,按你的现状选:The terminal needs no sign-in, but the agent is an account feature: every dispatch runs through Warp's cloud harness and credits land on your account, so click sign-in at the top right before using it (first time opens a browser for authorization, then you're in).1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.2注 2Note 2Warp 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 — as of 2026-08-06: the Free plan includes no bundled Warp Agent usage — use BYOK / a custom endpoint / SuperGrok / X Premium, or upgrade; credits come in AI / compute / platform buckets drawing from one pool; plain shell commands consume no credits; balance and usage live under Settings > Billing and usage. Once signed in, there are three roads to a running agent — pick by your situation:
|| 你的现状Your situation | 走哪条Which road | 怎么做How |
| :-- | :-- | :-- |
| 手里有 OpenAI / Anthropic / Google 的 API keyYou hold an OpenAI / Anthropic / Google API key | BYOK(最顺)BYOK (smoothest) | 打开 Settings(⌘,),搜 API keys,把 key 贴进去;模型选择器里带钥匙图标的模型就会走你的 key,provider 直接计费,不耗 Warp creditsOpen Settings (⌘,), search API keys, paste it in; key-icon models in the picker then route through your key, billed by the provider, spending no Warp credits |
| 没有 key,想先零门槛试No key, want to try first | 按量充值(PAYG)Pay-as-you-go reload | Free 档支持按 pay-as-you-go 价格买 credits;在 Settings > Billing and usage 里充一小笔,够你跑完这本书的前几章The Free tier lets you buy credits at pay-as-you-go rates; top up a small amount under Settings > Billing and usage — enough for this book's first chapters |
| 确定会常用You know you'll use it | Build 档(正经答案)Build tier (the serious answer) | 月付 $20 / 年付折算 $18,含 1500 credits/月;同一个 Billing and usage 页点 Upgrade(价格截至 2026-08-06,选型章细讲)$20 monthly / $18 annualized, 1,500 credits/month; click Upgrade on the same Billing and usage page (prices as of 2026-08-06; the tier chapter goes deep) |
设置项很多,只有三个和「第一次就交办成功」直接相关。其余的 —— 尤其是主题 —— 跑通之后再回来玩。There are many settings; only three directly affect whether your first dispatch succeeds. Everything else — especially themes — comes back later, after it works.
01
确认 auto-detection 开着,认识 (autodetected) 标记Confirm auto-detection is on, learn the (autodetected) mark
Settings > Agents > Warp Agent > Input 里,Autodetect agent prompts in terminal input 新用户默认开。它的作用:你在普通输入框打一句人话,提交前 Warp 用 magenta 色标 (autodetected) 告诉你这句会发给 agent;打的是 shell 语法就直接当命令跑。认错了就按 ⌘I(Windows / Linux:Ctrl+I)手动改判,或加 ! 前缀强制当命令跑。5注 5Note 5Warp Docs · Terminal and Agent modes —— auto-detection 对新用户默认开启(老用户默认关闭),提交前以 magenta 的 (autodetected) 标注分流方向;两个开关在 Settings > Agents > Warp Agent > Input;⌘↩ 起新 agent 会话,⌘Y 继续上一段。Warp Docs · Terminal and Agent modes — auto-detection is on by default for new users (off for pre-existing ones), marking the routed direction with a magenta (autodetected) label before submit; both toggles live in Settings > Agents > Warp Agent > Input; ⌘↩ starts a new agent conversation, ⌘Y continues the last one.Under Settings > Agents > Warp Agent > Input, Autodetect agent prompts in terminal input is on by default for new users. It works like this: type plain language in the normal input box and before you submit Warp marks it (autodetected) in magenta, meaning it's headed to the agent; shell syntax runs as a command directly. If it misreads you, press ⌘I (Ctrl+I on Windows / Linux) to override, or prefix with ! to force a shell run.5注 5Note 5Warp Docs · Terminal and Agent modes —— auto-detection 对新用户默认开启(老用户默认关闭),提交前以 magenta 的 (autodetected) 标注分流方向;两个开关在 Settings > Agents > Warp Agent > Input;⌘↩ 起新 agent 会话,⌘Y 继续上一段。Warp Docs · Terminal and Agent modes — auto-detection is on by default for new users (off for pre-existing ones), marking the routed direction with a magenta (autodetected) label before submit; both toggles live in Settings > Agents > Warp Agent > Input; ⌘↩ starts a new agent conversation, ⌘Y continues the last one.
02
把命令面板和 Drive 的键位按进手指Drill the palette and Drive keys into your fingers
只记四个:⌘P 命令面板(搜一切功能、workflow、设置)、⌘\ 开关 Warp Drive、⌃R 命令搜索(历史 / workflow / agent 对话统一搜)、⌘, 设置。Windows / Linux 上对应 Ctrl+Shift+P 系,完整表在 Settings > Keyboard shortcuts。4注 4Note 4Warp Docs · Keyboard Shortcuts —— 截至 2026-08-06:⌘P 命令面板、⌘\ Warp Drive、⌃R Command Search、⌃⇧R Workflows、⌃` Generate(自然语言生成命令);自定义键位在 Settings > Keyboard shortcuts,或按 keysets 仓库的文件方式批量导入。Warp Docs · Keyboard Shortcuts — as of 2026-08-06: ⌘P Command Palette, ⌘\ Warp Drive, ⌃R Command Search, ⌃⇧R Workflows, ⌃` Generate (natural-language command search); remapping lives in Settings > Keyboard shortcuts, or in bulk via files from the keysets repository.Memorize just four: ⌘P for the Command Palette (search every feature, workflow, setting), ⌘\ to toggle Warp Drive, ⌃R for Command Search (history / workflows / agent conversations in one), ⌘, for Settings. On Windows / Linux the Ctrl+Shift+P family applies; the full table lives in Settings > Keyboard shortcuts.4注 4Note 4Warp Docs · Keyboard Shortcuts —— 截至 2026-08-06:⌘P 命令面板、⌘\ Warp Drive、⌃R Command Search、⌃⇧R Workflows、⌃` Generate(自然语言生成命令);自定义键位在 Settings > Keyboard shortcuts,或按 keysets 仓库的文件方式批量导入。Warp Docs · Keyboard Shortcuts — as of 2026-08-06: ⌘P Command Palette, ⌘\ Warp Drive, ⌃R Command Search, ⌃⇧R Workflows, ⌃` Generate (natural-language command search); remapping lives in Settings > Keyboard shortcuts, or in bulk via files from the keysets repository.
03
主题:选一个暗色或亮色,然后关掉设置页Theme: pick dark or light, then close the settings page
认真的 —— 主题不改变你做事的速度。挑一个顺眼的(<Kbd>⌃⌘T</Kbd> 打开主题选择器),然后回来继续。这本书后面不会再提外观。Seriously — a theme doesn't change how fast you work. Pick one that's easy on your eyes (<Kbd>⌃⌘T</Kbd> opens the theme picker), then come back. This book won't mention appearance again.
— IV
第一次交办(约 3 分钟)Your First Dispatch (About 3 Minutes).
现在把一件真实的活交出去。选一件只读、低风险、人人都有的:让 agent 看看你磁盘上最占地方的是什么。这个任务故意只读 —— 第一次建立信任的方式,是看它干活,而不是让它改东西。Now hand over a real job. Pick one that's read-only, low-risk, universal: have the agent look at what's taking the most space on your disk. The task is deliberately read-only — the way to build trust the first time is to watch it work, not to let it change things.
01
按 ⌘↩ 开一个 agent 会话Press ⌘↩ to open an agent conversation
在终端输入框直接按 ⌘↩(Windows / Linux:Ctrl+Shift+Enter)。输入框会展开成一个带模型选择器的对话视图 —— 这就是 Agent Mode。1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.In the terminal input, press ⌘↩ (Ctrl+Shift+Enter on Windows / Linux). The input expands into a conversation view with a model picker — this is Agent Mode.1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.
02
把这句话贴进去,回车Paste this sentence in, hit Enter
用下面这个 PromptBox 的示例 tab 里那句(复制按钮直接拷)。它要求 agent 只读、给命令先给你看 —— 第一次交办的两个好纪律,从第一天就养成。Use the sentence in the Example tab of the PromptBox below (the copy button grabs it). It asks the agent to stay read-only and to show commands first — two good dispatch habits to build from day one.
03
看它跑:每条命令你都有机会说不Watch it run: you can say no to every command
agent 会拆步骤:先跑 du / df 这类只读命令,读输出,再决定下一步。每条命令跑前都会摆出来等你确认 —— 看一眼,认得就放行,不认得就拒绝并问它「这条是干什么的」。这个过程本身就是教学。The agent breaks the work into steps: read-only commands like du / df first, read the output, decide the next move. Every command is shown to you before it runs — read it, approve what you recognize, reject what you don't and ask 'what does this one do.' That process is itself the lesson.
04
验收:你得到了一张清单,和一个判断Accept: you got a list, and a judgment
成功的样子:它给你一张按大小排的清单,标出哪些大概率能清(缓存、旧下载、安装包),哪些别碰 —— 并且没有删任何东西。你 3 分钟前还不知道答案的问题,现在有答案了。Success looks like this: a size-sorted list, marking what's probably safe to clear (caches, old downloads, installers) and what not to touch — and nothing was deleted. A question you had no answer to three minutes ago now has one.
提示词Prompt第一次交办:只读、给命令先看First dispatch: read-only, commands shown first
只读分析,不要改任何文件:
1. 列出 <目录> 下最占空间的 10 个文件/目录,按大小排序;
2. 每条打算跑的命令先给我看,我确认再跑;
3. 标出哪些大概率可以清理(缓存/旧下载/安装包),哪些别碰;
4. 最后给我一段 100 字以内的结论。Read-only analysis — don't change any files:
1. List the 10 largest files/directories under <directory>, sorted by size;
2. Show me every command you plan to run first, and wait for my confirmation;
3. Mark what is probably safe to clean (caches / old downloads / installers) and what not to touch;
4. End with a conclusion of 100 words or fewer.
只读分析,不要改任何文件:
1. 列出 ~ 下最占空间的 10 个文件/目录,按大小排序;
2. 每条打算跑的命令先给我看,我确认再跑;
3. 标出哪些大概率可以清理(缓存/旧下载/安装包),哪些别碰;
4. 最后给我一段 100 字以内的结论。Read-only analysis — don't change any files:
1. List the 10 largest files/directories under ~, sorted by size;
2. Show me every command you plan to run first, and wait for my confirmation;
3. Mark what is probably safe to clean (caches / old downloads / installers) and what not to touch;
4. End with a conclusion of 100 words or fewer.
没有 Warp 的这 3 分钟Those 3 minutes without Warp
打开访达或资源管理器,按大小排序,逐层点进去看;或者打开搜索引擎查「du 按大小排序」「mac 查看大文件」,拼出一条命令,跑,发现输出不对,再查。Open Finder or Explorer, sort by size, click down level by level; or open a search engine for 'du sort by size' / 'find large files on mac', assemble a command, run it, find the output wrong, search again.
刚才这 3 分钟The 3 minutes you just had
你用一句话换来了:一张排好序的清单、每条命令的解释权、和一个没被改动过的文件系统。这就是「交办」的最小完整形态 —— 后面十一章都在给它加宽加深。One sentence bought you: a sorted list, the right to an explanation of every command, and an untouched filesystem. That's the smallest complete form of 'dispatch' — the next eleven chapters just widen and deepen it.
— V
存下来(约 1 分钟)Save It (About 1 Minute).
跑通了别让它过去 —— 让它变成资产。在 agent 给出的那段结果上,用 Block Actions(块右键菜单)或对话里的 Save as Workflow 把它存成一个带参数的 Workflow;按 ⌘\ 打开 Warp Drive,确认它躺在里面。下个月磁盘再满,你不用再写那句话 —— 从命令面板调出这个 workflow 就行。这个「跑通 → 存下 → 复用」的动作是第六章的主题,今天先完成第一次。1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.Don't let a working run pass — turn it into an asset. On the result the agent produced, use Block Actions (the block's right-click menu) or Save as Workflow in the conversation to save it as a parameterized Workflow; press ⌘\ to open Warp Drive and confirm it's in there. Next time the disk fills up you won't rewrite that sentence — you'll call the workflow from the palette. This 'ran it → saved it → reused it' move is chapter 6's subject; today, just do it once.1注 1Note 1Warp quickstart —— 截至 2026-08-06,官方上手路径:安装(brew install --cask warp / winget install Warp.Warp / Linux 各包)→ 跑第一条命令看 Blocks → 试输入编辑(Shift+Enter 多行)→ 自动补全(→ 接受)→ ⌘↩(macOS)/ Ctrl+Shift+Enter(Windows/Linux)向 agent 提第一个问题;「可以不注册账户,直接开始用」—— 终端功能开箱即用。Warp quickstart — as of 2026-08-06, the official path: install (brew install --cask warp / winget install Warp.Warp / Linux packages) → run a first command and see Blocks → try the input editor (Shift+Enter for multi-line) → autosuggestions (→ to accept) → ask the agent a first question with ⌘↩ (macOS) / Ctrl+Shift+Enter (Windows/Linux); 「You can optionally sign up for an account (top right), or skip and start using Warp immediately」 — the terminal works out of the box.到这里,验收这一章 —— 逐条都能勾上,你才算拿到了首胜:At this point, accept the chapter — only when you can check every line does the first win count:
Warp 装好了,ls 的 output 收进了一个独立的 block。Warp is installed, and ls output landed in its own block.
我登录了账号,并且知道我的 agent 走哪条路:BYOK、按量充值,还是 Build。I'm signed in, and I know which road my agent runs on: BYOK, pay-as-you-go, or Build.
我认得 (autodetected) 标记,会用 ⌘I 改判、会用 ! 前缀强制当命令跑。I recognize the (autodetected) mark, can override with ⌘I, and can force a shell run with the ! prefix.
我用 ⌘↩ 开了第一个 agent 会话,交办了一个只读任务,逐条审了它要跑的命令。I opened my first agent conversation with ⌘↩, dispatched a read-only task, and reviewed its commands one by one.
我拿到了那张「最占空间」的清单,并且文件系统没被改动。I got the 'what's taking space' list, and my filesystem was not modified.
这次交办存进了 Warp Drive,我能用 ⌘\ 再看到它。The dispatch was saved into Warp Drive, and I can see it again with ⌘\.
10 分钟前你装的是一个终端,
现在你有一个能交办的搭档.
Ten minutes ago you installed a terminal,
now you have a partner you can dispatch to.
Aklman Library
— 讨论Discussion
讨论Discussion.
评论区初始化中…Initializing comments…
01 / 01
没有匹配结果No matches.
换个关键词，或按 Esc 回到页面Try another keyword, or press Esc to return
