Claude 4 410 Error Fix: How to Fix "Gone" Errors in 5 Minutes

The Error You're Seeing

If your application suddenly started failing with a 410 Gone error, here's what the response looks like:

{
  "error": {
    "type": "gone",
    "message": "The model 'claude-4-opus-20250615' has been retired.
                Please migrate to claude-opus-4-8 or visit
                https://anthropic.com/models for alternatives."
  }
}

This isn't a bug. Anthropic retired Claude 4 Opus and Claude Sonnet 4 on June 15, 2026. The models are permanently offline. There is no fix other than migrating to a newer model.

The good news: the fix takes 5 minutes and costs 67-97% less.

The 5-Minute Fix

- model: "claude-4-opus-20250615"
+ model: "claude-opus-4-8"

// That's it. Same API key, same SDK, same everything.
// Claude Opus 4.8 is 67% cheaper with better performance.

- model: "claude-4-opus-20250615"
+ model: "deepseek-v4-pro"
- base_url: "https://api.anthropic.com/v1"
+ base_url: "https://api.deepseek.com/v1"

// Requires DeepSeek API key from platform.deepseek.com
// 97% cheaper. Similar quality to Claude 4 Opus.

Code Examples by Language

Python (OpenAI SDK compatible)

# Before (broken)
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-4-opus-20250615",  # ← RETIRED
    messages=[{"role": "user", "content": "Hello"}]
)

# After (working) — same SDK, just change the model name
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-opus-4-8",  # ← NEW
    messages=[{"role": "user", "content": "Hello"}]
)

Node.js / TypeScript

// Before (broken)
const response = await anthropic.messages.create({
  model: "claude-sonnet-4-20250514",  // ← RETIRED
  messages: [{ role: "user", content: "Hello" }]
});

// After (working)
const response = await anthropic.messages.create({
  model: "claude-sonnet-4-6",  // ← NEW
  messages: [{ role: "user", content: "Hello" }]
});

cURL

# Before (broken)
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -d '{"model": "claude-4-opus-20250615", "messages": [{"role": "user", "content": "Hello"}]}'

# After (working)
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -d '{"model": "claude-opus-4-8", "messages": [{"role": "user", "content": "Hello"}]}'

Alternatives Comparison

If you want to stay with Anthropic, just change the model name. If you want to save money, here are your options ranked by cost:

💡 Pro tip: Use our Cost Calculator to find the cheapest model for YOUR specific token usage. Enter your monthly tokens and see exactly what you'd pay with each provider.

Why This Happened

Anthropic announced the retirement of Claude 4 models months in advance. The shutdown date was June 15, 2026. If you're seeing this error, it means your code was still calling the old model IDs after the deadline.

The newer models (Claude Opus 4.8, Claude Sonnet 4.6) are faster, cheaper, and better — there's no reason to stay on the old versions. The migration is purely a model ID change.

Prevent Future Breakage

To avoid this happening again:

• Subscribe to Anthropic's model announcements — they announce deprecations months in advance
• Use environment variables for model IDs — ANTHROPIC_MODEL=claude-opus-4-8 makes future changes trivial
• Set up cost alerts — APIpulse Pro notifies you when provider prices change
• Review your API dependencies quarterly — check for deprecated models and outdated SDK versions