使用指南

以在 Claude Code 2.1.288~2.1.291 上验证的界面为准

1. 准备

将开发者的 Mac 接入一台公司服务器。

• 公司服务器：将 Web 应用服务器（WAS）和数据库部署在企业内部服务器上。网页控制台置于公司的 HTTPS 代理之后，Agent 连接（/ws/agent · /agent/）只在内网（VPN）中开放。网页登录必须提供账号 · 密码以及 OTP。
• 各 Mac：tmux 和 Claude Code。必须在 tmux 窗口中启动 Claude Code，才能在网页上输入 · 批准。
• 安装 Agent：在开发者 Mac 的终端（内网中）运行管理员通过网页 管理 › 主机 › “添加主机” 生成的一行命令。注册码只能使用一次，且须在 15 分钟内使用。

# “添加主机”生成的命令格式（地址 · 注册码以界面显示的值为准）
curl -fsSL <服务器地址>/agent/install.sh | bash -s -- --code XXXX-XXXX

安装脚本会校验可执行文件、完成注册、通过 launchd 使其常驻、设置 Claude Code hook，最后进行检查。此后，Agent 更新通过网页的“立即更新”完成。

2. 查看会话

会话列表按状态顺序显示所有 Mac 上的会话。

点击会话即可打开对话。对话 · 工具调用 · 结果按与终端相同的顺序实时累积；如果正在向上翻阅，新消息到来时也会保持当前阅读位置（点击“新消息”按钮可跳到底部）。

3. 批准 · 问题

• 权限请求：“允许” · “始终允许此命令” · “拒绝”。“始终允许”只保存 Claude 提议的那条规则（通常只针对该命令）。如果每条命令都询问太麻烦，请将权限模式切换为“自动”。
• Claude 的提问：在问题卡片中选择选项（单选 · 多选）或自行输入，然后点击“发送回答”。有多个问题时，需全部回答后才能发送。
• 终端中也会同时显示相同的对话框，以先回答的一方为准。
• 只在终端中出现的确认对话框（例如执行 /exit 时的“Background work is running”、切换模型时的“Switch model?”）也会以“终端正在询问”卡片显示，可在网页上选择。
• 待处理的请求汇集在通知栏（手机上为“通知”标签）中。

4. 提示词 · 文件 · 中断

• 在输入框中输入后发送（⌘/Ctrl+Enter）。长文本也能原样发送，只有收到发送成功的确认后才会清空输入框。
• 把文件拖放或粘贴到输入框，文件会上传到会话文件夹的 uploads/，并将 @路径 填入输入框。也可以用附件按钮选择文件夹后上传。
• “中断”相当于终端中的 Esc。/compact · /clear 等命令可通过快捷按钮发送。

5. 新会话 · 继续

1. 在“新会话”中选择 Mac（主机）· 账户 · 模型 · effort · 项目文件夹 · 权限模式。只能在该 Mac 允许的文件夹内打开。
2. 选择“新对话”或“继续”（选择已结束的对话）。列表从该 Mac 的磁盘读取，因此只在终端中使用过的文件夹的对话也会显示（最上方是与 claude --continue 相同的最近对话）。继续时会以该对话原来的权限模式 · effort 打开。
3. 用不同于对话所属账户的账户继续打开时，会把对话文件复制到该账户下继续使用（原账户的文件保持不变）。

6. 模型 · effort · 权限模式

• 通过会话标题栏的“模型 · effort”按钮切换。默认仅作用于此会话；开启“同时保存为新会话的默认值”后，该账户的默认值也会随之更改。
• 在对话中途切换模型时，下一条消息会让新模型重新读取整个对话，因此速度较慢，并消耗更多 Token。
• 权限模式：默认（每次询问）· 自动接受编辑 · 计划 · 自动（只询问看起来有风险的操作）· 全部允许（仅限可信任的文件夹）。

7. 移动会话

会话菜单 › “移到其他主机”。只能移动在原 Mac 上已结束的会话。

• 可以只移动对话，也可以连同工作文件夹一起移动。工作文件夹会排除 node_modules · target 等可重新生成的文件夹后打包，经由服务器解包到目标 Mac 的空文件夹中。
• 通过进度条查看各阶段（导出 → 打包 → 上传 → 接收 → 解包 → 继续打开）。关闭网页后仍会继续，重新进入即可看到进度。
• 代码原则上通过 git 同步。移动窗口会对比显示两台 Mac 的 git 状态。

8. 文件浏览器

• 通过会话标题栏的“文件”打开会话文件夹。支持标签页 · 并排查看 · Markdown 预览 · 图片预览。
• 编辑时先解除锁定，修改后按 ⌘+S。如果在此期间 Claude 修改了同一文件，会提示冲突。
• 可以重命名 · 创建副本 · 删除。删除只会移到废纸篓，且不会写入 .git · .claude。
• 将 设置 › 此浏览器 › “打开文件浏览器” 改为“在新窗口中”后，“文件”会在单独的窗口中打开，可边看对话边看文件。

9. 任务 · 用量

• 任务：跨会话查看正在运行的后台代理和工作流，以及最近 24 小时内已结束的任务。
• 用量：选择时间范围 · 账户 · 主机，将估算费用 · 请求 · 输出 Token · 缓存命中与上一周期对比。还提供账户限额（5 小时 · 每周 · 按模型每周）与基于当前速度的预测、按模型划分的每日柱状图、按项目 · 会话的排名，以及星期×小时热力图。
• 费用是按 API 单价换算的估算值，并非订阅费用。

10. 管理 · 设置

• 主机：连接状态 · 版本 · 指标，“添加主机” · 取消注册，Agent “立即更新”。
• 账户 · 用量：每台 Mac 上 Claude · Ollama 账户的登录状态，以及在网页上登录 · 退出登录。
• 模型：开启 · 关闭可用模型，设置各类型的默认模型。
• 备份：Agent 每 10 分钟将各 Mac 的对话记录上传到公司服务器。可查看服务器存档大小 · 磁盘剩余空间、各主机的备份状态和“立即备份”，以及搜索已备份的对话并“还原”（管理员）。还原后的对话可通过 新会话 › 继续 打开。
• 设置：文件预览上限 · 保留期限等服务器设置（管理员），以及主题 · 编辑器等此浏览器的设置。

11. 在手机 · 桌面上

手机：在 Safari 中通过“添加到主屏幕”像应用一样打开，用底部标签（会话 · 通知 · 任务 · 用量 · 管理）切换。批准 · 问题可在通知标签中通过“在会话中回答”直接前往。

桌面：会话列表 · 对话 · 通知三栏并排显示。两侧栏可收起为摘要栏 · 图标栏（由此浏览器记住），文件浏览器可并排打开两个文件。把文件拖放到对话区域即可直接上传。

12. 网页终端

在网页中打开开发者 Mac 的 Shell（管理 › 主机 › “终端”）和 claude 会话的实际 tmux 画面（会话菜单 › “以终端查看”）。由于这是拥有该 Mac 用户权限的 Shell，因此设有以下条件。

• 必须在该 Mac 上直接开启 — 无法从网页开启。关闭后，已打开的终端也会随之关闭。
• 仅限管理员，且每次打开时都会再次验证 OTP。打开 · 关闭 · 时间 · 字节数会记入审计日志，不记录按键内容。30 分钟无输入即自动关闭。
• 在桌面上会以单独的窗口打开（设置 › 此浏览器 › “打开网页终端”）。即使关闭或刷新控制台窗口，终端也保持不变。
• 用滚轮 · 滑动 · PgUp/PgDn · Shift+PageUp 查看历史输出，按任意键即可回到当前画面。拖选即自动复制；⌘+K 清除画面和历史输出，⌘+L 只清除画面。
• 保留的历史输出行数可在 设置 › “网页终端 › 历史行数” 中指定（默认 10,000 行）。

# 在该 Mac 的终端中 — 开启 · 关闭 · 状态
~/.ssemtong/bin/ssemtong-agent terminal on
~/.ssemtong/bin/ssemtong-agent terminal off
~/.ssemtong/bin/ssemtong-agent terminal status

13. 提示词汇总

• 右侧栏（手机上为“通知”标签）的“提示词”中，只显示该会话中由人输入的内容，最新的在前 — 显示编号 · 时间 · 前三行，点击可查看全文。
• 点击 ↳ 按钮会跳到对话中的该提示词并短暂高亮。从那里阅读期间，即使有新输出，画面也不会被拉到底部；可通过“滚动到底部”按钮返回。
• 选择尚未加载到画面中的较早提示词时，会从服务器加载其前后的对话并跳转过去，可通过“加载后续对话”继续阅读。

14. 语言

网页控制台支持 韩语 · English · 日本語 · 简体中文 · Français · Español · Bahasa Indonesia · Tiếng Việt · ភាសាខ្មែរ · العربية。可通过顶部的 🌐 按钮（登录页面中位于下方）或 设置 › 此浏览器 › “语言” 选择。初次使用时跟随浏览器语言，所选语言由该浏览器记住。服务器 · Agent 发送的部分提示目前仍以韩语显示。