claude-code - 💡(How to fix) Fix [DOCS] Extended thinking docs still describe a separate progress hint row

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

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

Section/Topic

"Use extended thinking (thinking mode)" section

Current Documentation

The docs currently say:

Extended thinking is enabled by default, giving Claude space to reason through complex problems step-by-step before responding. This reasoning is visible in verbose mode, which you can toggle on with Ctrl+O. During extended thinking, progress hints appear below the indicator to show that Claude is actively working.

What's Wrong or Missing?

This description is outdated for v2.1.116.

The changelog entry says the thinking spinner now shows progress inline — for example, "still thinking", "thinking more", and "almost done thinking" — and that this replaced the separate hint row.

The current docs still describe the old UI model where progress hints appear below the indicator, so they do not match the current terminal behavior users see during extended thinking.

Suggested Improvement

Update the extended thinking section to describe the current UI behavior instead of the older separate hint row.

For example, replace the sentence about hints appearing below the indicator with wording such as:

During extended thinking, the spinner shows inline progress labels such as still thinking, thinking more, and almost done thinking so you can tell Claude is still working.

If helpful, add a brief note or screenshot showing that the progress text is part of the spinner itself.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/common-workflowsExtended thinking overview still says progress hints appear below the indicator

Total scope: 1 page affected

Source: Changelog v2.1.116

Exact changelog entry:

Thinking spinner now shows progress inline ("still thinking", "thinking more", "almost done thinking"), replacing the separate hint row

extent analysis

TL;DR

Update the "Use extended thinking" section in the documentation to reflect the current UI behavior, where the spinner shows inline progress labels.

Guidance

  • Review the changelog entry for v2.1.116 to understand the changes made to the thinking spinner.
  • Update the documentation to describe the new UI behavior, using wording such as "During extended thinking, the spinner shows inline progress labels...".
  • Consider adding a brief note or screenshot to clarify that the progress text is part of the spinner itself.
  • Verify the changes by checking the affected page (https://code.claude.com/docs/en/common-workflows) to ensure the documentation matches the current terminal behavior.

Example

The updated sentence could be:

During extended thinking, the spinner shows inline progress labels such as still thinking, thinking more, and almost done thinking so you can tell Claude is still working.

Notes

The suggested improvement is specific to the "Use extended thinking" section and only affects one page, making it a targeted update.

Recommendation

Apply workaround: Update the documentation to reflect the current UI behavior, as the issue is due to outdated documentation and not a code-related problem.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Extended thinking docs still describe a separate progress hint row