title: "Behavioral Modes" description: "Ready-to-use behavioral mode files for customizing Claude Code behavior" tags: [config, template, workflows]

Behavioral Modes

Ready-to-use behavioral mode files for Claude Code. Copy to ~/.claude/ and reference in your CLAUDE.md.

Available Modes

Installation

1. Copy the mode file

cp MODE_Learning.md ~/.claude/

2. Reference in your CLAUDE.md

Add to ~/.claude/CLAUDE.md:

# Behavioral Modes
@MODE_Learning.md

3. Add flags (optional)

Add to ~/.claude/FLAGS.md for flag-based activation:

**--learn**
- Trigger: User requests learning mode, "why/how" questions
- Behavior: Enable just-in-time explanations with first-occurrence tracking

**--no-learn**
- Trigger: User wants pure execution without educational offers
- Behavior: Suppress all learning mode offers

Usage

# Activate for entire session
claude --learn

# Focus on specific domain
claude --learn focus:git
claude --learn focus:architecture

# Batch explanations at task end
claude --learn batch

More Modes: SuperClaude Framework

This guide includes only Learning Mode. For a complete behavioral framework with additional modes, check out SuperClaude:

SuperClaude also includes:

• FLAGS.md (behavioral flags like --delegate, --learn) Note: --think/--ultrathink are cosmetic only since v2.0.67, since thinking is now on by default across the Opus lineup (4.5 through Opus 5)
• PRINCIPLES.md — Engineering principles (SOLID, DRY, evidence-based)
• RULES.md — Actionable rules with priority system
• MCP server documentation (Context7, Sequential, Serena)

See Also

• SuperClaude Behavioral Modes — Full documentation
• SuperClaude Repository — Complete framework