[DOCS] Environment variable reference missing `CLAUDE_CODE_SIMPLE` and simple-mode tool behavior

Resolved 💬 2 comments Opened Feb 19, 2026 by coygeek Closed Feb 20, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

Environment variables table (CLAUDE_CODE_* reference).

Current Documentation

The environment variables section lists many CLAUDE_CODE_* variables (for example CLAUDE_CODE_EFFORT_LEVEL, CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION, etc.), but there is no entry for CLAUDE_CODE_SIMPLE.

What's Wrong or Missing?

Claude Code v2.1.49 release notes reference Simple mode via CLAUDE_CODE_SIMPLE and note that this mode now includes the file edit tool in addition to Bash.

The settings reference does not document:

  • what CLAUDE_CODE_SIMPLE does,
  • valid values,
  • its tool limitations/capabilities,
  • the new file edit tool behavior.

Suggested Improvement

Add a CLAUDE_CODE_SIMPLE row to the environment variables table with:

  • purpose and valid values,
  • what tools are available in Simple mode,
  • explicit note that as of v2.1.49, file editing is available in Simple mode alongside Bash,
  • cross-link to the most relevant usage page.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/settings | 765-800 | CLAUDE_CODE_* environment variable table lacks CLAUDE_CODE_SIMPLE |

Total scope: 1 page affected

View original on GitHub ↗

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