For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Configure kagent to use Anthropic Claude models by creating a ModelConfig for the Anthropic provider.

The Anthropic provider calls the Anthropic API directly.

Create the ModelConfig

1. Save your Anthropic API key as an environment variable.

   export ANTHROPIC_API_KEY=<your_api_key>

2. Create a Kubernetes Secret that stores the API key. Create it in the same namespace as the AgentTemplates that use it, such as kagent.

   kubectl create secret generic kagent-anthropic -n kagent --from-literal ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY

3. Create a ModelConfig that references the Secret.

   kubectl apply -f - <<EOF
   apiVersion: kagent.dev/v1alpha3
   kind: ModelConfig
   metadata:
     name: anthropic-model-config
     namespace: kagent
   spec:
     apiKeySecret: kagent-anthropic
     apiKeySecretKey: ANTHROPIC_API_KEY
     model: claude-sonnet-4-20250514
     provider: Anthropic
     anthropic: {}
   EOF

   Field	Description
   apiKeySecret	The name of the Kubernetes Secret that stores the API key, in the same namespace as this ModelConfig.
   apiKeySecretKey	The key within that Secret that holds the API key.
   model	The model to use. For the available models, see the Anthropic model docs.
   provider	The provider to use, Anthropic.
   anthropic	Settings that only the Anthropic provider takes. An empty block is valid.

Anthropic provider settings

The anthropic block takes the following optional settings. For every field, including its type, default, and validation rules, see the API reference.

Use the ModelConfig

Reference the ModelConfig by name from an AgentTemplate in the same namespace.

spec:
  modelConfig:
    name: anthropic-model-config

Next steps