Features · Built in · since version 1.0.81

Output styles

Change how Claude talks to you, from short and to the point to teaching as it goes.

What it is

An output style is a set of instructions that changes Claude's tone and the shape of its answers for a whole session. Built-in styles include Concise (results first, little narration), Explanatory (adds short insights about the code) and Learning (leaves small parts for you to write). You can also write your own style as a Markdown file.

Why it matters

  • Answers that fit how you workPick short replies when you know the code, or more explanation when you are learning it.
  • Learn while you buildThe Learning style hands parts of the work back to you, marked TODO(human), to write yourself.
  • Your own styleA custom style can turn Claude into a reviewer, a writer or anything else you describe.

How it works

  1. Run /output-style to list the styles, or /output-style concise to switch.
  2. The choice is saved as outputStyle in your local project settings; set it in ~/.claude/settings.json to use it everywhere.
  3. Write a custom style as a Markdown file in ~/.claude/output-styles or .claude/output-styles.
  4. Add keep-coding-instructions: true to its frontmatter to keep Claude's usual coding instructions.
  5. A style is guidance Claude follows; use hooks when something must always happen.

Hands-on example coming

This feature has no reviewed example yet. The official documentation below has the details.

Update history

  1. Version 2.1.237 · Aug 19, 2026

    Updated A built-in Concise style was added.

  2. Version 2.0.32 · Nov 3, 2025

    Updated The deprecation was reversed after community feedback.

  3. Version 2.0.30 · Oct 30, 2025

    Deprecated Output styles were marked deprecated.

  4. Version 1.0.81 · Aug 14, 2025

    Introduced Output styles were released with the Explanatory and Learning styles.

Official documentation