claude-code - 💡(How to fix) Fix [DOCS] Environment variables reference missing `CLAUDE_CODE_HIDE_CWD` startup logo option [1 participants]

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…
GitHub stats
anthropics/claude-code#52603Fetched 2026-04-24 06:02:43
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
Participants
Timeline (top)
labeled ×3
RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/env-vars

Section/Topic

CLAUDE_CODE_HIDE_CWD in the environment variables reference, with a cross-reference from startup UI documentation that mentions the logo/spinner.

Current Documentation

The docs currently say:

Claude Code supports the following environment variables to control its behavior. Set them in your shell before launching claude, or configure them in settings.json under the env key to apply them to every session or roll them out across your team.

The same reference documents nearby UI-related variables such as:

CLAUDE_CODE_DISABLE_TERMINAL_TITLE | Set to 1 to disable automatic terminal title updates based on conversation context

And the model configuration docs describe content shown in the startup UI:

The current effort level is also displayed next to the logo and spinner, for example "with low effort", so you can confirm which setting is active without opening /model.

No documentation currently exists for CLAUDE_CODE_HIDE_CWD or for hiding the working directory in the startup logo.

What's Wrong or Missing?

Changelog v2.1.119 added CLAUDE_CODE_HIDE_CWD to hide the working directory in the startup logo, but the documentation does not describe this environment variable anywhere.

That leaves users without the key details they need to use the feature:

  • where to set the variable
  • what UI element it changes
  • what behavior changes when it is enabled
  • where this fits relative to other startup UI controls already documented in the env var reference

Suggested Improvement

Add a new CLAUDE_CODE_HIDE_CWD row to https://code.claude.com/docs/en/env-vars that explains:

  • that it hides the working directory in the startup logo
  • when the setting is read (at launch/startup)
  • the accepted enable/disable values
  • whether it affects only the startup logo or any other UI surfaces

Also add a short cross-reference anywhere the docs describe startup logo/spinner information so users can discover that the displayed working directory can be hidden.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/env-varsComplete environment variable reference should include the new variable
https://code.claude.com/docs/en/model-configDocuments information shown next to the logo and spinner

Total scope: 2 pages affected

Source: Changelog v2.1.119

Exact changelog entry:

Added CLAUDE_CODE_HIDE_CWD environment variable to hide the working directory in the startup logo

extent analysis

TL;DR

Add documentation for the CLAUDE_CODE_HIDE_CWD environment variable to the environment variables reference page.

Guidance

  • Add a new row to the environment variables table at https://code.claude.com/docs/en/env-vars with details on the CLAUDE_CODE_HIDE_CWD variable, including its purpose, accepted values, and when it is read.
  • Include a cross-reference to the new documentation from the startup UI documentation that mentions the logo/spinner.
  • Verify that the added documentation is accurate and consistent with the behavior of the CLAUDE_CODE_HIDE_CWD variable.
  • Review the documentation for nearby UI-related variables, such as CLAUDE_CODE_DISABLE_TERMINAL_TITLE, to ensure consistency in formatting and content.

Example

No code snippet is necessary for this issue, as it is a documentation update.

Notes

The added documentation should follow the same format and style as the existing environment variable documentation to ensure consistency and ease of use for users.

Recommendation

Apply workaround: Add the missing documentation to the environment variables reference page, as this will provide users with the necessary information to use the CLAUDE_CODE_HIDE_CWD feature.

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] Environment variables reference missing `CLAUDE_CODE_HIDE_CWD` startup logo option [1 participants]