文档中心

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 -LsSf https://astral.sh/uv/install.sh | sh

uv init --no-workspace

uv venv --python 3.12

uv pip install agentkit-sdk-python==0.6.4

uv add veadk-python

source .venv/bin/activate

配置环境变量。

说明

请将 <your_access_key>、<your_secret_key> 替换为实际火山引擎 AK/SK。

请将 <your_ark_api_key> 替换为实际方舟模型 API Key。

AGENTKIT_SANDBOX_TTL：沙箱实例生命周期，默认值 28800 秒（8 小时）。取值范围为 180 秒（3分钟）～ 86400秒（24小时）。如需将生命周期延长至最大 604800 秒（7天），请联系客户经理申请。

export VOLCENGINE_ACCESS_KEY=<your_access_key>
export VOLCENGINE_SECRET_KEY=<your_secret_key>
export MODEL_API_KEY=<your_ark_api_key>
export AGENTKIT_SANDBOX_TTL=28800

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

说明

--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 覆盖模型配置：

参数说明：

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

设置沙箱实例生命周期

说明

AGENTKIT_SANDBOX_TTL：沙箱实例生命周期，默认值 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.21 18:42:25

这个页面对您有帮助吗？

有用

无用