[DOCS] Environment variable reference missing `CLAUDE_CODE_SIMPLE` and simple-mode tool behavior
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_SIMPLEdoes, - 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
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗