快速上手

这份指南带你从全新安装走到一次跑完的智能体会话，并让你能逐个事件地回放它。前提是 ORG-2 已经装好——如果还没有，请先看 安装 ORG-2。你还需要下面两者之一：某个模型服务商的 API 密钥，或者某个智能体 CLI（如 Claude Code、Codex、Gemini CLI）的现成订阅。

1. 打开 ORG-2，决定怎么登录

应用打开后是登录界面。你有两条路：

• 登录 —— 登入 ORG-2 账号，解锁云端和市场相关功能。
• 暂不登录，继续使用 —— 完全依靠自己的密钥运行。本页的内容都不需要账号。

选合适的那个就行。这个选择会一直保留，直到你登录或退出登录，之后也可以随时改。

2. 走完设置向导

首次运行的向导在左侧列出六个步骤。用 继续 和 返回 前后移动，点击任一步骤可直接跳转，也可以按 跳过设置 提前离开——这里没有任何一步是必须的。

1. 欢迎 —— 「让我们通过几个简单的步骤来配置您的工作区。」
2. 主题 —— 选 浅色 或 深色。之后在设置里随时可改。
3. 设置 Dev Passport —— 取一个 代号、选一个 头像，然后点 生成 Vibe Passport。这是你在 ORG-2 内部的工作署名身份。
4. 连接 GitHub —— 点 连接 GitHub 账户，就能在应用里直接访问仓库、提交和 pull request。你也可以稍后从 设置 → 集成 里连接。
5. 打开项目 —— 下面一节专门讲。
6. 完成 —— 点 开始使用。

走完（或跳过）之后，你会进入工作站（Workstation），也就是主要的工作界面。

3. 连接一个仓库

在 打开项目 这一步，二选一：

• 打开文件夹 —— 指向本地的一个 git 仓库，或者你手上任意一个文件夹。
• 克隆仓库 —— 从 GitHub 克隆。克隆表单提供 我的 GitHub 标签页（连接 GitHub 之后会列出你的仓库）和 GitHub URL 标签页，还有一个 克隆到 的父目录选择器。

如果你跳过了这一步，之后可以从侧边栏的 文件夹 区域用 添加工作区 补上。当一个任务横跨多个服务时，多个仓库可以编成一个 多仓库工作区（2–5 个仓库）。

4. 添加服务商密钥，或登录某个智能体 CLI

打开 设置 → 模型 & Keys。页面标题是 模型 & CLI，密钥只存在本地——它们不会离开你的机器。

如果用模型 API 密钥： 留在 我的 Keys 标签页，点 添加账户。向导会先问 提供商，再问 连接方式——API Key 还是 订阅。粘贴密钥并等它校验，通过之后这一行的状态会变成 可以使用。

如果用智能体 CLI 订阅： 切到 CLI 客户端 标签页，点 添加 Agent。有几个 CLI 支持用浏览器登录，不必粘贴密钥，例如 使用 Claude Code 登录、使用 Codex 登录 和 Sign in with Gemini。ORG-2 会接住授权回调，并把 OAuth token 存在本地。每个 CLI 那一行还会显示它是否 已安装、密钥状态，以及安装脚本。

只要有一个可用账户就能往下走。完整情况见 API 密钥。

5. 开启你的第一个会话

在左侧边栏点 新建会话。

1. 选一个 会话类别 —— 选择器把智能体分组为 内置 Agent（比如负责写代码的 SDE Agent 和负责电脑操作自动化的 OS Agent）、CLI Agent（「连接 CLI 编码 Agent」）、自定义 Agent、Agent 团队 和 外部 Agent。
2. 选一个 模型，需要时再选一个 账号 —— 就是你在第 4 步加的那些密钥。这两个选择器分别叫 选择模型 和 切换账号。
3. 在输入框里写你的任务。占位提示已经说明了最要紧的两个快捷键：「输入消息，使用 @ 添加文件，使用 / 调用 skills」。用 @ 把指定文件拉进上下文，用 / 调用 Skill、模式和模型。
4. 按发送箭头（发送）。

第一个任务尽量小而且好验证——「给 X 加个测试」「在整个仓库里把 Y 改名」「解释一下 Z 是怎么工作的」。如果你的提示词非常短，ORG-2 会在启动前请你确认一次。

6. 看它跑

会话会在工作站里打开，边干边流式输出。有两处值得看：

• 轨迹。 底部面板有一个 轨迹 标签页（旁边是 待办 标签页），事件发生时会实时填进去——工具调用、文件读写、终端命令、思考过程。第一个事件到达之前，它显示「暂无事件」。
• 工作站标签页。 智能体打开文件、执行命令或操作浏览器时，标签页会出现在下方的 dock 里。上方的筛选器可以在 所有标签页、代码、浏览器、数据库 和 项目 之间切换。

你不用一直盯着。会话是长时运行的，走开再回来就行。

7. 复盘发生了什么

一个轮次结束后，聊天会把它折叠成一行摘要——「Agent 工作了 …」——并附上工具调用次数和改动的文件数。从这里可以：

• 在改动文件条上点 查看，读这一轮的 diff。
• 用 查看 Diff 在独立窗口里打开整个会话的 diff。
• 从侧边栏打开 Ops Control，用看板视图查看每一个会话，列包括 待办、进行中、该你了 和 已结束。视图切换器还提供 列表 和 日志。

会话详情视图会呈现仓库、分支、轮次数、用到的模型、更改的文件，以及 Event 分析——工具用量、Token 用量、错误和耗时。

8. 回放它

轨迹之所以要被记录下来，就是为了回放：它按顺序重建智能体看到了什么、做了什么，而不是只留给你一份 diff 和一大堆文字。

• 整个会话： 在 Ops Control 里选中该会话，在详情页头部点 回放。播放从第一个事件开始。
• 单个轮次： 在聊天里，对已完成的轮次用 回放这轮 → 播放回放。

播放过程中你可以使用 播放 / 暂停、上一个事件 / 下一个事件 和 播放速度。筛选事件 能把事件流收窄到 关键交互、文件变更、终端事件、探索 或 其他。视图要么跟着智能体走（跟随 Agent），要么让你在时间轴照常推进的同时自己四处翻看（自由浏览）。

下一步

• 会话 —— 会话类型、长时运行，以及 worktree。
• 回放 —— 轨迹模型，以及回放能重建出什么。
• 智能体 —— 内置智能体、CLI 智能体和智能体团队。
• 项目 —— 围绕一个项目组织工作项和仓库。