Claude Agent Sdk Java

[!IMPORTANT] **This repository is no longer maintained.**

Active development has moved to [markpollack/claude-agent-sdk-java](https://github.com/markpollack/claude-agent-sdk-java). Current documentation is available at [lab.pollack.ai](https://lab.pollack.ai/projects/claude-agent-sdk).

This repository remains available for historical Spring AI Community releases. Its Apache 2.0 license and historical contents are unchanged. Please submit new issues and pull requests to the active repository.

Claude Agent SDK for Java

Java SDK for interacting with [Claude Code CLI](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview). This is a pure Java implementation that mirrors the design of the official Python and TypeScript Claude Agent SDKs.

Features

Feature	Description
Simple One-Shot API	Query.text() for quick answers in one line
Blocking Client	ClaudeSyncClient for multi-turn conversations with Iterator
Reactive Client	ClaudeAsyncClient with Flux/Mono for Spring WebFlux
Hook System	Register callbacks for tool use events
MCP Integration	Support for Model Context Protocol servers
Permission Callbacks	Programmatic control over tool execution

Documentation

• Tutorial — Step-by-step guide covering all SDK features
• Tutorial Source Code — Runnable examples for each tutorial module

The tutorial covers:

• All three API styles (Query, ClaudeSyncClient, ClaudeAsyncClient)
• Multi-turn conversations and session management
• Hooks, permission callbacks, and MCP integration
• Real-world patterns and best practices

Each module is a standalone runnable example with integration tests.

Requirements

• Java 17+
• Claude Code CLI installed and authenticated
• Maven 3.8+

Installa