@agentick/anthropic

Native Anthropic Messages API adapter for Agentick.

Installation

pnpm add @agentick/anthropic @anthropic-ai/sdk

Usage

Factory Pattern (Recommended)

import { anthropic } from "@agentick/anthropic";
import { createApp } from "@agentick/core";

const model = anthropic("claude-sonnet-4-20250514");

// Use with createApp
const app = createApp(MyAgent, { model });
const session = await app.session();
await session.run({ messages: [{ role: "user", content: [{ type: "text", text: "Hello!" }] }] });

// Or with config object
const model = anthropic({
  model: "claude-opus-4-20250514",
  maxTokens: 8192,
  apiKey: process.env.ANTHROPIC_API_KEY,
});

JSX Component Pattern

import { AnthropicModel } from "@agentick/anthropic";

function MyAgent() {
  return (
    <AnthropicModel model="claude-sonnet-4-20250514" maxTokens={4096}>
      <System>You are helpful.</System>
      <Timeline />
    </AnthropicModel>
  );
}

Features

• Streaming - Full streaming support with deltas
• Tool calling - Native Anthropic tool use
• Extended thinking - Reasoning/thinking blocks from supported models
• Vision - Image understanding via base64 or URL
• Prompt caching - Anthropic cache control support
• Documents - PDF and document content blocks

Configuration

| Option | Type | Description | | ---------------- | ------------ | ------------------------------------------------- | | model | string | Model name (e.g., claude-sonnet-4-20250514) | | apiKey | string? | API key (env: ANTHROPIC_API_KEY) | | baseURL | string? | Custom API endpoint (env: ANTHROPIC_BASE_URL) | | maxTokens | number? | Maximum tokens to generate | | headers | object? | Additional request headers | | timeout | number? | Request timeout in milliseconds | | maxRetries | number? | Maximum retry attempts | | client | Anthropic? | Pre-configured Anthropic SDK client instance | | customBlocks | object? | Custom block definitions to intercept from output | | deltaTransform | function? | User-facing delta transform |

Environment Variables

| Variable | Description | | -------------------- | ------------------- | | ANTHROPIC_API_KEY | Anthropic API key | | ANTHROPIC_BASE_URL | Custom API endpoint |

Models

• claude-opus-4-20250514
• claude-sonnet-4-20250514
• claude-3-5-haiku-20241022
• claude-3-5-sonnet-20241022

Exports

• anthropic(configOrModel) - Factory function returning ModelClass
• createAnthropicModel(config) - Same as anthropic()
• AnthropicModel - JSX component for declarative usage