Fix: Claude Isn't Working Right Now (2026)
You open Claude and get an error, a blank screen, or a message that says “This isn’t working right now.” This guide covers every known cause and fix, organized from most common to least common.
Start with the Quick Diagnostic Checklist, then drill into the specific section that matches your situation.
Quick Diagnostic Checklist
Run through these five checks in order. Most issues resolve within the first three.
- Check Anthropic status: Visit status.anthropic.com. If there is an active incident, wait for resolution.
- Check your internet: Open any website. If other sites load, your connection is fine.
- Check your plan: Log in to claude.ai/settings. Verify your subscription is active and not expired.
- Hard refresh: Press Ctrl+Shift+R (Cmd+Shift+R on Mac) in your browser. This clears cached data.
- Try a different browser or incognito: If Claude works in incognito, a browser extension is causing the issue.
If none of these fix it, continue to the specific sections below.
Scenario 1: Anthropic Service Outage
Symptoms: Everyone sees errors. Claude.ai shows error pages. API returns 500/503 errors. Claude Code fails with connection errors.
Check: Visit status.anthropic.com
What to do:
- Wait. Anthropic usually resolves outages within 30 minutes to 2 hours.
- Subscribe to status updates on the status page for email/SMS notifications.
- If using Claude Code with an API key, there is no workaround (the backend is down).
- If urgent, consider using OpenRouter with a fallback model from another provider.
How to confirm it is an outage vs your issue: Check Twitter/X for “Claude down” or the Anthropic Discord. If multiple people report issues, it is an outage.
Scenario 2: Rate Limited (429 Error)
Symptoms: “You’ve sent too many messages” or HTTP 429 error. Works for a while, then stops. Usually happens during heavy usage periods.
On Claude.ai (Web)
Cause: You hit the usage limit for your plan tier.
Fixes:
- Wait for the limit to reset (rolling 5-hour window for most plans)
- Switch to a less powerful model (Haiku uses less quota than Opus)
- Upgrade from Pro ($20/month) to Max ($100 or $200/month) for higher limits
- Reduce message length to consume fewer tokens per message
On Claude Code (CLI)
Cause: API rate limit exceeded.
Fixes:
- Check remaining rate limit from the error message headers
- Wait for the reset window (usually 1 minute for request limits)
- Switch to Haiku for less demanding tasks:
/model haiku - Use the
/compactcommand to reduce context size (smaller contexts use fewer tokens per request) - See rate limit handling strategies
On the API
Cause: Exceeded requests per minute (RPM) or tokens per minute (TPM) for your tier.
Fix: Implement exponential backoff:
import time
import anthropic
client = anthropic.Anthropic()
for attempt in range(5):
try:
response = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello"}]
)
break
except anthropic.RateLimitError as e:
wait_time = 2 ** attempt
print(f"Rate limited. Waiting {wait_time}s...")
time.sleep(wait_time)
Scenario 3: Account or Subscription Issues
Symptoms: “Unable to access” or “subscription required” messages. Previously worked, now shows errors.
Expired Subscription
Check: Go to claude.ai/settings (or console.anthropic.com for API).
Fixes:
- Renew your subscription payment method
- Check for failed payment notifications in your email
- Update your credit card if it expired
- Contact [email protected] if your subscription shows active but access is blocked
API Credits Exhausted
Check: Visit console.anthropic.com, look at your credit balance.
Fixes:
- Add more credits to your account
- Set up auto-recharge to prevent interruptions
- Review your spending to understand what consumed credits
- Set up cost alerts to catch this earlier
Account Suspended
Symptoms: Login works but all interactions return errors about account status.
Cause: Terms of service violation, unusual activity detection, or billing issues.
Fix: Contact [email protected]. Include your account email and the exact error message.
Scenario 4: Browser-Specific Issues
Symptoms: Claude works in one browser but not another. Works in incognito but not regular mode.
Browser Extension Conflicts
Common conflicting extensions:
- Ad blockers (uBlock Origin, AdBlock Plus) blocking Anthropic API requests
- Privacy extensions (Privacy Badger, Ghostery) interfering with WebSocket connections
- VPN extensions routing traffic through unsupported regions
- JavaScript-modifying extensions breaking the Claude.ai frontend
Fix: Temporarily disable all extensions and try again. Re-enable them one by one to identify the culprit. Then add an exception for claude.ai in the blocking extension.
Cached Data Issues
Fix: Clear site data for claude.ai:
- Open browser developer tools (F12)
- Go to Application tab
- Under Storage, click “Clear site data”
- Reload the page
Cookie Issues
Claude.ai requires cookies for authentication.
Fix:
- Ensure cookies are enabled for claude.ai
- Remove all claude.ai cookies and log in again
- Check that your browser is not set to clear cookies on close (if so, add an exception for claude.ai)
JavaScript Disabled
Claude.ai requires JavaScript.
Fix: Enable JavaScript in your browser settings. If using NoScript or similar, whitelist claude.ai and anthropic.com domains.
Outdated Browser
Fix: Update to the latest version of Chrome, Firefox, Safari, or Edge. Claude.ai drops support for old browser versions.
Scenario 5: Claude Code CLI Issues
Symptoms: Claude Code crashes, hangs, or returns errors in the terminal.
“ANTHROPIC_API_KEY not set”
Error: ANTHROPIC_API_KEY environment variable is not set
Fix:
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
Add to your shell profile (~/.zshrc or ~/.bashrc) for persistence. See our beginner guide for detailed setup.
“Connection refused” or Network Errors
Fixes:
- Check your internet connection
- Check if a corporate firewall blocks api.anthropic.com
- If using a VPN, try disconnecting
- If using a proxy, ensure it forwards to Anthropic’s API correctly
# Test connectivity
curl -I https://api.anthropic.com
Claude Code Hangs (No Response)
Cause: Usually a large context or complex operation timing out.
Fixes:
- Press Ctrl+C to cancel the current operation
- Start a new session: exit and run
claudeagain - Use
/compactbefore large operations to reduce context - Check if extended thinking is consuming time (thinking tokens take longer)
“Module not found” or Installation Errors
Fix: Reinstall Claude Code:
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code
If permission errors persist:
sudo npm install -g @anthropic-ai/claude-code
Outdated Version
Fix: Update to the latest version:
npm update -g @anthropic-ai/claude-code
claude --version
Many “not working” issues are fixed in newer releases.
Scenario 6: API Integration Issues
Symptoms: Your application that uses the Claude API stops working.
Invalid API Key
{"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}
Fixes:
- Verify the key in console.anthropic.com
- Generate a new key if the old one was revoked
- Check for whitespace or invisible characters in the key
- Ensure the key is sent in the
x-api-keyheader (notAuthorization: Bearer)
Model Not Found
{"type":"error","error":{"type":"not_found_error","message":"model: claude-xyz not found"}}
Fix: Use the exact model ID from Anthropic’s documentation:
claude-opus-4-0520(not “claude-opus-4” or “claude-4-opus”)claude-sonnet-4-20250514claude-3-5-haiku-20241022
Request Too Large
{"type":"error","error":{"type":"invalid_request_error","message":"prompt is too long"}}
Fix: Reduce your input tokens below the model’s context window (200K tokens). Options:
- Trim unnecessary context
- Summarize long documents before sending
- Use prompt caching to handle repeated static content efficiently
- Split the request into smaller chunks
Streaming Interrupted
Symptoms: Partial responses, cut-off text, or connection drops mid-stream.
Fixes:
- Implement reconnection logic in your application
- Check for network instability
- Increase timeout settings
- Reduce
max_tokensto get shorter, more reliable responses
Scenario 7: Regional Access Issues
Symptoms: Claude works from some locations but not others. VPN changes fix/break access.
Causes:
- Anthropic restricts access from certain countries
- Corporate networks blocking AI services
- ISP-level interference
Fixes:
- Check Anthropic’s supported regions list
- If using a VPN, connect to a US or EU server
- If on a corporate network, ask IT if api.anthropic.com is blocked
- Try from a personal network to isolate the issue
Need the complete toolkit? The Claude Code Playbook includes 200 production-ready templates.
Scenario 8: Specific Error Messages
“Overloaded” / “The model is currently overloaded”
Cause: High demand on Anthropic’s servers.
Fixes:
- Wait 1-5 minutes and retry
- Switch to a less popular model (Haiku is rarely overloaded)
- Try during off-peak hours (US morning/late night)
- For API users: implement retry with backoff
“This conversation is too long”
Cause: Context window exceeded.
Fixes:
- Start a new conversation
- In Claude Code, use
/compactto summarize and free context - Send shorter messages
- Remove unnecessary files from the conversation
“Something went wrong”
Cause: Generic server-side error. Could be anything.
Fixes:
- Retry the same message
- Simplify your prompt (remove complex formatting, reduce attachments)
- Try a different model
- If persistent, check status.anthropic.com
“Unable to complete your request”
Cause: Content policy trigger, malformed request, or server issue.
Fixes:
- Rephrase your request
- Remove any content that might trigger content filters
- If the request is legitimate, try breaking it into smaller parts
- Contact support if you believe it is incorrectly filtered
Prevention Strategies
Set Up Monitoring
Do not wait for Claude to break. Set up proactive monitoring:
- Status page alerts: Subscribe to status.anthropic.com updates
- Budget alerts: Configure spending notifications to catch credit exhaustion
- Health checks: If running API integrations, add a ping endpoint that verifies Claude API connectivity
Keep Software Updated
# Check for Claude Code updates weekly
npm outdated -g @anthropic-ai/claude-code
# Update
npm update -g @anthropic-ai/claude-code
Document Your Configuration
Keep a record of your working configuration:
- API key location
- Environment variables set
- Proxy/VPN settings
- Claude Code version
- CLAUDE.md configuration
When something breaks, you can compare against your known-working state.
Have a Fallback Plan
For production systems, plan for Claude downtime:
- Queue messages and retry when service returns
- Fall back to a local model for simple tasks
- Use OpenRouter for multi-provider routing
- Document manual procedures for critical tasks
Frequently Asked Questions
How long do Claude outages usually last?
Most outages resolve within 30 minutes to 2 hours. Major incidents are rare and Anthropic communicates updates through status.anthropic.com.
Does clearing my browser cache delete my conversations?
No. Conversations are stored server-side. Clearing cache only removes local session data. You will need to log in again.
Why does Claude work on my phone but not my computer?
Usually a browser extension, VPN, or network configuration issue on your computer. Try incognito mode or a different browser to confirm.
Can I get a refund for downtime?
Anthropic’s subscription terms do not typically include SLA-based refunds for consumer plans. Enterprise plans may have different terms. Contact support for significant outages affecting paid plans.
Why does Claude say “I can’t help with that” when I ask a normal question?
This is a content policy false positive. Rephrase your question with different wording. If the topic is clearly harmless, try providing more context about why you are asking.
Is there a way to check Claude’s status programmatically?
Yes. Monitor status.anthropic.com or build a simple health check that makes a test API call:
curl -s -o /dev/null -w "%{http_code}" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "content-type: application/json" \
-d '{"model":"claude-3-5-haiku-20241022","max_tokens":1,"messages":[{"role":"user","content":"hi"}]}' \
https://api.anthropic.com/v1/messages
A 200 response means the API is operational.
Why does Claude Code fail but Claude.ai works?
Claude Code uses the API, while Claude.ai uses a web interface with separate infrastructure. If the API is having issues but the web interface is not (or vice versa), they can fail independently. Also check that your API key is valid and has credits.
Should I use a VPN with Claude?
Only if you are in a region where Anthropic restricts access. VPNs can sometimes cause issues (slow connections, IP-based rate limiting). If Claude works without a VPN, you do not need one.