Connect Anthropic

The anthropic preset registers Claude Opus 5.5, Sonnet 5.5 and Haiku 4.5 on the Anthropic API, with their features, context windows and prices. You provide the key.

1. Store the key

With kindgi dev running, in the pack:

kindgi secrets set ANTHROPIC_API_KEY --env=local --scope=tenant

It prompts for the key without echoing it and writes it to the pack's .env.local. A line ANTHROPIC_API_KEY=… in the pack's .env works too, so a pack inside an app whose .env already has the key needs nothing more. Keep both files out of git.

2. Register the preset

kindgi providers register --preset=anthropic

{
  "providerId": "anthropic"
}
✓ Registered anthropic: claude-opus-5-5, claude-sonnet-5-5, claude-haiku-4-5 — key ANTHROPIC_API_KEY (env local)

• --models=claude-haiku-4-5 registers only the models you list (comma-separated).
• --secret=<NAME> reads the key from another variable than ANTHROPIC_API_KEY.

The preset checks that the key is there first:

Error: ANTHROPIC_API_KEY (the anthropic key) is not in .env, .env.local. Set it first, then register again:
  pnpm exec kindgi secrets set ANTHROPIC_API_KEY --env=local --scope=tenant   # a no-echo prompt
or add ANTHROPIC_API_KEY=… to .env yourself.

3. Run an agent

The provider answers from the next turn on; nothing restarts.

kindgi runs start --agent=acme.order-desk --input='{"userMessage":"Where is my order A-1001?"}'

{
  …
  "status": "completed",
  …
  "output": {
    …
    "usage": { "steps": 2, "durationMs": 2291, "promptTokens": 1449, "totalCostUsd": 0.001889, "completionTokens": 88 },
    …
    "provider": { "id": "anthropic", "model": "claude-haiku-4-5" },
    "response": { "role": "agent", "content": "Your order A-1001 has been shipped and is expected to arrive on October 6, 2026.", … },
    …
  }
}

totalCostUsd is the turn's cost at the preset's prices.

Which Claude model answers

Model	Features	Context window	Per 1K input / output tokens
claude-opus-5-5	tool-use, parallel-tool-use, structured-output, long-context	1,000,000	$0.004 / $0.02
claude-sonnet-5-5	tool-use, parallel-tool-use, structured-output, long-context	1,000,000	$0.002 / $0.01
claude-haiku-4-5	tool-use, parallel-tool-use	200,000	$0.001 / $0.005

Among the models that meet an agent's needs, Kindgi takes the agent's preferred one, else the first alphabetically. So an agent that needs only tool-use gets Haiku, and one that needs structured-output gets Opus. To choose, set preferredModel or require the model: see Choose the model an agent uses. To offer only some models, register only those (--models).

If it doesn't answer

A wrong key fails the turn with Anthropic's own message:

Error [server]: Model call to anthropic (claude-haiku-4-5) failed: 401 {"type":"error","error":{"type":"authentication_error","message":"API key is invalid."},"request_id":null}

To change the key, set it again with --write-mode=add-version; the next turn uses the new one.

If dev-echo still answers (the turn has a fallback-provider warning), the agent needs something none of the registered models has: see dev-echo, the fallback.