企业官网建设流程全解析

openharness 桌面端（Harness Desktop）是一个面向 coding agents 的开源指挥中心：Claude Code、Codex、Cursor 等十几种 AI 编码代理，可以在同一个窗口里各自独占一个终端面板（pane）并行工作。本快速入门将带你从安装、连接机器，到 3 分钟内让 Claude Code 与 Codex 同屏并跑，彻底告别窗口来回切换。

什么是 openharness 桌面端 🧰

openharness 的定位是一句话：All your agents. All your machines. One command center.（所有代理、所有机器、一个指挥中心。）

几个核心概念，先记住就够了：

它的特点是不包装任何代理——Harness 只是读取 Claude Code、Codex 等官方 CLI 自己写出的 transcript 并安装厂商原生 hooks，你的凭据原样留在~/.claude、~/.codex。各引擎的支持细节见 docs/engines.md。

下面这张动图就是它的招牌场景：一台 MacBook 上 Claude Code 与 Codex 并排干活，Cursor 跑在办公室台式机，OpenCode 跑在远程 GPU 盒子，四路代理一屏尽收 👀

桌面端源码位于 desktop/，是一个原生 Flutter 应用（macOS 为主力平台，Linux 可用，非 Electron），空闲时约 0.1% 单核 CPU、300 MiB 内存。

第一步：安装 openharness 桌面端（3 步搞定）⚡

1. 从官方下载页获取macOS / Linux 安装包，装好并登录账号；

2. 在目标机器上安装 CLI 并启动本地 daemon（它会主动外联，无需开放任何端口、无需 SSH key、无需端口转发）：

   harness login harness remote-password set harness start

3. 回到桌面端，进入Machines → Link Machine，输入刚才设置的密码，机器即在线。

如果想从源码构建，仓库地址是：

git clone https://gitcode.com/gh_mirrors/ope/openharness cd openharness/desktop flutter pub get flutter run -d macos

构建依赖与完整开发流程见 docs/development.md 和 desktop/README.md。

首次登录后，欢迎页会直接告诉你三个必会快捷键，完成一项会自动打勾 ✅

第二步：启动第一个 Claude Code harness 🚀

按⌘N（New Harness），弹出统一的创建面板：

面板中逐行确认（边输入边过滤）：

• Project：选择本地项目、新建项目或克隆仓库；
• Agent：选择引擎，如Claude Code或Codex；
• Machine：在哪台机器上跑（本机或已链接的远程机）；
• Branch / Worktree：默认会为每个 harness 单独开一个 git worktree，主工作副本保持干净；
• Approvals：默认Ask first，也可选引擎自带的 auto 模式。

回车启动后，你就有了一个跑在真实终端里的 Claude Code。

第三步：Claude Code 与 Codex 同屏并跑 🔀

这是 openharness 桌面端最爽的地方——分屏是原生的：

1. 在 Claude Code 面板上按⌘D（向下分屏）或⌘R（向右分屏）；
2. 弹出的 New Pane picker 里选New Harness use current defaults，或直接指定另一个代理；
3. 把 Agent 换成Codex，回车。

现在 Claude Code 在上、Codex 在下，各自独立终端、独立分支、独立对话，同屏可见、互不干扰。想再加一路？⌘D再来一次即可，单个标签页最多 64 个面板，五种等分布局任选：

💡 小技巧：面板标题栏的代理名点击后可换引擎；对已保存的 Claude / Codex 会话还支持暂停/恢复，进程被关也不会丢上下文（关闭面板只是隐藏视图，后台继续跑）。

管理一堆代理：⌘P 找任意会话，⇧⌘I 直达"等你回复" 🎯

代理多了之后，两个快捷键就是效率核心（完整键位表见 docs/keyboard.md）：

⌘P 的搜索 + 预览体验如图所示——输入几个字母，机器、项目、分支、最近回答一目了然，无需切窗口：

所有快捷键都可以通过~/.config/harness/keybindings.jsonc重映射，保存即生效。

超越代码：Harness Store 与 Beyond Code 🎨

openharness 的野心不止于写代码。按⌘S打开 Store，49 个领域专属 harness（DSH）开箱即用：Blender 建模、KiCad 画板、MuJoCo 机器人、Godogen 做游戏、Strudel 写音乐……每个都自带工具链 + 实时 viewer，聊天在左、成果在右。

架构层面，每台机器一个 daemon 跑 tmux，机器之间走端到端加密（ChaCha20-Poly1305 + WebRTC 直连/中继兜底），中继只转发密文。细节见 docs/architecture.md。

写在最后

回顾一下这条 3 分钟路径：装桌面端 → Link Machine → ⌘N 起 Claude Code → ⌘D 分屏加 Codex → ⌘P / ⇧⌘I 调度。从此多个 AI 编码代理在一个指挥中心同屏并跑，窗口切换成为历史。

继续深入可以看看：

• desktop/README.md — 桌面端功能全貌（媒体预览、远程 viewer、本地 Codex profile 等）
• docs/keyboard.md — 完整键盘快捷键与重映射指南
• docs/engines.md — 支持的全部 14 种引擎及其 hook 机制
• CONTRIBUTING.md — 参与贡献