Struct ClaudeCodeOptions 

pub struct ClaudeCodeOptions {

    pub system_prompt_v2: Option<SystemPrompt>,
    pub system_prompt: Option<String>,
    pub append_system_prompt: Option<String>,
    pub allowed_tools: Vec<String>,
    pub disallowed_tools: Vec<String>,
    pub permission_mode: PermissionMode,
    pub mcp_servers: HashMap<String, McpServerConfig>,
    pub mcp_tools: Vec<String>,
    pub max_turns: Option<i32>,
    pub max_thinking_tokens: i32,
    pub max_output_tokens: Option<u32>,
    pub model: Option<String>,
    pub cwd: Option<PathBuf>,
    pub continue_conversation: bool,
    pub resume: Option<String>,
    pub permission_prompt_tool_name: Option<String>,
    pub settings: Option<String>,
    pub add_dirs: Vec<PathBuf>,
    pub extra_args: HashMap<String, Option<String>>,
    pub env: HashMap<String, String>,
    pub debug_stderr: Option<Arc<Mutex<dyn Write + Send + Sync>>>,
    pub include_partial_messages: bool,
    pub can_use_tool: Option<Arc<dyn CanUseTool>>,
    pub hooks: Option<HashMap<String, Vec<HookMatcher>>>,
    pub control_protocol_format: ControlProtocolFormat,
    pub setting_sources: Option<Vec<SettingSource>>,
    pub fork_session: bool,
    pub agents: Option<HashMap<String, AgentDefinition>>,
    pub cli_channel_buffer_size: Option<usize>,
}

Configuration options for Claude Code SDK

Fields

system_prompt_v2: Option<SystemPrompt>

System prompt configuration (simplified in v0.1.12+) Can be either a string or a preset configuration Replaces the old system_prompt and append_system_prompt fields

system_prompt: Option<String>

👎Deprecated since 0.1.12: Use system_prompt_v2 instead

[DEPRECATED] System prompt to prepend to all messages Use system_prompt_v2 instead

append_system_prompt: Option<String>

👎Deprecated since 0.1.12: Use system_prompt_v2 instead

[DEPRECATED] Additional system prompt to append Use system_prompt_v2 instead

allowed_tools: Vec<String>

List of allowed tools

disallowed_tools: Vec<String>

List of disallowed tools

permission_mode: PermissionMode

Permission mode for tool execution

mcp_servers: HashMap<String, McpServerConfig>

MCP server configurations

mcp_tools: Vec<String>

MCP tools to enable

max_turns: Option<i32>

Maximum number of conversation turns

max_thinking_tokens: i32

Maximum thinking tokens

max_output_tokens: Option<u32>

Maximum output tokens per response (1-32000, overrides CLAUDE_CODE_MAX_OUTPUT_TOKENS env var)

model: Option<String>

Model to use

cwd: Option<PathBuf>

Working directory

continue_conversation: bool

Continue from previous conversation

resume: Option<String>

Resume from a specific conversation ID

permission_prompt_tool_name: Option<String>

Custom permission prompt tool name

settings: Option<String>

Settings file path for Claude Code CLI

add_dirs: Vec<PathBuf>

Additional directories to add as working directories

extra_args: HashMap<String, Option<String>>

Extra arbitrary CLI flags

env: HashMap<String, String>

Environment variables to pass to the process

debug_stderr: Option<Arc<Mutex<dyn Write + Send + Sync>>>

Debug output stream (e.g., stderr)

include_partial_messages: bool

Include partial assistant messages in streaming output

can_use_tool: Option<Arc<dyn CanUseTool>>

Tool permission callback

hooks: Option<HashMap<String, Vec<HookMatcher>>>

Hook configurations

control_protocol_format: ControlProtocolFormat

Control protocol format (defaults to Legacy for compatibility)

setting_sources: Option<Vec<SettingSource>>

Setting sources to load (user, project, local) When None, no filesystem settings are loaded (matches Python SDK v0.1.0 behavior)

fork_session: bool

Fork session when resuming instead of continuing When true, creates a new branch from the resumed session

agents: Option<HashMap<String, AgentDefinition>>

Programmatic agent definitions Define agents inline without filesystem dependencies

cli_channel_buffer_size: Option<usize>

CLI channel buffer size for internal communication channels Controls the size of message, control, and stdin buffers (default: 100) Increase for high-throughput scenarios to prevent message lag

Implementations

impl ClaudeCodeOptions

pub fn builder() -> ClaudeCodeOptionsBuilder

Create a new options builder

Trait Implementations

impl Clone for ClaudeCodeOptions

fn clone(&self) -> ClaudeCodeOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClaudeCodeOptions

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

Formats the value using the given formatter.

impl Default for ClaudeCodeOptions

fn default() -> ClaudeCodeOptions

Returns the “default value” for a type.