TL;DR Si no usas el texto gris que aparece tras cada respuesta, apágalo: en el terminal,
/configy Prompt suggestions afalse; en Desktop, Settings > Claude Code > Prompt suggestions. Si lo usas, acéptalo conTaby envíalo conEnter: pulsarEntersin aceptarlo no envía nada.
Las prompt suggestions de Claude Code no son autocompletado local. Cada vez que Claude termina de responder, Claude Code lanza en segundo plano una petición corta al mismo modelo de tu sesión para adivinar tu siguiente prompt, y lo deja en gris en la caja vacía.
Según la documentación, esa petición cuenta en los límites de tu plan o en tu factura de API, junto a todo lo que consume tu límite de uso. Reutiliza la caché del prompt de la conversación, así que casi todo son lecturas de caché y unos pocos tokens de salida: poco por respuesta, pero es una por cada respuesta, la uses o no.
No hay que confundirlas con dos cosas parecidas. El ejemplo gris que ves al abrir una sesión sale del historial de git del proyecto, no de tu conversación. Y la tarjeta con Start de Desktop es otra función, que abre una sesión nueva: la explica el tip de tareas sugeridas en Desktop.
Cómo se ve
Capturado en Claude Code v2.1.312, en una carpeta de pruebas con un calc.py cuyo add() resta. El prompt pregunta qué falla y avisa de que después vienen los tests. Al terminar la respuesta, la caja queda así:
● add() in calc.py subtracts instead of adding: it returns a-b where it should return a+b.
So add(2, 3) gives -1 instead of 5.
I haven't edited anything. Next I'll write the tests, then make the fix.
✻ Crunched for 3s · done 9:38 AM
────────────────────────────────────────────────────────────────────────
❯ write the tests
────────────────────────────────────────────────────────────────────────
⏸ manual mode on · ? for shortcuts
write the tests no lo escribió nadie: el terminal lo pinta atenuado (la secuencia ESC[2m). Lo que pasa con cada tecla, probado en esa misma sesión:
| Tecla | Qué hace |
|---|---|
Enter sin aceptar |
Nada. No se envía ningún mensaje |
Tab o flecha derecha |
Coloca la sugerencia como texto normal, editable |
Enter después de Tab |
Envía el prompt |
| Empezar a escribir | La descarta |
En Desktop funciona igual en la pestaña Code, con una condición más: solo aparece con la caja de prompt vacía y sin archivos adjuntos.
Cómo apagarlas
1. En el terminal, desde /config
Escribe /config, filtra por prompt y cambia Prompt suggestions a false. El toggle escribe la opción promptSuggestionEnabled.
2. En el archivo de settings
Lo mismo a mano, en ~/.claude/settings.json o en el de un proyecto:
{
"promptSuggestionEnabled": false
}
Arrancando con --settings '{"promptSuggestionEnabled":false}' y la misma conversación de prueba, la caja quedó vacía tras la respuesta.
3. Con la variable de entorno, que gana a todo lo anterior
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
La variable tiene prioridad sobre la opción de settings. La prueba al revés lo confirma: con promptSuggestionEnabled: false en settings y CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=true en el entorno, la sugerencia write the tests volvió a salir. Si la apagaste en /config y la sigues viendo, busca la variable en tu .zshrc o en tu .bashrc.
4. En Claude Code Desktop
Settings > Claude Code (o Settings > Code, según cómo lo llame tu app) y apaga Prompt suggestions. Las sesiones abiertas dejan de mostrarlas la próxima vez que arrancan o se reanudan, no al instante.
5. En sesiones en la nube
Añade CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false a las variables de entorno del entorno cloud, en formato .env. Hasta la v2.1.290 esa variable se ignoraba en las sesiones cloud nuevas: si no te funcionaba antes, ahora sí. Cómo editar esas variables lo cuenta el tip de entornos de Desktop en la nube.
Cuándo se saltan solas
Aunque estén activadas, Claude Code no genera la sugerencia en estos casos, según la documentación y el changelog:
- Caché fría. Si el prompt cache ha caducado, la sugerencia costaría la conversación entera sin caché, así que no la pide. Qué enfría la caché lo cuenta el tip de qué rompió tu caché.
- Cerca del límite de uso. Cuando a tu cuenta le queda poco, se pausan. Con
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=truesiguen hasta que llegas al límite (desde la v2.1.238). - Respuestas pagadas con créditos. Desde la v2.1.302, tras una respuesta facturada a créditos de uso no se genera ninguna.
- Plan mode, una respuesta que acabó en error y los teammates de un agent team. En el equipo, solo la sesión principal las muestra.
- Veinte sin usar seguidas. Desde la v2.1.283 el terminal las muestra con menos frecuencia y avisa con
Showing fewer prompt suggestions · use one to bring them back. Usar una las devuelve. claude -p. En modo print no se generan, salvo con--prompt-suggestionsy--output-format stream-json --verbose. Con una consulta corta de prueba no emitió ningún mensajeprompt_suggestion: las conversaciones muy cortas también se saltan.
Hay un caso más que puede confundirte: en una sesión que no descarga los feature flags (un proveedor de terceros, un gateway de Claude apps o la primera sesión tras actualizar), vienen apagadas por defecto y el toggle no aparece en /config.
Documentación oficial: Prompt suggestions
Probado con Claude Code v2.1.312 el 29 de octubre de 2026.
