Claude¶

Claude Agent SDK¶

Install the optional SDK:

uv add "kedi[claude]"

In a source checkout use uv sync --extra claude.

Authentication¶

The Claude Agent SDK owns authentication. Configure the SDK-supported credentials before running Kedi; ANTHROPIC_API_KEY is the common non-interactive path. Authentication and other non-retryable 4xx SDK events fail immediately with actionable context; transient retry events may continue.

Model and Effort¶

> agent: claude
> model: claude-sonnet-4-5
> effort: high

Effort is normalized through the shared Kedi effort mapping.

System Presets¶

Claude Code's system prompt preset remains active. > system: is appended to that preset rather than replacing it, preserving coding/file-tool behavior.

Working Directory¶

> settings:
    cwd: `str(project_root)`

Other supported settings are allowed_tools, disallowed_tools, env, fallback_model, max_budget_usd, max_turns, permission_mode, and tools.

Permission Mode¶

Non-interactive runs default to permission_mode: acceptEdits. Override it explicitly when a narrower Claude SDK mode is required. Kedi still installs its approval hook; SDK permission mode and Kedi approval are separate layers.

Built-In File Tools¶

Claude Code tools are enabled through the SDK preset by default. Kedi-projected tools are exposed through an in-process SDK MCP server and added to allowed_tools. External stdio/SSE/HTTP MCP servers are also mapped.

Native Read, Glob, Grep, WebFetch, and WebSearch are classified read-only. Other native/MCP operations require policy.

CodeMode¶

> codemode: enabled exposes the three shared CodeMode controls through Kedi's in-process Claude SDK MCP server. Kedi procedures and declared stdio/SSE/HTTP MCP tools are materialized into the run-scoped catalog and are callable only from execute_code. Claude's built-in filesystem, search, web, and shell tools remain native control-plane tools.

The SDK approval hook skips the three controls; the nested application call is the single approval owner. Kedi closes the local MCP clients and Monty session on completion, error, or cancellation.

Subagent Lifecycle¶

Claude supports foreground/background children and native resume using the SDK session ID. Child options preserve model, tools, system, MCP, approval ceiling, and usage constraints.

Capability Limits¶

The SDK must be installed for this adapter. Exact built-in tool availability and model names follow the installed Claude Agent SDK. Kedi validates its own setting keys but does not emulate missing SDK capabilities.