这篇教程带你从下载到跑起第一个 Agent，只要几分钟。之后再介绍你每天都会用到的布局和快捷键。
系统要求
- macOS 15 或更高版本，Apple 芯片或 Intel 均可
- 至少安装并登录一款 Agent CLI（见下文）
1. 安装 Vibe Console
- 下载 Vibe Console 并打开 DMG。
- 把 Vibe Console 拖进“应用程序”文件夹。
- 从“应用程序”里打开它。因为应用来自互联网，macOS 会询问一次：点 打开。
每次下载都附带 14 天全功能免费试用。
2. 安装 Agent CLI
Vibe Console 启动的是你已经在用的 Agent CLI，它本身不捆绑这些 CLI，也不带模型。请按官方说明安装并登录至少一款。下面是应用为每款 Agent 运行的命令：
| Agent | 命令 |
|---|---|
| Claude Code | claude |
| Codex | codex |
| Grok Build | grok |
| Gemini CLI | gemini |
| GitHub Copilot CLI | copilot |
| Cursor CLI | cursor-agent |
| Qwen Code | qwen |
| Kimi Code | kimi |
如果你选的 Agent 对应命令没装，Vibe Console 会告诉你怎么安装。
3. 添加项目并启动 Agent
- 按 ⌘O（或使用“项目”侧边栏），选择你的项目文件夹。
- 在“开始”按钮旁边的选择器里选一个 Agent。
- 点 开始 或按 ⌘K。
如果当前终端是一个空闲的 shell，Agent 就在这里启动；否则会新开一个终端。不管哪种，都在你的项目目录里。
4. 配置你的终端
一个项目最多可以有 10 个终端。按 ⌘⇧T 新建终端，用工具栏在 标签页 和 网格 之间切换。网格布局从 1×2 到 3×3。
大多数 Web 项目都适用的一种布局：
- 终端 1：Claude Code
- 终端 2：Codex，审查 Claude 改了什么
- 终端 3：开发服务器（
npm run dev） - 终端 4：测试监听（
npm run test:watch）
右键点标签页，选 重命名…，给终端起个好认的名字。每个标签页都有一个圆点，显示它的 Agent 在运行还是空闲。更大规模的配置，可以看 如何并行运行多个 Claude Code Agent。
5. 给 Agent 提供项目上下文
如果项目还没有上下文文件，文件树顶部会出现 初始化上下文（文件已存在时则是 审查上下文）。它会在 Claude Code 或 Codex 终端里准备一条提示词，让 Agent 写出 STRUCTURE.json、PROJECT_NOTES.md 和 tasks.json。发送前你可以先检查提示词，Agent 写入每个文件前也会先给你预览、等你确认。你自己的 CLAUDE.md 和 AGENTS.md 不会被动到。
6. 保存常用提示词
按 ⌘⇧S 打开“已保存的提示词”，把经常输入的提示词存进去，比如一份审查清单。点一下就能粘贴到当前终端。提示词可以全局保存，也可以按项目保存。
快捷键
| 快捷键 | 作用 |
|---|---|
| ⌘K | 启动所选 Agent |
| ⌘O | 添加项目文件夹 |
| ⌘⇧T | 新建终端 |
| ⌘⇧W | 关闭终端 |
| ⌘1 – ⌘9 | 跳到终端 1–9 |
| ⌃Tab / ⌃⇧Tab | 下一个 / 上一个标签页 |
| ⌘⇧[ / ⌘⇧] | 上一个 / 下一个项目 |
| ⌘B | 显示 / 隐藏侧边栏 |
| ⌘⇧G | 显示 / 隐藏源代码管理 |
| ⌘⇧S | 显示 / 隐藏已保存的提示词 |
第一周的小技巧
- 从文件树或访达把文件、图片拖进终端，就能把路径粘贴给 Agent。
- 在 设置 → 账号 里打开用量圆环，随时查看 Claude Code 和 Codex 的额度。
- 在 Skill 里添加一个你信任的 GitHub 仓库，并为 Claude Code 或 Codex 选好分区。参见 安装 Agent Skill。
- 在 设置 → 通用 → 语言 里选择界面语言。Vibe Console 支持 15 种语言。
试用结束后订阅
14 天试用期结束后，不会自动转为订阅。想继续使用，打开 设置 → 订阅，输入你的邮箱和我们发送的验证码，然后点 订阅…。结账页面会在浏览器中打开，一分钟内订阅就会同步到应用里。价格为 $4.99/月 或 $39.99/年，最多可在 3 台 Mac 上使用；要换到别的 Mac，先在这台 Mac 上点 退出登录，它就会从你的订阅中移除。更多内容见 帮助。