This module integrates Anthropic's Claude API with the Odoo LLM framework, providing access to Claude models for chat, tool calling, and extended thinking capabilities.

Module Type: 🔧 Provider

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                    Used By (Any LLM Module)                     │
│  ┌─────────────┐  ┌───────────┐  ┌─────────────┐  ┌───────────┐ │
│  │llm_assistant│  │llm_thread │  │llm_knowledge│  │llm_generate│ │
│  └──────┬──────┘  └─────┬─────┘  └──────┬──────┘  └─────┬─────┘ │
└─────────┼───────────────┼───────────────┼───────────────┼───────┘
          │               │               │               │
          └───────────────┴───────┬───────┴───────────────┘
                                  ▼
          ┌───────────────────────────────────────────────┐
          │        ★ llm_anthropic (This Module) ★        │
          │              Anthropic Provider               │
          │  Claude 4.5 │ Claude 4 │ Claude 3.x │ Vision  │
          └─────────────────────┬─────────────────────────┘
                                │
                                ▼
          ┌───────────────────────────────────────────────┐
          │                    llm                        │
          │              (Core Base Module)               │
          └───────────────────────────────────────────────┘

Installation

What to Install

For AI chat with Claude:

odoo-bin -d your_db -i llm_assistant,llm_anthropic

Auto-Installed Dependencies

llm (core infrastructure)
llm_tool (tool/function calling support)

Alternative Providers

Instead of Anthropic	Use	Best For
`llm_openai`	OpenAI	GPT models, DALL-E
`llm_ollama`	Local AI	Privacy, no API costs
`llm_mistral`	Mistral AI	European, fast

Common Setups

I want to...	Install
Chat with Claude	`llm_assistant` + `llm_anthropic`
Claude + document search	Above + `llm_knowledge` + `llm_pgvector`
Claude + external tools	Above + `llm_mcp_server`

Features

Connect to Anthropic API with proper authentication
Support for all Claude models (4.5, 4, 3.x series)
Tool/function calling capabilities
Extended thinking support (Claude's reasoning mode)
Streaming responses
Multimodal (vision) capabilities for supported models
Automatic model discovery

Multimodal Support

Claude models support sending images and PDFs along with text messages.

How to Use

Attach files (images, PDFs, text files) to your chat message
The module automatically:
- Converts images to base64 for Claude's vision API
- Sends PDFs as document blocks
- Includes text file contents in the message

Supported Formats

Type	Formats	Claude Format
Images	JPEG, PNG, GIF, WebP	`type: "image"` with base64 source
PDFs	application/pdf	`type: "document"` with base64 source
Text	.txt, .md, .csv, .py, .json, etc.	Appended to message text

Example

# Attach an image to the chat thread
thread.message_post(
    body="What's in this image?",
    attachment_ids=[(4, image_attachment.id)]
)
# Claude will analyze the image and respond

Note: Non-multimodal models (like older Claude versions) will skip images/PDFs automatically.

Configuration

Install the module
Navigate to LLM > Configuration > Providers
Create a new provider and select "Anthropic" as the provider type
Enter your Anthropic API key
Click "Fetch Models" to import available models

Supported Models

Model Family	Models	Capabilities
Claude 4.5	Opus, Sonnet, Haiku	Chat, Vision, Tools, Extended Thinking
Claude 4	Opus, Sonnet	Chat, Vision, Tools
Claude 3.x	Opus, Sonnet, Haiku	Chat, Vision, Tools

Technical Details

This module extends the base LLM integration framework with Anthropic-specific implementations:

Key Differences from OpenAI

Aspect	OpenAI	Anthropic
System message	In messages array	Separate `system` parameter
Tool format	`{"type": "function", "function": {...}}`	`{"name", "description", "input_schema"}`
Response content	Single string	Array of content blocks
Tool results	`role: "tool"`	`role: "user"` + `type: "tool_result"`

Extended Thinking

Claude supports extended thinking mode, which allows the model to show its reasoning process:

# Enable extended thinking in your assistant configuration
response = provider.chat(
    messages=messages,
    extended_thinking=True,
    thinking_budget=10000  # tokens for reasoning
)

Implemented Methods

anthropic_get_client() - Initialize Anthropic client
anthropic_chat() - Chat with tool calling and streaming support
anthropic_format_tools() - Convert tools to Anthropic format
anthropic_format_messages() - Format mail.message records
anthropic_models() - List available Claude models
anthropic_normalize_prepend_messages() - Handle prepend messages

Dependencies

llm (LLM Integration Base)
llm_tool (Tool Calling Support)
Python: anthropic package

Contributors

Crottolo bo@fl1.cz - Odoo 18.0 port with full tool calling and extended thinking support

License

LGPL-3