[DOCS] Environment variables reference missing `CLAUDE_CODE_HIDE_CWD` startup logo option

Open 💬 3 comments Opened Apr 23, 2026 by coygeek

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:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/env-vars | Complete environment variable reference should include the new variable |
| https://code.claude.com/docs/en/model-config | Documents 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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗