5 min / beginner / 5 steps
Build Your First CLAUDE.md in 5 Minutes
The single most important thing you can do with Claude Code. Create the file that turns it from generic to personalized.
A CLAUDE.md file is like a briefing doc for Claude. It tells Claude who you are, what your project is, and how you like to work. Without it, Claude starts every conversation from scratch. With it, Claude already knows the deal. Let's build one.
follow along in
You need: A Claude account. Open claude.ai in a browser, or the Claude desktop app.
step 01 / 05
Get to your starting point
Pick any project you're working on, a side project, a work repo, anything. We just need to get Claude looking at the right place.
PromptPaste into ClaudeI want to set up a CLAUDE.md file for my project. It's a Next.js app with TypeScript. Where do I start?what you should see
Get to your starting pointmy-projectShareDescribe a task or ask a question+Accept editsstep 02 / 05
Generate your CLAUDE.md
In the terminal, one command does it all. In the app or IDE, you describe your project and Claude writes it for you.
PromptPaste into ClaudeMy project is a Next.js SaaS app with TypeScript and Tailwind. We use Prisma for the DB, vitest for tests, and prefer functional components. Never use `any` types.what you should see
Generate your CLAUDE.mdmy-projectShareDescribe a task or ask a question+Accept editsstep 03 / 05
Open the generated CLAUDE.md
Take a look at what Claude created. It should have your project name, the tech stack it detected, build commands, and some basic context. This is your starting point.
bashcat CLAUDE.mdwhat you should see
Open the generated CLAUDE.mdmy-projectShareDescribe a task or ask a question+Accept editsstep 04 / 05
Add your communication preferences
This is what separates a good CLAUDE.md from a great one. Tell Claude how you like to work. Are you a senior dev who wants terse answers? A beginner who wants explanations? Add a section for it.
PromptPaste into ClaudeAdd this to the CLAUDE.md you just wrote: Be concise. Give code first, explanation second. Use TypeScript always. When fixing bugs, show root cause before fix. Don't ask. Just do it.markdown# Add this to the bottom of your CLAUDE.md ## Communication Preferences - Be concise. Skip the preamble. - When I ask for code, give me the code first, explanation second. - Use TypeScript. Never suggest JavaScript alternatives. - When fixing bugs, show me the root cause before the fix. - Don't ask "would you like me to...". Just do it.what you should see
Add your communication preferencesmy-projectShareDescribe a task or ask a question+Accept editsstep 05 / 05
Test it and see the difference
Now start Claude Code and give it a prompt. Notice how it already knows your stack, your build commands, and your preferences. No more explaining yourself.
PromptPaste into ClaudeAdd a dark mode toggle to the header. My stack is Next.js 16, Tailwind, TypeScript.what you should see
Test it and see the differencemy-projectShareDescribe a task or ask a question+Accept edits
Tell someone what you built
Just finished "Build Your First CLAUDE.md in 5 Minutes" on Claude Code Guide. Took about 5 min, and it's free: https://claudecodeguide.dev/tutorials/your-first-claude-md
New guides, when they ship
One email, roughly weekly. CLAUDE.md templates, workflows I actually use, and the cut-for-length stuff that does not make the public guides. One-click unsubscribe.
Or read Product Field Notes, the Substack