文档中心

AgentKit

最佳实践

通过AgentKit CLI在沙箱中运行Codex

Codex是运行在沙箱内的AI编码Agent，擅长编写代码、执行脚本与修改文件。借助云端沙箱，Codex在隔离环境中运行，支持会话恢复与产物持久化，适合AI编码、批量任务执行及长时运行场景，无需在本地安装和配置Codex环境。

本文介绍如何通过AgentKit CLI在云端沙箱中调用Codex完成编码任务，包括CLI安装、环境配置，以及交互式与一次性任务的执行方式。

前提条件

已安装Python，且版本不低于3.10。

已配置火山方舟模型广场的Deepseek v4模型，并获取API Key。

登录平台控制台获取AK/SK，进入API访问密钥页面，创建并获取Access Key ID和Secret Access Key。

操作步骤

下载并安装AgentKit CLI。

本文使用uv命令安装。

# 使用curl下载并安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 初始化uv环境
uv init --no-workspace

# 使用uv创建一个基于Python XXX版本的虚拟环境，本文使用3.12版本
uv venv --python 3.12

# 安装AgentKit SDK
uv pip install agentkit-sdk-python==0.6.4

# 安装VeADK
uv add veadk-python

# 激活uv环境
source .venv/bin/activate

配置环境变量。

export VOLCENGINE_ACCESS_KEY=<your_access_key> #火山引擎AK
export VOLCENGINE_SECRET_KEY=<your_secret_key> #火山引擎SK
export MODEL_API_KEY=<your_ark_api_key> #方舟模型API Key
export AGENTKIT_SANDBOX_TTL=28800 #沙箱实例生命周期，默认值28800秒（8小时）。取值180秒（3分钟）～ 86400秒（24小时）。如需将生命周期延长至最大604800秒（7天），请联系客户经理申请。

创建沙箱工具并指定默认模型。

#--model-name：沙箱内Codex使用的模型名称，需与方舟模型广场中的模型ID保持一致。默认使用deepseek-v4-flash模型。
agentkit sandbox create --model-name deepseek-v4-flash-260425

创建沙箱实例并使用Codex。

说明

session-id：沙箱实例的ID，请根据实际情况进行替换。相同的session-id可在多次执行间复用同一个实例（包括工作目录、Codex历史记录等）。

如果指定的session-id对应的沙箱实例不存在或已超过生命周期时长被回收，AgentKit会自动创建一个新的实例。

示例如下：

#示例1 交互式启动 Codex 并发送初始指令
agentkit sandbox exec --session-id "test-0610-12" --command "codex 'hello'"
#示例2 以非交互方式向 Codex 提交编码任务，并要求对生成代码进行测试验证
agentkit sandbox exec --session-id "test-0610-12" --command 'codex exec --skip-git-repo-check "/goal 在 50MB 内存限制下，对一个无法全部载入内存的超大文本文件（≥100GB），实现单次扫描找出出现次数最多的前 K 个单词（忽略大小写与标点）。evaluate this code with test data。'

相关操作

切换模型

如果需要切换沙箱使用的模型，可在exec命令中通过--model-name覆盖模型配置：

agentkit sandbox exec --session-id "test-0610-12" \​
  --model-name deepseek-v4-flash-260425 \​
  --command "codex 'hello'"​

参数说明：

参数	说明	取值样例
--session-id	沙箱实例的ID。	test-0610-12
--model-name	覆盖沙箱默认模型配置，后续调用同样使用该模型，直至再次修改。需与方舟模型广场中的模型ID保持一致。	deepseek-v4-flash-260425
--command	连接建立后发送的初始命令。省略时仅建立连接并打开终端，不发送任何指令。	codex 'hello'

设置沙箱实例生命周期

export AGENTKIT_SANDBOX_TTL=28800 #单位为秒，默认28800秒（8小时）。取值180秒（3分钟）～86400秒（24小时）。如需将生命周期延长至最大604800秒（7天），请联系客户经理申请。​

查看产物

沙箱内产生的文件（如代码、日志、构建产物）会自动持久化存储到名为agentkit-platform- {{accountId}}/{{sandboxToolId}}的TOS存储桶，任务结束后可前往TOS控制台查看与下载。

您也可以执行以下命令查看产物。

# 打开沙箱 Web UI，在浏览器中查看产物（如生成的 HTML 文件）​
agentkit sandbox web --session-id "test-0610-12"​
​
# 通过 TOS Web 浏览器查看沙箱产物，或将沙箱存储挂载为本地磁盘​
agentkit sandbox mount --session-id "test-0610-12"​

最近更新时间：2026.10.09 16:52:12

这个页面对您有帮助吗？

有用

无用