Claude Agent SDK provider

What this provider is Cerevisor's Claude Agent SDK provider hands an entire agent run to Anthropic's official @anthropic-ai/claude-agent-sdk runtime in-process. This is the same agent loop that powers Claude Code. Unlike the native Anthropic provider (where Cerevisor owns the chat loop and you control every tool call), Claude Agent SDK is a delegated-loop provider : Cerevisor sets sandbox + approval policy up-front, then the SDK runs the loop on its own. You get Claude Code-style agent behavior (read, write, edit, bash, glob, grep tools out of the box) without leaving Cerevisor. Best fit for users who want Claude Code's agent UX inside a Cerevisor workflow. Setup You need an Anthropic API key from console.anthropic.com . Settings → Providers → + Add provider → Claude Code (Claude Agent SDK). Paste your API key into the API key field. Click Test connection. Cerevisor verifies the SDK is installed and the key shape is valid. Click Save. The key is stored in a dedicated OS keychain slot , distinct from the native Anthropic provider's slot. You can have both providers configured side by side with the same key without conflict. The SDK key is injected at runtime via the SDK's env option, not process.env . This prevents the key from leaking to any child process Cerevisor spawns. Models The default is claude-sonnet-4-6 (cost-effective production default for SDK runs). You can override it in the Library entry's default model field, or per-agent via Agent Config → Provider override . The model picker shows only one entry because the SDK chooses model details at query time based on the value you pass. To target a specific model, type its id ( claude-opus-4-7 , claude-sonnet-4-6 , claude-haiku-4-5-20251001 , etc.) in the default model field or the agent's override. Cost Cerevisor records usage from the SDK's result message when present. The orchestrator's cost-projector returns 0 for Claude Agent SDK runs because the SDK chooses turn counts dynamically; you cannot pre-estimate cost the way you can for native Anthropic. Costs appear in the audit log after the run completes, billed through your Anthropic account. v1.2.0 limitations The Claude Agent SDK provider intentionally trades some Cerevisor features for the SDK's full agent harness. In v1.2.0: No mid-run conversation continuation. Contract-retry and verifier-retry don't fire for SDK runs. No subagent spawning. Agent depth must be 0 (the SDK has its own subagent model, separate from Cerevisor's). No skill injection. The SDK's harness owns its own skill discovery (it reads .claude/skills/ directly). Cerevisor-assigned skills are not passed in. No per-tool PermissionModal. Permission policy is set up-front via the SDK's permissionMode . Cerevisor's PermissionModal cannot interpose mid-run. These limitations mirror the Codex CLI and Cursor Agent providers; all three are delegated-loop providers and share the same constraint shape. Permission policy mapping Cerevisor's WorkflowPermissions policy maps onto th

Back to docs