AgentBox

这是什么？适合谁？

AgentBox（pedrogiroldo/agentbox）是一个容器化个人编码 Agent 虚拟机：容器化的个人编码 Agent 虚拟机：Ubuntu + Herdr + Claude Code/Codex，开箱即用的隔离编码环境，降低本地配置成本。

核心价值：用 Docker 打包 Ubuntu + Herdr + Claude Code/Codex/opencode + 移动端友好 Neovim，通过 SSH 访问，提供开箱即用的隔离编码环境。

适合人群：

• 想用容器隔离编码 Agent 的开发者
• 需要在多台机器间复现编码环境的工程师
• 偏好 SSH + 终端工作流的极客

使用前提：Docker 环境与 SSH 客户端；需配置 Claude Code/Codex 等工具

准备工作

1. 安装：git clone 后 Docker 构建镜像
2. 环境：Docker 与 SSH 客户端
3. 工具：Claude Code/Codex/opencode 账号
4. 成本：代码开源（许可证非标准，商用前确认）；容器资源成本
5. 时间：构建 + 首次连接约 30 分钟

快速上手（3 步）

第一步：构建镜像

git clone https://github.com/pedrogiroldo/agentbox && cd agentbox && docker build -t agentbox .

克隆仓库并构建 AgentBox 容器镜像。

第二步：启动容器

docker run -d --name agentbox -p 2222:22 agentbox

启动容器并映射 SSH 端口。

第三步：SSH 连接编码

ssh user@localhost -p 2222

通过 SSH 进入容器，使用内置 Claude Code/Codex 与 Neovim 编码。

成功判定：SSH 连入容器，能在隔离环境里用 Claude Code/Codex 完成编码任务。

初级用法

隔离编码环境

在容器内运行编码 Agent，与宿主机隔离。

SSH 远程访问

通过 SSH 从任意设备接入。

内置编码工具

预装 Claude Code/Codex/opencode 与 Neovim。

高级玩法

多环境复现

用镜像在任意机器复现同一编码环境。

移动端 SSH 编码

配合移动端 Neovim 在手机上编码。

资源限制与快照

限制容器资源并做环境快照。

小技巧

1. 1. 密钥别打进镜像，用挂载或环境变量
2. 2. 容器内数据做持久化卷，避免丢失
3. 3. 限制容器 CPU/内存
4. 4. SSH 密钥轮换，别用默认口令
5. 5. 定期更新镜像基础系统

常见踩坑

踩坑 1：密钥泄漏

• 现象：账号凭证暴露
• 原因：把 key 打进镜像
• 解决：用挂载卷/环境变量传凭证

踩坑 2：数据丢失

• 现象：容器重建后代码没了
• 原因：未用持久化卷
• 解决：挂载持久化数据卷

踩坑 3：SSH 暴露风险

• 现象：容器被外部扫描
• 原因：端口裸暴露
• 解决：限定访问来源，改默认端口

踩坑 4：资源失控

• 现象：容器吃满宿主机资源
• 原因：未设资源上限
• 解决：设置 CPU/内存限制

踩坑 5：许可证不明确

• 现象：商用有风险
• 原因：许可证非标准
• 解决：商用前确认授权

常见问题 FAQ

Q1: 它解决什么问题？

A: 用容器提供开箱即用、可复现、隔离的编码 Agent 环境。

Q2: 免费吗？

A: 代码开源，许可证非标准，商用前需确认。

Q3: 需要什么环境？

A: Docker 与 SSH 客户端。

Q4: 内置哪些工具？

A: Ubuntu + Herdr + Claude Code/Codex/opencode + Neovim。

Q5: 适合生产吗？

A: 偏个人/开发环境，生产使用需自行加固。

进阶学习建议

掌握基础后，建议深入：

1. 1. 研究编码 Agent 环境的容器化最佳实践
2. 2. 设计凭证与数据卷的安全策略
3. 3. 对比 devcontainer 与自建容器的取舍

参考链接

• 官方仓库

最后更新：2026-09-01 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成