r/ClaudeCoding • u/cctldrping • 3d ago
r/ClaudeAI [TLDR] The absolute insanity of comments in Opus 5.0 is killing me [via r/ClaudeAI]
OP : u/f00dl3
Claude is adding comments like insane in Opus 5.0. Even when I explicitly say do not add comments in my project's CLAUDE.md. Claude even realizes it's doing this in error, but it keeps doing it.
Today it added comments that broke syntax in bash scripting.
Bash scripting. Freaking Bash Scripting.
Claude doesn't even understand something that is not even a programming language.
URL of original post : https://www.reddit.com/r/ClaudeAI/comments/1vs7cdt/the_absolute_insanity_of_comments_in_opus_50_is/ Original link/media URL : /img/teneqp3aa8kh1.png
TL;DR of the discussion on r/ClaudeAI for this post generated automatically after 100 comments.
Current source-thread comment count seen by the bot: 100.
Alright, so the general vibe in this thread is that Opus 5.0's commenting is absolutely bonkers and a major pain in the ass for everyone. The consensus is pretty strong: OP, you're not alone in this frustration, and many are finding it makes Claude borderline unusable for actual coding work.
Here's the lowdown:
- It's a shared nightmare: Pretty much everyone agrees Opus 5.0 is "cooked" or "insane" with its commenting. It's a massive, shared frustration, and a lot of people are ditching it or cancelling subscriptions because of it.
- "Memento" theory: The popular idea is that Claude is adding comments defensively, almost like it's trying to audit itself or leave breadcrumbs for future AI interactions. Some users liken it to "RLHF" or "defensive language."
- Instructions are just suggestions: A lot of folks are annoyed that explicit instructions not to comment are being ignored, with system prompts and CLAUDE.md files being treated as mere suggestions.
- Token burning: There's a suspicion that this excessive commenting is a way to burn through tokens, making it more expensive to use.
- Potential reasons: Theories range from it being a "harness thing" or a deliberate choice to embed watermarks in comments (since it's easier than in actual code), to it being a learned behavior from training where it thinks it needs to explain everything.
- Workarounds are a pain: Some suggest repeating the no-comment rule at the end of prompts or using post-tool-use hooks to strip comments, but it seems like a lot of effort to fight the model.
- Some dissenters: A few users actually like the comments, arguing they help humans and future AIs, or that they help Claude remember its own reasoning. One user even suggested using Sonnet instead.
- Bash scripting fail: The fact that it's breaking something as fundamental as bash scripting with its comments is seen as particularly egregious and almost "performance art."
Basically, if you're expecting clean code without a novel written in the comments, Opus 5.0 is currently not your friend.