Struct ClaudeCliBuilder 

pub struct ClaudeCliBuilder { /* private fields */ }

Builder for creating Claude CLI commands in JSON streaming mode

This builder automatically configures Claude to use:

• --print mode for non-interactive operation
• --output-format stream-json for streaming JSON responses
• --input-format stream-json for JSON input
• --replay-user-messages to echo back user messages

Implementations

impl ClaudeCliBuilder

pub fn new() -> Self

Create a new Claude CLI builder with JSON streaming mode pre-configured

pub fn command<P: Into<PathBuf>>(self, path: P) -> Self

Set custom path to Claude binary

pub fn prompt<S: Into<String>>(self, prompt: S) -> Self

Set the prompt for Claude

pub fn debug<S: Into<String>>(self, filter: Option<S>) -> Self

Enable debug mode with optional filter

pub fn verbose(self, verbose: bool) -> Self

Enable verbose mode

pub fn dangerously_skip_permissions(self, skip: bool) -> Self

Skip all permission checks (dangerous!)

pub fn allowed_tools<I, S>(self, tools: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add allowed tools

pub fn disallowed_tools<I, S>(self, tools: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add disallowed tools

pub fn mcp_config<I, S>(self, configs: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Add MCP configuration

pub fn append_system_prompt<S: Into<String>>(self, prompt: S) -> Self

Append a system prompt

pub fn permission_mode(self, mode: PermissionMode) -> Self

Set permission mode

pub fn continue_conversation(self, continue_conv: bool) -> Self

Continue the most recent conversation

pub fn resume<S: Into<String>>(self, session_id: Option<S>) -> Self

Resume a specific conversation

pub fn model<S: Into<String>>(self, model: S) -> Self

Set the model to use

pub fn fallback_model<S: Into<String>>(self, model: S) -> Self

Set fallback model for overload situations

pub fn settings<S: Into<String>>(self, settings: S) -> Self

Load settings from file or JSON

pub fn add_directories<I, P>(self, dirs: I) -> Self

where I: IntoIterator<Item = P>, P: Into<PathBuf>,

Add directories for tool access

pub fn ide(self, ide: bool) -> Self

Automatically connect to IDE

pub fn strict_mcp_config(self, strict: bool) -> Self

Use only MCP servers from config

pub fn session_id(self, id: Uuid) -> Self

Set a specific session ID (must be a UUID)

pub fn oauth_token<S: Into<String>>(self, token: S) -> Self

Set OAuth token for authentication (must start with “sk-ant-oat”)

pub fn api_key<S: Into<String>>(self, key: S) -> Self

Set API key for authentication (must start with “sk-ant-api”)

pub fn permission_prompt_tool<S: Into<String>>(self, tool: S) -> Self

Enable bidirectional tool permission protocol via stdio

When enabled, Claude CLI will send permission requests via stdout and expect responses via stdin. Use “stdio” for standard I/O based permission handling.

Example

use claude_codes::ClaudeCliBuilder;

let builder = ClaudeCliBuilder::new()
    .permission_prompt_tool("stdio")
    .model("sonnet");

pub async fn spawn(self) -> Result<Child>

Spawn the Claude process

pub fn build_command(self) -> Command

Build a Command without spawning (for testing or manual execution)

pub fn spawn_sync(self) -> Result<Child>

Spawn the Claude process using synchronous std::process

Trait Implementations

impl Clone for ClaudeCliBuilder

fn clone(&self) -> ClaudeCliBuilder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClaudeCliBuilder

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

Formats the value using the given formatter.

impl Default for ClaudeCliBuilder

fn default() -> Self

Returns the “default value” for a type.