从一句需求,到能打开的网页。

先连接你的电脑,再选择本机模型,最后发送任务。代码在你选择的 Git 项目里修改,执行日志和指定的网页成果回到 Studio。

首次连接,只做一次

如果“本机设置”里已有你的项目且显示“已连接”,直接跳到每天怎么用,无需重复安装或配对。

  1. 打开上方“进入固定工作台”,登录你的 HarbourMind 账户。输入框上方的“执行位置”选“我的电脑”。
  2. 点“安装与连接”。填写连接名称,例如“我的 Mac · 项目”,系统选 macOS 或 Linux。
  3. 要通过 HM 调用模型:在“OpenCode 的 HM 密钥来源”选择“在本机选择 CC Switch 的 HM 配置”。电脑上需要 Python 3.10+、Git 和已安装的 OpenCode;CC Switch 中先配置好你要使用的 HM key。
  4. 需要开机后可用,就勾选“登录电脑时自动启动”。连接器更新单独勾选。点“下载并配对”。
  5. 在十分钟内解压:Mac 打开 Install.command;Linux 在解压目录运行 bash install.sh。选择允许修改的 Git 项目,选择对应的 CC Switch HM 配置,核对后输入 yes。系统若询问是否打开下载的脚本,核对来源后确认。
  6. 回到网页,点“刷新连接”。在“本机项目”里选择刚连接的项目,状态应为“已连接”。

已经连接,怎样调用 Claude Code?

  1. 先在本机终端运行 command -v claude 和 claude --version,确认 Claude Code 已安装。在你要操作的 Git 项目目录运行 claude,完成它需要的登录或模型配置。
  2. 回到 Studio:执行位置 → 我的电脑 → 本机设置 → 本机项目 → 执行器 → Claude Code。选择的项目必须显示“已连接”。
  3. 勾选“在当前频道启用本机执行”,关闭设置,输入需求并发送。连接器会在所选项目目录启动本机 Claude Code,执行日志回传当前频道。
  4. 需要网页成果时,发送前在“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 额度仍不代表所有上游请求都会成功。发现重复无效修改时用“停止本机任务”,确认停止后再换模型或缩小需求。不要把“等待接单”或“执行中”当成生成成功。