English
4
下载Agent文档价格更新日志 GitHub4 个 StarEnglish

常见问题

最常遇到的问题怎么解决，解决不了的怎么反馈。

Agent

新建会话里没有某个 Agent

新建会话只列出已安装的 Agent，Kettu 在你登录 Shell 的 PATH 里找它们。在设置 › Harness 里，没找到的 Agent 列在未安装下，点**安装…可以看到它官方文档里的安装方式。如果它装在 Kettu 找不到的位置，点已经装在别处？选择可执行文件…**选中它。

如果是在 Kettu 打开期间、在你自己的终端里装的，点设置 › Harness 底部的重新加载环境。

Agent 需要登录

Agent 菜单里它标着需要登录，启动时会弹出登录 Codex 这样的对话框。点在终端中登录，按 Agent 自己的方式登录，再点我已登录，重试。Codex 也可以在终端里运行 codex login。Kettu 不经手你的凭据。

Agent 安装失败

  • 以 ACP 包安装的 Agent 需要 Node.js 22 或更高版本以及 npm；fast-agent 和 Minion Code 需要的是 uv。装好之后，在设置 › Harness 里点重新加载环境。
  • 需要代理时，在设置 › 高级 › 代理里设置，Agent、npx 和更新都会用它。
  • 复制日志可以复制安装过程的输出，安装失败，重试再试一次。

Claude Code 提示你的 claude 版本太旧

Kettu 经 Claude Agent SDK 驱动你自己安装的 claude，SDK 要求 Claude Code 不低于它构建时对应的版本。版本更旧时，Claude Code 会提示需要更新的 claude，并写出你当前的版本。在设置 › Harness › Claude Code 里点更新到加版本号的按钮，它会按你安装 Claude Code 的方式更新。要运行的命令也写在那里，你也可以复制到自己的终端里运行。

Agent 反复停止

一个 Agent 在五分钟内停止好几次后，在你重试之前 Kettu 不会再启动它。如果一直这样，按下文导出诊断信息并反馈。

安装和打开 Kettu

macOS 版经过 Apple 签名和公证，放进“应用程序”后和其他应用一样打开。如果直接从磁盘映像里运行 Kettu，它无法在原地更新：点更新会先把它移到“应用程序”，再重启。

打开登录时打开时，macOS 可能要求你在系统设置 › 通用 › 登录项里允许 Kettu。

日志和反馈

日志在哪里

Kettu 的日志、Agent 的消息和错误输出都只保存在内存里，不写成文件。要保存下来，点设置 › 高级里的导出诊断信息，Kettu 会让你选择 JSON 文件的保存位置，默认是“下载”文件夹。文件里可能含有代码和消息内容，请只分享给你信任的人。

反馈问题

在 github.com/KettuAI/Kettu/issues 提交 issue，或者点设置 › 关于里的反馈问题。写清楚你做了什么、发生了什么，用什么语言都可以；附上截图和诊断信息文件会更好。安全问题请按 SECURITY.md 的说明私下报告，不要发在公开的 issue 里。