Struct ClaudeCodeDriver 

pub struct ClaudeCodeDriver { /* private fields */ }

Driver that talks to the Claude Code CLI (or any stream-json compatible agent) via the SDK’s --input-format=stream-json --output-format=stream-json protocol.

Implementations

impl ClaudeCodeDriver

pub fn finish_input(&mut self)

Signal that no more user input will be sent in this session. This closes claude’s stdin, after which claude will process any pending frames, emit its final result frame, and exit.

For one-shot interactions this should be called immediately after the final Driver::send. For long-running sessions (multi-turn interactive use) leave stdin open and rely on Driver::shutdown to terminate.

impl ClaudeCodeDriver

pub async fn spawn(cwd: impl AsRef<Path>) -> Result<Self, DriverError>

Spawn a fresh Claude Code session in the given working directory, using the binary on PATH (or $CLAUDE_BIN env override).

Defaults to persistent session mode via --replay-user-messages — one claude process serves an unbounded number of turns. Call Self::finish_input when you’re done so claude can exit gracefully. For multi-turn use, just keep calling Driver::send.

pub fn builder(cwd: impl AsRef<Path>) -> ClaudeCodeDriverBuilder

Begin building a Claude Code session with custom options.

Trait Implementations

impl Debug for ClaudeCodeDriver

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Driver for ClaudeCodeDriver

fn send<'life0, 'async_trait>( &'life0 mut self, frame: ClientFrame, ) -> Pin<Box<dyn Future<Output = Result<(), DriverError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Send a frame to the agent. The frame is processed asynchronously; resulting events arrive via Driver::next_event.

fn next_event<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Option<AgentEvent>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Await the next event from the agent. Returns None when the agent has exited cleanly.

fn shutdown<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), DriverError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Shut down the agent process and release resources.