claude-code - 💡(How to fix) Fix [DOCS] Session quality survey docs omit `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/data-usage

Section/Topic

Session quality surveys and the related survey configuration docs

Current Documentation

The docs currently say:

When you see the "How is Claude doing this session?" prompt in Claude Code, responding to this survey, including selecting "Dismiss", records only your rating. We do not collect or store any conversation transcripts, inputs, outputs, or other session data as part of the rating prompt itself.

To disable these surveys, set CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1. The survey is also disabled when DISABLE_TELEMETRY or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set. To control frequency instead of disabling, set feedbackSurveyRate in your settings file to a probability between 0 and 1.

Related pages currently document only the disable path and the sample-rate setting:

CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY | Set to 1 to disable the "How is Claude doing?" session quality surveys. Surveys are also disabled when DISABLE_TELEMETRY or CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set.

feedbackSurveyRate | Probability (0–1) that the session quality survey appears when eligible. Set to 0 to suppress entirely. Useful when using Bedrock, Vertex, or Foundry where the default sample rate does not apply

What's Wrong or Missing?

As of v2.1.136, Claude Code added CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL to re-enable the session quality survey for enterprises capturing responses through OpenTelemetry.

The current docs do not mention that variable anywhere, and the existing survey guidance only describes:

A. How to disable the survey

data-usage and env-vars explain the disable behavior, but not the new OTEL-specific re-enable path.

B. How to tune survey frequency

settings documents feedbackSurveyRate, but not when an enterprise OTEL deployment needs the new override before survey sampling applies.

That leaves the current documentation incomplete for enterprise admins using OpenTelemetry, because the documented behavior stops at "disabled" and never explains the new opt-in override.

Suggested Improvement

Update the survey documentation to cover the v2.1.136 behavior in one place and cross-reference it from the related config pages.

Minimum fix:

1. Add CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL to env-vars with its accepted value(s), default behavior, and when it should be used.
2. Update the Session quality surveys section in data-usage to explain that enterprise deployments capturing survey responses through OpenTelemetry can re-enable the survey with this variable.
3. Update the feedbackSurveyRate setting docs to clarify whether the rate applies only after that OTEL-specific re-enable condition is satisfied.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 3 pages affected