clade-upgrade-migration

name	clade-upgrade-migration
description	Upgrade Anthropic SDK versions and migrate between Claude model generations. Use when working with upgrade-migration patterns. Trigger with "upgrade anthropic sdk", "migrate claude model", "anthropic breaking changes", "new claude model".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version	1.0.0
license	MIT
author	Jeremy Longshore <[e-mail]>
compatible-with	claude-code
tags	["saas","anthropic","claude","migration","upgrade"]

Anthropic Upgrade & Migration

Overview

Upgrade the Anthropic SDK to new versions and migrate between Claude model generations. Covers version checking, changelog review, model ID updates across the codebase, output comparison testing, and gradual rollout via environment variables.

SDK Upgrade

# Check current version
npm list @claude-ai/sdk
pip show anthropic

# Upgrade to latest
npm install @claude-ai/sdk@latest
pip install --upgrade anthropic

# Check changelog for breaking changes
# https://github.com/anthropics/claude-sdk-typescript/releases

Model Migration Checklist

When Anthropic releases new model versions:

1. Read the model card — check for behavior changes, new capabilities
2. Update model IDs — find and replace old IDs

# Find all model references in your codebase
grep -r "claude-" --include="*.ts" --include="*.py" --include="*.json" .

3. Test with new model — run integration tests against both old and new
4. Compare outputs — spot-check key prompts for quality regression
5. Update max_tokens — new models may have different limits
6. Gradual rollout — use env var to control model selection

// Environment-based model selection for safe rollout
const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-20250514';

const message = await client.messages.create({
  model: MODEL,
  max_tokens: 1024,
  messages,
});

Common Migration Issues