开源 · 可自托管 · 开发中在任意设备上，掌控任意编码 Agent
Agents Anywhere 是面向 Claude Code、Codex 等编码 Agent 的远程控制台。Agent 依旧运行在你自己的笔记本、远程 devbox 或云沙箱里——你只需从一个可自托管的 Web 工作区掌控会话、审批、文件、终端与运行时状态。
界面与前端正在快速迭代,以运行中的应用为准。
这是什么
为长时间运行的 Agent 加上一层远程控制台
你在终端里启动了一个 Claude Code 或 Codex 任务。它会运行一段时间:读取文件、修改代码、运行测试,然后停下来等你审批某个操作。一旦它卡在审批、报错或需要你纠正的瞬间,你就得回到那台机器前。Agents Anywhere 解决的正是这件事。
一句话
它是「遥控器」,而不是新的 Agent 宿主。
你的代码不会被搬到中转服务里执行,你的模型账号与模型账单仍然留在你自己的 Claude Code / Codex 工具链中。
为什么需要它
编码 Agent 早已不只是一次性的聊天窗口
它们可以运行数分钟甚至更久,在整个工作区里修改文件、调用工具,并恰好在需要人来决策的那一刻暂停。没有远程控制台时:
- 你必须守在运行 Agent 的那台机器旁边。
- 一旦离开,任务可能因为一次审批或报错而卡住。
- 多台机器、多个会话与多种运行时很难统一管理。
Agents Anywhere 把这些长时间运行的任务变成一个可随时重新打开的工作区:查看状态、检查文件、观察输出、审批、打断、继续,并在同一个 Web 界面里切换设备。
工作原理
三层结构,代码永不离开你的机器
后端只负责认证、状态、文件元数据与 RPC 路由——它不会在服务器上执行你的代码。
Web 控制台
浏览器客户端通过 HTTP / WebSocket 连接后端,提供认证、设备、工作区与会话详情。
FastAPI 服务端
认证 / 会话 / RPC 中转 / 文件在 Web 与 Connector 之间中转,支持 SQLite(本地)与 PostgreSQL(生产)。
Connector
本地守护进程 + CLI运行在拥有工作区的机器上,通过运行时适配器对接 Codex / Claude。
本地运行时与工作区
Codex / Claude · 文件 / Shell / 终端Agent 与代码始终在本地,使用本地权限读写文件、执行命令。
当前能力
已经能做什么
统一会话工作区
创建、查看、置顶、归档、标记已读、接管与管理会话。
Codex 优先的运行时集成
Connector 自动发现本地 Codex 与 Claude 运行时并上报能力。
审批与同步
支持打断、同步、审批解析以及时间线轮询 / SSE。
本地文件访问
通过在线的 Connector 浏览工作区、读写文件、上传与下载内容。
远程 Shell 与终端
运行一次性 Shell 命令、Shell 任务与交互式终端。
设备配对
通过 Web 生成的令牌命令,或用 uvx anywhere-cli pair 配对码完成配对。
可自托管后端
FastAPI 后端本地用 SQLite,生产用 PostgreSQL。
Web 控制台
React + Vite 前端,覆盖认证、设备、工作区、运行时设置与团队管理。
支持的 Agent 与运行时
它不取代你的 Agent,而是在它旁边运行
Connector 适配器是可扩展的,新运行时应尽量复用已有的会话、时间线、审批、文件与终端能力。
客户端平台
和我们一起工作
我们正在快速迭代,期待和你一起做
整个项目都还在快速迭代中——界面、协议、适配器乃至文档都在持续变化,一切请以实际代码与 README 为准。我们暂时没有独立的文档站,也欢迎你对任何不准确的地方提出修正。如果这件事让你兴奋,我们非常期待和你一起把它做出来。
现状
Codex 适配最完整,Claude 为基础支持,其余运行时与桌面/移动客户端仍在路上。核心的会话、文件、终端与审批链路已经可用。
希望怎么做
公开开发、小步快跑。欢迎贡献新的 Connector 适配器、打磨 Web 控制台、完善文档,或分享你的真实使用场景与需求。
遇到问题
发现 bug、有想法或不确定该怎么用,直接在 GitHub 上提 issue。这是目前最快得到回应、也最能帮我们确定方向的方式。
常见问题