Claude Code Runtime

Call Claude Code headlessly from a non-Claude runtime with one canonical command shape.

Contract

• Resolve the active workspace authority contract before composing the prompt. It governs writes, credentials, external actions, production changes, destructive operations, and human gates. Include the exact contract in any delegated prompt that may reach those surfaces.
• Without a workspace contract, use the read-only tool set and stop before external effects.
• Run from the target repository so Claude discovers its local instructions.
• Capture the returned session id; it is the only reliable follow-up handle.

Canonical invocation

cd <target-repo> && claude -p "<prompt>" --output-format json