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

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

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 {@link 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/[email protected]` — 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