@molecule/api-agent-runtime-claude-code

Claude Code agent runtime — unattended runs in ephemeral cloud sandboxes; artifacts-only return, per-run credentials, deny-by-default egress

Type

provider

Installation

npm install @molecule/api-agent-runtime-claude-code @molecule/api-agent-run @molecule/api-ai-tools @molecule/api-code-sandbox

API

Interfaces

`ClaudeCodeRuntimeConfig`

Options for createProvider.

interface ClaudeCodeRuntimeConfig extends AgentRunConfig {
  /**
   * npm package spec for the Claude Code CLI, installed at run start from the
   * egress-allowed npm registry. Default
   * `@anthropic-ai/claude-code@2.1.289` — PINNED EXACTLY, never `@latest`:
   * its postinstall runs in the sandbox, so the version that runs there must
   * be a deliberate choice.
   */
  cliPackage?: string
  /**
   * Model id passed to the CLI when a spec names none. This is a CATALOG id
   * (`claude-sonnet-5-5`); the runtime maps catalog ids to the CLI's model
   * argument. Default `claude-sonnet-5-5`.
   */
  defaultModel?: string
  /**
   * Extra seconds granted to the ENVIRONMENT beyond the task budget — the
   * clone + CLI install happen before the agent starts, and the artifact
   * collection happens after. Default 240000 (4 minutes).
   */
  setupSlackMs?: number
}

Classes

`ClaudeCodeAgentRuntime`

Claude Code agent runtime backed by an ephemeral cloud sandbox.

Functions

`createProvider(config)`

Create a Claude Code agent runtime.

function createProvider(config?: ClaudeCodeRuntimeConfig): AgentRuntimeProvider

config — CLI package, default model, budgets.

Returns: An AgentRuntimeProvider running the Claude Code CLI in ephemeral sandboxes.

Constants

`provider`

The provider implementation (wire with the agent-run core's setProvider).

const provider: AgentRuntimeProvider

`RUNTIME_ALLOWED_HOSTS`

Hosts the runtime's own tooling needs, always allowed on top of the spec's.

const RUNTIME_ALLOWED_HOSTS: readonly [
  'api.anthropic.com',
  'github.com',
  'api.github.com',
  'codeload.github.com',
  'objects.githubusercontent.com',
  'registry.npmjs.org',
]

Core Interface

Implements @molecule/api-agent-run interface.

Bond Wiring

Setup function to register this provider with the core interface:

import { setProvider } from '@molecule/api-agent-run'
import { provider } from '@molecule/api-agent-runtime-claude-code'

export function setupAgentRuntimeClaudeCode(): void {
  setProvider(provider)
}

Injection Notes

Requirements

Peer dependencies:

@molecule/api-agent-run >=1.0.0
@molecule/api-ai-tools >=1.0.0
@molecule/api-code-sandbox >=1.0.0

Runtime Dependencies

@molecule/api-agent-run
@molecule/api-ai-tools
@molecule/api-code-sandbox

`@molecule/api-agent-runtime-claude-code`

How it works

Reference