Claude Code
Hands-on articles for the Claude Code CLI — installation, CLAUDE.md design, subagents, hooks, CI integration, and fixes for common errors.
Diagnosing Claude Code Subagents That Stall or Never Return
Diagnostic flow for Claude Code subagents that freeze, return silently, or produce the wrong output shape — classified by symptom with runnable examples.
Claude Code's TodoList Quality Comes Down to Task Granularity — Patterns That Actually Worked
The TodoList tool in Claude Code can backfire when used carelessly. Three field-tested patterns — task granularity, verification steps, and update timing — that shift the output from 'looks organized' to 'actually delivered'.
The Claude Code Error Handbook — Auth, Billing, Stalls, Tools & MCP, Diagnosed by Symptom
A field-tested reference for 40+ Claude Code error patterns, organized by visible symptom: authentication, billing, response stalls, tool failures, MCP connectivity, and hook issues. Each entry tells you where to look and what to change.
Claude Code Environment Variables — The Complete Practical Reference
A practitioner-focused reference for every Claude Code environment variable that actually matters. Covers API connectivity, model selection, PowerShell tool quirks, logging, timeouts, security flags, and real-world templates for solo, team, and CI/CD setups.
Debugging Claude Code Hooks in Production — Where to Start When Logs Are Missing
Your Claude Code hooks work locally but go silent in production. Here is the three-layer observability pattern I use on real projects, plus a 60-second minimal reproduction recipe for isolating failures.
Fixed-Bid Pricing Engineering for Freelancers in the Claude Code Era
How to price fixed-bid engagements in the Claude Code era without bleeding profit — a three-layer cost model, risk buffers, and contract clauses that protect freelancers when generative AI compresses hours.
Claude Keeps Saying 'Response Incomplete' — A Layered Troubleshooting Guide
Diagnose why Claude or Claude Code freezes with a 'Response incomplete' or 'Try stopping' message. Walk through the four layers where generation can stall and recover the session without losing context.
Three Minutes with /doctor: Catching Claude Code Config Drift Before It Costs You an Hour
When Claude Code acts up, the first thing to run is /doctor. It shows merged settings, MCP server status, and permission mode at a glance.
Write the Repro Test Before Delegating Bug Fixes to Claude Code
After watching Claude Code spin its wheels on ambiguous bug reports, I started writing the failing test myself before delegating. This post walks through the design principles, a concrete repro test, and the three-stage workflow I run in production.
Finishing Long-Running Claude Code Tasks: A Resilience Playbook You Can Ship
Multi-hour Claude Code jobs — bulk refactors, TypeScript migrations, mass test generation — always stop before they finish, and recovery is painful when you cannot tell what already ran. This guide ships concrete patterns: a checkpoint-driven manifest, a three-state circuit breaker, idempotent retry rules, and a freeze-and-resume protocol you can copy into your repo today.
Turning Claude Skills and Claude Code Plugins Into Products That Actually Sell
How to design, price, distribute, and improve Claude Skills and Claude Code Plugins as real products — with concrete patterns for packaging, billing, churn control, and knowing when to shut it down.
Auto-Generating Conventional Commits with Claude Code — Letting it Infer Type and Scope from the Diff
Are your commit messages starting to look like a wall of update and fix? Here's a small, stable setup that lets Claude Code read your staged diff and turn it into proper Conventional Commits.
Stop Rewriting Code: Using Claude Code Plan Mode as a Real Design Phase
Claude Code's Plan Mode sounds unremarkable on paper, but treating it as a dedicated design phase dramatically reduces token spend and rework. Here's when to switch into it, the prompt template that produces useful plans, and the pitfalls I kept hitting.
Stabilizing Solo Revenue: A Customer Portfolio Playbook for Claude Code Consultants
After you have raised your rate, the next challenge is revenue volatility. A practical framework for solo Claude Code consultants to design a client portfolio that keeps monthly income predictable.
Taking Over an Unfamiliar Codebase in One Week with Claude Code — A Maintenance Handover Playbook
When you inherit a codebase from someone who has already left, how do you use Claude Code to reach a state where you can confidently make changes in just seven days? This is the exact protocol I've repeated many times across solo projects and client work, complete with the prompts I use.
Keeping Claude Code Accurate Through Long Sessions: Signals of Context Decay and What to Do About Them
After a few hours in the same Claude Code session, output quality can quietly slip. This is a practical field guide to spotting the early signals, choosing where to end a session, and keeping a long workflow reliable.
Build a Mobile App Revenue Dashboard with Claude Code — Integrating AdMob, App Store Connect, and Google Play Console APIs with Automated Daily Reports
How I unified AdMob, App Store Connect, and Google Play Console revenue into one dashboard with automated daily Slack reports — plus the three aggregation bugs I found by actually measuring the parser, and the corrected code.
Claude Code × Python Hybrid Development Patterns: A Production Guide to 50% Token Reduction
Seven production-tested patterns for hybrid Claude Code × Python workflows, each with working code and real-world token reduction data.
When Bash Misbehaves in Claude Code on Windows — A Practical Note on CLAUDE_CODE_USE_POWERSHELL_TOOL=1
On Windows, Claude Code's Bash-based shell tool sometimes fails in odd ways. Setting CLAUDE_CODE_USE_POWERSHELL_TOOL=1 routes commands through PowerShell and removes many of the symptoms. Here are the practical trade-offs I've seen after living with the switch.
The 12-Week Roadmap from Zero to a Monetized Claude Code Product
A week-by-week roadmap for indie developers starting from a single idea and reaching a product with paying users in 12 weeks, built around Claude Code. Includes the exact prompts I use and the mistakes I ran into along the way.
Resolving tRPC Type Errors in 15 Minutes with Claude Code — A Practical Workflow
When tRPC type errors cascade across files, how can Claude Code help you fix them fast? Router design, client integration, and the pitfalls I hit in real projects — distilled into a practical workflow.
Running Next.js on Cloudflare Workers in Production with Claude Code — Every Build Crisis, Cache Bug, and Automation Pattern We Solved
Running Next.js on Cloudflare Workers is not the same as Vercel. The 62 MiB bundle limit, ASSETS binding quirks, and edge cache personalization conflicts are real production hazards. Here's how Claude Code helped us solve each one.
Building a Stripe Subscription SaaS with Claude Code: Webhooks, Auth, and Production Pitfalls
Shipping a Stripe subscription SaaS with Claude Code on Cloudflare Workers: Webhook verification, KV + Cookie auth, and a cookie regex that failed silently.
Claude Code × Cursor × Devin Desktop (formerly Windsurf): A Practical Hybrid Development Setup
How to route work across Claude Code, Cursor, and Devin Desktop (formerly Windsurf) — and sync rules into the directory format, measured over five consecutive runs.
Building iOS 18 Widgets & App Intents with Claude Code: A Complete Implementation Guide
Accelerate WidgetKit and App Intents development with Claude Code. A hands-on guide covering interactive widgets, Live Activities, and Siri integration—with working code and real-world pitfalls.
Claude Code for Mobile App Development in 2026: A Practical SwiftUI & Kotlin Workflow
How to actually integrate Claude Code into iOS (SwiftUI) and Android (Kotlin) development. Real patterns from an indie developer maintaining multiple apps.
Three Months of Cutting Technical Debt in Half with Claude Code — A Practical Record
A three-month hands-on record of tackling accumulated technical debt using Claude Code. Covers visualization, prioritization, and automated refactoring — with real numbers showing what actually changed.
From Spec to Production: Spec-Driven Development with Claude Code
Driving tests, implementation, and docs from a YAML spec with Claude Code, plus measured bcrypt 72-byte results where a valid spec still yields broken code.
Building a Custom Autonomous Agent Loop with Claude Code SDK — Beyond the CLI
Understand the internals of the Claude Code SDK and build custom autonomous agent loops in Python and TypeScript. Covers tool permissions, error recovery, and streaming, plus the cost instrumentation and monthly model audits I rely on in real operation.
Claude Code Multi-Agent Parallel Execution — Task Tool and SubAgent Patterns That Hold Up in Practice
Measured results from parallelizing Claude Code with the Task tool and SubAgents. Covers what to split and what never to split, a JSON extractor that survives real SubAgent output, and the arithmetic showing three agents had already hit the floor.
Building StoreKit 2 × SwiftUI Purchases with Claude Code — The Minimum That Passes Review
Build a StoreKit 2 × SwiftUI purchase flow end to end with Claude Code as your design partner — PurchaseManager, server-side validation, and paywall UI — plus the operational traps Apple's docs skip, like Ask to Buy and late-arriving transactions.
Claude Code Stopped Mid-Task? A Practical Recovery Guide to Resume Work Safely
When Claude Code stops responding mid-task, the worst thing you can do is immediately retry. This guide walks you through a 5-step recovery process using git to confirm what was completed before resuming safely.
Claude Code Tool Permissions: Custom Allow/Deny Policies
Learn how to control Claude Code tool permissions with allowedTools, disallowedTools, and settings.json. Includes project-specific permission patterns for frontend, backend, and read-only review scenarios.
Claude Code Sub-agent Patterns — Designing Autonomous Task Decomposition and Parallel Execution
Dissect Claude Code's internal Sub-agent architecture and learn concrete design patterns for task decomposition, parallel execution, and result merging in your own projects.
CLAUDE.md Not Working? A Complete Troubleshooting Guide for Claude Code
Claude Code ignoring your CLAUDE.md settings? This guide covers the most common causes — wrong file location, formatting issues, conflicting configs, and more — with clear fixes for each.
Claude Code × Swift/iOS Production Guide — From Xcode Integration to App Store Launch
A practical guide to building production-quality iOS apps with Claude Code and Xcode. Covers CLAUDE.md design, SwiftUI implementation, Clean Architecture, automated testing, Fastlane CI/CD, and App Store submission.
Running Claude Code and GitHub Copilot Together — Different Philosophies, Practical Division of Labor
Claude Code and GitHub Copilot are built on different philosophies, and their strengths barely overlap. Here is how their limits compare across real implementation scenarios, and how to run both in one workflow.
Claude Code × Docker — DevContainers, Multi-Stage Builds, and Production Deployment
A practical guide to production-grade development workflows combining Claude Code and Docker. From DevContainer setup and multi-stage build optimization to GitHub Actions CI/CD and Kubernetes deployment — with practical code examples throughout.
Claude Code × SvelteKit Full-Stack Development Guide: From Zero to Production
A complete guide to full-stack development with Claude Code and SvelteKit. Covers Svelte 5 Runes, Drizzle ORM, Auth.js, and Cloudflare Workers deployment through practical, production-ready workflows.
iOS Test Automation with Claude Code — Where XCTest, Swift Testing, and XCUITest Each Belong
How I rebuilt an iOS test suite with Claude Code: where XCTest, Swift Testing, and XCUITest each belong, the pipefail trap that turns failed tests green in CI, and a hook that hands only test failures back to Claude.