How to turn off Claude Code's gray prompt suggestions
After Claude replies, Claude Code can show a suggested next prompt as gray text in the input box. Press Tab or the right arrow to place it in the input, or start typing to dismiss it. Each suggestion is a short background request to the same model your session uses, so it counts toward your plan's usage limits or API costs. It reuses the prompt cache, so the added cost is small.
Turn it off if it distracts you or you want to save usage.
- In the terminal, turn off the Prompt suggestions toggle in
/config. That toggle writes thepromptSuggestionEnabledsetting. To set it by hand, put it in~/.claude/settings.json.
{
"promptSuggestionEnabled": false
}
- The environment variable
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONtakes precedence over the setting. If you set it totruesomewhere, change it tofalseor the suggestions stay.
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
- The VS Code extension follows the same
~/.claude/settings.jsonvalue. It applies to new conversations, and to open ones after you run Developer: Reload Window from the Command Palette. According to the changelog, v2.1.326 (November 16) also added a VS Code setting,claudeCode.promptSuggestions, that turns them off.
The same variable works the other way too. Claude Code pauses suggestions when your account is close to its usage limit; set it to true to keep them until you actually reach the limit (v2.1.238 or later). Suggestions never appear in plan mode, right after a response that ended in an error, when the prompt cache is cold, or in agent-team teammates' sessions.
Sources
Get notified when a new tip lands
Tip alerts only go out in the app. Install it and turn notifications on.