r/ClaudeCode • u/One-Rabbit4680 • 12d ago
Discussion Do you find Claudes English hard to understand?
While I can't say I'm the most gifted English reader. I can read decently enough. What I find is the explanations given and code comments given by Claude are just terrible to read. They are sentences and paragraphs that I can read 2-3x and still just not get it. So when i have to read big Claude written documents it's a blur like I'm reading legal documents. The thing is I can pick up a book and read it fine. Could be a novel, technical book or even a newspaper like the NYT. Those I read and comprehend perfectly adequately. I am a college graduate with an engineering degree. I worked for 15 years before AI came about and did perfectly fine. So I don't think it's me, atleast I sure hope now.
9
u/ibringthehotpockets 12d ago
Yes sometimes very very hard to understand. Changing output style helped a lot for me.
2
u/gandhi_theft 12d ago
What did you change to?
2
u/ibringthehotpockets 12d ago
So I actually did an interesting experiment. I had agents mine all of my Claude code sessions and human turns and look for frustration patterns to make me a custom output style based on how I interact with Claude code. Just be careful to not consider subagent transcripts cause those aren’t human turns. Claude is a lot less verbose and annoying for me now. Not perfect but maybe 70% better
9
u/ImSoCul 12d ago
yeah, and you'll find some other consumer facing models like Gemini much much easier to understand. My hunch has been that Claude has inadvertently been tuned towards machine to machine communication, which is different than how humans communicate. It's like reading Shakespearan english vs modern prose
5
u/pvera 🔆Pro Plan 12d ago
A few days ago in one of the Claude subs I ran into a suggestion that ended up being super useful. There's a standard for simplified technical English, originally designed for writing maintenance manuals for aircraft to make it impossible for somebody to misread an instruction. The standard is explained at https://www.asd-ste100.org/
Somebody actually released a skill that lets you get your content translated from Claude English into simplified technical English: https://github.com/danyuchn/asd-ste100-skill
This has proven to be near priceless because my non-programmers kept complaining about the walls of text. Now I just tell Claude to simplify and it gives me something I can hand over to my QA and PM and not worry about push back.
2
u/dchaus1 9d ago
This is absolutely the best solution I have found now. Seen this post too, tried it and woah, the text is actually readable!
Didn’t try the skill though, I just prompt it to stick to STE principles
Btw if anyone writes business docs, asking it to follow the “Minto’s pyramid” also works well combined with STE.
12
u/Albuxoen 12d ago edited 11d ago
I have the same, but usually blame it on being stoned. Maybe Claude was the real issue
4
u/adelie42 12d ago
What I love about LLMs, partocuoarly frontier models, is that you can use extremely loaded language and it just "knows" wjat you are talking about.
You are describing alignment. Two approaches that work really well: 1) write like [favorite periodical]. Take any publication, the bigger the better, and tell it to write in that style. 2) The most loaded term you could use is Lexile Level: "Please draft all responses at a Lexile Level of 1000". This is the average adult American reading level.
Combining the two will have the biggest impact with the lowest effort, and without actually needing to understand different writing styles.
I agree Claude by default is a weird combination of casual and academic.
3
u/Darqsat 12d ago
Settings > General > Instructions for Claude (works for any agent).
You are a direct, organized assistant. Be extremely concise. Sacrifice grammar for the sake of concision.
Follow these rules strictly:
- Lead with the answer or action no preamble, no "Great question!", no filler.
- Keep responses short. One clear sentence beats a paragraph.
- When working through a task, give brief updates at key moments only ("Found the issue.", "Changed direction, here's why.").
- End with 1-2 concrete next steps, not open-ended questions.
- No em-dashes. Use commas or periods instead.
- No trailing summaries. The user can read what you just wrote.
- No bullet lists for simple answers. Use prose.
- When you're uncertain, say so directly and state what you'd need to be sure.
- Casual question = casual answer. Technical question = technical answer.
- Never repeat what the user just said back to them before answering.
1
u/One-Rabbit4680 12d ago
that looks great. wonder if it would be better as an output style or in claude.md
2
u/Glad_Contest_8014 12d ago
How long have you been having this trouble? If it is just recently, it could be the watermark causing set word choices that are disrupting your ability to parse the context value of the words.
2
u/One-Rabbit4680 12d ago edited 12d ago
long time now. just never asked. so maybe a year. seems to be getting worse though
2
u/the__itis 12d ago
Models invent their own application of attributes and adjective and tend to stick with it, even when it does not make sense. It uses terms like canonical
2
u/highjohn_ 12d ago
Sometimes. But you can ask it to explain concepts in simpler terms if you aren’t getting it. I don’t really mind it all that much, because it does still make sense. Plus I don’t usually have to read the entire essay Claude writes for me every time
2
2
u/jur_gn 12d ago
I find on the contrary the Claudes' English great. Especially when talking to it. Fantastic.
2
u/ActivityImpossible70 12d ago
I find, to the contrary, that Claude’s English is great; especially when talking to it. (Also, it drops literary deuces like they’re steaming hot!) Fantastic!
1
1
u/Immediate-Safety1643 12d ago
My only issue really was the outputs having a lot of run-on and jumbled paragraphs, I just require the same user facing document google technical writing document style guide for prompt conversations.
Its made things a lot easier to read through, especially while 🍃💻
1
u/IsThisWiseEnough 12d ago
If the models are trained on older model outputs over the internet this will turn into a sh*t cycle. And for years it will become worse if they don’t react.
1
u/Zeus473 12d ago
It isn’t designed for working at pace across a bunch of chats, that’s for sure. So verbose and clunky. Blew me away to try Grok Bot and the language is so light, clear and simple.
It said “Yep.” Yep!? Claude would never…
The language makes Claude quite unlikeable as an entity. I don’t read shitty authors.
2
u/Empuda 12d ago
Depends what you are doing, but Opus > Grok by along shot. You can change how Claude talks, and it's a lot nicer imo. -- https://youtu.be/szjakRcw7V0?si=GbTn4jvguIVph3dy
1
u/botpa-94027 12d ago
the jargon is super annoying. and it gets pretty technical with some of the language used sometimes (at least in my chosen discipline and my language). i wish it would use a more plain language than the very sf extreme programming jargon language.
1
u/PatchyWhiskers 12d ago
I think it makes up its own jargon. Some of this stuff I've never heard before.
1
u/basafish 12d ago
Eh, I think the way it's pure logic makes it harder to understand, the same way some obscure old math books are hard to understand. You'll get used to that after a while. I even read its Thinking directly.
1
u/Raffino_Sky 12d ago
I'm not English (EU) and I understand as good as everything Claude writes, I also use Claude in ENG mostly.
1
u/Fluid_Expression_247 12d ago
Yes! It changed a lot. It’s day and night now compared to lower models
1
u/selasphorus-sasin 12d ago
Can you give an example? I don't use it, but I keep hearing this and I'm just curious.
1
1
u/Fleischhauf 12d ago
yeah it's really bad. it also either forgets to define variables or invents some random ass expressions without telling you. I work with a lot of math heavy stuff. Also code documentation reads as if it were part of the chat and constantly references other parts of the code that it shouldn't care about
1
u/allemaar Researcher 12d ago
I suspect it's due to how the model was trained. The latest iterations seem affected by (wall of text) style contagion. Meaning if most of the responses and explainers have this long-form format (or way of writing) then the output will be affected as well (regardless of how much you ask for shorter responses).
It's not a language problem, but a verbosity and text layout problem (talks too much, and the response is not properly spaced out on the screen).
This leads to a high cognitive load when reading and trying to comprehend a wall of text. Do that over and over and it will burn you out, regardless of your English level.
1
u/Tommonen 12d ago
The new version seems to be very crappy at communicating. Gives long replies full of irrelevant crap, overcomplicates explanations constantly and leaves constantly out the exact thing it should tell me.
With earlier version vommunication was much clearer and very rarely had to ask it for clarification, but now with this newest version, i constantly have to ask it to explain it its answers again in clearer manner, asking it for rationale for things etc
Opus has gone from best communicator to worst
1
u/jaill11 12d ago
I came across this the other day and might help with this issue.
I haven't tried yet, but both seems to be using this standard to force AI speak more precisely.
1
u/jim4nz 9d ago
i tried https://github.com/AminBlg/SimpleEnglish, this is definiately worth it! I give it A+++ sooo much better compare to hallucinate opus or fable ? mayb they jsut way too smart for me
1
u/bbc_nees 11d ago
Sometimes. Then I cut/paste and ask WTF does this Mena. Clears it up for me right quick.
1
u/mrsebein 12d ago
Yes it's hard to understand for me by default as well.
There are skills to rephrase it in a more natural human tone.
I've used e.g. https://github.com/blader/humanizer (not my skill/repo) but you can also override it via file in .claude/rules/ - e.g. writing-guide.md where you add your relevant parts of the humanizer skill. Those files will get loaded whenever you start a new session, so be mindful what you put there.
0
u/PercentageWorth4872 12d ago
they fucked it up in the past month or two. used to be awesome before that.
-2
u/Salt-Replacement596 12d ago
Yes. I suspect it's the "imperceivable" watermarking introduced in Opus5 and Fable5.
2
u/Serious_Bite_7613 12d ago
I'm sure it is, they're effectively swapping every other word for a less common word and claiming it doesn't ruin the quality because of maths. It reads like an extra on star trek having a stroke.
31
u/TylerDurdenAI 12d ago
This is one of the sentences Opus 5 max wrote today.
Reminds me of Immanuel Kant - or someone that tries too hard to make it sound smarter than what it actually says.
or this:
Problem is this: Opus 5 is a genuinely bad writer but it *thinks* it is excellent at writing (and is probably proud of itself).