Claude Agent SDK for Ruby

Quick start

• Use ClaudeAgentSDK.query for one-shot prompts (unidirectional streaming).
• Use ClaudeAgentSDK::Client for interactive sessions (multiple turns, interrupt, hooks, permission callbacks, custom tools, runtime control APIs).
• Install prerequisites: Ruby 3.2+, Node.js, and Claude Code CLI.

require 'claude_agent_sdk'

ClaudeAgentSDK.query(prompt: "What is 2 + 2?") do |message|
  puts message.inspect
end

Workflow

1. Choose an interface: