claudify: Instructions file for Claude Code

CLAUDE.md - Claude Code Integration Guide

This file provides guidance to Claude Code and other LLMs when working with this SDK.

Project Overview

This is the Claude Code SDK Complete - a production-ready monorepo containing:

• SDK: Universal integration layer for using Claude Code as a headless LLM provider
• Demo: Full-featured chat application demonstrating all SDK capabilities
• Documentation: Comprehensive guides for developers and LLMs
• Examples: Ready-to-use integration examples

Key Principles

1. Subscription-Based Access: No API keys needed - users authenticate via Claude.ai subscription
2. Real Implementation: Everything is real - no mocks, actual Claude Code CLI integration
3. Production Ready: Complete error handling, retries, monitoring, and documentation
4. LLM Friendly: Documentation specifically designed for AI-assisted integration

Architecture Summary

Your App → Claude Code SDK → Claude Code CLI → Claude.ai Subscription

The SDK handles:

• Process management
• Response parsing
• Session continuity
• Streaming
• Error recovery

When Integrating This SDK

Essential Steps:

1. Ensure Claude Code CLI is installed and user is logged in
2. Initialize SDK: const sdk = new ClaudeCodeSDK()
3. Execute prompts: await sdk.executeWithClaudeCode(prompt, options)
4. Handle responses properly with error checking

Common Patterns:

Basic Usage:

const result = await sdk.executeWithClaudeCode("Your prompt")
if (result.success) {
  console.log(result.messages[0].content)
}

Streaming:

for await (const chunk of sdk.executeStreamingWithClaudeCode("Prompt")) {
  process.stdout.write(chunk)
}

WebSocket Integration:

socket.on('message', async (data) => {
  const result = await sdk.executeWithClaudeCode(data.prompt)
  socket.emit('response', result)
})

Important Implementation Notes

CORS Configuration

Always include all HTTP methods when setting up CORS:

cors({
  origin: ['http://localhost:3000'],
  methods: ['GET', 'POST', 'DELETE', 'PUT', 'PATCH', 'OPTIONS']
})