[DOCS] Environment variables reference missing `FORCE_HYPERLINK` configuration
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/env-vars
Section/Topic
Environment variables table (FORCE_HYPERLINK) and its settings.json env usage
Current Documentation
The docs currently say:
Claude Code supports the following environment variables to control its behavior. Set them in your shell before launchingclaude, or configure them insettings.jsonunder theenvkey to apply them to every session or roll them out across your team.
And the settings page says:
Environment variables let you control Claude Code behavior without editing settings files. Any variable can also be configured in [settings.json](#available-settings) under theenvkey to apply it to every session or roll it out across your team.
There is currently no documented entry for FORCE_HYPERLINK on the environment variables reference page.
What's Wrong or Missing?
Changelog v2.1.94 includes:
FixedFORCE_HYPERLINKenvironment variable being ignored when set viasettings.jsonenv
That confirms FORCE_HYPERLINK is a supported user-facing configuration variable and that settings.json env is an intended configuration path. The docs currently promise that environment variables can be configured this way, but they do not tell users that FORCE_HYPERLINK exists, what it does, when to use it, or what values are supported.
Suggested Improvement
Add a FORCE_HYPERLINK row to the environment variables reference that documents:
- what behavior it controls,
- accepted values and default behavior,
- when to use it (for terminals where hyperlink auto-detection is wrong), and
- that it can be set either in the shell or in
settings.jsonunderenv.
Include a minimal settings.json example such as:
{
"env": {
"FORCE_HYPERLINK": "1"
}
}
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/env-vars | Authoritative environment variable reference; currently omits FORCE_HYPERLINK |
| https://code.claude.com/docs/en/settings | Documents that any environment variable can be set via settings.json env, but gives no discoverable reference for this variable |
Total scope: 2 pages affected
Source: Changelog v2.1.94
Exact changelog entry: Fixed \FORCE_HYPERLINK\ environment variable being ignored when set via \settings.json\ \env\``
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗