[DOCS] Docs Gap: Missing Flags, Settings, and Env Vars introduced in v2.0+ (Changelog Audit)

Documentation Type

Missing documentation (feature not documented)

Documentation Location

• docs/en/cli-reference.md - docs/en/settings.md

Section/Topic

• CLI Reference: CLI flags table
• Settings: Available settings table
• Settings: Environment variables table
• Settings: Tools available to Claude table
• Interactive Mode: Keyboard shortcuts -> General controls table

Current Documentation

The documentation reflects features up to the v1.x era and some early v2.x features, but omits specific configuration options and tool changes introduced between v2.0.0 and v2.1.9.

• settings.md lists BashOutput as a tool.
• cli-reference.md lacks budget and slash command flags.
• interactive-mode.md does not list the external editor shortcut.

What's Wrong or Missing?

A cross-reference of the Changelog from v2.0.0 to v2.1.9 reveals the following missing items:

1. Missing Flags (docs/en/cli-reference.md)

• --max-budget-usd (v2.0.28): Set a hard cost cap for the session.
• --disable-slash-commands (v2.0.60): Disables all slash commands.
• --agent (v2.0.59): Override the agent setting for the current session.

2. Missing Settings (docs/en/settings.md)

• plansDirectory (v2.1.9): Customize plan file storage location.
• showTurnDuration (v2.1.7): Toggle turn duration messages.
• spinnerTipsEnabled (v1.0.112/active): Enable/disable spinner tips.
• terminalProgressBar (v2.0.56): Enable/disable OSC 9;4 progress bar.

3. Missing Environment Variables (docs/en/settings.md)

• CLAUDE_CODE_TMPDIR (v2.1.5): Override internal temp directory.
• FORCE_AUTOUPDATE_PLUGINS (v2.1.2): Force plugin updates even if auto-updater is disabled.
• IS_DEMO (v2.1.0): Hide email/org from UI.
• CLAUDE_CODE_PROXY_RESOLVES_HOSTS (v2.0.55): Opt-in for proxy DNS resolution.
• CLAUDE_CODE_EXIT_AFTER_STOP_DELAY (v2.0.35): Auto-exit SDK mode after idle.

4. Missing/Incorrect Tools (docs/en/settings.md)

• Missing: MCPSearch (v2.1.7): Used for discovering MCP tools when descriptions exceed context limits.
• Incorrect: TaskOutput (v2.0.64): The changelog states "Unshipped AgentOutputTool and BashOutputTool, in favor of a new unified TaskOutputTool." The docs still list BashOutput.

5. Missing Interactive Shortcuts (docs/en/interactive-mode.md)

• Ctrl+G (v2.0.10): Edit prompt in system text editor.

Suggested Improvement

Update cli-reference.md:
Add entries for --max-budget-usd and --disable-slash-commands.

Update settings.md (Available Settings):
Add plansDirectory, showTurnDuration, and terminalProgressBar.

Update settings.md (Environment Variables):
Add the 5 missing variables listed above (TMPDIR, FORCE_AUTOUPDATE, IS_DEMO, etc).

Update settings.md (Tools):

1. Add MCPSearch.
2. Replace BashOutput with TaskOutput (or verify if BashOutput is an alias, otherwise update to reflect the v2.0.64 change).

Update interactive-mode.md:
Add Ctrl+G to the General Controls table: "Edit prompt in external editor".

Impact

High - Prevents users from using a feature

Additional Context

Reference: Changelog v2.0.64 regarding TaskOutputTool.
Reference: Changelog v2.1.7 regarding MCPSearch.