ShipAI.today engineering guide
What is Claude Code? Anthropic's terminal AI agent explained.
Claude Code is an AI coding agent by Anthropic that lives in your terminal, not a GUI editor. It reads your codebase, writes files, runs commands, and can complete entire features autonomously. Unlike Cursor or Copilot, Claude Code works without constant direction — you describe the task, it executes. Here's what it is, how it works, and whether it's worth it.
Definition
What Claude Code actually is
Claude Code is an AI coding agent built by Anthropic. Unlike Cursor or GitHub Copilot — which work inside a GUI code editor — Claude Code runs as a command-line interface (CLI) tool directly in your terminal.
The key difference from other AI coding tools: Claude Code works autonomously. You describe a task end-to-end — “add Stripe subscription webhooks to this project, handle all the relevant events, write tests” — and Claude Code reads your codebase, writes the files, runs commands, and reports back when done. You don't direct every step.
It was built specifically for vibe coding — the AI-first development approach where you describe intent and AI handles implementation. Claude Code takes this further than any other tool by giving the AI full agentic control over your development environment.
What “agentic” means in practice
An agentic AI tool can take sequences of actions to complete a task: read file A, understand the pattern, write file B, run a test command, check the output, fix the error, commit — all without you directing each step. Claude Code does this. Most AI coding tools don't.
Capabilities
What Claude Code can do
These are the actual actions Claude Code can take — not theoretical capabilities, what it actually uses in practice.
Read and understand your codebase
Claude Code reads any file you give it access to. In a real project, it builds context from your auth setup, DB schema, API structure, and existing patterns before writing a single line.
Write and edit files
Claude Code creates new files and edits existing ones. It follows your patterns: if your project uses specific imports, naming conventions, or error handling, it adapts, not overrides.
Run shell commands
Claude Code can run commands: migrations, builds, tests, linters. It reads the output and responds — if a test fails, it fixes the code and re-runs without you intervening.
Autonomous multi-step task execution
This is the defining feature. You say 'build a usage limits feature across the whole stack' and Claude Code works through it: schema → migration → middleware → API → UI → tests. End to end.
Debug from error output
Paste an error or point Claude Code to failing tests. It traces the failure back through your code, identifies the root cause, and applies a fix — not a generic patch, a fix that understands your code.
Refactor with context
Move from one pattern to another across a whole codebase. Claude Code handles the global state — updating imports, adapting callers, and keeping tests passing across the refactor.
Comparison
Claude Code vs Cursor AI
Both are powerful. They serve different workflows. Here's when to use each.
| Claude Code | Cursor AI | |
|---|---|---|
| Interface | Terminal (CLI) | GUI editor (VS Code fork) |
| Interaction model | Autonomous agent | Interactive assistant |
| Best for | Long autonomous tasks | Continuous interactive coding |
| Codebase context | Full files you share | @codebase index (always on) |
| Pricing model | Pay-per-token (API) | Flat monthly subscription |
| File editing | Reads and writes autonomously | Composer with review diffs |
| Visual feedback | Terminal output only | Side-by-side diffs, inline |
| Runs commands | Yes (autonomous) | Generates but doesn't auto-run |
Practical recommendation
Most serious vibe coders use both. Cursor for day-to-day interactive work — quick edits, feature ideation, inline help. Claude Code for large autonomous tasks — full feature builds, complex refactors, or long tasks where you want to describe the goal and walk away. See the full 3-way comparison.
Pricing
Is Claude Code free?
The short answer: no permanent free tier. Here's how the billing actually works.
Claude Code is billed through Anthropic's API — you pay per token (input + output). There's no free tier. The Claude Pro subscription ($20/month) and Max ($100/month) include a monthly usage allowance you can use with Claude Code instead of pure API billing.
API (pay as you go)
Usage-based
Claude 3.5 Sonnet: $3/M in · $15/M out
Low-volume or burst use
Claude Pro
$20/mo
5× more usage than Sonnet free tier
Regular daily use
Claude Max
$100/mo
20× more usage · all models
Heavy autonomous builds
For the full model-by-model cost breakdown, token usage examples, and which plan to choose, see the complete Claude Code pricing guide.
Quick start
How to use Claude Code: the essential setup
Get Claude Code running and producing useful output in under 10 minutes.
Install Claude Code
npm install -g @anthropic-ai/claude-code
Requires Node.js 18+. One-time global install.
Set your API key
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Get your API key from console.anthropic.com. Add to your shell profile (~/.zshrc) for persistence.
Create a CLAUDE.md context file
Create CLAUDE.md at project root: describe your stack (Next.js 15, TypeScript, Drizzle ORM), your patterns, and any key conventions. This is what makes Claude Code produce project-specific code, not generic output.
This is the single biggest quality improvement you can make. Claude Code reads CLAUDE.md on every session.
Run Claude Code in your project
cd your-project && claude
Starts the interactive Claude Code session in your terminal. Describe the task. Claude Code reads your files and begins working.
For the complete setup guide with real prompt examples, see the Claude Code pricing + setup guide.
Best use cases
When to use Claude Code (and when not to)
Claude Code excels at
- Full feature builds: 'implement X end to end including tests'
- Large codebase refactors across many files
- Debugging from failing tests or complex error traces
- Generating entire modules from a spec or design doc
- Running + iterating on test suites autonomously
- Long tasks where you want to describe and step away
Less suited for
- Quick interactive exploratory coding (use Cursor)
- Real-time visual UI work requiring immediate feedback
- Small isolated edits where API cost exceeds value
- Tasks where you want step-by-step control throughout
- Projects with no CLAUDE.md / poor codebase context
FAQ
Claude Code questions answered
What is Claude Code?
Claude Code is an AI coding agent by Anthropic that runs in your terminal. It can read your codebase, write and edit files, run shell commands, and autonomously complete coding tasks end-to-end. It's fundamentally different from Cursor or Copilot — it's an agent, not an editor assistant.
How is Claude Code different from the Claude chatbot?
Claude.ai is a chat interface for asking questions and getting help. Claude Code has tool access — it can actually read files on your computer, create and edit files, and run commands. Claude Code acts on your codebase; Claude chat cannot.
Is Claude Code free?
No permanent free tier. Claude Code uses your Anthropic API key and charges per token. The Claude Pro subscription ($20/month) includes a usage budget you can apply to Claude Code sessions. Claude Max ($100/month) provides much larger usage budgets for heavy automated work.
How do I install Claude Code?
Run 'npm install -g @anthropic-ai/claude-code' to install globally. Set your ANTHROPIC_API_KEY environment variable. Navigate to your project and run 'claude'. Full setup takes under 5 minutes. See the getting started guide at /vibe-coding/claude-code-pricing for complete instructions.
Which is better: Claude Code or Cursor?
Different tools for different jobs. Cursor is best for interactive day-to-day coding with visual feedback. Claude Code is best for autonomous long-form tasks where you describe a full goal and let it work. Many serious developers use both — Cursor for interactive work, Claude Code for large autonomous tasks.
Does Claude Code work with any language or framework?
Yes — Claude Code can work with any codebase. Output quality is highest for TypeScript/JavaScript, Python, and Go, which have the most coverage in Claude's training. The clearer your CLAUDE.md context file, the better Claude Code performs on any framework.
Building with Claude Code?
ShipAI.today is the boilerplate built for agentic AI workflows.
Claude Code performs best with a structured, well-documented codebase. ShipAI.today ships with a pre-written CLAUDE.md context file, consistent TypeScript patterns across auth/billing/AI, and inline architecture comments — so Claude Code can navigate, extend, and ship features from the first session, not after hours of context-building.
- Pre-written CLAUDE.md file with full stack, patterns, and conventions documented
- Consistent module structure means Claude Code generates code that integrates correctly
- 45 vibe coding playbooks with prompt templates for Claude Code workflows