ONLINE
ANALYSIS

How to Upgrade to Claude Opus 4.6 Using Your Max Subscription (No API Required)

How to Upgrade to Claude Opus 4.6 Using Your Max Subscription

Published February 6, 2026

Claude Opus 4.6 just dropped and you want to run it. If you have a Claude Max subscription ($100/month or $200/month), you already have access - no API key required.

But the upgrade process has some gotchas that cost me 6 hours of debugging. This tutorial will get you there in 5 minutes.

Prerequisites

  • Claude Max subscription (either tier works)
  • Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
  • Node.js 18+ installed
  • A terminal you’re comfortable with

The 5-Minute Upgrade

Step 1: Update Claude Code CLI

sudo npm update -g @anthropic-ai/claude-code

That’s the main step. The CLI’s opus alias automatically points to the latest Opus model. When you update the CLI, it picks up Opus 4.6 without any config changes.

Verify the update:

claude --version

Step 2: Verify Your Auth

Make sure you’re logged in with your Max subscription OAuth:

claude auth status

You should see your account with Max subscription tier listed. If not:

claude auth login

Follow the browser OAuth flow. This uses your existing Max subscription - no API key involved.

Step 3: Test It

claude "What model are you? Give me your exact model ID."

You should see claude-opus-4-6 (or similar) in the response.

Done. You’re running Opus 4.6.

For Multi-Agent Setups (Claude Code as Backend)

If you’re running AI agents that use Claude Code as their model backend (routing through the CLI instead of direct API), the key detail is your model identifier.

The Right Way

model: "claude-cli/opus"

The claude-cli/ prefix tells your system to route through Claude Code CLI. The opus alias always points to the latest Opus model. Update the CLI, and your agents automatically use 4.6.

The Wrong Way (Don’t Do This)

# These will NOT work with Max subscription OAuth:
model: "anthropic/claude-opus-4-6"      # Direct API - needs API key
model: "claude-opus-4-6"                # Missing provider prefix
model: "openrouter/anthropic/..."       # Different auth entirely

Max subscription OAuth tokens have restricted scope - they only work through the Claude Code CLI. You cannot make direct Anthropic API calls with them. This is the single biggest gotcha.

Common Mistakes (I Made All of These)

Mistake 1: Changing the Model ID Manually

What I did: Changed my config from claude-opus-4-5 to claude-opus-4-6

What happened: 404 errors everywhere. The model ID format was wrong for CLI routing.

The fix: Use the alias opus through claude-cli/opus. Don’t hardcode model version numbers.

Mistake 2: Running claude setup-token

What I did: Tried to generate a token for direct API access

What happened: It generated a token that didn’t work for API calls AND broke my existing OAuth login. Double whammy.

The fix: Never run claude setup-token if you’re using Max subscription OAuth. If you already did, re-run claude auth login to restore OAuth.

Mistake 3: Trying Direct API Calls

What I did: Tried to call the Anthropic API directly using my OAuth credentials

What happened: Rejected. Max OAuth tokens are scoped exclusively to Claude Code CLI.

The fix: Accept that Max subscription = CLI-only access. Route everything through Claude Code.

Troubleshooting

”404 Not Found” errors

  • Update CLI: sudo npm update -g @anthropic-ai/claude-code
  • Use claude-cli/opus not anthropic/claude-opus-4-6
  • Verify auth: claude auth status

”Unauthorized” or auth errors

  • Re-login: claude auth login
  • Don’t use claude setup-token - it breaks OAuth
  • Make sure your Max subscription is active

Agents still using old model

  • Update CLI first (the alias auto-updates)
  • Restart your agent processes after CLI update
  • Check that your agent config uses claude-cli/opus not a hardcoded model ID

Fallback model burning credits

  • Your system might be falling back to OpenRouter or another provider when Claude fails
  • Fix the primary model routing first, then restart agents
  • Check your fallback provider dashboard for unexpected charges

Why This Works

Claude Max is a consumer subscription that gives you access to Anthropic’s models through their products (claude.ai, Claude Code). It’s not an API key.

The OAuth flow authenticates you as a Max subscriber. The Claude Code CLI is an approved product that can use that authentication. Direct API calls are not.

Think of it like Netflix - your subscription lets you watch through the app, but doesn’t give you direct access to their CDN endpoints.

When you use claude-cli/opus as your model provider, your requests go:

Your Agent -> Claude Code CLI -> Anthropic (authenticated via Max OAuth) -> Response

The CLI handles auth. You handle the model alias. Anthropic handles the routing to the latest Opus version.

Cost

If you’re on Claude Max, this upgrade costs you nothing extra. You’re already paying the flat subscription rate. Opus 4.6 is included.

For API users (not Max subscribers), Opus 4.6 pricing is:

  • Standard: $5 input / $25 output per million tokens
  • Premium (200k+ context): $10 input / $37.50 output per million tokens

The Max subscription is the better deal if you’re a heavy user. $100-200/month flat vs potentially hundreds in API costs.

What You Get

After upgrading, your Claude setup now has:

  • 1M token context window (beta) - massive document analysis
  • Agent teams - multiple AI agents coordinating in parallel
  • Context compaction - no more hitting context limits on long tasks
  • Adaptive thinking - model automatically scales reasoning effort
  • 128k output tokens - longer responses without workarounds

For a detailed breakdown of what’s new and our first impressions, read our Opus 4.6 analysis. Full in-depth review coming soon.

Testing AI tools so you don’t have to. This tutorial is based on 6 hours of real debugging so you can do it in 5 minutes.