Claude Code pricing has two paths: a flat-rate Claude subscription (Free, Pro at $20/mo, or Max at $100 and $200/mo, each bundling a Claude Code usage allowance) or the Anthropic API billed per token. The CLI is free to install; you pay only for the model usage. Confirm current figures on Anthropic's pricing page, since they change.
Here is the part most write-ups bury: the cheapest way to run Claude Code is rarely the obvious one. New users assume "free CLI" means free, then watch the metered bill climb, or they jump straight to the $200 plan to be safe and overpay by 90%. The real answer depends on one number you can measure in a week. This guide lays out exactly how Claude Code pricing works, what a heavy month actually costs, and the simple rule for picking the right plan. By the end you will know which of the two billing paths fits how you work, and how to cut the bill without cutting the value.
How Claude Code Pricing Actually Works (Two Paths)
Claude Code is a free, open-source command-line tool. Installing it costs nothing. What you pay for is the Claude model doing the thinking behind it, and Anthropic bills that in one of two ways. Path one is a Claude subscription, a flat monthly price (Free, Pro, or Max) that includes a Claude Code usage allowance. Path two is the Anthropic API, where you attach an API key and pay per token with no monthly fee. You pick one; you do not pay twice.
| Path | You pay | Best for |
|---|---|---|
| Claude subscription | Flat monthly: Free, Pro $20/mo, or Max $100 & $200/mo (includes a usage allowance) | Individuals who want a predictable bill |
| Anthropic API | Per token, no monthly fee, no usage cap | Teams, automation, and bursty or shared workloads |
The catch with both: the subscription has rate limits (it slows or pauses you once you burn through the allowance in a rolling window), and the API has no ceiling (it keeps charging as long as you keep running). Figures here are the stable structure, not gospel numbers, so treat the exact dollar amounts as a snapshot and check Anthropic's pricing page before you commit. If you are new to the tool, our guide on how to add skills to Claude Code covers the setup that comes after billing.
The Subscription Plans: Free, Pro, Max
A Claude subscription is one price for everything: the Claude apps, the web chat, and Claude Code, all sharing a usage allowance. There are three tiers. Free gets you a small taste, Pro is the default for working developers, and Max exists for people who run the agent for hours at a stretch.
| Plan | Price | Claude Code usage | Who it's for |
|---|---|---|---|
| Free | $0 | Small allowance; throttles quickly | Trying the tool, not real daily work |
| Pro | $20/mo | Solid allowance for a few hours a day | Most individual developers |
| Max 5x | $100/mo | ~5x the Pro allowance | All-day users on bigger codebases |
| Max 20x | $200/mo | ~20x the Pro allowance | Power users running long parallel sessions |
The numbers shift over time, and Anthropic tunes the per-plan limits as model costs change, so the exact "hours" you get are not fixed. The shape holds, though: Pro is the entry point for serious use, and each Max tier roughly multiplies your headroom before throttling. The honest move is to start on Pro and let your own usage tell you whether you need more. Want to feed the agent reusable workflows while you test your limits? Browse the skill registry and install one that matches your stack.
The API Path: Pay Per Token
The API path skips the subscription entirely. You generate an Anthropic API key, set it in your environment, and Claude Code bills you per token: a price for every chunk of text it reads (input) and a higher price for every chunk it writes (output). There is no monthly fee and no usage cap, which is the point and the danger. Different Claude models cost different amounts, so the model you run matters as much as how much you run it.
| Model tier | Relative cost | When to run it |
|---|---|---|
| Smallest (Haiku-class) | Cheapest per token | Quick edits, file lookups, simple refactors |
| Mid (Sonnet-class) | Mid-range; the everyday default | Most coding work, the balanced choice |
| Largest (Opus-class) | Most expensive per token | Hard architecture, gnarly debugging, planning |
Two features blunt the per-token sting. Prompt caching reuses the parts of your context that do not change (your codebase, your CLAUDE.md) at a steep discount instead of re-billing them every turn. And the Batches API runs non-urgent jobs at roughly half price. For exact per-million-token rates by model, the Anthropic API pricing page is the source of truth, because those numbers move with each model release.
Subscription vs API: Which Is Cheaper for You
For one person coding most days, the subscription almost always wins on price and on peace of mind. A flat $20 or $100 means you never get a surprise invoice, and Anthropic's allowance is generous enough that you would have to work hard to out-consume a Max plan. The API only beats it when your usage is either very light (you run the agent twice a month) or genuinely industrial (you are scripting it across a fleet).
The API earns its place in three cases: shared or automated workloads where per-token accounting is cleaner than buying a seat per human; CI pipelines and bots that run on their own schedule; and teams who want one consolidated bill with per-project cost attribution. If you are routing requests across providers or models, the setup in our Claude Code router guide pairs naturally with API billing. For a solo developer, though, paying per token usually means paying more for the privilege of watching a meter.
What a Real Month Costs
Concrete numbers beat hand-waving, so here is a real shape. Maya, a backend engineer at a 12-person startup, uses Claude Code about three hours a day across a mid-size Python and TypeScript repo. On the API path her first month came in around $140 in token charges, with most of the spend coming from one habit: leaving long debugging sessions running on the largest model. She switched to a $20 Pro subscription, dropped to the mid-tier model for routine work, and her cost fell to a flat $20, with throttling only twice near month-end.
Contrast that with a four-person team running Claude Code in CI to auto-triage failing tests. Their usage was spiky, mostly off-hours, and spread across no fixed human, so per-token API billing came to roughly $85 a month total, cleaner than buying four subscriptions at $80. The lesson is not "subscription good, API bad." It is that steady individual use rewards the flat rate, and bursty automated use rewards the meter. Measure your own pattern for a week before you decide.
How to Keep Claude Code Costs Down
Most overspending comes from running the biggest model on small tasks and feeding it more context than it needs. These habits cut the bill on either billing path without cutting much value:
- Right-size the model:use the mid or small tier for edits and lookups; save the largest model for genuine architecture and hard bugs.
- Run
/clearbetween tasks:a fresh context window is a cheaper context window. Carrying 50 messages of irrelevant history into a new task bills you for all of it. - Lean on prompt caching:keep your CLAUDE.md and project context stable so the cache discount applies instead of re-billing every turn.
- Be specific:a vague prompt makes the agent read more files and try more paths. A precise ask ("fix the null check in auth.ts line 40") spends fewer tokens.
- Batch non-urgent work:on the API, the Batches API runs background jobs at roughly half the standard rate.
If repeated tasks are eating your budget, package them once instead of re-prompting from scratch each time. A custom slash command or an installed skill turns a six-paragraph prompt into one short invocation, which is fewer tokens and less drift. Ready to trim the repetitive prompting? Find a skill that automates your most-repeated task and stop paying to re-explain it.
Do Skills, Plugins, and MCP Cost Extra?
No. Skills, plugins, custom commands, hooks, subagents, and MCP servers carry no extra charge from Anthropic. They are local configuration files Claude Code reads at startup, not paid add-ons. They touch cost only indirectly: a skill that makes the agent read ten files spends more tokens than one that targets a single function. So the feature is free, but the work it triggers still counts against your plan or your API meter.
This is also where the registry side matters. Skills on PolySkill are open-source and free to install, and each one is security-scanned before listing, so adding capability does not add a subscription. The only cost a skill or plugin can create is token usage, and a well-scoped one usually saves tokens by getting the agent to the answer faster. Treat the building blocks as free and focus your budget thinking on model usage, where it actually lives.
The Bottom Line on Cost
Here is the decision, compressed. Start on Pro at $20 a month; it covers most individual developers with room to spare. Move to Max when you start hitting limits often enough that the throttling wastes more time than the upgrade costs, which for all-day users tends to happen fast. Reach for the Anthropic API only when your usage is automated, shared across a team, or so light that a metered bill beats any flat rate. And whichever path you pick, right-size the model and clear context between tasks, because that single habit moves the bill more than your plan choice does. Then confirm today's exact numbers on Anthropic's pricing page before you put down a card, because the structure is stable but the figures are not.
Browse next: How to Add Skills to Claude Code (2026) | Claude Code vs Gemini CLI (2026) | Claude Code Router (2026) | Claude Code Memory (2026)
Claude Code Pricing Questions, Answered
How much does Claude Code cost?
Claude Code is free to install; you pay for the model behind it. Two paths: a Claude subscription (Free, Pro at $20/mo, or Max at $100 and $200/mo, each with a Claude Code usage allowance) or the Anthropic API billed per token with no monthly fee. Most individuals start on Pro for about $20/mo. Confirm exact figures on Anthropic's pricing page, since they change.
Is Claude Code free?
The CLI is free and open-source to install with npm install -g @anthropic-ai/claude-code. Running it past the small Free-plan allowance is not free: you need a paid Claude subscription (Pro or Max) or an Anthropic API key with a payment method. For steady daily use, a Pro subscription is the cheapest practical option.
Claude Code Pro vs Max: which should I get?
Pick Pro ($20/mo) if you use Claude Code a few hours a day and rarely hit limits. Pick Max ($100 or $200/mo) if you run the agent all day, work in large codebases, or keep getting throttled on Pro. Start on Pro, track how often you hit limits, and upgrade only when throttling costs more time than the price gap.
Does Claude Code charge per token?
Only on the API path. A Pro or Max subscription is a flat monthly price with a usage allowance, so you are not metered per token. The Anthropic API bills per input and output token with no monthly fee, so cost scales with how much you run it. Individuals usually prefer the subscription's flat rate.
Do Claude Code skills or plugins cost extra?
No. Skills, plugins, commands, hooks, and MCP servers add no extra Anthropic charge. They are local config files that only affect cost indirectly by changing how many tokens a task uses. Registries like PolySkill list skills for free, so the building blocks are free even though the model usage they trigger still counts against your plan.