Skip to content
BENIBIX Learn

Output Style vs CLAUDE.md

People think an output style and CLAUDE.md do the same job, since both shape every reply. They do not. CLAUDE.md tells Claude about your project, such as how to run the tests, and it loads whatever style you pick. An output style changes how Claude talks and works, such as shorter replies or notes on each choice. Put facts in CLAUDE.md and the way of working in a style.

AI⌨️ Claude Code

Output Style

Rules for how Claude talks to you, for a whole session.

An output style changes how Claude Code talks and works with you for a whole session. It is a set of instructions that sets Claude's role, tone and format. Claude Code has a default style and four more built in, such as Concise, Explanatory and Learning. You can also write your own. A custom style can even drop the normal coding instructions, which CLAUDE.md cannot do. Switch with /output-style or in /config.

Example
Lucy is new to a codebase. She picks the Explanatory style, and Claude adds short notes about why it wrote the code the way it did.
Why it matters
You set the way of working once, instead of asking for it in every prompt.
Full entry
AI⌨️ Claude Code

CLAUDE.md

A file of rules Claude Code reads each time it starts.

CLAUDE.md is a plain text file of instructions that Claude Code reads at the start of every session. You write it in Markdown. It can hold your build commands, your style rules and things to avoid. There can be one in your home folder for all projects, one in the project for the team, and more in sub-folders. Claude Code loads them all together. Running /init writes a first version for you by looking at your code.

Example
Emma's team keeps telling Claude to use their test command. She adds it to CLAUDE.md once, and every session after that uses it.
Why it matters
It is the easy way to stop saying the same thing in every session.
Full entry

In one line

Output Style
Rules for how Claude talks to you, for a whole session.
CLAUDE.md
A file of rules Claude Code reads each time it starts.