aenv CLI完整指南：用15个核心命令玩转AgentENV

aenv CLI完整指南用15个核心命令玩转AgentENV【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENVAgentENVAENV是一个用于规模化运行 AI Agent 环境的分布式沙箱平台而aenv是它的官方命令行工具。这份 aenv CLI 完整指南一次性讲清楚 15 个核心命令——从模板构建、沙箱启动到文件传输、快照与持久卷帮助新手 15 分钟上手 AgentENV像管理容器一样管理你的智能体环境。为什么需要 aenv CLIAgentENV 把每个 Agent 的运行环境隔离在轻量沙箱sandbox中而 aenv 把这些底层能力封装成了开发者友好的命令行接口️模板即模板镜像用aenv pull一行命令把任意 OCI 镜像变成秒级启动的模板⚡沙箱生命周期全掌控启动、暂停、恢复、续期、删除一条命令搞定文件自由搬运本机与沙箱之间互传文件和目录状态随时固化一键把运行中的沙箱打成快照或持久卷所有命令的入口定义在 crates/aenv/src/main.rs 中完整文档见 docs/src/getting-started/aenv-cli/index.md。15 个核心命令速查表#命令一句话说明常用别名1aenv auth保存服务器地址与 API Key—2aenv pull从 OCI 镜像构建模板—3aenv build用本地 Dockerfile 构建模板—4aenv template查看/追踪/删除模板templates5aenv start启动沙箱并进入交互 Shell—6aenv connect附加到已运行的沙箱cn7aenv exec在沙箱中执行单条命令—8aenv upload上传文件/目录到沙箱—9aenv download从沙箱下载文件/目录—10aenv list列出所有沙箱ls11aenv pause暂停沙箱—12aenv resume恢复已暂停的沙箱—13aenv timeout设置沙箱到期时间—14aenv delete销毁并删除沙箱rm15aenv snapshot创建/列出持久快照snap 快速上手登录 AgentENVaenv auth交互式输入服务器地址默认http://localhost:8000和 API Key凭据会安全存储在~/.config/aenv/credentials权限 0600。一次配置后续所有命令自动生效。详见 docs/src/getting-started/aenv-cli/authentication.md。 构建模板aenv pull / aenv build模板Template是沙箱的启动盘。两种构建方式方式一从镜像直接构建aenv pull ubuntu:22.04 --name my-ubuntu默认等待构建完成加-d可后台提交。方式二从本地 Dockerfile 构建aenv build . --name my-app在隔离的 microVM 中调用 BuildKit 编译支持--build-arg、--secret、--no-cache等参数。管理模板aenv template list查看列表aenv template watch my-ubuntu实时追踪构建进度aenv template delete my-ubuntu删除模板。 技巧--start-cmd/--ready-cmd可在构建时预装依赖、等待服务就绪后再捕获模板。⚡ 启动沙箱aenv startaenv start my-ubuntu # 从模板启动直接进入交互 Shell aenv start --cold ubuntu:24.04 --cpu 2 --memory 2048--cold跳过模板直接从外部 OCI 镜像冷启动--timeout 秒设置存活时间默认 300 秒--volume /workspacevol1挂载持久卷-d后台启动只打印沙箱 ID启动后会自动获取并管理 envd 访问令牌无需手动处理鉴权。完整参数见 docs/src/getting-started/aenv-cli/sandboxes.md。 连接与执行connect / execaenv connect sandbox-id # 附加交互 Shell别名 aenv cn aenv exec sandbox-id ls -la /exec适合脚本化场景——跑完一条命令并流式返回输出。如果远程命令的旗标和 aenv 冲突用--隔开aenv exec sandbox-id -- some-cmd --timeout 10 文件传输upload / downloadaenv upload sandbox-id ./config.json /workspace/config.json aenv upload sandbox-id ./project /workspace/app aenv download sandbox-id /workspace/result.txt ./result.txt目录会自动创建文件逐个流式传输--user user以指定用户身份解析相对路径下载时--force可覆盖本地同名文件注意传输只保留文件内容与目录结构不保留权限位、时间戳、符号链接等元数据。 生命周期管理pause / resume / timeout / delete场景命令暂停保留状态aenv pause id恢复运行aenv resume id --timeout 600延长到期时间aenv timeout id 3600销毁删除aenv delete id查看全量沙箱aenv list --output jsonpauseresume组合非常实用先把沙箱冻结住之后随时恢复比重新拉一个环境快得多。list在终端默认表格输出重定向到文件时自动切换为 JSON方便写脚本。 快照与持久卷snapshot / volume快照——把当前沙箱状态固化为可复用镜像aenv snapshot create sandbox-id --name my-base aenv snapshot list创建后的快照可像模板一样直接aenv start使用。持久卷——跨沙箱保存数据aenv volume create workspace aenv volume create job-data --mode exclusive --from-volume dataset-base aenv volume inspect job-data推荐模式为每个沙箱创建独占exclusive卷的写时复制分叉避免多个沙箱争用同一份可写数据。挂载方式aenv start ubuntu --volume /workspace/datajob-data。详见 docs/src/getting-started/aenv-cli/volumes.md 与 docs/src/getting-started/aenv-cli/snapshots.md。 进阶玩法codex 与 shell 补全原生 Codex 会话——在沙箱副本中直接对项目跑 AI 编程aenv codexTab 补全——支持 bash / zsh / fish还能根据沙箱实时状态动态补全 IDaenv completion zsh ~/.local/share/zsh/site-functions/_aenv输入aenv resume TAB只补全已暂停的沙箱aenv exec TAB只补全运行中的沙箱详见 docs/src/getting-started/aenv-cli/shell-completion.md。常见问题Q命令提示找不到服务器重新执行aenv auth检查地址和 API Key 是否正确。Q沙箱启动后多久会自动回收默认 TTL 300 秒可用--timeout或aenv timeout延长。Q快照怎么删除快照与模板共用存储执行aenv template delete snapshot-id即可。Q列表输出如何进脚本加--output json或直接把输出重定向到文件会自动切换 JSON 格式。写在最后掌握这 15 个 aenv CLI 命令你就拥有了 AgentENV 沙箱平台的完整操作能力auth登录 →pull/build备模板 →start起环境 →exec/upload/download干活 →pause/snapshot/volume保存状态 →delete清理收尾。配合 Tab 补全与 JSON 输出把它嵌入 CI/CD 或自动化脚本也绰绰有余。现在就aenv auth开始体验吧【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考