Configuration
Command flags
| Flag | Required | Meaning |
|---|---|---|
--session-id | Yes | Identifier attached to the runtime Session. |
--agent-config | Yes | Path to the JSON configuration file. |
--api-key | No | Compatibility override for ANTHROPIC_API_KEY; environment configuration is preferred. |
JSON configuration
| Field | Required | Meaning |
|---|---|---|
system_prompt | No | Instructions supplied to the model. |
model | No | Model identifier. Defaults to claude-sonnet-4-6. |
initial_prompt | No | First user message sent by the command. |
permission | No | Must currently be always_allow. |
The command rejects always_ask because approval rendezvous is not complete.
Managed deployments should enforce their sandbox policy independently rather
than treating the runtime configuration as a security boundary.
Environment
The default model client reads ANTHROPIC_API_KEY, falling back to the legacy
MODELVERSE_API_KEY. Without an explicit base URL, the former selects
https://api.anthropic.com and the latter preserves the legacy Modelverse
endpoint. ANTHROPIC_BASE_URL overrides either choice.
The built-in adapter currently implements Anthropic Messages. OpenAI Responses requires a separate adapter because its function-call, reasoning-item and stream-event semantics are not wire-compatible; it is planned, not silently emulated by changing the base URL.