Claude Code
Hands-on articles for the Claude Code CLI — installation, CLAUDE.md design, subagents, hooks, CI integration, and fixes for common errors.
Claude Code Stops Mid-Execution: Complete Diagnostic Guide
Diagnose why Claude Code freezes or stops mid-task. Covers context budget exhaustion, unresponsive subagents, infinite loops, and tool timeouts with actionable fixes for each scenario.
Stop the 'old_string is not unique' Error in Claude Code's Edit Tool — A Practical Rewrite Strategy
When Claude Code's Edit tool throws 'old_string is not unique in the file', the root cause is usually that the prompt didn't guarantee a uniquely identifiable target. Here's how to design rewrites that actually stick.
Recipes for a Useful Claude Code Status Line — Show Model, Remaining Context, and Git Branch in One Line
Concrete recipes for a Claude Code status line that displays the active model, remaining context, and git branch in a single line — written in both Bash and Node.js, with the failure modes you should plan for.
Designing a Release Gate Claude Code Can Run — Pre-Deploy Verification You Can Actually Read
A green CI does not mean a safe release. Walk through a seven-checkpoint release gate that asks Claude Code to write a readable, narrative report — with concrete scripts and the operational lessons behind them.
/clear vs /compact in Claude Code: Choosing the Right Reset for Long Sessions
When should you use /clear, and when should you reach for /compact in Claude Code? Three decision criteria from real long-session experience, with the pitfalls that hit me before I figured it out.
Claude Code × Storybook: A Production-Grade Component-Driven Development Playbook — From Auto-Generated Stories to Visual Regression and Design System Operations
A practical guide to combining Claude Code and Storybook for production-grade component-driven development. Covers auto-generating stories, visual regression strategy, interaction testing, CI integration, and running a design system at scale, with full code examples.
Testing Stripe Webhooks Safely with Claude Code: Three Practical Local Workflows
Reproduce Stripe webhook failures locally with confidence. Three practical patterns combining Claude Code with Stripe CLI, signed payload replay, and idempotency checks — with full working code.
Eliminating Flaky Tests Systematically with Claude Code
Move past the 'just hit retry' habit. This guide walks through a structured workflow for using Claude Code to classify, reproduce, and fix flaky tests at the root cause level — without papering over them with sleeps or skips.
Composing Claude Code Skills — Building Automation a Single Skill Can't Reach
A practical guide to going beyond one-skill-at-a-time and composing multiple Claude Code Skills into real workflows. Pipeline, branching, and meta-skill patterns with full implementation examples and the failure modes you should design against.
Designing Codebases Where AI Agents Hit the Ground Running
A practical blueprint for designing codebases where Claude Code and other AI agents can contribute productively from minute one. Covers CLAUDE.md, contract boundaries, guardrails, and test strategy.
Why Claude Code Skips .gitignore Files in Search — and How to Pull Them in When You Need Them
When .env.example or dist/ won't show up in Claude Code's Glob and Grep, .gitignore is the reason. Here's why it happens, plus three concrete ways through it: the Read tool, --no-ignore flags, and selective gitignore overrides.
Automating Frontend Accessibility Audits with Claude Code — axe-core, Hooks, and PR Comments That Actually Get Read
A practical way to make accessibility audits actually stick in a real codebase. Combine axe-core with Claude Code skills, pre-commit hooks, and a GitHub Actions PR comment, with code you can paste in today.
Observability for Claude Code with OpenTelemetry — A Production-Grade Tracing Guide for Agentic Workflows
Trace Claude Code agent runs end to end with OpenTelemetry. Hook integration, per-tool spans, MCP propagation, cost attribution, and sampling patterns that survive thousands of runs per day.
Claude Code Auto-Update Not Working? A Practical Diagnosis Flow When `claude --version` Won't Move
If you ran `npm install -g @anthropic-ai/claude-code` but `claude --version` still reports last week's number, this guide walks you through the three most common root causes — PATH conflicts, stale binaries, and shell-managed Node — with concrete fixes for each.
Two Personalities for Claude Code — A Morning and Afternoon Workflow That Separates Exploration from Implementation
Treating Claude Code as a different persona in the morning and afternoon stabilises design decisions. A solo developer's six-month run with two CLAUDE.md files, a switching script, and the failure modes I hit along the way.
Stopping Claude Code from Quitting Mid-Task — Prompt Patterns and Verification Loops
Claude Code says "Done!" — but the build is broken and only half the files were touched. Here are the prompt patterns and automated verification loops I now use in production to keep agents running until the job is actually finished.
From /init Output to a CLAUDE.md That Actually Steers Claude — A 4-Step Refinement
The CLAUDE.md that /init generates is a draft, not a finished file. Here's the 4-step process I run on every new project to turn that draft into a CLAUDE.md that meaningfully changes how Claude behaves.
Pasting Screenshots into Claude Code: A Practical Workflow for Fixing UI Bugs Fast
A field-tested workflow for handing screenshots and design comps to Claude Code from the terminal—covering the three input methods, prompt templates that actually work, and the gotchas that bit me in production.
Weekend MVP with Claude Code — From Zero to First Revenue in 48 Hours
Build a minimum viable product in a single weekend using Claude Code, integrate Stripe payments, and get your first paying customer — with actual prompts and commands shown step by step.
Automate Presentation Slides in 30 Minutes with Claude Code Skills
Learn how to combine Claude Code Skills with Markdown intermediate format to generate presentation slides from planning to Google Slides export in just 30 minutes.
Read Your Own Code as Someone Else's: Coaxing Tougher Reviews from Claude Code
When you review code you just wrote, the rough edges become invisible. Here's how I summon Claude Code as a mid-career engineer reading someone else's code, plus the prompts I actually use in production.
Turning Claude Code Into a Design Sparring Partner
How to use Claude Code as a sparring partner for design decisions rather than a code generator. The questioning craft I have refined while running four sites and several apps as a solo developer.
Claude Code Context Window Mastery — 7 Production Patterns to Stop Sessions From Stalling
Most slowdowns and silent quality drops in Claude Code on large repos come from context window management, not from model limits. This guide walks through seven patterns I rely on in production, with measurement scripts and runtime rules.
Claude Code Hooks: A Field Guide to the 8 Core Hooks — and the 33-Event Catalog They Now Live In
Claude Code hooks are powerful, but most people give up before figuring out which event does what. Here's the field guide I wish I had when I started — six months of running hooks in production, distilled.
When `claude --resume` Won't Restore Your Previous Session — A Practical Troubleshooting Guide
When Claude Code's --resume or --continue stops bringing back your last conversation, the cause almost always falls into one of four buckets. Here's how to walk through them in five to ten minutes.
Using Claude Code in a pnpm Monorepo — Combining --filter with dlx
Running Claude Code in a pnpm monorepo? It often touches files in packages you didn't ask about. Here's how to scope work properly with --filter, when dlx is dangerous, and what to put in .claude/settings.json so confirmation dialogs stop interrupting you.
Should You Flip CLAUDE_CODE_USE_POWERSHELL_TOOL=1? — A Practical Decision Guide for Windows Developers
When you run Claude Code on Windows, you eventually wonder whether CLAUDE_CODE_USE_POWERSHELL_TOOL=1 is worth flipping on. After running both modes across several projects, here is the decision rubric I now use.
Untangling Claude Code's 'Authorization Failed' Error — OAuth, MCP, and Dynamic Client Registration
Why Claude Code suddenly throws 'authorization failed' or 'incompatible auth server: does not support dynamic client registration', and what to actually do about it. A practical walkthrough of OAuth, MCP server requirements, and the real fixes that work in production.
Test-Driven Development with Claude Code — A TDD Workflow for the Agent Era
Adding the constraint of 'write tests first' to Claude Code stops the agent's drift and dramatically changes the quality of generated code. Here's the TDD workflow I arrived at after six months of trial and error.
Designing Pricing for Indie Projects with Claude Code — Shorten the Lead Time to Your First Revenue
When indie projects fail to earn, the gap is rarely technical — it's pricing design and lead time. Here's a practical mindset for using Claude Code to ship the smallest revenue-ready MVP and reach your first paying customer faster.
Letting Claude Code Handle Dependency Upgrades — A Verification Loop That Catches Breaking Changes
Once a solo project carries 30+ dependencies, the monthly upgrade run becomes a dreaded ritual. This article maps out where Claude Code can take the wheel, where humans must keep judgment, and the verification loop I use to keep breaking changes out of production.
Sharing Claude Code's .claude/ directory across a team — what to commit and what to keep personal
When you start sharing Claude Code's .claude/ directory across a team, which files belong in Git and which stay local? Here are the boundaries I've drawn after running it on four projects, plus a working .gitignore template.
Secret Management and Trust Boundaries for Claude Code — A Production Guide for the Agent Era
A field-tested approach to secrets in a Claude Code workflow: trust-boundary modeling, three injection patterns, leak-prevention hooks, and rotation runbooks — with working code for .env, MCP, and OS Keychain integrations.
When Claude Code Hooks Loop Forever — Stopping Self-Triggering PostToolUse Hooks
You wired up Claude Code hooks and now your terminal is a waterfall of tool calls that won't stop. Here's why PostToolUse hooks loop on themselves, and the patterns I use in real projects to make sure they never do again.
Claude Code for Unity Game Development: Practical
Hands-on guide to using Claude Code on real Unity projects: writing CLAUDE.md for Unity, the Unity MCP server, scene-aware C# generation, PlayMode tests, and build verification.
Automating CI/CD Pipelines with Claude Code's --print and --output-format json
A practical guide to using Claude Code's --print flag and --output-format json in CI/CD pipelines. Covers automated code review in GitHub Actions, PR comment generation, and test failure analysis — with working code throughout.
Claude Code × uv: Blazing-Fast Python Environment Setup — 10x Faster Than pip in Practice
Learn how to combine uv — Astral's Rust-powered Python package manager — with Claude Code for dramatically faster environment setup. Covers project initialization, dependency management automation, CI integration, and migrating from pip.
When Claude Code Hits `index.lock` in VMs and CI: Three Workarounds That Actually Stick
When Claude Code freezes on `fatal: Unable to create '.git/index.lock'` inside a VM, container, or CI sandbox, here are three battle-tested workarounds — pick the one that matches the layer of failure you're actually hitting.
Editing Multiple Repositories at Once With Claude Code --add-dir
How to use Claude Code's --add-dir flag to edit multiple repositories in a single session. Practical patterns for cross-repo API changes, shared utility refactoring, and keeping docs in sync with code.
Running Claude Code Without Breakage — A Failure-First Production Workflow with Plan Mode, Hooks, Rewind, and Subagents
If Claude Code has ever landed a broken commit on your main branch, this guide shows how to combine Plan Mode, Hooks, Rewind, and Subagents into a single failure-first workflow that keeps your repository safe without slowing you down.