claude-code - 💡(How to fix) Fix [DOCS] Session recap docs missing telemetry-disabled behavior and opt-out controls [1 comments, 2 participants]

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/common-workflows

Section/Topic

"Resume previous conversations" and the related session-return / command documentation for session recap (away summary)

Current Documentation

The resume workflow docs currently say:

When starting Claude Code, you can resume a previous session:

• claude --continue continues the most recent conversation in the current directory
• claude --resume opens a conversation picker or resumes by name
• claude --from-pr 123 resumes sessions linked to a specific pull request

The commands reference currently says:

The table below lists all the commands included in Claude Code.

| /config | Open the Settings interface to adjust theme, model, output style, and other preferences. Alias: /settings | | /resume [session] | Resume a conversation by ID or name, or open the session picker. Alias: /continue |

The telemetry docs currently say:

By default, error reporting, telemetry, and bug reporting are disabled when using Bedrock, Vertex, or Foundry.

There is no user-facing documentation for the session recap / away summary shown when returning to a session, the /recap command, the /config opt-out, or the CLAUDE_CODE_ENABLE_AWAY_SUMMARY environment variable.

What's Wrong or Missing?

Changelog v2.1.110 says: "Session recap is now enabled for users with telemetry disabled (Bedrock, Vertex, Foundry, DISABLE_TELEMETRY). Opt out via /config or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0."

That behavior is not documented in the product docs:

A. The feature itself is undocumented

The docs explain how to resume sessions, but not that Claude Code can generate a recap / away summary when you return.

B. Telemetry-disabled behavior is undocumented

Users on Bedrock, Vertex, Foundry, or with DISABLE_TELEMETRY=1 are explicitly called out by the changelog, but the docs do not explain that session recap is available for them too.

C. Opt-out controls are undocumented

The docs do not explain how to disable this behavior via /config or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0.

D. Manual invocation is undocumented

The command surface for manually requesting a recap is not documented in the command reference.

Suggested Improvement

Add a short, user-facing section that documents session recap / away summary behavior when returning to a session.

At minimum, document:

1. When a recap appears after resuming a session
2. That the feature is available for Bedrock, Vertex, Foundry, and DISABLE_TELEMETRY users as of v2.1.110
3. How to opt out in /config
4. How CLAUDE_CODE_ENABLE_AWAY_SUMMARY works, including CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0
5. Whether /recap is available for manual invocation, and if so, add it to the commands reference

Suggested placement:

• Add the main behavior explanation to common-workflows
• Add /recap to the commands reference
• Add the setting/env-var details to settings and env-vars

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 5 pages affected

Source: Changelog v2.1.110

Entry text: Session recap is now enabled for users with telemetry disabled (Bedrock, Vertex, Foundry, DISABLE_TELEMETRY). Opt out via /config or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0.