Claude treats you like a stranger at the start of every conversation. A CLAUDE.md fixes that permanently — here's exactly how to write one that works.
A CLAUDE.md is a plain-text file that sits at the top of your Claude project. Claude reads it before every single conversation — before you type a word. It's a permanent briefing: who you are, how you work, what you need, and what you don't.
Without one, Claude starts every chat as if it's meeting you for the first time. You re-explain your job. You re-specify your tone. You re-describe your audience. Then you do it again tomorrow. A good CLAUDE.md ends that loop.
Think of it as a standing instruction document — the kind you'd give a new team member on day one. "Here's what we do, here's how we write, here's what a finished deliverable looks like." A CLAUDE.md gives Claude that brief once, and it holds for every conversation in the project.
The difference isn't subtle. These are real prompts — same task, same Claude, with and without a CLAUDE.md.
Without a CLAUDE.md, Claude writes to a generic audience in a generic voice. With one, it knows your byline, your clients, and your house style.
Without context, Claude gives you the MBA playbook. With a CLAUDE.md, it gives you advice calibrated to your actual stage, market, and constraints.
Without context, Claude produces generic strategy docs that look like a blog post. With one, it applies your frameworks and formats deliverables the way your clients expect.
Claude doesn't need your career history. It needs to know what you make. "I'm a freelance journalist who writes 800-word feature articles for tech publications" is more useful than three paragraphs of background.
"Write like a smart friend, not a consultant. Short sentences. No jargon. Concrete over abstract." Better than "write conversationally." Claude responds to instruction, not description.
Negative constraints are some of the most powerful instructions. "Never use bullet points unless I ask" or "Don't hedge every sentence with 'it's worth noting that'" will immediately improve your outputs.
If you always produce the same type of output — a client brief, a research summary, a social post — paste a representative example. Claude will match the format without being asked every time.
Longer isn't better. A bloated CLAUDE.md dilutes the most important instructions — Claude pays less attention to everything when there's too much. If yours is running long, use the Trim Existing CLAUDE.md tab to cut it down without losing the substance.
Describe your role and workflow. CoworKit generates a scored, structured CLAUDE.md — free, no signup required.