Anthropic Claude models

Anthropic is a BYOK (bring-your-own-key) LLM provider in ModuleX. You connect your own Anthropic API key, then use Claude models in the LLM node, the Agent node, chat, and the Assistant. Because Anthropic is BYOK, Anthropic bills you directly for token usage and ModuleX adds no credit charge on top — see BYOK billing below. For the full list of provider types and how managed versus BYOK selection works, see LLM providers. If you would rather have ModuleX provision and meter the model for you in credits, use ModuleX-managed models instead.

🎬 MEDIA PLACEHOLDER · MX-MEDIA-4070 · [SCREENSHOT] [SCREENSHOT_DESCRIPTION]: The Anthropic connection card in the ModuleX integrations/credentials UI. [SCREENSHOT_DETAILS]: Capture the API Key Authentication form for Anthropic in the credential-management UI: the API Key field (masked), the optional Base URL field defaulted to https://api.anthropic.com, and the “Test connection” / “Save” controls. Light theme, 16:9, crop to the card.

What you need

An Anthropic API key

Create a key in the Anthropic Console. Anthropic keys start with sk-ant- (for example sk-ant-api03-…). ModuleX validates the key against the pattern ^sk-ant-[a-zA-Z0-9\-_]{20,}$ before saving it.

A ModuleX organization and an owner/admin role

Credentials are scoped to an organization. Connecting and managing integrations requires the owner or admin role — the member role is retired. See roles & permissions.

A ModuleX API key (for programmatic setup)

To connect Anthropic over the API or an SDK, you need a ModuleX API key (mx_live_…) and your organization id. See authentication.

Connect Anthropic

You connect Anthropic by storing your Anthropic API key as a credential for the anthropic integration. You can do this in the app or programmatically.

In the app

Open the integrations catalog and select Anthropic, or open Settings → Credentials.
Choose API Key Authentication and paste your Anthropic key.
Optionally set a custom Base URL (defaults to https://api.anthropic.com) — only needed for Anthropic-compatible gateways.
Save. ModuleX validates the key with a minimal request before storing it (see Test a key before saving).

Anthropic exposes a single authentication scheme — api_key. Its fields are:

api_key

string

required

Your Anthropic API key. Stored encrypted and never returned in plaintext. Pattern ^sk-ant-[a-zA-Z0-9\-_]{20,}$; sample format sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

base_url

string

default:"https://api.anthropic.com"

Optional custom API base URL, only needed when pointing at an Anthropic-compatible API. Must match ^https?://.*.

Over the API or an SDK

Create the credential with POST /credentials. ModuleX detects the credential type from the body: an auth_data.api_key value is stored as an api_key credential. Set make_default: true to make this the default Anthropic credential for the organization. Every request authenticates with Authorization: Bearer mx_live_… plus the X-Organization-ID header (see authentication).

curl -X POST https://api.modulex.dev/credentials \
  -H "Authorization: Bearer mx_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Organization-ID: 6f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f" \
  -H "Content-Type: application/json" \
  -d '{
        "integration_name": "anthropic",
        "display_name": "Anthropic production key",
        "make_default": true,
        "auth_data": { "api_key": "sk-ant-api03-..." }
      }'

string

The new credential’s identifier. A 201 response returns the credential metadata; the secret is never echoed back.

Creating, listing, and managing credentials and the integration catalog requires the owner or admin role in the organization. A caller without that role receives a 403. The integration-catalog read routes (for example GET /integrations/llm-providers/anthropic) are also owner/admin-gated.

Test a key before saving

Use POST /credentials/test-temporary to validate an Anthropic key without storing it. ModuleX runs the provider’s test call — a 10-token POST to https://api.anthropic.com/v1/messages against claude-haiku-4-5-20251001 with the header anthropic-version: 2023-06-01 — and reports success when the response status is 200 and includes the fields id, type, and content.

curl -X POST https://api.modulex.dev/credentials/test-temporary \
  -H "Authorization: Bearer mx_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Organization-ID: 6f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f" \
  -H "Content-Type: application/json" \
  -d '{
        "integration_name": "anthropic",
        "auth_type": "api_key",
        "auth_data": { "api_key": "sk-ant-api03-..." }
      }'

is_valid

boolean

true when the test call succeeds.

status_code

integer

The HTTP status returned by Anthropic’s test endpoint (200 on success).

test_method

string

How the credential was validated. For Anthropic this is api_call.

cost_level

string

The cost class of the test call. For Anthropic this is minimal (a 10-token request).

Available models

ModuleX serves Claude models from the catalog at GET /integrations/llm-providers/anthropic. The catalog is read-only metadata used by the credential UI and the builder — it is not the execution path. The models below are the ones ModuleX currently advertises for Anthropic.

Model id	Display name	Max input tokens	Max output tokens	Vision	Input $/1M	Output $/1M
`claude-opus-4.7`	Claude Opus 4.7	1,000,000	128,000	Yes	`$5.00`	`$25.00`
`claude-sonnet-4.6`	Claude Sonnet 4.6	200,000	64,000	Yes	`$3.00`	`$15.00`
`claude-haiku-4.5`	Claude Haiku 4.5	200,000	64,000	Yes	`$1.00`	`$5.00`

Prices in the table are Anthropic’s per-token rates as recorded in the ModuleX catalog, in USD per 1,000,000 tokens. Because Anthropic is BYOK, these are the rates Anthropic charges you directly — they are not ModuleX credits. See BYOK billing.

Each model id is the catalog id you select in the app and in node configuration. ModuleX maps the catalog id to the underlying Anthropic wire model and request settings:

Show Claude Opus 4.7 — full catalog fields

string

claude-opus-4.7 — the catalog id you select.

display_name

string

Claude Opus 4.7

provider

string

Anthropic

provider_id

string

anthropic — the routing provider slug.

max_input_tokens

integer

1000000

max_output_tokens

integer

128000

supports_vision

boolean

true

intelligence

integer

5 (quality score, 1–5).

speed

integer

1 (latency score, 1–5; higher is faster).

data_freshness

string

2026-01-01 (knowledge cutoff).

input_usd_per_1m_tokens

number

5.0

output_usd_per_1m_tokens

number

25.0

wire model

string

ModuleX sends the wire model claude-opus-4-7 with max_tokens: 128000 and the header anthropic-version: 2023-06-01.

Show Claude Sonnet 4.6 — full catalog fields

string

claude-sonnet-4.6

display_name

string

Claude Sonnet 4.6

provider_id

string

anthropic

max_input_tokens

integer

200000

max_output_tokens

integer

64000

supports_vision

boolean

true

intelligence

integer

4

speed

integer

3

data_freshness

string

2026-01-01

input_usd_per_1m_tokens

number

3.0

output_usd_per_1m_tokens

number

15.0

wire model

string

Wire model claude-sonnet-4-6 with max_tokens: 64000 and anthropic-version: 2023-06-01.

Show Claude Haiku 4.5 — full catalog fields

string

claude-haiku-4.5

display_name

string

Claude Haiku 4.5

provider_id

string

anthropic

max_input_tokens

integer

200000

max_output_tokens

integer

64000

supports_vision

boolean

true

intelligence

integer

2

speed

integer

5 (fastest).

data_freshness

string

2025-07-01

input_usd_per_1m_tokens

number

1.0

output_usd_per_1m_tokens

number

5.0

wire model

string

Wire model claude-haiku-4-5-20251001 with max_tokens: 64000 and anthropic-version: 2023-06-01. This is the model ModuleX uses for the connection test.

The model list is served from the ModuleX catalog and may change as Anthropic releases or deprecates models. Always read GET /integrations/llm-providers/anthropic for the current set rather than hard-coding ids. Catalog reads are cached for up to 10 minutes.

Read the model catalog

curl https://api.modulex.dev/integrations/llm-providers/anthropic \
  -H "Authorization: Bearer mx_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "X-Organization-ID: 6f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f"

The response is an integration-detail object whose models array contains the entries shown above, plus an auth_schemas array describing the api_key scheme. A truncated example:

Catalog detail (truncated)

{
  "name": "anthropic",
  "display_name": "Anthropic",
  "description": "Anthropic's Claude models for advanced reasoning and long-context tasks",
  "integration_type": "llm_provider",
  "version": "1.0.0",
  "categories": ["AI & LLM Providers", "ai", "chat", "reasoning"],
  "auth_schemas": [
    {
      "auth_type": "api_key",
      "display_name": "API Key Authentication",
      "description": "Connect using Anthropic API Key"
    }
  ],
  "models": [
    {
      "id": "claude-opus-4.7",
      "display_name": "Claude Opus 4.7",
      "max_input_tokens": 1000000,
      "max_output_tokens": 128000,
      "supports_vision": true,
      "input_usd_per_1m_tokens": 5.0,
      "output_usd_per_1m_tokens": 25.0
    }
  ]
}

Use Claude in ModuleX

Once Anthropic is connected, select a Claude model id wherever a model can be chosen:

LLM node

Call Claude with prompts, variables, and structured output inside a workflow.

Agent node

Run an autonomous step where Claude can call tools and loop.

Chat

Pick Claude as the model for a chat conversation.

Assistant

Configure the Assistant to reason and act with a Claude model.

If your organization holds more than one Anthropic credential, ModuleX uses the credential marked default for the anthropic integration. Set a different default with POST /credentials/{credential_id}/set-default. See managing credentials.

BYOK billing

Anthropic is bring-your-own-key, which changes how usage is billed compared with ModuleX-managed models.

BYOK (Anthropic)

Token usage is billed by Anthropic against your own API key. ModuleX adds no credit charge and no markup for the model call itself. BYOK usage is recorded for analytics only — it does not consume ModuleX credits.

Managed (modulexai)

ModuleX provisions the model and bills it in credits through the usage gate, applying a system margin. Use this when you do not want to manage a provider account.

What this means in practice:

No ModuleX credit cost for tokens. A Claude call made with your Anthropic key is not metered in credits. Anthropic invoices you directly at its own rates (the per-million-token prices in the model table).
Other ModuleX usage still applies. Running a workflow or a turn through the Assistant can still consume the flat per-run credit and may pass through the billing gate even when the model itself is BYOK. See credits & metering and usage gating & limits.
Rate limits and quotas are Anthropic’s. Token-rate limits, monthly spend caps, and model availability for a BYOK key are governed by your Anthropic account, not by ModuleX.

BYOK is available on all plans — there is no separate ModuleX entitlement that gates connecting your own Anthropic key. The pricing matrix on the marketing site lists BYOK for every tier; the only ModuleX-side billing that applies to a BYOK call is the non-model usage described above. TBD: confirm with the billing owner that no per-call ModuleX surcharge applies to BYOK model calls before treating “no markup” as a guarantee.

Errors

Catalog and credential operations return ModuleX’s standard error shapes. See errors & status codes for the full taxonomy.

Status	When it happens	Shape
`400`	Invalid `auth_data`/`auth_type` on credential create, or asking a typed endpoint for the wrong integration type (for example `anthropic` is not a tool).	`{detail: string}`
`401`	Missing or invalid `Authorization` / missing `X-Organization-ID`.	`{detail: string}`
`403`	Caller is not an owner/admin in the organization.	`{detail: string}`
`404`	Unknown provider, for example `GET /integrations/llm-providers/<unknown>` returns `LLM provider not found`.	`{detail: string}`
`422`	Query/parameter validation error.	`{detail: [ ... ]}`
`500`	Unhandled server error.	`{detail: string}`

A bad Anthropic key does not surface as a ModuleX 401. Connection validation happens against Anthropic: POST /credentials/test-temporary (or saving with validation) returns is_valid: false with the status Anthropic returned (for example 401 from api.anthropic.com). The ModuleX request itself still succeeds.

LLM providers

All providers, and how managed vs BYOK selection works.

ModuleX-managed models

The credit-billed managed alternative to BYOK.

Authentication & credentials

How integrations authenticate and the auth schema variants.

Managing credentials

Create, default, rotate, and scope credentials.

​What you need

​Connect Anthropic

​In the app

​Over the API or an SDK

​Test a key before saving

​Available models

​Read the model catalog

​Use Claude in ModuleX

LLM node

Agent node

Chat

Assistant

​BYOK billing

BYOK (Anthropic)

Managed (modulexai)

​Errors

​Related

LLM providers

ModuleX-managed models

Authentication & credentials

Managing credentials

What you need

Connect Anthropic

In the app

Over the API or an SDK

Test a key before saving

Available models

Read the model catalog

Use Claude in ModuleX

BYOK billing

Errors

Related