@standardagents/anthropic

Overview

The @standardagents/anthropic package provides the Anthropic provider factory for Standard Agents. It wraps the official @anthropic-ai/sdk and enables direct access to Claude models with typed providerOptions, extended thinking support, prompt caching, and Anthropic's server-side web search tool.

Installation

npm install @standardagents/anthropic

pnpm add @standardagents/anthropic

yarn add @standardagents/anthropic

Quick Start

import { defineModel } from '@standardagents/spec';
import { anthropic } from '@standardagents/anthropic';

export default defineModel({
  name: 'claude-opus',
  provider: anthropic,
  model: 'claude-opus-5-5',
  // Prices change. Check https://platform.claude.com/docs/en/about-claude/pricing
  inputPrice: 4,
  outputPrice: 20,
});

Provider Factory

The anthropic export is a provider factory function that creates Anthropic provider instances:

import { anthropic } from '@standardagents/anthropic';

// The factory is used by defineModel internally
defineModel({
  name: 'my-model',
  provider: anthropic,  // Pass the factory, not a string
  model: 'claude-sonnet-5-5',
});

Provider Options

The anthropic factory includes a typed schema for provider-specific options:

import { defineModel } from '@standardagents/spec';
import { anthropic } from '@standardagents/anthropic';

export default defineModel({
  name: 'claude-opus',
  provider: anthropic,
  model: 'claude-opus-5-5',
  // Prices change. Check https://platform.claude.com/docs/en/about-claude/pricing
  inputPrice: 4,
  outputPrice: 20,
  providerOptions: {
    service_tier: 'auto',
    metadata: { user_id: 'user-123' },
    cacheSystemPrompt: true,
  },
});

Available Options

Unknown keys are passed through to the Messages API for forward compatibility.

Extended Thinking

The provider maps the Standard Agents 0-100 reasoning level to the right thinking configuration per model generation:

A prompt's explicit reasoning.level takes precedence over native thinking options. Level 0 disables thinking where supported. Fable, Mythos, Opus 5.5, and Sonnet 5.5 use low effort at level 0.

Thinking text, signatures, and redacted thinking blocks are preserved on responses and replayed exactly on subsequent turns, which Anthropic requires for multi-turn tool use with thinking enabled. When thinking is active, sampling parameters (temperature, top_p, top_k) are automatically omitted since the API rejects them alongside thinking.

Provider Tools

Anthropic's server-side web_search tool is exposed as a provider-embedded tool. Add it to a prompt or model's tool list and Claude will search the web on Anthropic's servers; results are recorded in execution logs as provider tool calls with their queries and sources.

Usage & Cost Tracking

Token usage is normalized to the Standard Agents convention: promptTokens covers the full prompt (including cache reads and cache writes), cachedTokens reports tokens served from the prompt cache, and reasoningTokens reports thinking tokens. Raw Anthropic usage buckets (cacheCreationInputTokens, cacheReadInputTokens, serviceTier, server tool usage) are preserved in response metadata for inspection.

The Anthropic API reports token counts but no dollar cost, so the provider derives the exact request cost for documented Claude models from the raw billing buckets — uncached input at the base rate, cache writes at 1.25x (5-minute TTL) or 2x (1-hour TTL), cache reads at the model-specific cached-input rate, and output (including thinking tokens) at the output rate. This provider-reported cost takes precedence over a flat inputPrice/outputPrice calculation, so you do not need to set prices on models in the known-pricing table. For custom or future model IDs without table entries, set inputPrice and outputPrice on the model definition.

Supported Models

All Claude models are supported (model IDs starting with claude-). The model picker lists live data from the Anthropic Models API, including context window, output limits, and per-model capabilities.

API Key: Set ANTHROPIC_API_KEY environment variable

Package: @standardagents/anthropic