Skip to content
Every command tested · Every cost measured

The Missing Manual
for Claude CLI

Stop guessing what Claude sends. Start controlling it.

Automation, CI/CD, cost control, and security — every command tested with real payloads.

For developers already using Claude Code who want to go deeper.

See what Claude actually sends Browse 60 Recipes
Terminal
$ claude -p "Summarize this file" --max-budget-usd 0.01 --output-format json
{
"result": "The module exports a retry wrapper...",
"total_cost_usd": 0.152,
"session_id": "sess_7f3a91...",
"usage": { "input_tokens": 4821, "output_tokens": 312 }
}
# Budget was $0.01. Actual cost: $0.152. That's 15x over.
19
Chapters
zero fluff
60
Recipes
all tested
10
Anti-Patterns
with real fixes
20
Experiments
real CLI outputs
The problem

You use Claude Code every day.
But do you know what it actually sends?

The interactive mode is intuitive. The programmatic CLI is a different beast — JSON envelopes, session management, tool restrictions, cost control, sandboxing. The official docs cover the basics. This site covers everything else.

Real Payloads

Every JSON envelope, every API response, every cost measurement comes from a real claude-opus-4-6 session.

Tested Commands

60 copy-paste recipes with the exact command, expected output, parsing code, and documented gotchas.

Every Cost Measured

Know the true minimum cost of a CLI call ($0.004), why budgets overshoot by 152x, and how to optimize spend.

Learning paths

Start from where you are

Four self-contained paths. Pick your level, skip what you know.

01

First Steps

beginner

I've never used Claude CLI
02

Everyday Use

intermediate

I want to build multi-step automations
03

Production & Security

advanced

I need this in CI/CD or a SaaS product
04

Advanced

intermediate+

I want to build on top of Claude
Interactive

See it in action

Real CLI behaviors you can explore, not just read about.

The Security Escape

You blocked Write and Edit. Claude wrote a file anyway. See why — and how to actually prevent it.

sandbox ✓ active
allowedTools ⚠ bypassed
disallowedTools ✗ NOT SET

The 152x Budget Overshoot

You set --max-budget-usd 0.001. Claude spent $0.152. It's by design — learn why.

Budget: $0.001 Actual: $0.152
152x

Stream Protocol

Watch NDJSON events arrive one by one — system init, assistant messages, tool calls, and results.

system session_id, tools[]
assistant content_block_delta
result total_cost_usd

Hook Builder

Generate hook configs visually — pick events, matchers, and handlers. Copy the JSON into your settings.

"hooks": {
  "PreToolUse": [{
    "matcher": "Bash",
    "hooks": [{ "type": "command" }]
  }] }
Recipes

Copy. Paste. Ship.

60 tested recipes with the exact command, JSON response, parsing code, and documented gotchas.

Browse All Recipes
9
Getting Started
8
Sessions
12
CI/CD
8
Security
7
MCP & Plugins
8
Agents
8
Cost
Free tools

Tools you won't find anywhere else

Zero signup. Built for developers who use Claude Code daily.

Linter

CLAUDE.md Linter

Paste your CLAUDE.md — get instant feedback on size, security, formatting, and 20 common mistakes.

Explainer

Command Explainer

Paste any claude command — get flag-by-flag explanations, conflict detection, and gotcha warnings.

Gallery

10 Anti-Patterns

The 10 most common CLI mistakes with real data and proven fixes. Are you making these?

Newsletter

New recipes every week

CLI updates, cost-saving patterns, and gotchas — before they hit your production pipeline.

Weekly
Free
Unsubscribe anytime
newsletter

Get CLI tips that ship code

One email per week. Recipes, gotchas, and cost tricks.
From the blog

Latest posts

View all posts
costgotcha

152x Over Budget: The Claude CLI Trap Nobody Warns You About

3 min read
securitygotcha

Your 'Read-Only' Claude Agent Can Write Files. Here's the Proof.

3 min read