feat: Add CI workflow for Claude Code SDK integration testing

- Add GitHub Actions workflow that runs on PR open/synchronize
- Install Claude Code CLI via official install script
- Run quickstart example and dedicated e2e tests
- Test across Python 3.10-3.13
- Add basic integration tests and file operation tests

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ashwin-ant

.github/workflows/claude-code-integration.yml

@@ -0,0 +1,57 @@
+name: Claude Code Integration Test
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  integration-test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Claude Code
+        run: |
+          curl -fsSL https://claude.ai/install.sh | bash
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Verify Claude Code installation
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          claude -v
+
+      - name: Install Python dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .
+
+      - name: Run quickstart example
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          cd examples
+          python quick_start.py
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+
+      - name: Run basic integration tests
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          python e2e-tests/test_basic_integration.py
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+
+      - name: Run file operation tests
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          python e2e-tests/test_file_operations.py
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

e2e-tests/test_basic_integration.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""Basic integration test for Claude Code SDK."""
+
+import anyio
+
+from claude_code_sdk import AssistantMessage, TextBlock, query
+
+
+async def test_basic_query():
+    """Test basic query functionality."""
+    print("Testing basic query...")
+    found_response = False
+    
+    async for message in query(prompt="What is 2 + 2?"):
+        if isinstance(message, AssistantMessage):
+            for block in message.content:
+                if isinstance(block, TextBlock):
+                    print(f"Response: {block.text}")
+                    found_response = True
+    
+    if not found_response:
+        raise Exception("No response received from Claude")
+    
+    print("✅ Basic query test passed")
+
+
+async def test_with_system_prompt():
+    """Test query with custom system prompt."""
+    print("\nTesting with system prompt...")
+    found_response = False
+    
+    from claude_code_sdk import ClaudeCodeOptions
+    
+    options = ClaudeCodeOptions(
+        system_prompt="You are a helpful assistant that answers concisely.",
+        max_turns=1,
+    )
+    
+    async for message in query(
+        prompt="What is Python in one sentence?", options=options
+    ):
+        if isinstance(message, AssistantMessage):
+            for block in message.content:
+                if isinstance(block, TextBlock):
+                    print(f"Response: {block.text}")
+                    found_response = True
+    
+    if not found_response:
+        raise Exception("No response received from Claude")
+    
+    print("✅ System prompt test passed")
+
+
+async def main():
+    """Run all integration tests."""
+    print("=" * 50)
+    print("Running Claude Code SDK Integration Tests")
+    print("=" * 50)
+    
+    try:
+        await test_basic_query()
+        await test_with_system_prompt()
+        
+        print("\n" + "=" * 50)
+        print("✅ All integration tests passed!")
+        print("=" * 50)
+    except Exception as e:
+        print(f"\n❌ Integration test failed: {e}")
+        raise
+
+
+if __name__ == "__main__":
+    anyio.run(main())

e2e-tests/test_file_operations.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""Test file operations with Claude Code SDK."""
+
+import os
+import tempfile
+import anyio
+from pathlib import Path
+
+from claude_code_sdk import AssistantMessage, ClaudeCodeOptions, TextBlock, query
+
+
+async def test_file_creation():
+    """Test file creation through SDK."""
+    print("Testing file creation...")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_file = Path(tmpdir) / "test_output.txt"
+        
+        options = ClaudeCodeOptions(
+            allowed_tools=["Write"],
+            system_prompt="You are a helpful file assistant. Be concise.",
+            max_turns=1,
+        )
+        
+        prompt = f"Create a file at {test_file} with content 'Hello from Claude Code SDK!'"
+        
+        async for message in query(prompt=prompt, options=options):
+            if isinstance(message, AssistantMessage):
+                for block in message.content:
+                    if isinstance(block, TextBlock):
+                        print(f"Claude: {block.text[:100]}...")  # Print first 100 chars
+        
+        # Verify file was created
+        if not test_file.exists():
+            raise Exception(f"File {test_file} was not created")
+        
+        content = test_file.read_text()
+        if "Hello from Claude Code SDK!" not in content:
+            raise Exception(f"File content incorrect: {content}")
+        
+        print(f"✅ File created successfully with correct content")
+
+
+async def test_file_reading():
+    """Test file reading through SDK."""
+    print("\nTesting file reading...")
+    
+    with tempfile.TemporaryDirectory() as tmpdir:
+        test_file = Path(tmpdir) / "input.txt"
+        test_content = "This is a test file for Claude Code SDK e2e testing."
+        test_file.write_text(test_content)
+        
+        options = ClaudeCodeOptions(
+            allowed_tools=["Read"],
+            system_prompt="You are a helpful file assistant. Be concise.",
+            max_turns=1,
+        )
+        
+        prompt = f"Read the file at {test_file} and tell me the first word in the file"
+        
+        found_response = False
+        async for message in query(prompt=prompt, options=options):
+            if isinstance(message, AssistantMessage):
+                for block in message.content:
+                    if isinstance(block, TextBlock):
+                        print(f"Claude: {block.text[:100]}...")
+                        # Check if Claude identified "This" as the first word
+                        if "This" in block.text or "this" in block.text.lower():
+                            found_response = True
+        
+        if not found_response:
+            raise Exception("Claude did not identify the first word correctly")
+        
+        print("✅ File reading test passed")
+
+
+async def main():
+    """Run file operation tests."""
+    print("=" * 50)
+    print("Running File Operation Tests")
+    print("=" * 50)
+    
+    try:
+        await test_file_creation()
+        await test_file_reading()
+        
+        print("\n" + "=" * 50)
+        print("✅ All file operation tests passed!")
+        print("=" * 50)
+    except Exception as e:
+        print(f"\n❌ File operation test failed: {e}")
+        raise
+
+
+if __name__ == "__main__":
+    anyio.run(main())