README.md

September 10, 2026 · View on GitHub

Agents Anywhere：跨设备的开源 Agent 工作台。支持 Codex、Claude Code 和 DeepSeek Harness，更多 Agent 即将支持。

连接工作设备，在桌面、手机和 Web 管理 AI Agent。
开源 · 多种 Agent · 会话与工作区 · 自托管

官网 · 下载客户端 · 打开 Web · 使用文档 · English

Release 2.0.0 MIT Self-host with Docker

Agents Anywhere 是跨设备的开源 Agent 工作台。连接运行 Codex、Claude Code 或 DeepSeek Harness 的工作设备，在桌面、手机和 Web 查看会话、回复请求、管理文件与终端。Agent 在连接的工作设备上执行任务。

下载与入口

在工作设备上安装桌面客户端，再通过手机、平板或 Web 访问。Linux 和无图形界面的服务器可使用 Connector CLI 接入。各客户端均可连接 Cloud 或自托管服务。

直接使用 Web： 打开 web.agents-anywhere.com，注册或登录，开始使用。服务器位于中国大陆，在中国大陆使用可获得最佳体验。

平台获取客户端
macOSUniversal DMG · 2.0.0
Windowsx64 安装包 · 2.0.0
iOS / iPadOS加入 TestFlight
AndroidAPK · 2.0.0
Web立即打开 Web
Linux / headless运行 Connector CLI

更多平台说明见官网下载页。旧版部署升级前请阅读升级指南。

平台要求、安装包与更新说明
  • macOS：Apple Silicon / Intel 通用，已签名、公证。
  • Windows：x64 桌面工作台，含本机 Connector；当前安装包未做代码签名。
  • Android：Android 8.0 及以上。
  • iOS / iPadOS：通过 TestFlight 安装测试版，以邀请页显示的可用状态为准。
  • Linux / headless：运行 Connector 接入工作设备，通过其他客户端操作。

macOS、Windows 和 Android 的下载文件均为 Agents Anywhere 安装包，托管在 ModelScope 的 t4wefan/deepseek-harness-desktop 仓库中。历史 GitHub Releases 中的 0.1.x 安装包不作为 2.0 下载入口。当前发布客户端的应用内更新地址仍是占位配置，请通过上面的链接手动下载。

main 是当前开发主线。源码中的新修复不一定已进入上面的 2.0.0 安装包；产品、Connector 包和数据库 schema 的版本分别管理。发布范围见 2.0.0 发布说明。

Agent 与工作区管理

Windows 桌面工作台：左侧管理设备、项目和会话，右侧查看 Agent 的任务结果。

你想做的事在 Agents Anywhere 中
管理项目与会话在设备、项目和会话之间切换，通过时间线（Timeline）查看运行进度。
审批操作与回复请求响应工具审批和输入请求；按 Runtime 能力打断或继续任务。
查看文件与使用终端浏览与预览文件、上传下载附件，打开远程 shell 和交互式终端。
配置 Agent配置 Codex、Claude Code 和 DSH；根据对应 Runtime 支持的能力选择模型、权限与操作。

Runtime 是工作设备上运行和连接 Agent 的组件。模型账号和调用费用遵循所使用 Agent 的规则。各 Runtime 的能力存在差异，具体操作以客户端显示为准。DSH 接入说明 →

桌面、移动端与 Web

iPhone、iPad 和 Android 的真实客户端截图：查看会话、继续对话，以及回复 Agent 的输入请求。

用手机查看进展、回复 Agent，在平板上打开工作区，回到电脑后继续处理。同一服务、同一账号下，自己的设备和会话可以从不同客户端访问。

手机负责控制，工作设备负责执行。 远程使用时，工作设备需要保持开机、联网，并让 Connector 与对应 Runtime 正常运行。上图 iPad 展示了回复 Agent 输入请求的界面。

首次使用

  1. 登录服务。 安装客户端或打开 Web，登录 Cloud，或填写自托管服务地址。
  2. 连接工作设备。 Desktop 集成本机 Connector；服务器与无图形环境使用 Connector CLI。
  3. 准备 Agent 和项目。 在工作设备上配置 Runtime、账号与工作目录，创建或打开会话。
  4. 从其他设备访问。 在手机、平板或另一台电脑登录同一服务和账号，访问自己的设备与任务。

详细配对步骤、登录排查和后台运行说明见安装与首次使用。

执行位置与自托管

Agent 使用 Connector 所在机器的工作区与权限。可以连接 Cloud，也可以在自己的服务器上部署 Agents Anywhere 服务。

flowchart LR
    Clients["桌面 · 手机 · Web"] <-->|"访问与控制"| Server["Agents Anywhere Server"]
    Server <-->|"Connector RPC"| Connector["工作设备上的 Connector"]
    Connector <--> Agents["Codex · Claude Code · DSH"]
    Connector <--> Workspace["工作区 · 文件 · 终端"]

会话内容、Timeline 和上传附件等数据会按功能经过或存储在 Server。自托管时，这些服务端数据由你部署的实例处理。

使用 Docker 部署

克隆仓库后，在根目录运行以下命令，先替换示例密码和密钥：

POSTGRES_PASSWORD=replace-with-a-strong-password \
AGENT_SERVER_SECRET=replace-with-a-long-random-secret \
docker compose -f docker/docker-compose.postgres.yml up --build

打开 http://127.0.0.1:5174，从 Server 日志取得 setup token，完成首位管理员设置。Compose 包含 PostgreSQL、Redis、迁移任务以及托管 Web 的 Server。

完整部署步骤 · 备份与升级 · Server 文档

开发与贡献

开发环境使用 Python 3.12+ / uv / Node.js 22 / Corepack + Yarn。从开发指南开始，查看源码运行方式与 headless 检查。

想了解什么从这里开始
整体架构与 APIServer 架构 · API 文档
Agent 接入与本机执行Connector · Runtime 协议
Web 与桌面客户端Web 源码 · Desktop Workbench
原生移动客户端Android · iOS 源码
DSH 集成DSH Bridge Next
更多文档文档目录 · 协议契约

欢迎通过 Issues 反馈问题，或通过 Pull Requests 参与改进。报告问题时，请附上客户端版本、系统、Runtime 类型和复现步骤，并移除日志中的凭据。

交流与反馈

欢迎加入社区，分享使用体验、反馈问题或参与开发。扫码加入微信群或 QQ 群参与交流。自托管实例的账号由自己的管理员管理。

微信群QQ 群
微信群二维码QQ 群二维码

开源许可

MIT。README 中的产品截图与品牌素材说明见图片来源与复现方式。