Agenv — 用于构建、运行和监控 AI 代理的完整 IDE

发布: (2026年5月3日 GMT+8 18:56)
6 分钟阅读
原文: Dev.to

I’m happy to translate the article for you, but I need the full text of the post in order to do so. Could you please paste the content you’d like translated (excluding the source link, which I’ll keep unchanged)? Once I have the article text, I’ll provide a Simplified Chinese translation while preserving the original formatting and markdown.

概览

Agenv(Agent Development Environment,代理开发环境)是一款专为运行和监控 AI 代理(如 Claude、Gemini、Vertex 或任何基于 CLI 的模型)而打造的全网页 IDE。它提供了一个统一的工作空间,您可以:

  • 在分割的终端窗格中并排运行多个代理
  • 使用 30 多种语言的语法高亮编辑代码
  • 通过内置的 Git 集成进行暂存、差异查看和提交
  • 实时跟踪每个会话的 token 使用量和费用
  • 持久化会话,能够在浏览器崩溃和重新连接后继续

Agenv 可作为桌面应用(通过 Electron)使用,也可作为 Web 服务器供任何设备访问,包括手机。

Features

  • Split terminals – 同时运行多个代理,每个都有独立的持久 PTY 会话。可使用 Alt+1‑9 或标签栏切换,并可将文件直接拖拽到终端中。
  • Full‑featured file editor – 支持语法高亮、树形视图资源管理器、快速文件搜索(Ctrl+P)以及项目范围的文本搜索(Ctrl+T)。
  • Git sidebar – 可暂存文件、查看差异、编写提交信息并推送,无需离开 IDE。
  • Session persistence – 滚动历史、运行中的进程和环境状态在浏览器关闭后仍然保留;数据在磁盘上使用 AES‑256‑GCM 加密。
  • Cost monitoring – 实时显示令牌使用量和每个代理会话的费用,并通过状态指示器展示运行中、等待中或出错的状态。
  • Security – 桌面模式本地运行且不开放端口;网页模式使用 128 位随机令牌认证、scrypt 哈希密码、速率限制、CSP 头以及 AES‑256‑GCM 加密。
  • Lightweight architecture – 采用原生 JavaScript 模块(无 React/Vue),依赖极少,界面响应快速。

安装

# Global install via npm
npm install -g @adibenmatdev/agenv

Or run without installing:

npx @adibenmatdev/agenv

For the optional desktop app experience, install Electron globally:

npm install -g electron

快速开始

# Launch the environment (desktop app if Electron is installed, otherwise web mode)
agenv

# Force web mode (opens in browser, accessible from any device)
agenv --web

# Web mode on a custom port
agenv --web --port 8080

# Launch directly into an agent (example with Claude)
agenv run claude --model

使用说明

运行多个代理

每个代理都在其独立的持久化 PTY 会话中运行。使用 Alt+1‑9 或标签栏在它们之间切换。即使关闭浏览器或关闭笔记本电脑,会话仍会保留滚动历史和正在运行的进程。

编辑文件

内置编辑器支持 30 多种语言的语法高亮、树形视图文件资源管理器、快速文件搜索(Ctrl+P)以及项目范围的文本搜索(Ctrl+T)。无需在终端和外部编辑器之间切换。

Git 集成

在侧边栏中,你可以:

  • 暂存和取消暂存文件
  • 查看差异
  • 编写提交信息
  • 推送到远程仓库

这满足了大多数会话期间的版本控制需求,无需离开 IDE。

会话持久化与安全

  • 所有会话数据均使用 AES‑256‑GCM 加密存储。
  • 桌面模式本地运行,不打开网络端口。
  • Web 模式使用 128 位随机令牌进行身份验证,密码采用 scrypt 哈希,具备速率限制和严格的 CSP 头部。

成本监控

实时显示每个代理会话的令牌使用量和费用,帮助你避免意外的计费惊喜。

桌面模式 vs. Web 模式

# 桌面模式(当 Electron 可用时默认)
agenv

# Web 模式 – 可从网络中的任意设备访问
agenv --web --host 0.0.0.0

# 通过内置 ngrok 集成进行远程访问(在 UI 中启用)
agenv --web

架构

Agenv 将技术栈保持在最小化:

  • express – HTTP 服务器
  • ws – WebSocket 通信
  • @lydell/node-pty – 终端仿真
  • qrcode-terminal – 为移动访问生成二维码

前端由普通的 JavaScript 模块组成——无需 React、Vue,也不需要构建步骤。

许可证与链接

  • GitHub:
  • npm 包: @adibenmatdev/agenv
  • 许可证: Apache‑2.0

如果您正在使用 AI 代理进行构建,请尝试一下 Agenv。欢迎提交问题、拉取请求和点赞。

0 浏览
Back to Blog

相关文章

阅读更多 »

Claude 运行快速。Codex 发布。

摘要:我给 Claude 和 Codex 两个大型编码任务。- Claude 大约在一小时内完成。- Codex 大约用了八小时。乍一看,这看起来像是……