Anthropic SDK

Build agents using the Anthropic Python SDK with Claude models and tool use.

Language:PythonProvider:AnthropicKey required:ANTHROPIC_API_KEY

Quick start

1

Create the project

npx agentvoy create my-project --framework anthropic --provider anthropic --model claude-sonnet-4-20250514 --yes
2

Install dependencies

cd my-project-agent
pip install -r requirements.txt
3

Add your API key

cp .env.example .env
# Edit .env and add: ANTHROPIC_API_KEY=sk-ant-api03-...

Need a key? See how to get an Anthropic API key.

4

Run

python run.py

App mode

npx agentvoy create my-project --framework anthropic --build-mode app --deploy-target docker --yes

What gets generated

# agent.py — uses Anthropic's tool_use pattern
import anthropic
from dotenv import load_dotenv
load_dotenv()

client = anthropic.Anthropic()

def create_agent():
    tools = get_tools()
    return {"client": client, "tools": tools}

def run_agent(prompt: str, model: str | None = None) -> str:
    from agentvoy_guard import Guard
    guard = Guard.from_config()
    _model = model or os.environ.get("DEFAULT_MODEL", "claude-sonnet-4-20250514")

    with guard.session() as session:
        session.check_input(prompt)
        response = client.messages.create(
            model=_model,
            max_tokens=8096,
            system="You are a helpful AI assistant...",
            messages=[{"role": "user", "content": prompt}],
            tools=tools,
        )
        final = response.content[0].text
        session.check_output(final)
    return final

Switching models at runtime

DEFAULT_MODEL=claude-haiku-4-5-20251001

Or switch via the chat UI model dropdown in app mode.

Compatible providers

The Anthropic SDK only works with Anthropic as the provider. For multi-provider support, use CrewAI or LangGraph.