[DOCS] Environment variables reference missing `FORCE_HYPERLINK` configuration

Open 💬 3 comments Opened Apr 7, 2026 by coygeek

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 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.

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 the env key 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:

Fixed FORCE_HYPERLINK environment variable being ignored when set via settings.json env

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.json under env.

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\``

View original on GitHub ↗

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