助手
在 Joppa 的面板中打开 Claude Code、Codex、OpenCode 或 Cursor，并把日志中的错误连同上下文发送给它们：项目、完整路径、进程、服务、数据库。
助手 是窗口右侧的一个面板，你的编程代理在其中运行：Claude Code、Codex、OpenCode 或 Cursor，运行在真正的终端里，并打开在项目文件夹中。在 Joppa 的日志中选中一个错误，它就会连同全部上下文发送给代理。
打开面板
⌘ I 可在任意界面打开或关闭助手（也可在 ⌘ K 命令面板中选择 助手）。没有会话时，它会列出已安装的代理和 终端（你的 shell）。会话在当前界面所示项目的文件夹中打开，路径显示在标签页下方；没有项目时，在你的个人文件夹中打开。
- +：新建会话，可以是代理或终端。每个会话有自己的标签页；× 关闭它并停止程序。
- 重新启动：代理停止后，在同一文件夹中重新启动。
- 调整大小：拖动面板的左边缘。Joppa 会记住宽度。
切换界面或关闭面板时，会话会继续运行。
提供的代理
Joppa 只提供在你的登录 shell 的 PATH 中（以及它们常用的安装文件夹，如 ~/.local/bin 或 ~/.opencode/bin）找到的代理：
| 代理 | 命令 |
|---|---|
| Claude Code | claude |
| Codex | codex |
| OpenCode | opencode |
| Cursor | cursor-agent |
在 Joppa 运行期间安装的代理，会在下次打开面板时出现。
发送错误
在 内置终端 或某个 服务 的 日志 中选中几行。上方会出现一个气泡：
- 询问 Claude Code（默认代理）；旁边的箭头提供其他已安装的代理和 终端。
- 连同上下文复制：把同样的内容放入剪贴板，可粘贴到任意地方（网页版 Claude、Cursor…）。
Joppa 在正确的文件夹中打开代理，或复用该代理在该文件夹中已打开的会话，然后把问题输入到它的输入框中。问题会明确说明这些行来自哪里：
- 对于进程：项目、其文件夹的完整路径、进程、它的命令、运行目录、端口、状态和退出码；在 全部 标签页中，说明每行以其进程名开头；
- 对于服务：服务、它的容器和端口、所选标签页的数据库，以及使用它的项目及其完整路径。代理会在使用该数据库的项目文件夹中打开（或在唯一使用该服务的项目文件夹中打开）。
随后是选中的行，以及一个你可以改写的初始问题（“哪里出了问题，该如何修复？”）。
允许代理
Joppa 第一次打开某个代理时，会询问 允许 Joppa 打开 Claude Code？，并显示命令的路径。代理可以读取和修改该文件夹中的文件，就像在你的终端里一样。
直接发送从 Joppa 提出的问题 复选框默认 不勾选：Joppa 只把问题输入到输入框中，不按回车。你检查、补充后再发送。勾选后，Joppa 会替你按回车。终端本身从不自行发送任何内容。
设置
面板的 ⚙ 按钮可设置 默认代理 和 直接发送问题，并通往 全部设置…。设置 › 助手 包含这两个选项，并列出 已允许的代理，每个都带有 撤销：下次 Joppa 会再次询问。参见 设置。