AIGC标识 装好 AI 编码工具后先让它干什么？Caravel 新手 20 分钟 6 步：从下载到第一次验收 AI 改动

一句话答案：第一次用 AI 编码 Agent，别急着让它「重构整个项目」——先装好一个 Agent、加一个你熟悉的项目，发一个一句话就能说清的小任务，然后看 Diff 决定留不留。在 Caravel 里这对应 6 步：认识界面 → 下载安装 → 安装并登录 Agent → 添加项目 → 发出第一个任务 → 查看结果并验收，按手册走一遍大约 20 分钟。第一个任务，从一句写清楚的需求开始。

很多人装好 AI 编码工具后的第一个问题是「我该让它干什么」。我的答案是：先发一个小任务，完整走完一次「派发—验收」，摸清它会怎么动你的项目、你怎么拦住它、不满意怎么撤回，之后再放心交给它更大的活。

本文演示工具：Caravel —— 本地优先的多 AI 编码 Agent 桌面工作台，统一管理 Claude Code、Codex、OpenCode、pi、Grok、TRAE、Antigravity 的并行任务、协作团队、代码 Diff 验收与工作流。免费使用，支持 macOS 与 Windows。

作者立场：本文作者在做 Caravel。下面的步骤、按钮名和选项都来自 Caravel 中文手册「新手上路」6 篇和常见问题，可以装好后自己对照；文末也写清它做不到的地方。只用命令行的读者，可以直接看「不用工作台，只用命令行能走同样的流程吗？」一节。

第一次用，20 分钟真的能走完吗？要准备什么？

直答：能。手册的「新手上路」一共 6 篇，按顺序做大约 20 分钟，前提是你手边有：

  • 一台 macOS（Apple Silicon 或 Intel）或 Windows x64 电脑（没有 Linux 版）；
  • 一个本地项目文件夹，Git 仓库或普通文件夹都行（想用隔离副本、独立分支，则需要是 Git 仓库）；
  • 至少一个 Agent 的账号（例如 Claude Code 或 Codex），模型费用按各厂商的订阅或 API 计费，由你自己的账号支付；
  • Windows 额外要先装好 Git for Windows 和 Node.js：Node.js 用于安装通过 npm 分发的 Agent，Git 用于隔离副本和分支。

Caravel 本身免费使用，它不包含 AI 模型：你在 Caravel 里发任务、看进度、做验收，实际读代码和改代码的是你电脑上的 Agent。

第 1 步：打开后界面一堆区域，先看哪几块？

直答：主界面叫「工作台」，分 6 个区域；刚开始只需要记住左上角蓝色的 新建任务 按钮，以及任务列表右下角的状态小字。

编号 区域 用来做什么
① 功能菜单 在工作台、定时器、数据库等功能之间切换，刚开始只用 工作台
② 工作区 你添加进来的项目文件夹，Agent 只在你指定的工作区里干活
③ 任务列表 你发出的每件事都是一个「任务」，按项目分组，右侧小字是状态
④ 任务标题栏 任务名称、状态、使用的 Agent 和模型，右上角是验收按钮
⑤ 对话区 Agent 的回复、执行计划和结果，像聊天记录一样往下滚
⑥ 输入框 对当前任务补充要求或继续提问

任务状态看这 4 种就够：

状态 含义 你要做什么
运行中 Agent 正在干活，后面的数字是已用时间 等着，也可以随时补充要求
待确认 Agent 要执行需要你同意的操作，或有问题问你 点开看清楚，再确认或回复
待验收 Agent 做完了，等你检查结果 查看改动，决定是否采用
已完成 你已经验收过 无需处理

另外还可能看到 已停止（你手动停下的）和 已失败（运行出错，可以点 重新运行）。

第 2 步：去哪下载？Windows 找不到安装包、第一次打开被拦怎么办？

直答：到 GitHub Releases 下载：https://github.com/yy36295238/caravel-agent/releases ，在版本的 Assets 里按系统选文件。

文件 适用系统
以 _universal.dmg 结尾 macOS，Apple Silicon 和 Intel 通用
以 _x64-setup.exe 结尾 Windows x64
  • Windows 注意：最近几个版本可能只有 macOS 包，请在 Releases 列表里往下翻，找带 x64-setup.exe 的版本。
  • 列表里的其他文件用于自动更新和校验，不用下载。
  • 安装：macOS 双击 .dmg，把 Caravel 拖进「应用程序」；Windows 双击 .exe，按向导一路下一步。

第一次打开被拦截：Caravel 安装包暂未使用 Apple 和微软的开发者签名，所以系统会拦第一次打开。先确认安装包来自上面的 Releases 页，再这样放行（只需处理一次）：

  • macOS：先双击打开一次，在提示里点 完成；再到「系统设置 → 隐私与安全性」，往下找到 Caravel 被阻止的说明，点 仍要打开（部分系统显示为「仍然打开」），输入密码或用触控 ID 确认。找不到按钮时，也可以在终端执行下面这条命令后重新打开：

    xattr -dr com.apple.quarantine /Applications/Caravel.app

    这条命令只移除 Caravel 的下载隔离标记，不会关闭系统的安全检查；提示 Permission denied 时在前面加 sudo。

  • Windows：出现「Windows 已保护你的电脑」时，点 更多信息 → 仍要运行。

以后有新版本，Caravel 会在启动时提示更新，也可以在 设置 里手动检查，两个平台都支持应用内更新。

第 3 步：Agent 要单独装吗？装完怎么登录？

直答：要。在 设置 → Agent → 安装 Agent 里点安装即可，然后按该 Agent 自己的方式登录一次，再选好默认 Agent 和运行权限。

  1. 点左下角 设置，进入 Agent 页，切到 安装 Agent，找到要用的 Agent 点右侧安装。目前支持 Claude Code、Codex、OpenCode、pi、Grok、TRAE 和 Antigravity，用其中任意一个就能开始；已安装的会显示版本号，可以单独升级或 全部升级。
  2. 登录账号：每个 Agent 用自己的账号体系。以 Claude Code 为例，打开终端运行 claude，按提示完成登录。
  3. 回到 通用配置，选择 默认 Agent，以后新建任务会预先选好它。
  4. 运行权限 新手选 等待确认：遇到需要额外权限的操作时暂停，任务变成 待确认，等你同意；全自动 则不再询问，只适合完全信任的任务。

Windows 用户可以在 配套工具 页签查看 Git 和 Node.js 是否已就绪。

第 4 步：项目怎么加进来？从 Caravel 里移除会不会删我的文件？

直答：在左侧 工作区 标题右边点 +，选择分组、点 目录 选项目文件夹，再点 添加。移除工作区只是取消登记，不会删除电脑上的文件。

  • 加进来的项目文件夹就叫「工作区」，Agent 只在你指定的工作区里干活。
  • 旁边的文件夹图标是 新建分组，可以把项目归成「公司项目」「个人项目」。
  • 项目名右边的数字是该项目下的任务数；右键可以移到其他分组。
  • 新建任务的弹窗里也有 添加工作区 按钮，不用先回侧栏。

第 5 步：第一个任务怎么写需求？权限选哪个？

直答：点 新建任务 → 左侧选项目 → 在 任务目标 里用一两句话写清楚要做什么 → 确认权限、Agent、模型 → 创建并运行。需求写得越具体，结果越接近你想要的：

不够具体 更好的写法
改一下标题 把首页标题改成蓝紫渐变色，手机上也要显示正常
修 bug 登录页输入错误密码后没有提示，请加上「密码错误」的红色提示

权限决定 Agent 做事前要不要先问你，第一次保持默认即可：

权限 适合什么时候
请求批准 默认选项。Agent 可以直接改文件，运行命令等其他操作会先问你
先规划 不确定它会怎么做时用。先给出计划，你同意后才动手
完全访问 不再逐项询问，所有命令直接执行。只在完全信任这次任务时用

（具体执行方式取决于所选 Agent 的支持情况。）

新建任务弹窗：选工作区、写任务目标、选 Agent

图1：新建任务弹窗（示例数据）：左侧选中工作区 caravel，右侧「任务目标」写着「给安装指引补上一节缺失内容」；下方权限为默认的「请求批准」，Agent 下拉框里可选 Claude Code、Codex、OpenCode、pi、Grok 等，右下角是「创建并运行」。

创建后任务出现在列表最上方，显示 运行中 和已用时间，任务计划 会显示 Agent 拆分的步骤和进度。运行中想到新要求，直接在输入框补充就行，不用等它做完；也不用守着屏幕，可以同时发出多个任务，需要你处理时状态会变成 待确认 或 待验收。

第 6 步：AI 说做完了，我怎么验收？

直答：状态变成 待验收 后，按「读总结 → 查看 Diff → 做决定」三步走。它做得对不对，由你来判断。

  1. 点开 待验收 的任务，先读对话区里 Agent 的执行计划、改了什么和验证结果。
  2. 点标题下方显示分支名的按钮（例如 main +2，数字是改动的文件数），再点 查看 Diff。
  3. 在改动窗口逐个文件看：左侧是文件列表，红色背景是删掉的旧代码，绿色背景是新增的代码，可以切换 左右 对照或 行内 显示。
  4. 做决定：改动符合预期就采用；大体可以但还要调整，就直接在输入框写问题（例如「按钮颜色再浅一点」），Agent 会接着改；方向不对就放弃。

待验收任务：先读 Agent 的总结

图2：待验收任务（示例数据）：任务「为任务列表添加快捷搜索」状态为「待验收」，对话区里 Agent 先列出计划，再说明改动和验证结果；标题下方的「main +2」是改动入口，右上角是「放弃改动」和「通过并合并」（这是隔离副本任务）。

逐个文件查看 Diff

图3：改动窗口（示例数据）：共 3 个文件 +11 −3，左侧切换文件，右侧左右对照显示 search.ts 的修改，红删绿增。

按钮为什么和截图不一样？ 取决于运行方式：

运行方式 Agent 在哪改 验收时
工作区（默认） 直接改你的项目文件夹 改动已写入项目，右上角只有 完成
隔离副本 项目的一份临时副本 通过并合并 回项目，或 放弃改动（会再次确认，不可撤销）
独立分支 从 main/master 新建分支的副本 在分支上提交并推送，再到代码托管平台发起合并请求，不自动合并

想「先看再合」，就在 设置 → Agent → 通用配置 的「运行方式」里打开 隔离副本，之后新建任务时选它；隔离副本和独立分支需要项目是 Git 仓库。

中途变成「待确认」怎么办？ 说明 Agent 要执行需要你同意的操作（例如运行安装命令），或有问题问你。点开任务看清它要做什么，同意就点请求卡片上的允许选项或右上角 确认；不同意可以拒绝，或在输入框告诉它换一种做法。

新手最容易卡在哪？

  • 新建任务时找不到 Agent：到 设置 → Agent → 安装 Agent 点 刷新，确认已安装；刚装的 Agent 还要登录账号。Windows 再确认 Git for Windows 和 Node.js 已装好。
  • 任务一直「运行中」，像卡住了：工作台和看板会对长时间没有输出的任务提示「疑似卡住」。先打开看看最新输出；确实卡住就点输入框右下角的停止按钮，再发一条消息让它继续。设置里的静默超时也会自动停止长时间无输出的任务。
  • 担心 Agent 乱改项目：保持默认的 请求批准（改文件可以，运行命令前先问你），想先看结果再决定就开 隔离副本。但要记住：权限确认不等于完整的安全沙箱，Agent 执行的是你电脑上的真实命令，只在信任的项目里用 完全访问。

不用工作台，只用命令行能走同样的流程吗？

直答：能，6 步的逻辑一样，只是每一步要自己在终端里做：

# 准备：干净的 Git 状态 + 练习分支
git status
git switch -c try/first-agent

# 派发：在项目目录里启动 Agent，发一句具体需求（安装、登录方式以各 CLI 当前文档为准）
claude      # 或 codex

# 验收：先看范围，再逐行看
git diff --stat
git diff

# 不满意：撤回（git clean 先用 -n 预览）
git restore .
git clean -fdn

区别在于：几个任务并行时，要自己记哪个终端在跑什么、哪个在等你确认；工作台把状态、授权和 Diff 放在同一个界面里。

常见问答

  • Caravel 要付费吗？ 本身免费使用；Agent 背后的模型由各厂商收费，用你自己的订阅或 API 账号。
  • 支持哪些系统？ macOS（Apple Silicon / Intel）和 Windows x64，没有 Linux 版。
  • Caravel 自带模型吗？ 不带。它管理的是你电脑上已安装并登录的 Agent。
  • 关掉窗口，任务还会继续吗？ 会。关闭主窗口后 Caravel 转到后台（macOS 菜单栏、Windows 托盘）继续运行，选择退出后才真正停止。
  • 可以同时跑多个任务吗？ 可以，每个任务独立运行，可以用看板和分屏同时看。
  • 我的任务和对话存在哪？ 保存在你的电脑本地；Agent 调用在线模型时需要联网，发送的内容由对应的 Agent 和模型厂商处理。

边界说明

  • 权限确认（请求批准 / 等待确认）不等于完整的安全沙箱，Agent 执行的是你电脑上的真实命令。
  • 安装包暂未使用 Apple / 微软开发者签名，第一次打开需要手动放行；请只从 GitHub Releases 获取安装包。
  • 默认的「工作区」运行方式会直接改你的项目文件；想先看后合，需要开启隔离副本，且项目必须是 Git 仓库。
  • 独立分支不会自动合并，也不会自动发起合并请求，需要你到代码托管平台操作。
  • Caravel 不包含模型，Agent 的登录、额度和模型能力由各厂商决定；具体权限档位的执行方式取决于所选 Agent 的支持。
  • 平台只有 macOS 与 Windows x64；Windows 最近几个版本可能只有 macOS 包，需要在 Releases 里找带 x64-setup.exe 的版本。

想试试的话

  1. 先看 GitHub 主页的界面截图和安装说明，心里有个数：https://github.com/yy36295238/caravel-agent
  2. 想了解完整功能，看功能介绍：https://github.com/yy36295238/caravel-agent/blob/main/docs/product-overview.md
  3. 到 Releases 下载安装包：https://github.com/yy36295238/caravel-agent/releases （macOS 用 .dmg；Windows 用 Releases 里带 x64-setup.exe 的版本），然后照本文 6 步发出第一个任务。

本文展示的界面来自 Caravel（免费使用，macOS / Windows）。GitHub 主页有界面截图和安装说明，完整功能见 功能介绍，安装包在 Releases。

posted @ 2026-10-30 11:09  36295238  阅读(17)  评论(0)    收藏  举报