快速开始

选一个项目和 Agent,发出第一条消息,回答 Agent 的请求。

打开新建会话

点侧边栏顶部的新建会话,或者按 ⌘N(macOS)、Ctrl+N(Windows 和 Linux)。页面上方写着“想做点什么?”,下面是输入框。输入框下方选会话在哪里工作、由哪个 Agent 来做。

选项目

点输入框下方的文件夹按钮,一开始写着选择项目。选一个最近的项目,或者点打开项目…(⌘O 或 Ctrl+O)添加一个文件夹,Agent 就在这个文件夹里工作。只是想问点什么,可以选无项目,会话在自己的临时文件夹里运行。

选 Agent 和模型

点右边的 Agent 按钮,一开始写着选择 Agent。菜单左边列出你的 Agent,右边是选中那个 Agent 的模型、推理强度和开关。按钮旁边是模式菜单。

菜单里列的是这台电脑上装好的 Agent。Claude Code 在 Kettu 装好它需要的部分之前,显示首次使用时自动配置。想用的 Agent 不在里面,点设置 Agent…,或者到设置 › Harness 里安装(见安装)。想每次都用同一个 Agent,在设置 › 通用 › 默认 Agent 里选。

需要时登录

要先登录的 Agent 在菜单里显示需要登录。点登录…会打开设置 › Agent 里它的页面,点在终端中登录,Kettu 在自己的终端里运行这个 Agent 自己的登录命令。Kettu 不会获取你的凭据。

发出第一条消息

描述任务,按 Enter 发送。想改成 ⌘Enter 或 Ctrl+Enter 发送,到设置 › 通用 › 发送快捷键里改。+ 按钮添加文件、照片或文件夹,也可以直接粘贴图片,输入 @ 引用项目里的文件。会话随这条消息开始,出现在侧边栏对应的项目下。

回答授权请求

Agent 要运行命令或改文件前,会在对话里用一张卡片问你。点一个选项,或者在输入框为空时按 1 到 4。详见授权请求。

侧边栏的标记

几个会话可以同时运行。每一行只显示一个标记,最要紧的优先:

标记意思
带光圈的圆点等待你处理:有授权请求没回答
警告图标错误:会话失败,或 Agent 停止了
转圈运行中;灰色的表示正在启动
圆环提示缓存快要过期(见 Claude Code)
灰色小圆点未读:有你还没看过的新内容

Kettu 的窗口都不在前台时,会话需要授权、完成或出错,系统通知会提醒你,点通知就回到那个会话。要哪些通知,在通知里选。