claude-code-sdk-rust 0.2.0

Async Rust SDK for the Claude Code CLI: streaming agent turns, tool use, and sessions.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use std::collections::HashMap;

use super::*;

#[derive(Debug, Clone)]
pub struct ClaudeAgentOptions {
    pub tools: Vec<String>,
    pub tools_set: bool,
    pub tools_preset: Option<ToolsPreset>,
    pub allowed_tools: Vec<String>,
    pub system_prompt: Option<String>,
    pub system_prompt_preset: Option<SystemPromptPreset>,
    pub system_prompt_file: Option<SystemPromptFile>,
    pub mcp_servers: HashMap<String, MCPServerConfig>,
    pub mcp_servers_config: Option<String>,
    pub permission_mode: Option<PermissionMode>,
    pub continue_conversation: bool,
    pub resume: Option<String>,
    pub session_id: Option<String>,
    pub fork_session: bool,
    pub max_turns: Option<i32>,
    pub max_budget_usd: Option<f64>,
    pub task_budget: Option<TaskBudget>,
    pub disallowed_tools: Vec<String>,
    pub model: Option<String>,
    pub fallback_model: Option<String>,
    pub betas: Vec<SdkBeta>,
    pub permission_prompt_tool_name: Option<String>,
    pub cwd: Option<String>,
    pub cli_path: Option<String>,
    pub settings: Option<String>,
    pub add_dirs: Vec<String>,
    pub env: HashMap<String, String>,
    pub extra_args: HashMap<String, Option<String>>,
    pub max_buffer_size: Option<usize>,
    pub user: Option<String>,
    pub include_partial_messages: bool,
    pub include_hook_events: bool,
    pub strict_mcp_config: bool,
    pub setting_sources: Option<Vec<SettingSource>>,
    pub skills: Option<SkillsConfig>,
    pub sandbox: Option<SandboxSettings>,
    pub plugins: Vec<SDKPluginConfig>,
    pub max_thinking_tokens: Option<i32>,
    pub thinking: Option<ThinkingConfig>,
    pub effort: Option<String>,
    pub output_format: Option<serde_json::Map<String, serde_json::Value>>,
    pub enable_file_checkpointing: bool,
    pub stderr: Option<StderrCallback>,
    pub can_use_tool: Option<CanUseToolCallback>,
    pub sdk_mcp_servers: HashMap<String, crate::mcp::SimpleMCPServer>,
    pub hooks: HookMap,
    pub agents: HashMap<String, AgentDefinition>,
    pub session_store: Option<crate::session_store::SessionStoreHandle>,
    pub session_store_flush: SessionStoreFlushMode,
    pub load_timeout_ms: i32,
}

impl Default for ClaudeAgentOptions {
    fn default() -> Self {
        Self {
            tools: Vec::new(),
            tools_set: false,
            tools_preset: None,
            allowed_tools: Vec::new(),
            system_prompt: None,
            system_prompt_preset: None,
            system_prompt_file: None,
            mcp_servers: HashMap::new(),
            mcp_servers_config: None,
            permission_mode: None,
            continue_conversation: false,
            resume: None,
            session_id: None,
            fork_session: false,
            max_turns: None,
            max_budget_usd: None,
            task_budget: None,
            disallowed_tools: Vec::new(),
            model: None,
            fallback_model: None,
            betas: Vec::new(),
            permission_prompt_tool_name: None,
            cwd: None,
            cli_path: None,
            settings: None,
            add_dirs: Vec::new(),
            env: HashMap::new(),
            extra_args: HashMap::new(),
            max_buffer_size: None,
            user: None,
            include_partial_messages: false,
            include_hook_events: false,
            strict_mcp_config: false,
            setting_sources: None,
            skills: None,
            sandbox: None,
            plugins: Vec::new(),
            max_thinking_tokens: None,
            thinking: None,
            effort: None,
            output_format: None,
            enable_file_checkpointing: false,
            stderr: None,
            can_use_tool: None,
            sdk_mcp_servers: HashMap::new(),
            hooks: HashMap::new(),
            agents: HashMap::new(),
            session_store: None,
            session_store_flush: SessionStoreFlushMode::Batched,
            load_timeout_ms: 60_000,
        }
    }
}