# llm_anthropic A RocketRide LLM node that connects Anthropic's Claude models to your pipeline. ## What it does Connects Anthropic's Claude models to your pipeline. Used primarily as an `llm` invoke connection by agents, vector stores, database nodes, and other nodes that need an LLM (`classType: ["llm"]`, capability `invoke`). Can also be used directly in a pipeline via lanes. Built on **langchain-anthropic** (`ChatAnthropic`) with the **anthropic** SDK used directly for save-time validation. The configured `modelOutputTokens` is passed to the model as `max_tokens`. Token counts for budgeting are estimated at roughly 4 characters per token. When the selected model is flagged as reasoning-capable, the node enables extended thinking automatically and streams the model's reasoning over the `thinking` SSE lane; see "Extended thinking" below. --- ## Configuration ### Lanes | Lane in | Lane out | Description | | ----------- | --------- | ----------------------------------------------------- | | `questions` | `answers` | Send a question directly, receive a generated answer | ### Fields | Field | Type / Default | Description | | ------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------- | | `profile` | enum, `claude-sonnet-4-6` | Which Claude model to use (see Profiles below) | | `apikey` | string | Anthropic API key. Must start with `sk-ant` (e.g. `sk-ant-...` or `sk-ant-api03-...`) | | `modelSource` | string | Where the model definition comes from (`manual` or `openrouter`) | | `model` | string (custom profile only) | Anthropic model ID, used only when `profile` is `custom` | | `modelTotalTokens` | number (custom profile only) | Total context tokens for the custom profile; must be greater than 0 | The model ID and token limits for named profiles are fixed by the profile. Only the `custom` profile exposes `model` and `modelTotalTokens` directly. --- ## Profiles Default profile: **Claude Sonnet 4.6**. | Profile | Model ID | Context tokens | Output tokens | | ------------------------------ | ------------------- | ------------------ | ------------- | | Claude Sonnet 4.6 _(default)_ | `claude-sonnet-4-6` | 1,000,000 | 128,000 | | Claude Opus 4.7 | `claude-opus-4-7` | 1,000,000 | 128,000 | | Claude Opus 4.6 | `claude-opus-4-6` | 1,000,000 | 128,000 | | Claude Sonnet 4.5 | `claude-sonnet-4-5` | 1,000,000 | 64,000 | | Claude Opus 4.5 | `claude-opus-4-5` | 200,000 | 64,000 | | Claude Haiku 4.5 | `claude-haiku-4-5` | 200,000 | 64,000 | | Custom | _(user-specified)_ | 200,000 (editable) | _(none set)_ | --- ## Extended thinking Whether thinking is requested is driven by the model's `capabilities.reasoning` flag in the node configuration (stamped from OpenRouter model sync). When set, the node builds provider-correct thinking parameters based on the model name. Routing prefixes such as `openrouter/anthropic/` are stripped before matching. | Model | Thinking parameters sent | | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Any Haiku model | None. Haiku has no extended thinking; sending parameters would return a 400. | | `claude-opus-4-7` / `claude-opus-4-8` | `thinking: {type: "adaptive", display: "summarized"}` (adaptive thinking) | | Other Claude models | `thinking: {type: "enabled", budget_tokens: N}` plus the `interleaved-thinking-2025-05-14` beta header, where `N` is half the output-token limit (minimum 2,048, always below `max_tokens`). Skipped entirely if the output window is too small for a valid budget. | When thinking is actually enabled, responses are streamed through the native Anthropic Messages API handler (`ai.common.llm_native_stream`, provider `anthropic`) so that thinking deltas (which LangChain drops) are preserved and forwarded on the `thinking` SSE lane. Non-reasoning models stay on the default LangChain streaming path. --- ## Authentication Provide an Anthropic API key in the `apikey` field. The key is validated at startup: it must be non-empty and start with `sk-ant` (covers both standard `sk-ant-...` and newer `sk-ant-api03-...` formats). If the key fails this check, the node raises `Invalid Anthropic API key format, please check your API key.` The key is read at construction time and not stored by the node. --- ## Save-time validation When the node configuration is saved, a lightweight validation pass runs before the first pipeline execution: - Checks that `modelTotalTokens` (custom profile) is greater than 0. - Sends a minimal one-token probe request (`max_tokens: 1`) to the configured model using the configured key. Any failure (bad key, unknown model, rate limit, network error) is surfaced as a concise single-line warning in the form `Error : - `, extracted from the API's structured error payload when available. Network or SDK errors that carry no structured payload fall back to the raw exception message, collapsed to a single line. --- ## Schema | Field | Type | Description | Default | |---|---|---|---| | `anthropic.profile` | `string` | **Model**
LLM model | `"claude-sonnet-4-6"` | | `model` | `string` | **Model**
Anthropic model | | | `modelTotalTokens` | `number` | **Tokens**
Total Tokens | | ## Dependencies - `langchain-anthropic` - `anthropic` - `langchain-core` - `langchain` ## Source [ View source](https://github.com/rocketride-org/rocketride-server/tree/develop/nodes/src/nodes/llm_anthropic)