Blog · November 16, 2026 · 8 min read · by Vilva Athiban P B
Claude Code Session Recap Explained: The One-Line Summary You See When You Come Back to the Terminal, /recap, and How to Turn It Off
Step away from a Claude Code session for a coffee and, as of November 2026, the terminal greets you with a single line describing what happened while you were gone. That line is the session recap. It arrived in 2.1.108, it is on by default, and most people who notice it do not know the rules: why it shows up some times and not others, why it is so short, and whether it replaces a notification. The docs’ Session recap section answers the first part; the changelog answers the rest. Quotes are their words.
What you see when you come back to the terminal
The docs’ own sentence: “When you return to the terminal after stepping away, Claude Code shows a one-line recap of what happened in the session so far.” Not a sound, not a popup, not a message from Claude inside the conversation; the changelog calls it “the session recap line” and notes it is rendered in italics. It covers the session so far, not only the minutes you missed.
The exact rules, from the docs
Six conditions. If a recap did not appear, the answer is here.
- Timing. The recap “generates in the background once at least three minutes have passed since the last completed turn and the terminal is unfocused, so it’s ready when you switch back”. Both halves must hold: three minutes since a turn finished, and the terminal out of focus.
- Minimum session. “Recaps only appear once the session has at least three turns.” A fresh session with one prompt gets nothing.
- Never twice in a row. Leave, come back, leave again without sending anything, and the second return shows no recap.
- Default. “Session recap is on by default for every plan and provider.”
- Interactive only. “The automatic recap never appears in non-interactive mode.”
- Length. “Claude Code caps both automatic recaps and
/recapoutput at 400 characters.” The 2.1.236 changelog adds that the cut is “at a word boundary”.
/recap on demand
You do not have to wait. “Run /recap to generate a summary on demand.” The one restriction is who asks: “It runs only when you ask for it yourself.” If the command “arrives in a message relayed from a Slack, Teams, or project thread, you get a notice instead of a recap”, and the same notice appears “when /recap arrives in a prompt a cloud scheduled task sent”. Typed at your own prompt:
# In an interactive Claude Code session, at the prompt:
/recap
# Output is a short summary of the session so far,
# capped at 400 characters.How to turn the session recap off
The documented switch: “open /config and turn off Session recap”. That stops the automatic line; the docs do not say it disables /recap typed by hand.
There is also an environment variable, in the changelog rather than on the docs page. The 2.1.108 entry says to “force with CLAUDE_CODE_ENABLE_AWAY_SUMMARY if telemetry disabled”, from when telemetry-off setups did not get recaps. Then 2.1.110 turned recaps on for those setups and listed the opposite use: “Opt out via /config or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0.”
# Turn automatic recaps off for this shell (changelog 2.1.110):
export CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0
# Force them on where they would otherwise be off (changelog 2.1.108):
export CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1The variable is attested only by the changelog, so check it still behaves on your version; our Claude Code tips post has more settings of this kind.
A short history, by version
- 2.1.108. “Added recap feature to provide context when returning to a session, configurable in
/configand manually invocable with/recap.” - 2.1.110. “Session recap is now enabled for users with telemetry disabled (Bedrock, Vertex, Foundry,
DISABLE_TELEMETRY).” - 2.1.236. “Fixed occasional runaway session recaps”: the 400-character cap, automatic and manual.
- 2.1.251. Fixed the recap line “rendering as highlighted blocks in GNU screen and in tmux sessions using a
screenterminal type”. - 2.1.268. “Rapid terminal focus reports during a session recap no longer keep the CPU high.”
- 2.1.284.
/recapnow declines “with a short notice when it arrives relayed from a chat thread (your own included) or from a routine or webhook”; typed in the terminal, the Claude apps, Remote Control,-por an SDK host, “it runs as before”. - 2.1.323. “Fixed
/btwanswers and recaps sometimes including earlier replies from the conversation.”
What a recap is not
It is not a notification. The recap appears when you come back; nothing about it tells you, from another window or another room, that the run has finished or is waiting on a permission prompt. It never fires for a claude -p or SDK run, because those are non-interactive. And it depends on the terminal reporting focus, so inside a multiplexer or an editor-embedded terminal the “unfocused” condition may not behave as you expect. The docs do not spell that out; the only multiplexer line in the changelog is the 2.1.251 rendering fix, which is about italics, not focus.
Notification tells you when; recap tells you what
A notification is about when to come back: the run is done, or stuck on a permission. A recap is about what happened once you are there. AI Done Now does the first, as a Mac notification the moment Claude Code finishes or needs you (see the home page, our waiting-for-input post and the usage-limit reset post). The recap does the second. One without the other means arriving on time with no context, or arriving an hour late with a perfect one-line summary.
Recap vs Ctrl+O transcript vs /btw
Three depths. The recap is one line about the whole session. Ctrl+O toggles the transcript viewer, which “shows detailed tool usage and execution, with a timestamp and the model used on each assistant message”. /btw lets you “ask a question about your current work without adding to the conversation history”, answering from what is already in the conversation, with no tool access. Read the recap, ask /btw which files did you change? if 400 characters were not enough, and open the transcript for the exact commands.
A tiny scenario
You ask Claude to rename a module across the repository and fix the imports, exchange two turns about edge cases, and go to lunch. The terminal loses focus; the last turn completes; three minutes pass, and the recap is generated in the background. Forty minutes later you click back and one italic line summarises the session: the rename, the import fix, perhaps a test that needed attention. Whether the run ended at minute two or minute thirty-eight is what the notification was for.
When not to rely on it
Four hundred characters cannot carry a list of twelve changed files or the reasoning behind a design choice; scroll the transcript or ask Claude. Pair programming at one screen where the terminal never loses focus produces no automatic recap at all, by rule; type /recap when you want one.
FAQ
What is the Claude Code session recap?
A one-line summary of the session so far, shown when you return to the terminal after stepping away. Added in 2.1.108; on by default for every plan and provider.
How do I trigger it manually?
Type /recap at the prompt. Relayed from a Slack, Teams or project thread, or from a cloud scheduled task’s prompt, you get a notice instead.
Why did I not get a recap?
One rule was not met: under three minutes since the last completed turn, the terminal still focused, fewer than three turns, a recap already shown last time (never twice in a row), or a non-interactive session.
How do I turn it off?
Open /config and turn off Session recap. The changelog also lists CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 as an opt-out.
Does it work on Bedrock or Vertex?
Yes. The docs say it is on for every plan and provider, and 2.1.110 specifically enabled it for Bedrock, Vertex, Foundry and DISABLE_TELEMETRY setups.
Keep reading
Desk Exercises for Programmers: 15 Moves to Do While Your AI Agent Codes
7 min read
Exercise While Coding: Turn Claude Code Wait Time Into Micro-Workouts
7 min read
Claude Code Notch Notifications on Mac: See When Claude Is Done Without Watching the Terminal
7 min read
Claude Code Tips and Tricks: 12 Ways to Use Claude Code Effectively
8 min read
Claude Code Multiple Sessions: How to Run Agents in Parallel Without Losing Track
6 min read
A Claude Code Workflow That Doesn't Involve Watching the Terminal
5 min read
Claude Code Hooks: A Practical Guide to Automating Your Agent Workflow
7 min read
Claude Code Auto Mode: Fewer Permission Prompts Without Living Dangerously
7 min read
Claude Code Subagents: How to Delegate Work to Specialized Agents
7 min read
Claude Code Context Management: Treat the Context Window Like a Budget
6 min read
Per-Subagent Model Selection: Route the Grunt Work Down, Keep the Judgment Up Top
7 min read
Skills and Plugins: How to Teach Claude Code Your Way of Working
7 min read
Claude Code Background Tasks: Run Long Commands Without Blocking Your Session
6 min read
Codex CLI Notifications: How to Get a Ding When Codex Is Done or Needs Input
7 min read
Cursor Notification When Done: Every Way to Get Notified When Cursor Finishes
6 min read
Claude Code Notifications: How to Get Notified When Claude Code Finishes or Needs Your Input
6 min read
Want to Be Notified When Claude Responds? How Claude Notifications Work on Web, Desktop, and Mobile
5 min read
Claude Code Notification Scripts: Copy-Paste Recipes for Every Platform
6 min read
Get a Ding the Moment Codex Needs Your Response
6 min read
Get Notified the Moment Claude Code Is Waiting for Your Input
6 min read
“Notifications Are Turned Off for Claude” — Here Is the Fix
6 min read
Codex Sound When Done: Make Codex CLI Play a Sound When It Finishes
6 min read
terminal-notifier + Claude Code: Native macOS Alerts When Your Agent Finishes
6 min read
Gemini CLI Notifications: How to Get a Sound or Alert When Gemini Finishes
6 min read
Get Claude Code Notifications on Your Phone
6 min read
Claude Code Remote Control, Explained
7 min read
preferredNotifChannel: Claude Code's Built-In Notification Setting
6 min read
Claude Code Notifications in tmux and Over SSH
7 min read
Claude Code Effort Levels: Why Your Setting Keeps Getting Ignored
8 min read
Codex vs Claude Code Notifications: How Each One Tells You It Is Done
8 min read
Claude Code Notifications Not Working: A Diagnostic Checklist
10 min read
Claude Code Notifications Inside Your Editor's Terminal
7 min read
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Explained
7 min read
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP Explained
8 min read
Cursor Alerts Explained: Every Alert Cursor Raises, and How to Control Them
7 min read
Claude Code Environment Variables: The Groups That Actually Matter
10 min read
Claude Code Notifications on WSL and Windows
9 min read
Claude Code Checkpoints and /rewind
8 min read
Claude Remote Control: How It Works, Turning It Off, and Auto Mode
7 min read
Claude Code /loop: Poll a Deploy, Babysit a PR, and Get Told When It's Done
8 min read
Setting Up NotchFit With OpenAI Codex CLI: Hooks, $notchfit-plan, and the Daily Flow
7 min read
Claude Mods Explained: What the New Plugin Layer Can Do, and How to Turn On 'You Should Know'
9 min read
NotchFit vs Mac Break Reminder Apps: A Clock or a Signal From Your Coding Agent?
8 min read
Claude Code Headless Mode: Running claude -p in Scripts and CI, and the Three Signals That It Finished
10 min read
Building a Movement Habit at a Desk: Use the Agent Run as the Cue, One Set as the Unit, and Streaks Carefully
8 min read
Claude Code MCP Servers Explained: Adding Servers, Choosing a Scope, Handling Secrets, and Why Long Tool Calls Go to the Background
10 min read
/notchfit:plan Explained: How Claude Code or Codex Writes a Weekly Workout Plan the Notch Can Actually Run
8 min read
Claude Code Spinner Verbs Explained: What “Pondering” and “Brewing” Mean, How to Change Them, and Why You Should Stop Watching the Spinner
7 min read
Why NotchFit's Done and Permission Alerts Wait Until Your Set Ends, When That Costs You, and How to Turn the Workout Off
7 min read
How to Resume a Claude Code Session: --continue vs --resume, Naming Sessions, the Session Picker, Branching, and What Comes Back
9 min read
NotchFit on a Mac Without a Notch: How Pill Mode Works on Mac mini, iMac, Mac Studio and a MacBook With the Lid Closed
6 min read
How to Run a Claude Code Session in the Background: /background, claude --bg, Agent View, and Getting Back to It
9 min read
What a Notch App Can See: NotchFit's Local-First Design, What the Claude Code and Codex Hooks Send, and What Stays on Your Mac
7 min read
Why Codex CLI Asks for Permission Every Time, and How to Tune the Sandbox and Approval Policy Without Going Full Access
8 min read
What to Do While Claude Code or Codex Works: A Simple Protocol for the Two-to-Twenty-Minute Gap in Every Agent Run
7 min read
Is It Possible to Get a Notification When Claude Code or Codex Hits a Reset? Yes for Claude Code: the quota_auto_resume Hooks, Explained
8 min read
What a MacBook Notch App Can Actually Do: The Five Kinds of Notch Utility, Their Trade-offs, and Where NotchFit Fits
7 min read
How to Make MCP Servers Not Take Up as Much Context in Claude Code: Tool Search, alwaysLoad, Scopes and Output Caps
8 min read
The notchfit Command Line: Drive Your Workout, Read Status as JSON, Validate Plans and Test the Notch Without Leaving the Terminal
7 min read
How to Audit MCP Tool Calls Made by Claude Code: A Five-Minute Hook Audit Log, OpenTelemetry Tool Events, and the Transcript for Investigations
9 min read
Exercise Snacks: What the Research Actually Says About One-Minute Vigorous Breaks, What It Does Not, and How NotchFit's Agent-Run Sets Compare
8 min read
How Long Until a Claude Code MCP Tool Call Times Out? The Four Timers (Startup, Two-Minute Backgrounding, Idle, Wall-Clock), Their Defaults, and Which One to Change
8 min read
Sitting Too Long as a Developer: The Posture Problems Coding Agents Made Worse, What the Research Says About Breaking Up Sitting, and How NotchFit Turns an Agent Run Into the Break
8 min read
Claude Code .mcp.json Explained: Where Project-Scoped MCP Servers Are Read From, What Happens in Subfolders and Monorepos, and Why a Committed Server Shows Pending Approval
8 min read
Standing Desk Exercises for Developers: Why Standing Still Is Not the Goal, Eight Movements That Fit a Thirty-Second Agent Run, and How NotchFit Cues Them From the Notch
8 min read
The claude mcp Command Reference: add Syntax by Transport, What --scope local, project and user Actually Mean, add-json and add-from-claude-desktop, list, get, remove, login and serve
9 min read
Your First Week With NotchFit: Install and Simulate, Run Real Tasks, Write a Smaller Plan Than You Want, Tune the Alerts, Survive the First Skipped Day, and Decide What Stays
8 min read
How to Stop a Running Claude Code Task: Esc vs Ctrl+C, Background Tasks, Subagents, and Disconnecting Remote Control
8 min read
Pomodoro vs Agent-Driven Breaks: Timing Movement to Claude Code and Codex Runs Instead of a Timer
7 min read
Claude Desktop MCP Configuration: claude_desktop_config.json, Logs, Extensions, and the Difference From Claude Code
9 min read
The 20-20-20 Rule for Developers: Eye Strain, the Evidence, and Agent Runs as the Cue
8 min read
Claude Agent SDK + MCP Servers: mcpServers, allowedTools, Status Checks and Auth
9 min read
Discreet Desk Exercises for an Open-Plan Office While Claude Code Runs
7 min read
claude remote-control Server Mode: Run Claude Code as a Session Server
9 min read
Wrist and Forearm Stretches for Developers: A 60-Second Routine for Every Claude Code Run
7 min read
Claude Remote Control vs Claude Code on the Web: Which to Use and How They Differ
9 min read
Neck and Shoulder Stretches for Developers: A 90-Second Routine Between Agent Runs
7 min read
What Happens When You Step Away From a Claude Code Session: Prompt Cache Expiry, Idle Compaction, and When to Come Back
8 min read
Hip Flexor and Lower Back Stretches for Developers: A Two-Minute Standing Routine Between Agent Runs
7 min read
Claude Code's Monitor Tool: Watch Logs, CI Runs and PRs (Even a WebSocket) and Let Claude React While You Keep Working
7 min read
Hunched Over the Keyboard? Upper-Back (Thoracic) Stretches for Developers: A Two-Minute Seated Routine Between Agent Runs
6 min read
Claude Code Ultrareview: The 15–25 Minute Cloud Review, What to Do While It Runs, and How the Findings Come Back
8 min read
Why Your Legs Go Dead After a Long Claude Code Session: A Two-Minute Standing Calf, Glute and Hamstring Routine Between Agent Runs
7 min read
claude --teleport: Pull a Cloud Session Into Your Terminal, Start One With --cloud, Send Follow-Ups From the CLI, and the Requirements That Trip People Up
8 min read
Rounded Shoulders From Typing? A Two-Minute Chest Opener, Chair Twist and Wall Press Desk Routine for Developers Between Agent Runs
7 min read
Claude Code ultrathink Explained: It Now Runs the Turn at xhigh Effort, How It Differs From /effort, What It Costs in Time, and What to Do While It Runs
7 min read
Best Break Reminder Apps for Mac in 2026: Time Out, Stretchly, BreakTimer, LookAway and NotchFit Compared
7 min read
Claude Code 2.1.319: denyInsteadOfPrompting, MCP Background Tasks and What Changes for Unattended Runs and Notifications
8 min read
Drink Water and Stand Up Cues for Developers: Use Claude Code Agent Runs as Hydration and Standing Reminders
7 min read
Claude Code 2.1.323: Code Mode, Progress Heartbeat, Auto-Mode Fallback and 1M Context — What Changed for Unattended Runs
9 min read
Notch Media Controls on a Mac: What the MacBook Notch Can and Cannot Do, Dynamic Island-Style Apps vs NotchFit
7 min read
Claude Code Code Mode Explained: Claude Writes JavaScript to Call Tools — Requirements, Limits, Permissions, Hooks and What It Means for Unattended Runs
9 min read
NotchFit's Hide Workout Toggle: Using the Notch as a Pure Claude Code / Codex Status Panel (and When to Turn the Exercises Back On)
7 min read
A Five-Day Desk-Stretch Schedule for Developers: Rotating the NotchFit Routines Through the Week (Wrists Monday, Neck Tuesday, Hips Wednesday, Upper Back Thursday, Legs Friday)
7 min read
Claude Code 2.1.326: What Changed for Unattended Runs — Background Sessions, Permission and Settings Fixes, Code Mode with Agent Teams
8 min read
NotchFit Spoken Alerts: Let Your Mac Say 'Claude Is Done' Out Loud (On-Device macOS Voices, the Mute Button, the Mid-Set Wait and When to Turn Them Off)
7 min read