Claude SDK Adapter

1
import asyncio
2
import os
3
from dotenv import load_dotenv
4
from thenvoi import Agent
5
from thenvoi.adapters import ClaudeSDKAdapter
6
from thenvoi.config import load_agent_config
7
8
async def main():
9
    load_dotenv()
10
11
    # Load agent credentials
12
    agent_id, api_key = load_agent_config("my_agent")
13
14
    # Create adapter with Claude SDK
15
    adapter = ClaudeSDKAdapter(
16
        model="claude-sonnet-4-5-20250929",
17
    )
18
19
    # Create and run the agent
20
    agent = Agent.create(
21
        adapter=adapter,
22
        agent_id=agent_id,
23
        api_key=api_key,
24
        ws_url=os.getenv("THENVOI_WS_URL"),
25
        rest_url=os.getenv("THENVOI_REST_URL"),
26
    )
27
28
    print("Agent is running! Press Ctrl+C to stop.")
29
    await agent.run()
30
31
if __name__ == "__main__":
32
    asyncio.run(main())

1
# Claude Sonnet (recommended for most use cases)
2
adapter = ClaudeSDKAdapter(model="claude-sonnet-4-5-20250929")
3
4
# Claude Opus (most capable)
5
adapter = ClaudeSDKAdapter(model="claude-opus-4-5-20251215")
6
7
# Claude Haiku (fastest)
8
adapter = ClaudeSDKAdapter(model="claude-3-5-haiku-20241022")

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    custom_section="""
4
    You are a helpful assistant that specializes in answering
5
    questions about Python programming. Be concise and include
6
    code examples when helpful.
7
    """,
8
)

1
adapter = ClaudeSDKAdapter(
2
    # Model to use
3
    model="claude-sonnet-4-5-20250929",
4
5
    # Custom instructions to append to the system prompt
6
    custom_section="You are a helpful assistant.",
7
8
    # Enable extended thinking (chain of thought)
9
    max_thinking_tokens=10000,
10
11
    # Permission mode for tool execution
12
    permission_mode="acceptEdits",  # or "plan", "bypassPermissions"
13
14
    # Enable visibility into tool calls and thinking
15
    enable_execution_reporting=False,
16
)

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    max_thinking_tokens=10000,
4
)

1
adapter = ClaudeSDKAdapter(
2
    model="claude-sonnet-4-5-20250929",
3
    enable_execution_reporting=True,
4
)

1
import asyncio
2
import os
3
from dotenv import load_dotenv
4
from thenvoi import Agent
5
from thenvoi.adapters import ClaudeSDKAdapter
6
from thenvoi.config import load_agent_config
7
8
async def main():
9
    load_dotenv()
10
    agent_id, api_key = load_agent_config("my_agent")
11
12
    adapter = ClaudeSDKAdapter(
13
        model="claude-sonnet-4-5-20250929",
14
        custom_section="""
15
        You are a helpful data analysis expert. When users ask questions:
16
        1. Think through the problem carefully
17
        2. Provide clear, step-by-step explanations
18
        3. Include code examples in Python when relevant
19
        4. Offer to help with follow-up questions
20
        """,
21
        max_thinking_tokens=5000,
22
        enable_execution_reporting=True,
23
    )
24
25
    agent = Agent.create(
26
        adapter=adapter,
27
        agent_id=agent_id,
28
        api_key=api_key,
29
        ws_url=os.getenv("THENVOI_WS_URL"),
30
        rest_url=os.getenv("THENVOI_REST_URL"),
31
    )
32
33
    print("Data analysis agent is running! Press Ctrl+C to stop.")
34
    await agent.run()
35
36
if __name__ == "__main__":
37
    asyncio.run(main())

1
import asyncio
2
import os
3
import logging
4
from dotenv import load_dotenv
5
from thenvoi import Agent
6
from thenvoi.adapters import ClaudeSDKAdapter
7
from thenvoi.config import load_agent_config
8
9
# Enable debug logging for the SDK
10
logging.basicConfig(
11
    level=logging.WARNING,
12
    format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
13
    datefmt="%Y-%m-%d %H:%M:%S",
14
)
15
logging.getLogger("thenvoi").setLevel(logging.DEBUG)
16
17
async def main():
18
    load_dotenv()
19
    agent_id, api_key = load_agent_config("my_agent")
20
21
    adapter = ClaudeSDKAdapter(
22
        model="claude-sonnet-4-5-20250929",
23
    )
24
25
    agent = Agent.create(
26
        adapter=adapter,
27
        agent_id=agent_id,
28
        api_key=api_key,
29
        ws_url=os.getenv("THENVOI_WS_URL"),
30
        rest_url=os.getenv("THENVOI_REST_URL"),
31
    )
32
33
    print("Agent running with DEBUG logging. Press Ctrl+C to stop.")
34
    await agent.run()
35
36
if __name__ == "__main__":
37
    asyncio.run(main())