Guides
Practical guides for building with Claude Code, written for solo founders and the people who help them. Each guide is meant to be read once and referred back to, not skimmed and forgotten, so they run long where running long is what the topic deserves.
Getting started with Claude Code: what to actually do on day oneA real first-day setup for Claude Code that goes beyond install. What to set up, what to skip, how to think about the first session, and the things most people miss in week one.
12 min read
Claude Code on macOS Terminal: the five settings that change the experienceWhich terminal to use on macOS, the Option-key problem nobody warns you about, how to wire up notifications, and the other small settings that make Claude Code feel like it was built for your machine rather than just running on it.
10 min read
Claude Code on Windows: native PowerShell, Git for Windows, and when WSL still winsNative Windows is genuinely supported now and you don't need WSL the way you used to. The honest guide to picking PowerShell or WSL2, what Git for Windows changes, the install pitfalls that catch people, and the small terminal settings that matter.
9 min read
Claude Code workflow and power moves: plan mode, subagents, auto mode, and the patterns that separate pros from noobsThe handful of workflow features that actually change how much you get out of Claude Code, why most users discover them too late, and the patterns Anthropic's own teams use to keep sessions productive across long tasks.
13 min read
CLAUDE.md and auto memory: how to give Claude Code persistent context that actually helpsCLAUDE.md is the single highest-leverage file in a Claude Code project, and most people write it badly. The honest guide to what belongs in it, where it lives, how the new auto memory system works alongside it, and the mistakes that quietly hurt response quality.
10 min read
Claude Code settings, hooks, and permissions: making the tool yours without losing the guardrailsThe configuration surface that turns Claude Code from a useful default into a tool genuinely shaped to your workflow. Settings files, the permission rule system, when to use hooks vs CLAUDE.md vs skills, and the patterns that survive long-term.
10 min read
Custom slash commands and MCP servers: extending Claude Code without writing your own toolThe two main ways to extend Claude Code are skills (custom slash commands you write in markdown) and MCP servers (external services that expose tools to the model). Most users discover these too late. Here's the honest guide to when to reach for each.
10 min read
Claude Code in CI: headless mode, the Agent SDK, and GitHub ActionsEverything you do in the interactive terminal, Claude Code can also do unattended. Three ways to run it in a pipeline: the headless CLI (claude -p), the Agent SDK, and the official GitHub Action. Same engine, three entry points, one set of cost and permission rules to get right.
8 min read