指南
API
博客
版本
指南
API
博客
简体中文

OpenCode 集成

AIO Sandbox 内置 OpenCode CLI。OpenCode 是面向终端的开源 AI coding agent，可以在沙盒里直接使用，也可以通过内置终端页面打开。

访问方式

  • 浏览器：访问 http://localhost:8080/opencode，会跳转到内置终端并启动 opencode
  • 终端：在容器内直接运行 opencode

环境变量

启动容器时可以通过环境变量生成 OpenCode 配置：

变量默认值说明
OPENCODE_API_KEY必填Provider API key
OPENCODE_MODEL必填模型 ID
OPENCODE_PROVIDERarkProvider ID
OPENCODE_BASE_URLhttps://ark.cn-beijing.volces.com/api/v3API endpoint
OPENCODE_PROVIDER_NPM自动推导Provider 使用的 AI SDK npm 包
OPENCODE_JSON无完整 OpenCode 配置 JSON，优先级最高

OPENCODE_PROVIDER_NPM 通常无需手动设置。当 OPENCODE_BASE_URL 包含 anthropic 时，会使用 @ai-sdk/anthropic；其他情况默认使用 @ai-sdk/openai-compatible。

配置示例

默认 provider 是 ark，通常只需要提供 API key 和模型 ID：

docker run --security-opt seccomp=unconfined --rm -it \
  -p 8080:8080 \
  -e OPENCODE_API_KEY="your-api-key" \
  -e OPENCODE_MODEL="your-model-id" \
  ghcr.io/agent-infra/sandbox:latest

Anthropic 兼容端点：

docker run --security-opt seccomp=unconfined --rm -it \
  -p 8080:8080 \
  -e OPENCODE_PROVIDER="custom-anthropic" \
  -e OPENCODE_BASE_URL="https://example.com/anthropic/v1" \
  -e OPENCODE_API_KEY="your-api-key" \
  -e OPENCODE_MODEL="your-model-id" \
  ghcr.io/agent-infra/sandbox:latest

OpenAI 兼容端点：

docker run --security-opt seccomp=unconfined --rm -it \
  -p 8080:8080 \
  -e OPENCODE_PROVIDER="openai" \
  -e OPENCODE_BASE_URL="https://api.openai.com/v1" \
  -e OPENCODE_API_KEY="your-api-key" \
  -e OPENCODE_MODEL="your-model-id" \
  ghcr.io/agent-infra/sandbox:latest

如果需要完全自定义，可以使用 OPENCODE_JSON 传入完整配置：

docker run --security-opt seccomp=unconfined --rm -it \
  -p 8080:8080 \
  -e OPENCODE_JSON='{"model":"my-provider/my-model","provider":{"my-provider":{"npm":"@ai-sdk/openai-compatible","options":{"baseURL":"https://example.com/v1","apiKey":"your-api-key"},"models":{"my-model":{}}}}}' \
  ghcr.io/agent-infra/sandbox:latest

配置优先级

  1. OPENCODE_JSON
  2. OPENCODE_API_KEY + OPENCODE_MODEL 以及其他 OPENCODE_* 环境变量
  3. 用户手动维护的 ~/.config/opencode/config.json

当设置了 OPENCODE_JSON 或 OPENCODE_API_KEY + OPENCODE_MODEL 时，容器启动时会写入 ~/.config/opencode/config.json。如果希望长期维护自定义配置，建议使用 OPENCODE_JSON 固化完整配置，或在不设置 OPENCODE_* 环境变量的情况下手动编辑该文件。

相关文档