首次连接,只做一次
如果“本机设置”里已有你的项目且显示“已连接”,直接跳到每天怎么用,无需重复安装或配对。
- 打开上方“进入固定工作台”,登录你的 HarbourMind 账户。输入框上方的“执行位置”选“我的电脑”。
- 点“安装与连接”。填写连接名称,例如“我的 Mac · 项目”,系统选 macOS 或 Linux。
- 要通过 HM 调用模型:在“OpenCode 的 HM 密钥来源”选择“在本机选择 CC Switch 的 HM 配置”。电脑上需要 Python 3.10+、Git 和已安装的 OpenCode;CC Switch 中先配置好你要使用的 HM key。
- 需要开机后可用,就勾选“登录电脑时自动启动”。连接器更新单独勾选。点“下载并配对”。
- 在十分钟内解压:Mac 打开
Install.command;Linux 在解压目录运行bash install.sh。选择允许修改的 Git 项目,选择对应的 CC Switch HM 配置,核对后输入yes。系统若询问是否打开下载的脚本,核对来源后确认。 - 回到网页,点“刷新连接”。在“本机项目”里选择刚连接的项目,状态应为“已连接”。
已经连接,怎样调用 Claude Code?
- 先在本机终端运行
command -v claude和claude --version,确认 Claude Code 已安装。在你要操作的 Git 项目目录运行claude,完成它需要的登录或模型配置。 - 回到 Studio:执行位置 → 我的电脑 → 本机设置 → 本机项目 → 执行器 → Claude Code。选择的项目必须显示“已连接”。
- 勾选“在当前频道启用本机执行”,关闭设置,输入需求并发送。连接器会在所选项目目录启动本机 Claude Code,执行日志回传当前频道。
- 需要网页成果时,发送前在“HTML 预览路径”填写
studio-preview.html,需求中也明确要求生成这个文件,CSS、JavaScript 与资源内嵌。成功回传后,Studio 会打开成果预览。
Claude Code 使用自己的本机登录、模型与接口配置;这里不需要选择 OpenCode 的“本机 HM 模型”和“本机 HM 线路”。安装器中选择的 OpenCode CC Switch 密钥不会自动注入 Claude Code。需要通过 HM 使用 Claude Code 时,先在本机把 Claude Code 的 HM 配置启用。
| 路径 | 填写或查看的位置 |
|---|---|
| 操作入口 | Studio → 我的电脑 → 本机设置 → 执行器 → Claude Code |
| 本机项目目录 | 安装或配对时选择的 Git 根目录;在“已连接项目”卡片核对。切换执行器继续使用这个目录。 |
| Claude 可执行文件 | 终端运行 command -v claude 查看,例如 ~/.local/bin/claude;连接器自动检测,网页无需填写。 |
| HTML 预览路径 | 相对于所选 Git 根目录,例如 studio-preview.html。不要填写电脑绝对路径;文件必须实际生成。 |
当前 Claude Code 调用采用自动接受文件编辑的非交互模式;需要额外授权的工具调用会被拒绝,网页暂不提供 Claude 的逐次权限确认。Codex 也可在“执行器”中选择,使用已有本机配置。Windows 安装器目前尚未支持。
每天怎么用
打开固定工作台 → 点输入框上方“本机设置”(首次也可点“安装与连接”),核对下面这组设置:
| 页面选项 | 使用 HM 模型时怎么选 |
|---|---|
| 执行位置 | 我的电脑 |
| 本机项目 | 你的项目,状态为已连接 |
| 执行器 | OpenCode |
| 本机 HM 模型 | 从实际目录选,例如 gpt-6-luna |
| 本机 HM 线路 | 从该模型可用的线路选,例如 flex |
| HTML 预览路径 | index.html,需求中也写明生成这个文件 |
| 在当前频道启用本机执行 | 勾选 |
关闭设置面板。顶部状态出现“CC Switch · … · 模型 · 线路 · 密钥保留在本机”,就可以在输入框写需求并点“发送”。
同一站点、账户和浏览器会记住你的选择,新对话沿用这组配置;已单独设置过的频道保留自己的选择。换浏览器或清除站点数据后,需要重新选择。电脑要保持开机,连接器要保持运行。
本机 HM 模型和线路在“本机设置”里选择。页面顶部的云端模型选择器对应站内云端目录;本预览没有配置云端上游时,请使用“我的电脑”。
复制这条需求开始
先阅读当前项目的 AGENTS.md、相关代码和设计参考。 制作“和而不同”互动网页,沿用现有风格。 包含三种观点、点击后的解释、共识计数和重置按钮。 生成完整的 index.html,CSS 和 JavaScript 内联。 完成后检查交互并报告修改的文件。 不要提交、推送或部署,不读取密钥文件。
已有网页就写具体改动,例如“只调整首页的间距和配色,保留所有按钮与功能”。这个预览方式读取你指定的完整 HTML;React/Vite 项目需要先构建成可预览的 HTML 成果。
看进度,打开成果,继续修改
发送需求 → 等待本机接单 → 本机执行 → 回传成果 → 打开网页
- 执行状态显示任务是在等待、执行、完成还是失败;终端区域显示已经回传的输出。
- 打开成果查看实际生成的网页。新窗口打开可独立操作;需要调整时使用原有的快速改字、继续修改或版本对比。
- 下载完整终端输出保存完整记录。页面中显示的是最近日志,完整文件单独提供。
- 停止本机任务请求结束当前执行;看到“本机进程已停止”才是本机确认的回执。
- 关闭网页不会自动停止本机任务。重新打开原频道,可读取同一个任务。提交结果未确认时,用“恢复未确认任务”,避免重复发送。
遇到问题,对照这里处理
仍然显示“所选模型没有可用的当前线路”
先检查“执行位置”是否是“我的电脑”。打开“本机设置”,依次选项目、OpenCode、本机 HM 模型和本机 HM 线路,并勾选启用。完成后状态应显示本机 CC Switch 来源。不要在云端模型下拉框里反复尝试本机线路。
看不到本机 HM 模型
先选已连接项目,再选 OpenCode。连接器须以 CC Switch HM 配置启动,才能回传本机目录;已有环境变量方式不会自动产生这份目录。原来按环境变量方式安装的,确认没有运行中的任务后,用安装器提供的管理入口执行 stop、uninstall,再按“首次连接”重装,选择“在本机选择 CC Switch 的 HM 配置”。
项目显示离线或没有项目
确认电脑开机、网络可用、连接器正在运行,然后点“刷新连接”。安装器提供本机管理入口,可以 start、stop、update、uninstall。没有连接过这台电脑时,按“首次连接”完成一次配对;配对码过期就重新生成。
执行器里没有 Claude Code,或 Claude 调用失败
在本机运行 command -v claude、claude --version 确认安装,再在目标项目中运行 claude 核对登录和模型配置。刚安装执行器的,确认没有运行中的任务后重启连接器,再回网页点“刷新连接”。若日志提示工具权限不足,先在本机配置对应工具权限;切换网页顶部模型不会改变 Claude Code 的本机配置。
模型调用失败、循环修改,或接口返回错误
查看实际终端输出。管理员 key 免站内 HMT 额度仍不代表所有上游请求都会成功。发现重复无效修改时用“停止本机任务”,确认停止后再换模型或缩小需求。不要把“等待接单”或“执行中”当成生成成功。