anth-upgrade-migration

# Anthropic Upgrade & Migration ## Overview Guide for upgrading the Anthropic SDK and migrating between API versions. The SDK follows semver — major versions may have breaking changes. ## Check Current Versions ```bash # Python pip show anthropic | grep Version # Version: 0.40.0 # TypeScript npm list @anthropic-ai/sdk # @anthropic-ai/sdk@0.35.0 # Check latest available pip index versions anthropic 2>/dev/null | head -1 npm view @anthropic-ai/sdk version ``` ## Upgrade Path ### Step 1: Create Upgrade Branch ```bash git checkout -b upgrade/anthropic-sdk ``` ### Step 2: Upgrade SDK ```bash # Python pip install --upgrade anthropic pip show anthropic | grep Version # TypeScript npm install @anthropic-ai/sdk@latest ``` ### Step 3: Review Breaking Changes Key breaking changes by version: **Python SDK 0.20+ (anthropic-version: 2023-06-01)** ```python # OLD: Text Completions API (deprecated) response = client.completions.create( model="claude-2", prompt="\n\nHuman: Hello\n\nAssistant:", max_tokens_to_sample=256 ) # NEW: Messages API response = client.messages.create( model="claude-sonnet-4-20250514", max_tokens=256, messages=[{"role": "user", "content": "Hello"}] ) ``` **Python SDK 0.30+ (streaming changes)** ```python # OLD: Manual SSE parsing response = client.messages.create(..., stream=True) for line in response.iter_lines(): ... # NEW: High-level streaming with client.messages.stream(...) as stream: for text in stream.text_stream:...