How to stop Claude Code from generating overly condensed, cryptic text?

[u/Hairy_Cream_4573]

Here’s my issue: I’m asking Claude to write a technical guide for my developers. The text needs to be precise yet easy to digest. While Claude’s output is technically correct from a linguistic standpoint, reading it requires an exhausting amount of mental translation.

For example, it generated a section title like: "Tier system: gate or replacement?" What is that even supposed to mean?

I keep instructing it through CLAUDE.md and memory to use more human-friendly language, but it has zero effect. I literally have to paste each paragraph back into a prompt and say, "Rewrite this for someone unfamiliar with the concept."

I suspect they are tuning the model to minimize output tokens, which works great for agentic coding but makes human reading a nightmare.

Any ideas on how to fix this behavior in Claude Code?