概述

amp 是预构建的 AI Agents 运行环境，已内置 Sourcegraph 出品的 Amp CLI——一款采用多模型架构、内置代码智能能力的编码代理。可在隔离的沙箱环境中以无头方式运行，具备完整的文件系统、终端和 git 访问能力。

模板预装 Node.js、git、ripgrep、vim、GitHub CLI 等常用工具，以及 pnpm/tsx/vite 前端脚手架。镜像内不内置任何 API key，认证信息通过沙箱创建时的 envs 注入。

模板内容

创建沙箱

AMP_API_KEY 从 ampcode.com/settings 获取，通过 envs 注入：

import { Sandbox } from 'e2b'

const sandbox = await Sandbox.create('amp', {
  envs: { AMP_API_KEY: process.env.AMP_API_KEY },
})

常用 CLI flag

无头执行

import { Sandbox } from 'e2b'

const sandbox = await Sandbox.create('amp', {
  envs: { AMP_API_KEY: process.env.AMP_API_KEY },
})

const result = await sandbox.commands.run(
  `amp --dangerously-allow-all -x "Create a hello world HTTP server in Go"`,
)

console.log(result.stdout)
await sandbox.kill()

Git 仓库集成

await sandbox.git.clone('https://github.com/your-org/your-repo.git', {
  path: '/home/user/repo',
  username: 'x-access-token',
  password: process.env.GITHUB_TOKEN,
  depth: 1,
})

const result = await sandbox.commands.run(
  `cd /home/user/repo && amp --dangerously-allow-all -x "Add error handling to all API endpoints"`,
  { onStdout: (data) => process.stdout.write(data) },
)

const diff = await sandbox.commands.run('cd /home/user/repo && git diff')
console.log(diff.stdout)

流式 JSON 输出

--stream-json 会持续输出 JSONL 事件，可用于实时观测 token 用量、工具调用与决策过程：

const result = await sandbox.commands.run(
  `amp --dangerously-allow-all --stream-json -x "Find and fix all TODO comments"`,
  {
    onStdout: (data) => {
      for (const line of data.split('\n').filter(Boolean)) {
        const event = JSON.parse(line)
        if (event.type === 'assistant') {
          console.log(`[assistant] tokens: ${event.message.usage?.output_tokens}`)
        }
      }
    },
  },
)

线程管理

Amp 维护持久化的对话线程，可在多次调用之间复用：

const initial = await sandbox.commands.run(
  `cd /home/user/repo && amp --dangerously-allow-all -x "Analyze the codebase and create a refactoring plan"`,
)

const threads = await sandbox.commands.run('amp threads list --json')
const threadId = JSON.parse(threads.stdout)[0].id

const followUp = await sandbox.commands.run(
  `cd /home/user/repo && amp threads continue ${threadId} --dangerously-allow-all -x "Now implement step 1 of the plan"`,
)

参考

• Amp 官网：https://ampcode.com